diff --git a/src/global.d.ts b/src/global.d.ts
index 3b22a28..a60c9a0 100644
--- a/src/global.d.ts
+++ b/src/global.d.ts
@@ -24,6 +24,10 @@ type IO<T> = {
 }
 
 type Override<Original, Incoming> = Omit<Original, keyof Incoming> & Incoming
+type MakeOptional<Original, keys extends keyof Original> = Override<
+  Original,
+  Partial<Pick<Original, keys>>
+>
 
 type VoidFN<T> = (payload: T) => void
 
diff --git a/src/platforms/platform.d.ts b/src/platforms/platform.d.ts
index fb5de6e..d2b20a2 100644
--- a/src/platforms/platform.d.ts
+++ b/src/platforms/platform.d.ts
@@ -1,6 +1,7 @@
 type Platform = {
   isEnterprise(): boolean
-  resolveMeta(): MetaData | null
+  // branch name might not be available when resolving from DOM and URL
+  resolveMeta(): MakeOptional<MetaData, 'branchName'> | null
   getMetaData(
     metaData: Pick<MetaData, 'userName' | 'repoName'>,
     accessToken?: string,