From 7b296ce2fb080db71ac97faf8292ce0c55f16653 Mon Sep 17 00:00:00 2001
From: Oskar Otwinowski <oskar@trigger.dev>
Date: Thu, 12 Feb 2026 17:24:43 +0100
Subject: [PATCH 1/5] feat(deployments): propagate build metadata and
 conditionally enqueue

Include build server metadata in progress API and deployment handling,
add skipEnqueue flag, and avoid enque builds for GitHub-integrated
ments without artifact keys.

- Add BuildServerMetadata schema and include it in ProgressDeploymentRequestBody.
- Thread buildServerMetadata through API handler into deployment service.
- Make artifactKey optional for native builds and add skipEnqueue with
  default false to request validation.
- When progressing deployments, merge incoming buildServerMetadata and
  validate against existing metadata.
- Only enqueue native builds when artifactKey is present and
  skipEnqueue is false. This prevents enqueue attempts for GitHub
  integrated builds that lack an artifactKey.
---
 ...i.v1.deployments.$deploymentId.progress.ts |  1 +
 .../app/v3/services/deployment.server.ts      | 59 ++++++++++++--
 .../services/initializeDeployment.server.ts   |  4 +-
 packages/core/src/v3/schemas/api.ts           | 80 +++++++++----------
 4 files changed, 92 insertions(+), 52 deletions(-)

