@liiift-studio/deploy-vercel-from-sanity 1.5.0 → 1.6.0

package/README.md

@@ -336,8 +336,11 @@ Requirements for the route:
   your site's domain, so every call is cross-origin and the preflight fails
   without an allow-list. Echo one allow-listed origin; do not send `*` to an
   endpoint that takes an `Authorization` header.
-- **Restrict which branches it will bump.** The recovery flow only ever needs the
-  branches you deploy.
+- **Restrict which branches it will bump**, and read that list from the
+  environment rather than hard-coding it. The recovery flow only ever needs the
+  branches you deploy, but the list has to change when you add a deploy target —
+  and a hard-coded list can only be changed by shipping a deploy, which is the
+  very thing that is broken when this route is needed.
 - **Answer `{ error }` on failure.** The plugin shows that string to the editor
   verbatim, in preference to its own generic message.
 - **Serve it over https.** The plugin refuses a plaintext endpoint, because the

package/dist/index.d.mts

@@ -60,6 +60,12 @@ interface VercelDeployment {
          * deployment comes back BLOCKED.
          */
         githubCommitAuthorLogin?: string;
+        /**
+         * Branch the deploy hook is configured for. Present only on hook-triggered
+         * deployments, and more reliable than githubCommitRef for learning which branch
+         * a target follows, since it describes the hook rather than one commit.
+         */
+        deployHookRef?: string;
         /** GitHub repo in "org/repo" format — used to construct commit links */
         githubRepo?: string;
         /** GitHub org slug — fallback when githubRepo is absent */

package/dist/index.d.ts

@@ -60,6 +60,12 @@ interface VercelDeployment {
          * deployment comes back BLOCKED.
          */
         githubCommitAuthorLogin?: string;
+        /**
+         * Branch the deploy hook is configured for. Present only on hook-triggered
+         * deployments, and more reliable than githubCommitRef for learning which branch
+         * a target follows, since it describes the hook rather than one commit.
+         */
+        deployHookRef?: string;
         /** GitHub repo in "org/repo" format — used to construct commit links */
         githubRepo?: string;
         /** GitHub org slug — fallback when githubRepo is absent */

package/dist/index.js

@@ -617,7 +617,7 @@ async function vercelFetch(path, token, init) {
 async function listDeployments(opts) {
   const params = new URLSearchParams({
     projectId: opts.projectId,
-    "meta-deployHookId": opts.hookId,
+    ...opts.branch ? { "meta-githubCommitRef": opts.branch } : { "meta-deployHookId": opts.hookId },
     limit: String(opts.limit ?? 10)
   });
   if (opts.teamId) params.set("teamId", opts.teamId);
@@ -671,7 +671,7 @@ async function proxyFetch(url, statusKey, init) {
   }
   return res.json();
 }
-async function fetchDeployments(transport, target, limit) {
+async function fetchDeployments(transport, target, limit, branch) {
   if (transport.mode === "direct") {
     if (!target.projectId || !target.hookId) return [];
     return listDeployments({
@@ -679,11 +679,13 @@ async function fetchDeployments(transport, target, limit) {
       hookId: target.hookId,
       token: transport.token,
       teamId: target.teamId,
-      limit
+      limit,
+      branch
     });
   }
   const params = new URLSearchParams({ key: target.proxyKey ?? "" });
   if (limit) params.set("limit", String(limit));
+  if (branch) params.set("branch", branch);
   const data = await proxyFetch(
     `${transport.proxyUrl}/deployments?${params}`,
     transport.statusKey
@@ -952,7 +954,7 @@ function StatusBadge({ state, showSpinner }) {
 // src/components/DeployHistory.tsx
 var import_react7 = require("react");
 var import_jsx_runtime9 = require("react/jsx-runtime");
-function DeployHistory({ target, token, onClose }) {
+function DeployHistory({ target, token, branch, onClose }) {
   const dialogId = (0, import_react7.useId)();
   const pluginConfig = usePluginConfig();
   const [deployments, setDeployments] = (0, import_react7.useState)([]);
@@ -971,14 +973,14 @@ function DeployHistory({ target, token, onClose }) {
     setLoading(true);
     setError(null);
     try {
-      const data = await fetchDeployments(transport, targetRef, 20);
+      const data = await fetchDeployments(transport, targetRef, 20, branch);
       setDeployments(data);
     } catch (err) {
       setError(err instanceof Error ? err.message : "Failed to load history");
     } finally {
       setLoading(false);
     }
-  }, [transport, targetRef]);
+  }, [transport, targetRef, branch]);
   (0, import_react7.useEffect)(() => {
     load();
   }, [load]);
@@ -1004,7 +1006,7 @@ function DeployHistory({ target, token, onClose }) {
           ] }) }),
           deployments.map((d) => {
             const { label, tone } = stateLabel(d.state);
-            const branch = d.meta?.githubCommitRef ?? "\u2014";
+            const branch2 = d.meta?.githubCommitRef ?? "\u2014";
             const sha = shortSha(d.meta?.githubCommitSha);
             const message = d.meta?.githubCommitMessage?.split("\n")[0] ?? "";
             return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Card, { padding: 3, radius: 2, shadow: 1, tone: "default", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(Flex, { gap: 3, align: "center", children: [
@@ -1020,7 +1022,7 @@ function DeployHistory({ target, token, onClose }) {
               ) : /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { size: 1, muted: true, children: "\u2014" }) }),
               /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Box, { flex: 1, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Badge, { tone, children: label }) }),
               /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Box, { flex: 2, style: { overflow: "hidden" }, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(Stack, { space: 1, children: [
-                /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { size: 1, children: branch }),
+                /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { size: 1, children: branch2 }),
                 sha && /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(Text, { size: 0, muted: true, children: [
                   sha,
                   message ? ` \xB7 ${message.slice(0, 40)}${message.length > 40 ? "\u2026" : ""}` : ""
@@ -1054,6 +1056,7 @@ var import_jsx_runtime10 = require("react/jsx-runtime");
 var POLL_INTERVAL_MS = 5e3;
 var LABEL_WIDTH = 64;
 var PENDING_TIMEOUT_MS = 6e4;
+var BUMP_WATCH_TIMEOUT_MS = 3e5;
 function DeployItem({ target, token, onDelete, onEdit }) {
   const { projectId, hookId } = parseHookUrl(target.url);
   const toast = useToast();
@@ -1083,8 +1086,11 @@ function DeployItem({ target, token, onDelete, onEdit }) {
   const [logError, setLogError] = (0, import_react8.useState)(null);
   const [pollError, setPollError] = (0, import_react8.useState)(null);
   const [bumping, setBumping] = (0, import_react8.useState)(false);
+  const [awaitingBump, setAwaitingBump] = (0, import_react8.useState)(false);
+  const [knownBranch, setKnownBranch] = (0, import_react8.useState)(void 0);
   const [bumpResult, setBumpResult] = (0, import_react8.useState)(null);
   const triggeredFromUidRef = (0, import_react8.useRef)(void 0);
+  const bumpedFromUidRef = (0, import_react8.useRef)(void 0);
   const requestSeqRef = (0, import_react8.useRef)(0);
   const mountedRef = (0, import_react8.useRef)(true);
   (0, import_react8.useEffect)(() => {
@@ -1101,24 +1107,37 @@ function DeployItem({ target, token, onDelete, onEdit }) {
     if (!ready) return;
     const seq = ++requestSeqRef.current;
     try {
-      const data = await fetchDeployments(transport, targetRef);
+      const data = await fetchDeployments(transport, targetRef, void 0, knownBranch);
       if (seq !== requestSeqRef.current || !mountedRef.current) return;
       setDeployments(data);
       setPollError(null);
+      if (!knownBranch) {
+        const learned = data[0]?.meta?.deployHookRef ?? data[0]?.meta?.githubCommitRef;
+        if (learned) setKnownBranch(learned);
+      }
     } catch (err) {
       if (seq !== requestSeqRef.current || !mountedRef.current) return;
       setPollError(err instanceof Error ? err.message : "Could not reach the Vercel API");
       console.error("Deploy-vercel-from-sanity: fetch error", err);
     }
-  }, [transport, targetRef]);
+  }, [transport, targetRef, knownBranch]);
   (0, import_react8.useEffect)(() => {
     fetchDeployments2().finally(() => setLoadingInitial(false));
   }, [fetchDeployments2]);
   (0, import_react8.useEffect)(() => {
-    if (!isActive) return;
+    if (!isActive && !awaitingBump) return;
     const id = setInterval(fetchDeployments2, POLL_INTERVAL_MS);
     return () => clearInterval(id);
-  }, [isActive, fetchDeployments2]);
+  }, [isActive, awaitingBump, fetchDeployments2]);
+  (0, import_react8.useEffect)(() => {
+    if (!awaitingBump) return;
+    if (latest?.uid && latest.uid !== bumpedFromUidRef.current) setAwaitingBump(false);
+  }, [awaitingBump, latest?.uid]);
+  (0, import_react8.useEffect)(() => {
+    if (!awaitingBump) return;
+    const id = setTimeout(() => setAwaitingBump(false), BUMP_WATCH_TIMEOUT_MS);
+    return () => clearTimeout(id);
+  }, [awaitingBump]);
   (0, import_react8.useEffect)(() => {
     if (!isPending) return;
     if (latest?.uid && latest.uid !== triggeredFromUidRef.current) setPendingSince(null);
@@ -1248,6 +1267,8 @@ function DeployItem({ target, token, onDelete, onEdit }) {
         // failure. Unused by workflow-dispatch mode.
         studioToken: client.config().token
       });
+      bumpedFromUidRef.current = latest?.uid;
+      setAwaitingBump(true);
       setBumpResult({
         ok: true,
         message: `Version bump requested on ${ref}. The new deploy appears here in a minute or two.`
@@ -1264,7 +1285,7 @@ function DeployItem({ target, token, onDelete, onEdit }) {
     } finally {
       setBumping(false);
     }
-  }, [pluginConfig.unblock, latest?.meta?.githubCommitRef, currentUser, target.name, toast, client]);
+  }, [pluginConfig.unblock, latest?.meta?.githubCommitRef, latest?.uid, currentUser, target.name, toast, client]);
   const branch = latest?.meta?.githubCommitRef;
   const commitMsg = latest?.meta?.githubCommitMessage?.split("\n")[0];
   const sha = shortSha(latest?.meta?.githubCommitSha);
@@ -1478,9 +1499,12 @@ function DeployItem({ target, token, onDelete, onEdit }) {
                   ", which Vercel will build."
                 ] })
               ] }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Text, { size: 0, muted: true, children: pluginConfig.unblock ? "This deployment carries no branch information, so a version bump cannot be targeted. Ask a developer to deploy manually." : "Ask a developer to push a version bump \u2014 a commit by an authorised author is needed before this site can deploy." }),
-              bumpResult && /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Text, { size: 0, weight: bumpResult.ok ? "semibold" : void 0, children: [
-                bumpResult.ok ? "\u2713 " : "",
-                bumpResult.message
+              bumpResult && /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Flex, { align: "center", gap: 2, children: [
+                awaitingBump && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Spinner, { muted: true }),
+                /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Text, { size: 0, weight: bumpResult.ok ? "semibold" : void 0, children: [
+                  bumpResult.ok && !awaitingBump ? "\u2713 " : "",
+                  bumpResult.message
+                ] })
               ] })
             ] }) })
           ] }),
