[eas-cli] more branch map utility functions

CHANGELOG.md

@@ -12,6 +12,8 @@ This is the log of notable changes to EAS CLI and related packages.
 
 ### 🧹 Chores
 
+- More branch map utility functions. ([#2001](https://github.com/expo/eas-cli/pull/2001) by [@quinlanj](https://github.com/quinlanj))
+
 ## [4.1.2](https://github.com/expo/eas-cli/releases/tag/v4.1.2) - 2023-08-10
 
 ### 🧹 Chores

packages/eas-cli/src/rollout/__tests__/branch-mapping-test.ts

@@ -26,13 +26,25 @@ import {
   isConstrainedRolloutInfo,
   isLegacyRolloutInfo,
   isRolloutBranchMapping,
+  targetsRollout,
 } from '../branch-mapping';
 import {
   rolloutBranchMapping,
   rolloutBranchMappingLegacy,
   standardBranchMapping,
 } from './fixtures';
 
+describe(targetsRollout, () => {
+  it('detects whether a runtime targets a constrained rollout', () => {
+    expect(targetsRollout(rolloutBranchMapping, '1.0.0')).toBe(true);
+    expect(targetsRollout(rolloutBranchMapping, '2.0.0')).toBe(false);
+  });
+  it('should always return true if the rollout is unconstrained', () => {
+    expect(targetsRollout(rolloutBranchMappingLegacy, '1.0.0')).toBe(true);
+    expect(targetsRollout(rolloutBranchMappingLegacy, '2.0.0')).toBe(true);
+  });
+});
+
 describe(composeRollout, () => {
   it('composes a rollout', () => {
     const rollout = getRollout(channelInfoWithBranches);

packages/eas-cli/src/rollout/branch-mapping.ts

@@ -257,6 +257,17 @@ export function isRollout(channelInfo: ChannelBasicInfo): boolean {
   return isRolloutBranchMapping(branchMapping);
 }
 
+export function targetsRollout(
+  branchMapping: RolloutBranchMapping,
+  runtimeVersion: string
+): boolean {
+  const rolloutInfo = getRolloutInfoFromBranchMapping(branchMapping);
+  if (!isConstrainedRolloutInfo(rolloutInfo)) {
+    return true;
+  }
+  return rolloutInfo.runtimeVersion === runtimeVersion;
+}
+
 export function createRolloutBranchMapping({
   defaultBranchId,
   rolloutBranchId,