diff --git a/apps/webapp/app/routes/api.v1.deployments.$deploymentId.progress.ts b/apps/webapp/app/routes/api.v1.deployments.$deploymentId.progress.ts
index 64f20f4f64..2c78c59f55 100644
--- a/apps/webapp/app/routes/api.v1.deployments.$deploymentId.progress.ts
+++ b/apps/webapp/app/routes/api.v1.deployments.$deploymentId.progress.ts
@@ -48,6 +48,7 @@ export async function action({ request, params }: ActionFunctionArgs) {
       contentHash: body.data.contentHash,
       git: body.data.gitMeta,
       runtime: body.data.runtime,
+      buildServerMetadata: body.data.buildServerMetadata,
     })
     .match(
       () => {
diff --git a/apps/webapp/app/v3/services/deployment.server.ts b/apps/webapp/app/v3/services/deployment.server.ts
index 848c06c453..176b1947af 100644
--- a/apps/webapp/app/v3/services/deployment.server.ts
+++ b/apps/webapp/app/v3/services/deployment.server.ts
@@ -2,7 +2,12 @@ import { type AuthenticatedEnvironment } from "~/services/apiAuth.server";
 import { BaseService } from "./baseService.server";
 import { errAsync, fromPromise, okAsync, type ResultAsync } from "neverthrow";
 import { type WorkerDeployment, type Project } from "@trigger.dev/database";
-import { BuildServerMetadata, logger, type GitMeta, type DeploymentEvent } from "@trigger.dev/core/v3";
+import {
+  BuildServerMetadata,
+  logger,
+  type GitMeta,
+  type DeploymentEvent,
+} from "@trigger.dev/core/v3";
 import { TimeoutDeploymentService } from "./timeoutDeployment.server";
 import { env } from "~/env.server";
 import { createRemoteImageBuild } from "../remoteImageBuilder.server";
@@ -38,9 +43,20 @@ export class DeploymentService extends BaseService {
   public progressDeployment(
     authenticatedEnv: AuthenticatedEnvironment,
     friendlyId: string,
-    updates: Partial<Pick<WorkerDeployment, "contentHash" | "runtime"> & { git: GitMeta }>
+    updates: Partial<
+      Pick<WorkerDeployment, "contentHash" | "runtime"> & {
+        git: GitMeta;
+        buildServerMetadata: BuildServerMetadata;
+      }
+    >
   ) {
-    const validateDeployment = (deployment: Pick<WorkerDeployment, "id" | "status"> & { buildServerMetadata?: BuildServerMetadata }) => {
+    const { buildServerMetadata: newBuildServerMetadata, ...restUpdates } = updates;
+
+    const validateDeployment = (
+      deployment: Pick<WorkerDeployment, "id" | "status"> & {
+        buildServerMetadata?: BuildServerMetadata;
+      }
+    ) => {
       if (deployment.status !== "PENDING" && deployment.status !== "INSTALLING") {
         logger.warn(
           "Attempted progressing deployment that is not in PENDING or INSTALLING status",
@@ -54,12 +70,27 @@ export class DeploymentService extends BaseService {
       return okAsync(deployment);
     };
 
-    const progressToInstalling = (deployment: Pick<WorkerDeployment, "id">) =>
-      fromPromise(
+    const progressToInstalling = (
+      deployment: Pick<WorkerDeployment, "id"> & { buildServerMetadata?: BuildServerMetadata }
+    ) => {
+      const existingBuildServerMetadata = deployment.buildServerMetadata as
+        | BuildServerMetadata
+        | null
+        | undefined;
+
+      return fromPromise(
         this._prisma.workerDeployment.updateMany({
           where: { id: deployment.id, status: "PENDING" }, // status could've changed in the meantime, we're not locking the row
           data: {
-            ...updates,
+            ...restUpdates,
+            ...(newBuildServerMetadata
+              ? {
+                  buildServerMetadata: {
+                    ...(existingBuildServerMetadata ?? {}),
+                    ...newBuildServerMetadata,
+                  },
+                }
+              : {}),
             status: "INSTALLING",
             startedAt: new Date(),
           },
@@ -74,6 +105,7 @@ export class DeploymentService extends BaseService {
         }
         return okAsync({ id: deployment.id, status: "INSTALLING" as const });
       });
+    };
 
     const progressToBuilding = (
       deployment: Pick<WorkerDeployment, "id"> & { buildServerMetadata?: BuildServerMetadata }
@@ -85,13 +117,26 @@ export class DeploymentService extends BaseService {
           cause: error,
         }));
 
+      const existingBuildServerMetadata = deployment.buildServerMetadata as
+        | BuildServerMetadata
+        | null
+        | undefined;
+
       return createRemoteBuildIfNeeded
         .andThen((externalBuildData) =>
           fromPromise(
             this._prisma.workerDeployment.updateMany({
               where: { id: deployment.id, status: "INSTALLING" }, // status could've changed in the meantime, we're not locking the row
               data: {
-                ...updates,
+                ...restUpdates,
+                ...(newBuildServerMetadata
+                  ? {
+                      buildServerMetadata: {
+                        ...(existingBuildServerMetadata ?? {}),
+                        ...newBuildServerMetadata,
+                      },
+                    }
+                  : {}),
                 externalBuildData,
                 status: "BUILDING",
                 installedAt: new Date(),
diff --git a/apps/webapp/app/v3/services/initializeDeployment.server.ts b/apps/webapp/app/v3/services/initializeDeployment.server.ts
index 96439d94d6..939cfd7e6f 100644
--- a/apps/webapp/app/v3/services/initializeDeployment.server.ts
+++ b/apps/webapp/app/v3/services/initializeDeployment.server.ts
@@ -200,6 +200,7 @@ export class InitializeDeploymentService extends BaseService {
                     artifactKey: payload.artifactKey,
                     skipPromotion: payload.skipPromotion,
                     configFilePath: payload.configFilePath,
+                    skipEnqueue: payload.skipEnqueue,
                   }
                 : {}),
             }
@@ -238,7 +239,8 @@ export class InitializeDeploymentService extends BaseService {
         new Date(Date.now() + timeoutMs)
       );
 
-      if (payload.isNativeBuild) {
+      // For github integration there is no artifactKey, hence we skip it here
+      if (payload.isNativeBuild && payload.artifactKey && !payload.skipEnqueue) {
         const result = await deploymentService
           .enqueueBuild(environment, deployment, payload.artifactKey, {
             skipPromotion: payload.skipPromotion,
diff --git a/packages/core/src/v3/schemas/api.ts b/packages/core/src/v3/schemas/api.ts
index 4cb5c96503..5591760879 100644
--- a/packages/core/src/v3/schemas/api.ts
+++ b/packages/core/src/v3/schemas/api.ts
@@ -485,10 +485,22 @@ export const FinalizeDeploymentRequestBody = z.object({
 
 export type FinalizeDeploymentRequestBody = z.infer<typeof FinalizeDeploymentRequestBody>;
 
+export const BuildServerMetadata = z.object({
+  buildId: z.string().optional(),
+  isNativeBuild: z.boolean().optional(),
+  artifactKey: z.string().optional(),
+  skipPromotion: z.boolean().optional(),
+  configFilePath: z.string().optional(),
+  skipEnqueue: z.boolean().optional(),
+});
+
+export type BuildServerMetadata = z.infer<typeof BuildServerMetadata>;
+
 export const ProgressDeploymentRequestBody = z.object({
   contentHash: z.string().optional(),
   gitMeta: GitMeta.optional(),
   runtime: z.string().optional(),
+  buildServerMetadata: BuildServerMetadata.optional(),
 });
 
 export type ProgressDeploymentRequestBody = z.infer<typeof ProgressDeploymentRequestBody>;
@@ -528,16 +540,6 @@ export const DeploymentTriggeredVia = z
 
 export type DeploymentTriggeredVia = z.infer<typeof DeploymentTriggeredVia>;
 
-export const BuildServerMetadata = z.object({
-  buildId: z.string().optional(),
-  isNativeBuild: z.boolean().optional(),
-  artifactKey: z.string().optional(),
-  skipPromotion: z.boolean().optional(),
-  configFilePath: z.string().optional(),
-});
-
-export type BuildServerMetadata = z.infer<typeof BuildServerMetadata>;
-
 export const UpsertBranchRequestBody = z.object({
   git: GitMeta.optional(),
   env: z.enum(["preview"]),
@@ -590,41 +592,31 @@ export const InitializeDeploymentResponseBody = z.object({
 
 export type InitializeDeploymentResponseBody = z.infer<typeof InitializeDeploymentResponseBody>;
 
-export const InitializeDeploymentRequestBody = z
-  .object({
-    contentHash: z.string(),
-    userId: z.string().optional(),
-    /** @deprecated This is now determined by the webapp. This is only used to warn users with old CLI versions. */
-    selfHosted: z.boolean().optional(),
-    gitMeta: GitMeta.optional(),
-    type: z.enum(["MANAGED", "UNMANAGED", "V1"]).optional(),
-    runtime: z.string().optional(),
-    initialStatus: z.enum(["PENDING", "BUILDING"]).optional(),
-    triggeredVia: DeploymentTriggeredVia.optional(),
-    buildId: z.string().optional(),
+const InitializeDeploymentRequestBodyBase = z.object({
+  contentHash: z.string(),
+  userId: z.string().optional(),
+  /** @deprecated This is now determined by the webapp. This is only used to warn users with old CLI versions. */
+  selfHosted: z.boolean().optional(),
+  gitMeta: GitMeta.optional(),
+  type: z.enum(["MANAGED", "UNMANAGED", "V1"]).optional(),
+  runtime: z.string().optional(),
+  initialStatus: z.enum(["PENDING", "BUILDING"]).optional(),
+  triggeredVia: DeploymentTriggeredVia.optional(),
+  buildId: z.string().optional(),
+  isNativeBuild: z.boolean().default(false).optional()
+})
+export const InitializeDeploymentRequestBody = z.discriminatedUnion("isNativeBuild", [
+  InitializeDeploymentRequestBodyBase.extend({
+    isNativeBuild: z.literal(true),
+    skipPromotion: z.boolean().optional(),
+    artifactKey: z.string().optional(),
+    configFilePath: z.string().optional(),
+    skipEnqueue: z.boolean().default(false).optional(),
+  }),
+  InitializeDeploymentRequestBodyBase.extend({
+    isNativeBuild: z.literal(false).optional(),
   })
-  .and(
-    z.preprocess(
-      (val) => {
-        const obj = val as any;
-        if (!obj || !obj.isNativeBuild) {
-          return { ...obj, isNativeBuild: false };
-        }
-        return obj;
-      },
-      z.discriminatedUnion("isNativeBuild", [
-        z.object({
-          isNativeBuild: z.literal(true),
-          skipPromotion: z.boolean(),
-          artifactKey: z.string(),
-          configFilePath: z.string().optional(),
-        }),
-        z.object({
-          isNativeBuild: z.literal(false),
-        }),
-      ])
-    )
-  );
+]);
 
 export type InitializeDeploymentRequestBody = z.infer<typeof InitializeDeploymentRequestBody>;
 

From 349feb011f1a509dc9c39112a1df75994250074a Mon Sep 17 00:00:00 2001
From: Oskar Otwinowski <oskar@trigger.dev>
Date: Thu, 12 Feb 2026 17:25:22 +0100
Subject: [PATCH 2/5] feat(webapp): auto-select and optimize project selector

Automatically set the Vercel project when entering project-selection if
there is at least one available project and none selected. This prevents
an empty selection state and reduces manual clicks for the common case
of a single or first project.

Disable the Select when there is exactly one available project to make
the intent explicit and avoid unnecessary interaction. Add a filter
prop to the Select only when there are more than five projects to keep
the dropdown performant and avoid enabling filtering for small lists.

Adjust the effect deps to trigger selection only on relevant state and
project list changes.
---
 .../app/components/integrations/VercelOnboardingModal.tsx | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx b/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
index c2a5bfec43..ec541b6647 100644
--- a/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
+++ b/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
@@ -565,6 +565,12 @@ export function VercelOnboardingModal({
     }
   }, [state, customEnvironments, vercelStagingEnvironment]);
 
+  useEffect(() => {
+    if (state === "project-selection" && availableProjects.length > 0 && !selectedVercelProject) {
+      setSelectedVercelProject(availableProjects[0]);
+    }
+  }, [state, availableProjects, selectedVercelProject]);
+
   if (!isOpen || onboardingData?.authInvalid) {
     return null;
   }
@@ -625,6 +631,7 @@ export function VercelOnboardingModal({
                 </Callout>
               ) : (
                 <Select
+                  disabled={availableProjects.length === 1}
                   value={selectedVercelProject?.id || ""}
                   setValue={(value) => {
                     if (!Array.isArray(value)) {
@@ -634,6 +641,7 @@ export function VercelOnboardingModal({
                     }
                   }}
                   items={availableProjects}
+                  filter={availableProjects.length > 5 ? { keys: ["name"] } : undefined}
                   variant="tertiary/medium"
                   placeholder="Select a Vercel project"
                   dropdownIcon

From bb81ce3df9873dcac67679900630bb273e4a1359 Mon Sep 17 00:00:00 2001
From: Oskar Otwinowski <oskar@trigger.dev>
Date: Thu, 12 Feb 2026 18:40:51 +0100
Subject: [PATCH 3/5] feat(analytics): add PostHog tracking to Vercel
 onboarding

Introduce PostHog instrumentation in the VercelOnboardingModal to
capture user progress and actions during the onboarding flow.

Key changes:
- Import posthog and add a reusable trackOnboarding callback that
  attaches context (origin, step, organization_slug, project_slug).
- Start session recording and emit a "vercel onboarding started" event
  the first time the modal reaches project-selection while open.
- Track key milestones and user decisions:
  - "vercel onboarding project selected" when a project is chosen.
  - "vercel onboarding abandoned" when the user skips onboarding.
  - "vercel onboarding env mapping completed" with skipped flag or
    selected staging environment.
  - "vercel onboarding build settings completed".
  - "vercel onboarding completed" with github_connected flag.
- Ensure tracking callbacks are included in effect and callback deps
  to avoid stale closures and double-tracking.

Why:
- Provide visibility into onboarding funnel performance and user
  behaviors to improve onboarding UX and conversion.
---
 .../integrations/VercelOnboardingModal.tsx    | 79 +++++++++++++++++--
 apps/webapp/app/hooks/usePostHog.ts           | 17 +++-
 2 files changed, 87 insertions(+), 9 deletions(-)

diff --git a/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx b/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
index ec541b6647..70263829ca 100644
--- a/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
+++ b/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
@@ -47,6 +47,7 @@ import { type VercelOnboardingData } from "~/presenters/v3/VercelSettingsPresent
 import { vercelAppInstallPath, v3ProjectSettingsPath, githubAppInstallPath, vercelResourcePath } from "~/utils/pathBuilder";
 import type { loader } from "~/routes/resources.orgs.$organizationSlug.projects.$projectParam.env.$envParam.vercel";
 import { useEffect, useState, useCallback, useRef } from "react";
+import { usePostHogTracking } from "~/hooks/usePostHog";
 
 function safeRedirectUrl(url: string): string | null {
   try {
@@ -114,6 +115,7 @@ export function VercelOnboardingModal({
   nextUrl?: string;
   onDataReload?: (vercelStagingEnvironment?: string) => void;
 }) {
+  const { capture, startSessionRecording } = usePostHogTracking();
   const navigation = useNavigation();
   const fetcher = useTypedFetcher<typeof loader>();
   const envMappingFetcher = useFetcher();
@@ -172,6 +174,31 @@ export function VercelOnboardingModal({
     prevIsOpenRef.current = isOpen;
   }, [isOpen, state, computeInitialState]);
 
+  const trackOnboarding = useCallback(
+    (eventName: string, extraProperties?: Record<string, unknown>) => {
+      capture(eventName, {
+        origin: fromMarketplaceContext ? "marketplace" : "dashboard",
+        step: state,
+        organization_slug: organizationSlug,
+        project_slug: projectSlug,
+        ...extraProperties,
+      });
+    },
+    [capture, fromMarketplaceContext, state, organizationSlug, projectSlug]
+  );
+
+  const hasTrackedStartRef = useRef(false);
+  useEffect(() => {
+    if (isOpen && state === "project-selection" && !hasTrackedStartRef.current) {
+      hasTrackedStartRef.current = true;
+      startSessionRecording();
+      trackOnboarding("vercel onboarding started");
+    }
+    if (!isOpen) {
+      hasTrackedStartRef.current = false;
+    }
+  }, [isOpen, state, trackOnboarding, startSessionRecording]);
+
   const [selectedVercelProject, setSelectedVercelProject] = useState<{
     id: string;
     name: string;
@@ -337,6 +364,9 @@ export function VercelOnboardingModal({
 
   useEffect(() => {
     if (state === "project-selection" && fetcher.data && "success" in fetcher.data && fetcher.data.success && fetcher.state === "idle") {
+      trackOnboarding("vercel onboarding project selected", {
+        vercel_project_name: selectedVercelProject?.name,
+      });
       setState("loading-env-mapping");
       if (onDataReload) {
         onDataReload();
@@ -344,7 +374,7 @@ export function VercelOnboardingModal({
     } else if (fetcher.data && "error" in fetcher.data && typeof fetcher.data.error === "string") {
       setProjectSelectionError(fetcher.data.error);
     }
-  }, [state, fetcher.data, fetcher.state, onDataReload]);
+  }, [state, fetcher.data, fetcher.state, onDataReload, trackOnboarding, selectedVercelProject?.name]);
 
   // For marketplace origin, skip env-mapping step
   useEffect(() => {
@@ -437,6 +467,7 @@ export function VercelOnboardingModal({
   }, [selectedVercelProject, fetcher, actionUrl]);
 
   const handleSkipOnboarding = useCallback(() => {
+    trackOnboarding("vercel onboarding abandoned");
     onClose();
 
     if (fromMarketplaceContext) {
@@ -449,14 +480,23 @@ export function VercelOnboardingModal({
       method: "post",
       action: actionUrl,
     });
-  }, [actionUrl, fetcher, onClose, nextUrl, fromMarketplaceContext]);
+  }, [actionUrl, fetcher, onClose, nextUrl, fromMarketplaceContext, trackOnboarding]);
 
   const handleSkipEnvMapping = useCallback(() => {
+    trackOnboarding("vercel onboarding env mapping completed", {
+      skipped: true,
+      staging_environment: null,
+    });
     setVercelStagingEnvironment(null);
     setState("loading-env-vars");
-  }, []);
+  }, [trackOnboarding]);
 
   const handleUpdateEnvMapping = useCallback(() => {
+    trackOnboarding("vercel onboarding env mapping completed", {
+      skipped: false,
+      staging_environment: vercelStagingEnvironment?.displayName ?? null,
+    });
+
     if (!vercelStagingEnvironment) {
       setState("loading-env-vars");
       return;
@@ -471,9 +511,11 @@ export function VercelOnboardingModal({
       action: actionUrl,
     });
 
-  }, [vercelStagingEnvironment, envMappingFetcher, actionUrl]);
+  }, [vercelStagingEnvironment, envMappingFetcher, actionUrl, trackOnboarding]);
 
   const handleBuildSettingsNext = useCallback(() => {
+    trackOnboarding("vercel onboarding build settings completed");
+
     if (nextUrl && fromMarketplaceContext && isGitHubConnectedForOnboarding) {
       setIsRedirecting(true);
     }
@@ -501,7 +543,7 @@ export function VercelOnboardingModal({
     if (!isGitHubConnectedForOnboarding) {
       setState("github-connection");
     }
-  }, [vercelStagingEnvironment, pullEnvVarsBeforeBuild, atomicBuilds, discoverEnvVars, syncEnvVarsMapping, nextUrl, fromMarketplaceContext, isGitHubConnectedForOnboarding, completeOnboardingFetcher, actionUrl]);
+  }, [vercelStagingEnvironment, pullEnvVarsBeforeBuild, atomicBuilds, discoverEnvVars, syncEnvVarsMapping, nextUrl, fromMarketplaceContext, isGitHubConnectedForOnboarding, completeOnboardingFetcher, actionUrl, trackOnboarding]);
 
   const handleFinishOnboarding = useCallback((e: React.FormEvent<HTMLFormElement>) => {
     e.preventDefault();
@@ -531,9 +573,12 @@ export function VercelOnboardingModal({
 
   useEffect(() => {
     if (state === "completed") {
+      trackOnboarding("vercel onboarding completed", {
+        github_connected: isGitHubConnectedForOnboarding,
+      });
       onClose();
     }
-  }, [state, onClose]);
+  }, [state, onClose, trackOnboarding, isGitHubConnectedForOnboarding]);
 
   useEffect(() => {
     if (state === "installing") {
@@ -584,7 +629,14 @@ export function VercelOnboardingModal({
 
   if (isLoadingState) {
     return (
-      <Dialog open={isOpen} onOpenChange={(open) => !open && !fromMarketplaceContext && onClose()}>
+      <Dialog open={isOpen} onOpenChange={(open) => {
+        if (!open && !fromMarketplaceContext) {
+          if (state as string !== "completed") {
+            trackOnboarding("vercel onboarding abandoned");
+          }
+          onClose();
+        }
+      }}>
         <DialogContent className="max-w-lg">
           <DialogHeader>
             <div className="flex items-center gap-2">
@@ -607,7 +659,14 @@ export function VercelOnboardingModal({
   const showGitHubConnection = state === "github-connection";
 
   return (
-    <Dialog open={isOpen} onOpenChange={(open) => !open && !fromMarketplaceContext && onClose()}>
+    <Dialog open={isOpen} onOpenChange={(open) => {
+      if (!open && !fromMarketplaceContext) {
+        if (state !== "completed") {
+          trackOnboarding("vercel onboarding abandoned");
+        }
+        onClose();
+      }
+    }}>
       <DialogContent className="max-w-lg">
         <DialogHeader>
           <div className="flex items-center gap-2">
@@ -902,6 +961,10 @@ export function VercelOnboardingModal({
                   <Button
                     variant="primary/medium"
                     onClick={() => {
+                      trackOnboarding("vercel onboarding env vars configured", {
+                        env_vars_enabled: enabledEnvVars.length,
+                        env_vars_total: syncableEnvVars.length,
+                      });
                       if (fromMarketplaceContext) {
                         handleBuildSettingsNext();
                       } else {
diff --git a/apps/webapp/app/hooks/usePostHog.ts b/apps/webapp/app/hooks/usePostHog.ts
index 99e2597dfe..f52663ec01 100644
--- a/apps/webapp/app/hooks/usePostHog.ts
+++ b/apps/webapp/app/hooks/usePostHog.ts
@@ -1,6 +1,6 @@
 import { useLocation } from "@remix-run/react";
 import posthog from "posthog-js";
-import { useEffect, useRef } from "react";
+import { useCallback, useEffect, useRef } from "react";
 import { useOrganizationChanged } from "./useOrganizations";
 import { useOptionalUser, useUserChanged } from "./useUser";
 import { useProjectChanged } from "./useProject";
@@ -68,3 +68,18 @@ export const usePostHog = (apiKey?: string, logging = false, debug = false): voi
     posthog.capture("$pageview");
   }, [location, logging]);
 };
+
+export function usePostHogTracking() {
+  const capture = useCallback(
+    (eventName: string, properties?: Record<string, unknown>) => {
+      posthog.capture(eventName, properties);
+    },
+    []
+  );
+
+  const startSessionRecording = useCallback(() => {
+    posthog.startSessionRecording();
+  }, []);
+
+  return { capture, startSessionRecording };
+}

From a33b5424686cf4971addf2ec196a7eb65d91e112 Mon Sep 17 00:00:00 2001
From: Oskar Otwinowski <oskar@trigger.dev>
Date: Fri, 13 Feb 2026 11:03:22 +0100
Subject: [PATCH 4/5] feat(schema): fix typings for
 InitializeDeploymentRequestBody

Replace the previous discriminatedUnion-based InitializeDeploymentRequestBody
with a single extended schema (InitializeDeploymentRequestBodyFull) that
always includes an isNativeBuild boolean (default false) and optional
native-only fields. Add a transform that returns strongly-typed outputs:
NativeBuildOutput (with native fields present) or NonNativeBuildOutput
(with native-only fields removed). This simplifies runtime parsing and
ensures non-native payloads do not carry native-only keys.

Remove the ambiguous discriminated union and reintroduce buildId on the
base schema.

Add comprehensive unit tests for InitializeDeploymentRequestBody covering:
- parsing of non-native variant when isNativeBuild is omitted or false,
- stripping of native-only fields for non-native payloads,
- parsing of native variant with native-specific optional fields,
- behavior of skipEnqueue/default handling.

These changes improve type consistency, make runtime behavior explicit,
and increase test coverage for deployment initialization payloads.
---
 .vscode/launch.json                           |   9 ++
 packages/core/src/v3/schemas/api-type.test.ts | 141 ++++++++++++++++++
 packages/core/src/v3/schemas/api.ts           |  53 +++++--
 3 files changed, 188 insertions(+), 15 deletions(-)
 create mode 100644 packages/core/src/v3/schemas/api-type.test.ts

diff --git a/.vscode/launch.json b/.vscode/launch.json
index d135aa70a2..71a76904a2 100644
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -31,6 +31,15 @@
       "cwd": "${workspaceFolder}/apps/webapp",
       "sourceMaps": true
     },
+    {
+      "type": "node-terminal",
+      "request": "launch",
+      "name": "Debug opened test file",
+      "command": "pnpm run test -- ./${relativeFile}",
+      "envFile": "${workspaceFolder}/.env",
+      "cwd": "${workspaceFolder}",
+      "sourceMaps": true
+    },
     {
       "type": "chrome",
       "request": "launch",
diff --git a/packages/core/src/v3/schemas/api-type.test.ts b/packages/core/src/v3/schemas/api-type.test.ts
new file mode 100644
index 0000000000..c936b3c769
--- /dev/null
+++ b/packages/core/src/v3/schemas/api-type.test.ts
@@ -0,0 +1,141 @@
+import { describe, it, expect } from "vitest";
+import { InitializeDeploymentRequestBody } from "./api.js";
+import type { InitializeDeploymentRequestBody as InitializeDeploymentRequestBodyType } from "./api.js";
+
+describe("InitializeDeploymentRequestBody", () => {
+  const base = { contentHash: "abc123" };
+
+  describe("non-native build variant (isNativeBuild omitted or false)", () => {
+    it("parses with only required fields", () => {
+      const result = InitializeDeploymentRequestBody.safeParse(base);
+      expect(result.success).toBe(true);
+      if (result.success) {
+        expect(result.data.isNativeBuild).toBe(false);
+      }
+    });
+
+    it("parses with isNativeBuild explicitly false", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({ ...base, isNativeBuild: false });
+      expect(result.success).toBe(true);
+    });
+
+    it("parses with optional base fields", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        userId: "user_1",
+        type: "MANAGED",
+        runtime: "node",
+        initialStatus: "PENDING",
+      });
+      expect(result.success).toBe(true);
+    });
+
+    it("strips native-only fields when isNativeBuild is false", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        isNativeBuild: false,
+        skipPromotion: true,
+      });
+      // Zod discriminatedUnion matches the non-native branch and strips unknown keys
+      expect(result.success).toBe(true);
+      if (result.success) {
+        expect("skipPromotion" in result.data).toBe(false);
+      }
+    });
+  });
+
+  describe("native build variant (isNativeBuild: true)", () => {
+    it("parses with isNativeBuild true", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        isNativeBuild: true,
+      });
+      expect(result.success).toBe(true);
+      if (result.success) {
+        expect(result.data.isNativeBuild).toBe(true);
+      }
+    });
+
+    it("parses with native-specific optional fields", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        isNativeBuild: true,
+        skipPromotion: true,
+        artifactKey: "artifact_abc",
+        configFilePath: "trigger.config.ts",
+        skipEnqueue: true,
+      });
+      expect(result.success).toBe(true);
+      if (result.success) {
+        expect(result.data.skipPromotion).toBe(true);
+        expect(result.data.artifactKey).toBe("artifact_abc");
+        expect(result.data.configFilePath).toBe("trigger.config.ts");
+        expect(result.data.skipEnqueue).toBe(true);
+      }
+    });
+
+    it("skipEnqueue defaults to false when omitted", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        isNativeBuild: true,
+      });
+      expect(result.success).toBe(true);
+      if (result.success) {
+        expect(result.data.skipEnqueue).toBe(false);
+      }
+    });
+  });
+
+  describe("rejects invalid inputs", () => {
+    it("rejects missing contentHash", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({});
+      expect(result.success).toBe(false);
+    });
+
+    it("rejects invalid type enum value", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        type: "INVALID",
+      });
+      expect(result.success).toBe(false);
+    });
+
+    it("rejects invalid initialStatus enum value", () => {
+      const result = InitializeDeploymentRequestBody.safeParse({
+        ...base,
+        initialStatus: "RUNNING",
+      });
+      expect(result.success).toBe(false);
+    });
+  });
+
+  describe("type-level checks", () => {
+    it("native variant exposes native-specific fields", () => {
+      const result = InitializeDeploymentRequestBody.parse({
+        ...base,
+        isNativeBuild: true,
+        skipPromotion: true,
+      });
+
+      if (result.isNativeBuild === true) {
+        const _skipPromotion: boolean | undefined = result.skipPromotion;
+        const _artifactKey: string | undefined = result.artifactKey;
+        const _configFilePath: string | undefined = result.configFilePath;
+        expect(_skipPromotion).toBe(true);
+        expect(_artifactKey).toBeUndefined();
+        expect(_configFilePath).toBeUndefined();
+      }
+    });
+
+    it("non-native variant narrows correctly", () => {
+      const result: InitializeDeploymentRequestBodyType =
+        InitializeDeploymentRequestBody.parse(base);
+
+      if (!result.isNativeBuild) {
+        // Should only have base fields — native-specific fields should not exist
+        const narrowed: { isNativeBuild?: false; contentHash: string } = result;
+        expect(narrowed.contentHash).toBe("abc123");
+      }
+    });
+  });
+});
diff --git a/packages/core/src/v3/schemas/api.ts b/packages/core/src/v3/schemas/api.ts
index 5591760879..e9875bf2c5 100644
--- a/packages/core/src/v3/schemas/api.ts
+++ b/packages/core/src/v3/schemas/api.ts
@@ -9,6 +9,7 @@ import {
 } from "./common.js";
 import { BackgroundWorkerMetadata } from "./resources.js";
 import { DequeuedMessage, MachineResources } from "./runEngine.js";
+import { fa } from "zod/v4/locales";
 
 export const RunEngineVersion = z.union([z.literal("V1"), z.literal("V2")]);
 
@@ -602,21 +603,43 @@ const InitializeDeploymentRequestBodyBase = z.object({
   runtime: z.string().optional(),
   initialStatus: z.enum(["PENDING", "BUILDING"]).optional(),
   triggeredVia: DeploymentTriggeredVia.optional(),
-  buildId: z.string().optional(),
-  isNativeBuild: z.boolean().default(false).optional()
-})
-export const InitializeDeploymentRequestBody = z.discriminatedUnion("isNativeBuild", [
-  InitializeDeploymentRequestBodyBase.extend({
-    isNativeBuild: z.literal(true),
-    skipPromotion: z.boolean().optional(),
-    artifactKey: z.string().optional(),
-    configFilePath: z.string().optional(),
-    skipEnqueue: z.boolean().default(false).optional(),
-  }),
-  InitializeDeploymentRequestBodyBase.extend({
-    isNativeBuild: z.literal(false).optional(),
-  })
-]);
+  buildId: z.string().optional()
+});
+type BaseOutput = z.output<typeof InitializeDeploymentRequestBodyBase>;
+
+type NativeBuildOutput = BaseOutput & {
+  isNativeBuild: true;
+  skipPromotion?: boolean;
+  artifactKey?: string;
+  configFilePath?: string;
+  skipEnqueue?: boolean;
+};
+
+type NonNativeBuildOutput = BaseOutput & {
+  isNativeBuild: false;
+  skipPromotion?: never;
+  artifactKey?: never;
+  configFilePath?: never;
+  skipEnqueue?: never;
+};
+
+const InitializeDeploymentRequestBodyFull = InitializeDeploymentRequestBodyBase.extend({
+  isNativeBuild: z.boolean().default(false),
+  skipPromotion: z.boolean().optional(),
+  artifactKey: z.string().optional(),
+  configFilePath: z.string().optional(),
+  skipEnqueue: z.boolean().optional().default(false),
+});
+
+export const InitializeDeploymentRequestBody = InitializeDeploymentRequestBodyFull.transform(
+  (data): NativeBuildOutput | NonNativeBuildOutput => {
+    if (data.isNativeBuild) {
+      return { ...data, isNativeBuild: true as const };
+    }
+    const { skipPromotion, artifactKey, configFilePath, skipEnqueue, ...rest } = data;
+    return { ...rest, isNativeBuild: false as const };
+  }
+);
 
 export type InitializeDeploymentRequestBody = z.infer<typeof InitializeDeploymentRequestBody>;
 

From 146496f63045c4c80fd7a1f138d63388a565c140 Mon Sep 17 00:00:00 2001
From: Oskar Otwinowski <oskar@trigger.dev>
Date: Fri, 13 Feb 2026 11:51:24 +0100
Subject: [PATCH 5/5] chore(vercel): PR feedback minor tweaks

---
 .../app/components/integrations/VercelOnboardingModal.tsx | 8 +++++---
 apps/webapp/app/v3/services/deployment.server.ts          | 5 +----
 packages/core/src/v3/schemas/api.ts                       | 1 -
 3 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx b/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
index 70263829ca..dc6996dab1 100644
--- a/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
+++ b/apps/webapp/app/components/integrations/VercelOnboardingModal.tsx
@@ -188,6 +188,7 @@ export function VercelOnboardingModal({
   );
 
   const hasTrackedStartRef = useRef(false);
+  const hasTrackedCompletionRef = useRef(false);
   useEffect(() => {
     if (isOpen && state === "project-selection" && !hasTrackedStartRef.current) {
       hasTrackedStartRef.current = true;
@@ -196,6 +197,7 @@ export function VercelOnboardingModal({
     }
     if (!isOpen) {
       hasTrackedStartRef.current = false;
+      hasTrackedCompletionRef.current = false;
     }
   }, [isOpen, state, trackOnboarding, startSessionRecording]);
 
@@ -467,7 +469,6 @@ export function VercelOnboardingModal({
   }, [selectedVercelProject, fetcher, actionUrl]);
 
   const handleSkipOnboarding = useCallback(() => {
-    trackOnboarding("vercel onboarding abandoned");
     onClose();
 
     if (fromMarketplaceContext) {
@@ -480,7 +481,7 @@ export function VercelOnboardingModal({
       method: "post",
       action: actionUrl,
     });
-  }, [actionUrl, fetcher, onClose, nextUrl, fromMarketplaceContext, trackOnboarding]);
+  }, [actionUrl, fetcher, onClose, fromMarketplaceContext]);
 
   const handleSkipEnvMapping = useCallback(() => {
     trackOnboarding("vercel onboarding env mapping completed", {
@@ -572,7 +573,8 @@ export function VercelOnboardingModal({
   }, [completeOnboardingFetcher.data, completeOnboardingFetcher.state, state]);
 
   useEffect(() => {
-    if (state === "completed") {
+    if (state === "completed" && !hasTrackedCompletionRef.current) {
+      hasTrackedCompletionRef.current = true;
       trackOnboarding("vercel onboarding completed", {
         github_connected: isGitHubConnectedForOnboarding,
       });
diff --git a/apps/webapp/app/v3/services/deployment.server.ts b/apps/webapp/app/v3/services/deployment.server.ts
index 176b1947af..56888284ba 100644
--- a/apps/webapp/app/v3/services/deployment.server.ts
+++ b/apps/webapp/app/v3/services/deployment.server.ts
@@ -73,10 +73,7 @@ export class DeploymentService extends BaseService {
     const progressToInstalling = (
       deployment: Pick<WorkerDeployment, "id"> & { buildServerMetadata?: BuildServerMetadata }
     ) => {
-      const existingBuildServerMetadata = deployment.buildServerMetadata as
-        | BuildServerMetadata
-        | null
-        | undefined;
+      const existingBuildServerMetadata = deployment.buildServerMetadata;
 
       return fromPromise(
         this._prisma.workerDeployment.updateMany({
diff --git a/packages/core/src/v3/schemas/api.ts b/packages/core/src/v3/schemas/api.ts
index e9875bf2c5..76f93af3ff 100644
--- a/packages/core/src/v3/schemas/api.ts
+++ b/packages/core/src/v3/schemas/api.ts
@@ -9,7 +9,6 @@ import {
 } from "./common.js";
 import { BackgroundWorkerMetadata } from "./resources.js";
 import { DequeuedMessage, MachineResources } from "./runEngine.js";
-import { fa } from "zod/v4/locales";
 
 export const RunEngineVersion = z.union([z.literal("V1"), z.literal("V2")]);