feat(get-merge-queue-position): add merge queue position helper (#677)

Author: danadajian

.github/workflows/get-merge-queue-position.yml

@@ -0,0 +1,19 @@
+name: Get Merge Queue Position
+
+on:
+  pull_request:
+    branches: [main]
+    paths:
+      - 'src/helpers/get-merge-queue-position.ts'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: ./
+        with:
+          helper: get-merge-queue-position
+          pull_number: ${{ github.event.pull_request.number }}

README.md

@@ -46,6 +46,10 @@ with:
 
 Each of the following helpers are defined in a file of the same name in `src/helpers`:
 
+### [get-merge-queue-position](.github/workflows/get-merge-queue-position.yml)
+
+- Returns the current position of a given PR in the GitHub merge queue
+
 ### [are-reviewers-required](.github/workflows/are-reviewers-required.yml)
 
 - Returns true if all teams specified are requested for review on a pull request

bun.lockb

@@ -42973,6 +42973,16 @@ var map = {
 		461,
 		338
 	],
+	"./get-merge-queue-position": [
+		3604,
+		461,
+		604
+	],
+	"./get-merge-queue-position.ts": [
+		3604,
+		461,
+		604
+	],
 	"./initiate-deployment": [
 		5264,
 		461,

dist/604.index.js

@@ -8,6 +8,7 @@
     "@actions/core": "1.11.1",
     "@actions/github": "6.0.0",
     "@adobe/node-fetch-retry": "2.2.0",
+    "@octokit/graphql-schema": "15.25.0",
     "@octokit/rest": "21.0.2",
     "axios": "1.7.9",
     "bluebird": "3.7.2",

dist/604.index.js.map

@@ -0,0 +1,43 @@
+/*
+Copyright 2021 Expedia, Inc.
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+https://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { HelperInputs } from '../types/generated';
+import { context } from '@actions/github';
+import { octokitGraphql } from '../octokit';
+import { Repository } from '@octokit/graphql-schema';
+
+export class GetMergeQueuePosition extends HelperInputs {
+  pull_number = '';
+  max_queue_size?: string;
+}
+
+export const getMergeQueuePosition = async ({ pull_number, max_queue_size = '10' }: GetMergeQueuePosition) => {
+  const data = await octokitGraphql<{ repository: Repository }>(`
+query {
+  repository(owner: "${context.repo.owner}", name: "${context.repo.repo}") {
+    mergeQueue {
+      entries(first: ${max_queue_size}) {
+        nodes {
+          pullRequest {
+            number
+          }
+          position
+        }
+      }
+    }
+  }
+}
+`);
+  const mergeQueueEntries = data.repository.mergeQueue?.entries?.nodes;
+  return mergeQueueEntries?.find(entry => entry?.pullRequest?.number === Number(pull_number))?.position;
+};

dist/index.js

@@ -16,8 +16,8 @@ import { context } from '@actions/github';
 import { octokit } from '../octokit';
 
 export class {{ properCase helper }} extends HelperInputs {
-requiredInput = '';
-optionalInput?: string;
+  requiredInput = '';
+  optionalInput?: string;
 }
 
 export const {{ camelCase helper }} = async ({ requiredInput, optionalInput }: {{ properCase helper }}) => {