feat: limit searching issues based on type (#2186)

* feat: limit searching issues based on type

* Update src/test/java/org/kohsuke/github/AppTest.java

Co-authored-by: Liam Newman <bitwiseman@gmail.com>

* chore: sanitize search terms before updating search query

* chore: adjust tests

* fix: update test snapshots

---------

Co-authored-by: Liam Newman <bitwiseman@gmail.com>

Author: Anonycoders

src/main/java/org/kohsuke/github/GHIssueSearchBuilder.java

@@ -57,6 +57,16 @@ public GHIssueSearchBuilder isClosed() {
         return q("is:closed");
     }
 
+    /**
+     * Filters results to only include issues (excludes pull requests).
+     *
+     * @return the gh issue search builder
+     */
+    public GHIssueSearchBuilder isIssue() {
+        terms.removeIf("is:pr"::equals);
+        return q("is:issue");
+    }
+
     /**
      * Is merged gh issue search builder.
      *
@@ -75,6 +85,16 @@ public GHIssueSearchBuilder isOpen() {
         return q("is:open");
     }
 
+    /**
+     * Filters results to only include pull requests (excludes issues).
+     *
+     * @return the gh issue search builder
+     */
+    public GHIssueSearchBuilder isPullRequest() {
+        terms.removeIf("is:issue"::equals);
+        return q("is:pr");
+    }
+
     /**
      * Mentions gh issue search builder.
      *
@@ -121,6 +141,19 @@ public GHIssueSearchBuilder q(String term) {
         return this;
     }
 
+    /**
+     * Filters results to a specific repository.
+     *
+     * @param owner
+     *            the repository owner
+     * @param name
+     *            the repository name
+     * @return the gh issue search builder
+     */
+    public GHIssueSearchBuilder repo(String owner, String name) {
+        return q("repo:" + owner + "/" + name);
+    }
+
     /**
      * Sort gh issue search builder.
      *

src/test/java/org/kohsuke/github/AppTest.java

@@ -855,6 +855,52 @@ public void testIssueSearch() {
         }
     }
 
+    /**
+     * Test issue search with isIssue filter to exclude pull requests.
+     */
+    @Test
+    public void testIssueSearchIssuesOnly() {
+        PagedSearchIterable<GHIssue> r = gitHub.searchIssues()
+                .repo("hub4j", "github-api")
+                .isPullRequest()
+                .isIssue()
+                .isClosed()
+                .sort(GHIssueSearchBuilder.Sort.CREATED)
+                .list();
+        assertThat(r.getTotalCount(), greaterThan(0));
+        int count = 0;
+        for (GHIssue issue : r) {
+            assertThat(issue.getTitle(), notNullValue());
+            assertThat(issue.getPullRequest(), nullValue());
+            if (++count >= 3) {
+                break;
+            }
+        }
+    }
+
+    /**
+     * Test issue search with isPullRequest filter to only return pull requests.
+     */
+    @Test
+    public void testIssueSearchPullRequestsOnly() {
+        PagedSearchIterable<GHIssue> r = gitHub.searchIssues()
+                .repo("hub4j", "github-api")
+                .isIssue()
+                .isPullRequest()
+                .isClosed()
+                .sort(GHIssueSearchBuilder.Sort.CREATED)
+                .list();
+        assertThat(r.getTotalCount(), greaterThan(0));
+        int count = 0;
+        for (GHIssue issue : r) {
+            assertThat(issue.getTitle(), notNullValue());
+            assertThat(issue.getPullRequest(), notNullValue());
+            if (++count >= 3) {
+                break;
+            }
+        }
+    }
+
     /**
      * Test issue with comment.
      *

src/test/resources/org/kohsuke/github/AppTest/wiremock/testIssueSearchIssuesOnly/__files/1-user.json

@@ -0,0 +1,36 @@
+{
+  "login": "Anonycoders",
+  "id": 40047636,
+  "node_id": "MDQ6VXNlcjQwMDQ3NjM2",
+  "avatar_url": "https://avatars.githubusercontent.com/u/40047636?v=4",
+  "gravatar_id": "",
+  "url": "https://api.github.com/users/Anonycoders",
+  "html_url": "https://github.com/Anonycoders",
+  "followers_url": "https://api.github.com/users/Anonycoders/followers",
+  "following_url": "https://api.github.com/users/Anonycoders/following{/other_user}",
+  "gists_url": "https://api.github.com/users/Anonycoders/gists{/gist_id}",
+  "starred_url": "https://api.github.com/users/Anonycoders/starred{/owner}{/repo}",
+  "subscriptions_url": "https://api.github.com/users/Anonycoders/subscriptions",
+  "organizations_url": "https://api.github.com/users/Anonycoders/orgs",
+  "repos_url": "https://api.github.com/users/Anonycoders/repos",
+  "events_url": "https://api.github.com/users/Anonycoders/events{/privacy}",
+  "received_events_url": "https://api.github.com/users/Anonycoders/received_events",
+  "type": "User",
+  "user_view_type": "public",
+  "site_admin": false,
+  "name": "Sorena Sarabadani",
+  "company": "@Adevinta",
+  "blog": "",
+  "location": "Berlin, Germany",
+  "email": "sorena.sarabadani@gmail.com",
+  "hireable": null,
+  "bio": "Ex-Shopifyer - Adevinta/Kleinanzeigen",
+  "twitter_username": "sorena_s",
+  "notification_email": "sorena.sarabadani@gmail.com",
+  "public_repos": 12,
+  "public_gists": 0,
+  "followers": 38,
+  "following": 4,
+  "created_at": "2018-06-08T02:07:15Z",
+  "updated_at": "2026-01-24T22:07:12Z"
+}