@@ -1585,6 +1609,7 @@ function DeployItem({ target, token, onDelete, onEdit }) {
       {
         target,
         token,
+        branch: knownBranch,
         onClose: () => setShowHistory(false)
       }
     )
@@ -1870,7 +1895,7 @@ function DeployTargetForm({ initial, onSaved, onClose }) {
 }
 
 // src/version.ts
-var VERSION = "1.5.0";
+var VERSION = "1.6.0";
 
 // src/components/DeployTool.tsx
 var import_jsx_runtime13 = require("react/jsx-runtime");

package/dist/index.mjs

@@ -582,7 +582,7 @@ async function vercelFetch(path, token, init) {
 async function listDeployments(opts) {
   const params = new URLSearchParams({
     projectId: opts.projectId,
-    "meta-deployHookId": opts.hookId,
+    ...opts.branch ? { "meta-githubCommitRef": opts.branch } : { "meta-deployHookId": opts.hookId },
     limit: String(opts.limit ?? 10)
   });
   if (opts.teamId) params.set("teamId", opts.teamId);
@@ -636,7 +636,7 @@ async function proxyFetch(url, statusKey, init) {
   }
   return res.json();
 }
-async function fetchDeployments(transport, target, limit) {
+async function fetchDeployments(transport, target, limit, branch) {
   if (transport.mode === "direct") {
     if (!target.projectId || !target.hookId) return [];
     return listDeployments({
@@ -644,11 +644,13 @@ async function fetchDeployments(transport, target, limit) {
       hookId: target.hookId,
       token: transport.token,
       teamId: target.teamId,
-      limit
+      limit,
+      branch
     });
   }
   const params = new URLSearchParams({ key: target.proxyKey ?? "" });
   if (limit) params.set("limit", String(limit));
+  if (branch) params.set("branch", branch);
   const data = await proxyFetch(
     `${transport.proxyUrl}/deployments?${params}`,
     transport.statusKey
@@ -917,7 +919,7 @@ function StatusBadge({ state, showSpinner }) {
 // src/components/DeployHistory.tsx
 import { useId as useId3, useEffect as useEffect3, useMemo, useState as useState4, useCallback as useCallback3 } from "react";
 import { jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
-function DeployHistory({ target, token, onClose }) {
+function DeployHistory({ target, token, branch, onClose }) {
   const dialogId = useId3();
   const pluginConfig = usePluginConfig();
   const [deployments, setDeployments] = useState4([]);
@@ -936,14 +938,14 @@ function DeployHistory({ target, token, onClose }) {
     setLoading(true);
     setError(null);
     try {
-      const data = await fetchDeployments(transport, targetRef, 20);
+      const data = await fetchDeployments(transport, targetRef, 20, branch);
       setDeployments(data);
     } catch (err) {
       setError(err instanceof Error ? err.message : "Failed to load history");
     } finally {
       setLoading(false);
     }
-  }, [transport, targetRef]);
+  }, [transport, targetRef, branch]);
   useEffect3(() => {
     load();
   }, [load]);
@@ -969,7 +971,7 @@ function DeployHistory({ target, token, onClose }) {
           ] }) }),
           deployments.map((d) => {
             const { label, tone } = stateLabel(d.state);
-            const branch = d.meta?.githubCommitRef ?? "\u2014";
+            const branch2 = d.meta?.githubCommitRef ?? "\u2014";
             const sha = shortSha(d.meta?.githubCommitSha);
             const message = d.meta?.githubCommitMessage?.split("\n")[0] ?? "";
             return /* @__PURE__ */ jsx9(Card, { padding: 3, radius: 2, shadow: 1, tone: "default", children: /* @__PURE__ */ jsxs5(Flex, { gap: 3, align: "center", children: [
@@ -985,7 +987,7 @@ function DeployHistory({ target, token, onClose }) {
               ) : /* @__PURE__ */ jsx9(Text, { size: 1, muted: true, children: "\u2014" }) }),
               /* @__PURE__ */ jsx9(Box, { flex: 1, children: /* @__PURE__ */ jsx9(Badge, { tone, children: label }) }),
               /* @__PURE__ */ jsx9(Box, { flex: 2, style: { overflow: "hidden" }, children: /* @__PURE__ */ jsxs5(Stack, { space: 1, children: [
-                /* @__PURE__ */ jsx9(Text, { size: 1, children: branch }),
+                /* @__PURE__ */ jsx9(Text, { size: 1, children: branch2 }),
                 sha && /* @__PURE__ */ jsxs5(Text, { size: 0, muted: true, children: [
                   sha,
                   message ? ` \xB7 ${message.slice(0, 40)}${message.length > 40 ? "\u2026" : ""}` : ""
@@ -1019,6 +1021,7 @@ import { Fragment, jsx as jsx10, jsxs as jsxs6 } from "react/jsx-runtime";
 var POLL_INTERVAL_MS = 5e3;
 var LABEL_WIDTH = 64;
 var PENDING_TIMEOUT_MS = 6e4;
+var BUMP_WATCH_TIMEOUT_MS = 3e5;
 function DeployItem({ target, token, onDelete, onEdit }) {
   const { projectId, hookId } = parseHookUrl(target.url);
   const toast = useToast();
@@ -1048,8 +1051,11 @@ function DeployItem({ target, token, onDelete, onEdit }) {
   const [logError, setLogError] = useState5(null);
   const [pollError, setPollError] = useState5(null);
   const [bumping, setBumping] = useState5(false);
+  const [awaitingBump, setAwaitingBump] = useState5(false);
+  const [knownBranch, setKnownBranch] = useState5(void 0);
   const [bumpResult, setBumpResult] = useState5(null);
   const triggeredFromUidRef = useRef2(void 0);
+  const bumpedFromUidRef = useRef2(void 0);
   const requestSeqRef = useRef2(0);
   const mountedRef = useRef2(true);
   useEffect4(() => {
@@ -1066,24 +1072,37 @@ function DeployItem({ target, token, onDelete, onEdit }) {
     if (!ready) return;
     const seq = ++requestSeqRef.current;
     try {
-      const data = await fetchDeployments(transport, targetRef);
+      const data = await fetchDeployments(transport, targetRef, void 0, knownBranch);
       if (seq !== requestSeqRef.current || !mountedRef.current) return;
       setDeployments(data);
       setPollError(null);
+      if (!knownBranch) {
+        const learned = data[0]?.meta?.deployHookRef ?? data[0]?.meta?.githubCommitRef;
+        if (learned) setKnownBranch(learned);
+      }
     } catch (err) {
       if (seq !== requestSeqRef.current || !mountedRef.current) return;
       setPollError(err instanceof Error ? err.message : "Could not reach the Vercel API");
       console.error("Deploy-vercel-from-sanity: fetch error", err);
     }
-  }, [transport, targetRef]);
+  }, [transport, targetRef, knownBranch]);
   useEffect4(() => {
     fetchDeployments2().finally(() => setLoadingInitial(false));
   }, [fetchDeployments2]);
   useEffect4(() => {
-    if (!isActive) return;
+    if (!isActive && !awaitingBump) return;
     const id = setInterval(fetchDeployments2, POLL_INTERVAL_MS);
     return () => clearInterval(id);
-  }, [isActive, fetchDeployments2]);
+  }, [isActive, awaitingBump, fetchDeployments2]);
+  useEffect4(() => {
+    if (!awaitingBump) return;
+    if (latest?.uid && latest.uid !== bumpedFromUidRef.current) setAwaitingBump(false);
+  }, [awaitingBump, latest?.uid]);
+  useEffect4(() => {
+    if (!awaitingBump) return;
+    const id = setTimeout(() => setAwaitingBump(false), BUMP_WATCH_TIMEOUT_MS);
+    return () => clearTimeout(id);
+  }, [awaitingBump]);
   useEffect4(() => {
     if (!isPending) return;
     if (latest?.uid && latest.uid !== triggeredFromUidRef.current) setPendingSince(null);
@@ -1213,6 +1232,8 @@ function DeployItem({ target, token, onDelete, onEdit }) {
         // failure. Unused by workflow-dispatch mode.
         studioToken: client.config().token
       });
+      bumpedFromUidRef.current = latest?.uid;
+      setAwaitingBump(true);
       setBumpResult({
         ok: true,
         message: `Version bump requested on ${ref}. The new deploy appears here in a minute or two.`
@@ -1229,7 +1250,7 @@ function DeployItem({ target, token, onDelete, onEdit }) {
     } finally {
       setBumping(false);
     }
-  }, [pluginConfig.unblock, latest?.meta?.githubCommitRef, currentUser, target.name, toast, client]);
+  }, [pluginConfig.unblock, latest?.meta?.githubCommitRef, latest?.uid, currentUser, target.name, toast, client]);
   const branch = latest?.meta?.githubCommitRef;
   const commitMsg = latest?.meta?.githubCommitMessage?.split("\n")[0];
   const sha = shortSha(latest?.meta?.githubCommitSha);
@@ -1443,9 +1464,12 @@ function DeployItem({ target, token, onDelete, onEdit }) {
                   ", which Vercel will build."
                 ] })
               ] }) : /* @__PURE__ */ jsx10(Text, { size: 0, muted: true, children: pluginConfig.unblock ? "This deployment carries no branch information, so a version bump cannot be targeted. Ask a developer to deploy manually." : "Ask a developer to push a version bump \u2014 a commit by an authorised author is needed before this site can deploy." }),
-              bumpResult && /* @__PURE__ */ jsxs6(Text, { size: 0, weight: bumpResult.ok ? "semibold" : void 0, children: [
-                bumpResult.ok ? "\u2713 " : "",
-                bumpResult.message
+              bumpResult && /* @__PURE__ */ jsxs6(Flex, { align: "center", gap: 2, children: [
+                awaitingBump && /* @__PURE__ */ jsx10(Spinner, { muted: true }),
+                /* @__PURE__ */ jsxs6(Text, { size: 0, weight: bumpResult.ok ? "semibold" : void 0, children: [
+                  bumpResult.ok && !awaitingBump ? "\u2713 " : "",
+                  bumpResult.message
+                ] })
               ] })
             ] }) })
           ] }),
@@ -1550,6 +1574,7 @@ function DeployItem({ target, token, onDelete, onEdit }) {
       {
         target,
         token,
+        branch: knownBranch,
         onClose: () => setShowHistory(false)
       }
     )
@@ -1835,7 +1860,7 @@ function DeployTargetForm({ initial, onSaved, onClose }) {
 }
 
 // src/version.ts
-var VERSION = "1.5.0";
+var VERSION = "1.6.0";
 
 // src/components/DeployTool.tsx
 import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liiift-studio/deploy-vercel-from-sanity",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Sanity Studio plugin — trigger and monitor Vercel deployments with full status, history, and build logs. Supports Studio v3.30 through v6.",
   "license": "MIT",
   "author": "Liiift Studio",

package/proxy/core.ts

@@ -184,7 +184,7 @@ async function assertDeploymentInProject(
 
 /** List recent deployments for a proxy key. */
 export async function handleDeployments(
-	params: { key: string | null; limit?: number; statusKey: string | null },
+	params: { key: string | null; limit?: number; statusKey: string | null; branch?: string | null },
 	env: ProxyEnv,
 ): Promise<ProxyResult> {
 	const denied = checkStatusKey(params.statusKey, env)
@@ -192,9 +192,20 @@ export async function handleDeployments(
 	const project = params.key ? env.projects[params.key.trim().toLowerCase()] : undefined
 	if (!project) return { status: 404, body: { error: 'Unknown target key' } }
 
+	// Branch names come from the caller, so they are held to git's own character set
+	// before being spliced into an authenticated query. Anything else is ignored
+	// rather than rejected, which degrades to the previous hook-only behaviour.
+	const branch = params.branch && /^[A-Za-z0-9._\-/]{1,255}$/.test(params.branch)
+		? params.branch
+		: undefined
+
 	const query = new URLSearchParams({
 		projectId: project.projectId,
-		'meta-deployHookId': project.hookId,
+		// Branch filtering reports what is actually live on that branch; hook filtering
+		// only ever shows deployments this tool triggered, so a git push never appears.
+		...(branch
+			? { 'meta-githubCommitRef': branch }
+			: { 'meta-deployHookId': project.hookId }),
 		limit: String(params.limit ?? 10),
 	})
 	if (project.teamId) query.set('teamId', project.teamId)

package/proxy/nextjs-app-router/route.ts

@@ -87,7 +87,7 @@ async function handleGet(request: Request): Promise<Response> {
 	switch (operation(request)) {
 		case 'deployments': {
 			const limit = Number(url.searchParams.get('limit')) || undefined
-			return json(await handleDeployments({ key, limit, statusKey }, env), request)
+			return json(await handleDeployments({ key, limit, statusKey, branch: url.searchParams.get('branch') }, env), request)
 		}
 		case 'events':
 			return json(await handleEvents({ key, deploymentId: url.searchParams.get('deploymentId'), statusKey }, env), request)