@gitkraken/provider-apis 0.48.0 → 0.50.0

package/dist/providers/azureDevops/azureDevOps.d.ts

@@ -1,6 +1,6 @@
 import { AzureGetRepoInput, AzureGetReposInput, AzureGraphAccount, AzureOrganization, AzureProject, AzureSetAccountInput, AzureSetIssueInput, AzureSetPullRequestInput, PullRequestAsyncStatus, StatusByWorkItemIdByStatusId, WorkItemType } from '../../types/exportedTypes/azureDevOps';
-import { AddInlineCommentInput, CursorPageInput, DeleteCommentInput, EditCommentInput, EnterpriseOptions, GetMergeBaseInput, GetPRForRepoInput, GetPullRequestDescriptionInput, GetRepoErrorData, GetRepoInput, GetReposInput, GitComment, GitMergeStrategy, GitPullRequest, GitPullRequestReview, GitRepository, GitRepositoryPermissions, NumberedPageInput, PageInput, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
-import { Issue, SetStatusInput } from '../../types/exportedTypes/issueProvider';
+import { AddInlineCommentInput, CursorPageInput, DeleteCommentInput, EditCommentInput, EnterpriseOptions, GetMergeBaseInput, GetPRForRepoInput, GetPullRequestDescriptionInput, GetRepoErrorData, GetRepoInput, GetReposInput, GitComment, GitMergeStrategy, GitPullRequest, GitPullRequestReview, GitPullRequestState, GitRepository, GitRepositoryPermissions, NumberedPageInput, PageInput, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
+import { GitIssueState, Issue, SetStatusInput } from '../../types/exportedTypes/issueProvider';
 import { PagedResult, Result } from '../../types/exportedTypes/types';
 import { GitProvider } from '../gitProvider';
 import { IssueProvider } from '../issueProvider';
@@ -156,21 +156,30 @@ export declare class AzureDevOps extends EnterpriseProvider implements GitProvid
             };
         }[];
     }>;
+    private fetchRemoteInfoByRepoId;
     private getPullRequestsForRepoBase;
     getPullRequestsForRepo(input: {
         repo: GetRepoInput;
         assigneeLogins?: string[];
         authorLogin?: string;
+        reviewerId?: string;
+        states?: GitPullRequestState[];
+        includeRemoteInfo?: boolean;
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
-            nextPage: number;
+            nextPage: number | null;
+            currentPage: number;
         };
         data: GitPullRequest[];
     }>;
     getPullRequestsForRepos(input: {
         assigneeLogins?: string[];
         authorLogin?: string;
+        reviewerId?: string;
+        states?: GitPullRequestState[];
+        pageSize?: number;
+        includeRemoteInfo?: boolean;
     } & GetReposInput, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
     }>;
@@ -180,11 +189,15 @@ export declare class AzureDevOps extends EnterpriseProvider implements GitProvid
         project: string;
         assigneeLogins?: string[];
         authorLogin?: string;
+        reviewerId?: string;
+        states?: GitPullRequestState[];
         repo?: GetRepoInput;
+        includeRemoteInfo?: boolean;
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
-            nextPage: number;
+            nextPage: number | null;
+            currentPage: number;
         };
         data: GitPullRequest[];
     }>;
@@ -195,7 +208,11 @@ export declare class AzureDevOps extends EnterpriseProvider implements GitProvid
         }[];
         assigneeLogins?: string[];
         authorLogin?: string;
+        reviewerId?: string;
+        states?: GitPullRequestState[];
+        pageSize?: number;
         repo?: GetRepoInput;
+        includeRemoteInfo?: boolean;
     }, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
     }>;
@@ -264,16 +281,14 @@ export declare class AzureDevOps extends EnterpriseProvider implements GitProvid
         mentionLogin?: string;
         labelNames?: string[];
         statusByWorkItemIdByStatusId?: StatusByWorkItemIdByStatusId;
+        states?: GitIssueState[];
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
-            nextPage: null;
-        };
-        data: never[];
-    } | {
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number;
+            nextPage: number | null;
+            currentPage: number;
+            totalCount: number;
+            totalPages: number;
         };
         data: Issue[];
     }>;

package/dist/providers/bitbucket/bitbucket.d.ts

@@ -1,5 +1,6 @@
 import { RefreshTokenResponse } from '../../types/exportedTypes/bitbucket';
-import { Account, CursorPageInput, GetRepoErrorData, GetRepoInput, GetReposInput, GitMergeStrategy, GitPullRequest, GitRepository, GitRepositoryPermissions, NumberedPageInput, Options, SetAccountInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
+import { Account, CursorPageInput, GetRepoErrorData, GetRepoInput, GetReposInput, GitMergeStrategy, GitPullRequest, GitPullRequestState, GitRepository, GitRepositoryPermissions, NumberedPageInput, Options, SetAccountInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
+import { NumberedPageInfo } from '../../types/exportedTypes/types';
 import { BitbucketRepositoryRole } from '../../types/internalTypes/bitbucket';
 import { GitProvider } from '../gitProvider';
 import { Provider } from '../provider';
@@ -152,11 +153,10 @@ export declare class Bitbucket extends Provider implements GitProvider {
         userId: string;
         workspaceSlug: string;
         repos?: GetRepoInput[];
+        states?: GitPullRequestState[];
+        query?: string;
     } & NumberedPageInput, options?: Options): Promise<{
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number | null;
-        };
+        pageInfo: NumberedPageInfo;
         data: GitPullRequest[];
     }>;
     private getPullRequestsForRepoBase;
@@ -165,17 +165,19 @@ export declare class Bitbucket extends Provider implements GitProvider {
         authorLogin?: string;
         reviewerId?: string;
         useOrFilter?: boolean;
+        states?: GitPullRequestState[];
+        query?: string;
     } & NumberedPageInput, options?: Options): Promise<{
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number | null;
-        };
+        pageInfo: NumberedPageInfo;
         data: GitPullRequest[];
     }>;
     getPullRequestsForRepos(input: {
         authorLogin?: string;
         reviewerId?: string;
         useOrFilter?: boolean;
+        states?: GitPullRequestState[];
+        query?: string;
+        pageSize?: number;
     } & GetReposInput, options?: Options): Promise<{
         data: GitPullRequest[];
     }>;

package/dist/providers/bitbucketServer/bitbucketServer.d.ts

@@ -1,5 +1,5 @@
 import { BitbucketServerMergeStrategy } from '../../types/exportedTypes/bitbucket';
-import { Account, EnterpriseOptions, GetRepoErrorData, GetRepoInput, GetReposInput, GitPullRequest, GitRepository, NumberedPageInput, Options, SetPullRequestInput, User } from '../../types/exportedTypes/gitProvider';
+import { Account, EnterpriseOptions, GetRepoErrorData, GetRepoInput, GetReposInput, GitPullRequest, GitPullRequestState, GitRepository, NumberedPageInput, Options, SetPullRequestInput, User } from '../../types/exportedTypes/gitProvider';
 import { Result } from '../../types/exportedTypes/types';
 import { BitbucketServerPullRequest } from '../../types/internalTypes/bitbucketServer';
 import { GitProvider } from '../gitProvider';
@@ -55,22 +55,32 @@ export declare class BitbucketServer extends EnterpriseProvider implements GitPr
     getPullRequestsForRepo(input: {
         repo: GetRepoInput;
         authorLogin?: string;
+        reviewerLogin?: string;
+        states?: GitPullRequestState[];
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
             nextPage: number | null;
+            currentPage: number | null;
         };
         data: GitPullRequest[];
     }>;
     getPullRequestsForRepos(input: {
         authorLogin?: string;
+        reviewerLogin?: string;
+        states?: GitPullRequestState[];
+        pageSize?: number;
     } & GetReposInput, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
     }>;
-    getPullRequestsForCurrentUser(input: NumberedPageInput, options?: EnterpriseOptions): Promise<{
+    getPullRequestsForCurrentUser(input: {
+        reviewerLogin?: string;
+        states?: GitPullRequestState[];
+    } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
             nextPage: number | null;
+            currentPage: number | null;
         };
         data: GitPullRequest[];
     }>;

package/dist/providers/github/github.d.ts

@@ -1,6 +1,6 @@
-import { Account, AddInlineCommentInput, CreateCommitInput, CursorPageInput, DeleteCommentInput, EditCommentInput, EnterpriseOptions, GetMergeBaseInput, GetPullRequestDescriptionInput, GetRepoErrorData, GetRepoInput, GitComment, GitLabel, GitMergeStrategy, GitMilestone, GitPullRequest, GitPullRequestReviewComment, GitPullRequestReviewState, GitRepository, GitTreeItem, NumberedPageInput, Organization, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetMilestoneInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
+import { Account, AddInlineCommentInput, CreateCommitInput, CursorPageInput, DeleteCommentInput, EditCommentInput, EnterpriseOptions, GetMergeBaseInput, GetPullRequestDescriptionInput, GetRepoErrorData, GetRepoInput, GitComment, GitLabel, GitMergeStrategy, GitMilestone, GitPullRequest, GitPullRequestReviewComment, GitPullRequestReviewState, GitPullRequestState, GitRepository, GitTreeItem, NumberedPageInput, Organization, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetMilestoneInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
 import { FetchIssuesData, FetchPullRequestsData, GitHubIssueCloseReason } from '../../types/exportedTypes/github';
-import { Issue, SetIssueInput } from '../../types/exportedTypes/issueProvider';
+import { GitIssueState, Issue, SetIssueInput } from '../../types/exportedTypes/issueProvider';
 import { Result } from '../../types/exportedTypes/types';
 import { GitProvider } from '../gitProvider';
 import { IssueProvider } from '../issueProvider';
@@ -226,6 +226,7 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
         isDraft?: boolean;
         includeFromArchivedRepos?: boolean;
         maxPageSize?: number;
+        states?: GitPullRequestState[];
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
@@ -237,6 +238,7 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
         query: string;
         includeFromArchivedRepos?: boolean;
         maxPageSize?: number;
+        states?: GitIssueState[];
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;

package/dist/providers/github/githubHelpers.d.ts

@@ -1,4 +1,5 @@
-import { Account, EnterpriseOptions, GitComment, GitDiffLineType } from '../../types/exportedTypes/gitProvider';
+import { Account, EnterpriseOptions, GitComment, GitDiffLineType, GitPullRequestState } from '../../types/exportedTypes/gitProvider';
+import { GitIssueState } from '../../types/exportedTypes/issueProvider';
 import { FieldMap, GraphQLBody, GraphQLError, GraphQLResponse, ProviderConfig } from '../../types/exportedTypes/types';
 import { GraphQLBot, GraphQLEnterpriseUserAccount, GraphQLUser } from '../../types/internalTypes/github';
 export declare const minimumFeatureVersions: {
@@ -32,12 +33,29 @@ export declare const getPullRequestFields: (isDraftPullRequestSupported: boolean
 export declare const getIssueFields: (includeEmail: boolean | undefined, enterpriseVersion: [number, number, number] | null) => string;
 export declare const GithubSearchSyntaxQualifiers: Record<string, string>;
 export declare const getProjectGithubSearchSyntax: (search: string) => string[];
+/**
+ * Maps the requested pull request states to GitHub search qualifiers. GitHub search combines `is:`
+ * qualifiers with AND, so combinations that mix open with a closed/merged state cannot be expressed
+ * in a single query; those fall back to no state qualifier and are filtered after normalization.
+ * When no states are requested, only open pull requests are returned to preserve previous behavior.
+ */
+export declare const getPullRequestStateQualifier: (states?: GitPullRequestState[]) => string;
+/**
+ * Maps the requested issue states to GitHub search qualifiers. When no states are requested, only
+ * open issues are returned to preserve previous behavior.
+ */
+export declare const getIssueStateQualifier: (states?: GitIssueState[]) => string;
 export declare const makeSearchIssuesOrPRsGraphQLBody: (type: 'issue' | 'pr', query: string, cursor: string | null | undefined, options: {
     maxPageSize: number;
     supportsEmail: boolean;
     supportsDrafts?: boolean;
     enterpriseVersion?: [number, number, number] | null;
     includeFromArchivedRepos?: boolean;
+    /**
+     * The search state qualifier (e.g. `is:open`, `is:merged`) to apply. Defaults to `is:open` to
+     * preserve previous behavior. An empty string applies no state qualifier (all states).
+     */
+    stateQualifier?: string;
 }) => GraphQLBody;
 export declare const hasDraftsNotSupportedError: (errors?: GraphQLError[]) => boolean;
 export declare const getDiffLinesFromDiffHunk: (diffHunk: string, originalLine: number | null, originalStartLine: number | null, startDiffSide: 'LEFT' | 'RIGHT' | null) => {

package/dist/providers/gitlab/gitlab.d.ts

@@ -1,7 +1,7 @@
-import { Account, AddInlineCommentInput, CursorPageInput, DeleteCommentInput, EditCommentInput, EnterpriseOptions, GetMergeBaseInput, GetPullRequestDescriptionInput, GetRepoErrorData, GetRepoInput, GetReposInput, GitComment, GitLabel, GitMergeStrategy, GitPullRequest, GitPullRequestReview, GitRepository, GitTreeItem, NumberedPageInput, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetMilestoneInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
+import { Account, AddInlineCommentInput, CursorPageInput, DeleteCommentInput, EditCommentInput, EnterpriseOptions, GetMergeBaseInput, GetPullRequestDescriptionInput, GetRepoErrorData, GetRepoInput, GetReposInput, GitComment, GitLabel, GitMergeStrategy, GitPullRequest, GitPullRequestReview, GitPullRequestState, GitRepository, GitTreeItem, NumberedPageInput, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetMilestoneInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
 import { GitLabGetIssueInput, PullRequestAssociation } from '../../types/exportedTypes/gitlab';
-import { Issue, SetIssueInput } from '../../types/exportedTypes/issueProvider';
-import { Result } from '../../types/exportedTypes/types';
+import { GitIssueState, Issue, SetIssueInput } from '../../types/exportedTypes/issueProvider';
+import { NumberedPageInfo, Result } from '../../types/exportedTypes/types';
 import { GitProvider } from '../gitProvider';
 import { IssueProvider } from '../issueProvider';
 import { EnterpriseProvider } from '../provider';
@@ -54,14 +54,29 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         };
         data: GitRepository[];
     }>;
+    /**
+     * Lists the groups (namespaces) the current user is a member of.
+     *
+     * @param input.topLevelOnly When `true` (the default), only top-level groups are returned. Set to `false` to
+     *   include subgroups as their own entries.
+     */
+    getGroupsForCurrentUser(input?: {
+        topLevelOnly?: boolean;
+    } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
+        pageInfo: NumberedPageInfo;
+        data: {
+            id: string;
+            path: string;
+            fullPath: string;
+            name: string;
+            webUrl: string;
+        }[];
+    }>;
     private getRefs;
     getBranches(input: {
         repo: GetRepoInput;
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number | null;
-        };
+        pageInfo: NumberedPageInfo;
         data: {
             name: string;
             commit: {
@@ -74,10 +89,7 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
     getTags(input: {
         repo: GetRepoInput;
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number | null;
-        };
+        pageInfo: NumberedPageInfo;
         data: {
             name: string;
             commit: {
@@ -125,6 +137,8 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         includeFromArchivedRepos?: boolean;
         labelNames?: string[];
         repo?: GetRepoInput;
+        states?: GitPullRequestState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             endCursor: string | null;
@@ -157,6 +171,8 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         labelNames?: string[];
         isDraft?: boolean;
         reviewRequestedLogin?: string;
+        states?: GitPullRequestState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: null;
         data: never[];
@@ -175,6 +191,8 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         isDraft?: boolean;
         reviewRequestedLogin?: string;
         includeFromArchivedRepos?: boolean;
+        states?: GitPullRequestState[];
+        pageSize?: number;
     } & GetReposInput & CursorPageInput, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
     }>;
@@ -230,6 +248,8 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         updatedBefore?: string;
         authorLogin?: string;
         labelNames?: string[];
+        states?: GitIssueState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             endCursor: string | null;
@@ -244,6 +264,8 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         authorLogin?: string;
         labelNames?: string[];
         includeFromArchivedRepos?: boolean;
+        states?: GitIssueState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             endCursor: string | null;

package/dist/providers/jira/jira.d.ts

@@ -1,5 +1,5 @@
 import { CursorPageInput, EnterpriseOptions, SetAccountInput, SetLabelInput } from '../../types/exportedTypes/gitProvider';
-import { SetIssueInput, SetStatusInput } from '../../types/exportedTypes/issueProvider';
+import { GitIssueState, SetIssueInput, SetStatusInput } from '../../types/exportedTypes/issueProvider';
 import { JiraGetIssueInput, JiraProject, JiraResource, SetComponentInput } from '../../types/exportedTypes/jira';
 import { Result } from '../../types/exportedTypes/types';
 import { IssueProvider } from '../issueProvider';
@@ -72,6 +72,8 @@ export declare class Jira extends Provider implements IssueProvider {
         authorLogin?: string;
         mentionLogin?: string;
         labelNames?: string[];
+        states?: GitIssueState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         data: import("../../types/exportedTypes/issueProvider").Issue[];
         pageInfo: {
@@ -86,6 +88,8 @@ export declare class Jira extends Provider implements IssueProvider {
         authorLogin?: string;
         mentionLogin?: string;
         labelNames?: string[];
+        states?: GitIssueState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         data: import("../../types/exportedTypes/issueProvider").Issue[];
         pageInfo: {

package/dist/providers/jira/jiraHelpers.d.ts

@@ -1,8 +1,16 @@
 import { CursorPageInput, EnterpriseOptions, NumberedPageInput, SetLabelInput } from '../../types/exportedTypes/gitProvider';
-import { Issue, IssueComponent, IssueTransition, SetIssueInput, SetStatusInput } from '../../types/exportedTypes/issueProvider';
+import { GitIssueState, Issue, IssueComponent, IssueTransition, SetIssueInput, SetStatusInput } from '../../types/exportedTypes/issueProvider';
 import { JiraComponent, JiraUser, SetComponentInput } from '../../types/exportedTypes/jira';
 import { ProviderConfig } from '../../types/exportedTypes/types';
 import { JiraComponentStub, JiraIssueField, JiraIssue, JiraTransition } from '../../types/internalTypes/jira';
+/**
+ * Builds the JQL status clause for the requested issue states. Jira has three hard-coded status
+ * categories (To Do, In Progress, Done); open issues are those not in the Done category. When both
+ * states are requested no status clause is added (all states). When no states are requested, only
+ * open issues are returned to preserve previous behavior. Returns `null` when no clause should be
+ * added.
+ */
+export declare const getJiraStatusCategoryClause: (states?: GitIssueState[]) => string | null;
 export type JiraIssueFieldNameToId = Record<string, string>;
 export declare const normalizeIssue: (issue: JiraIssue, fields: JiraIssueFieldNameToId | null, resourceUrl: string | null, resourceId?: string) => Issue;
 export declare const normalizeTransition: (transition: JiraTransition) => IssueTransition;
@@ -45,6 +53,8 @@ export declare const getIssuesForProject: (config: ProviderConfig, input: {
     mentionLogin?: string;
     labelNames?: string[];
     fields: JiraIssueFieldNameToId | null;
+    states?: GitIssueState[];
+    pageSize?: number;
 } & CursorPageInput, resourceUrl: string | null, options?: EnterpriseOptions) => Promise<{
     data: Issue[];
     pageInfo: {
@@ -60,6 +70,8 @@ export declare const getIssuesForProjects: (config: ProviderConfig, input: {
     mentionLogin?: string;
     labelNames?: string[];
     fields: JiraIssueFieldNameToId | null;
+    states?: GitIssueState[];
+    pageSize?: number;
 } & CursorPageInput, resourceUrl: string | null, options?: EnterpriseOptions) => Promise<{
     data: Issue[];
     pageInfo: {

package/dist/providers/jira/jiraServer.d.ts

@@ -1,5 +1,5 @@
 import { CursorPageInput, EnterpriseOptions, SetLabelInput } from '../../types/exportedTypes/gitProvider';
-import { SetIssueInput, SetStatusInput } from '../../types/exportedTypes/issueProvider';
+import { GitIssueState, SetIssueInput, SetStatusInput } from '../../types/exportedTypes/issueProvider';
 import { SetComponentInput } from '../../types/exportedTypes/jira';
 import { IssueProvider } from '../issueProvider';
 import { EnterpriseProvider } from '../provider';
@@ -35,6 +35,8 @@ export declare class JiraServer extends EnterpriseProvider implements IssueProvi
         mentionLogin?: string;
         labelNames?: string[];
         resourceUrl?: string;
+        states?: GitIssueState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         data: import("../../types/exportedTypes/issueProvider").Issue[];
         pageInfo: {
@@ -49,6 +51,8 @@ export declare class JiraServer extends EnterpriseProvider implements IssueProvi
         mentionLogin?: string;
         labelNames?: string[];
         resourceUrl?: string;
+        states?: GitIssueState[];
+        pageSize?: number;
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         data: import("../../types/exportedTypes/issueProvider").Issue[];
         pageInfo: {

package/dist/types/exportedTypes/gitProvider.d.ts

@@ -180,6 +180,7 @@ export interface GitPullRequest {
         state: GitPullRequestReviewState;
     }[] | null;
     reviewDecision: GitPullRequestReviewState | null;
+    isCrossRepository: boolean;
     repository: {
         id: string;
         graphQLId?: string;
@@ -199,6 +200,7 @@ export interface GitPullRequest {
             login: string;
         };
         remoteInfo: GitRepositoryRemoteInfo | null;
+        isFork?: boolean;
     } | null;
     headCommit: {
         buildStatuses: GitBuildStatus[] | null;
@@ -250,10 +252,12 @@ export interface GetRepoInput {
 }
 export interface GetReposInput {
     repos: GetRepoInput[];
+    includeRemoteInfo?: boolean;
 }
 export type GetPRForRepoInput = {
     repo: GetRepoInput;
     number: number;
+    includeRemoteInfo?: boolean;
 };
 export type GetPullRequestDescriptionInput = {
     repo: GetRepoInput;
@@ -346,6 +350,12 @@ export interface CursorPageInput {
 }
 export interface NumberedPageInput {
     page?: number | null;
+    /**
+     * The number of items to request per page. Honored by all numbered-page providers (Bitbucket,
+     * Bitbucket Server, Azure DevOps). When omitted, each provider falls back to its historical fixed
+     * page size, preserving previous behavior.
+     */
+    pageSize?: number | null;
 }
 export type PageInput = CursorPageInput | NumberedPageInput;
 export interface GetRepoErrorData {

package/dist/types/exportedTypes/github.d.ts

@@ -1,4 +1,5 @@
-import { GetRepoInput } from './gitProvider';
+import { GetRepoInput, GitPullRequestState } from './gitProvider';
+import { GitIssueState } from './issueProvider';
 export declare enum GitHubIssueCloseReason {
     Completed = "COMPLETED",
     NotPlanned = "NOT_PLANNED"
@@ -12,6 +13,12 @@ export interface FetchPullRequestsData {
     mentionLogin?: string;
     labelNames?: string[];
     reviewRequestedLogin?: string;
+    /**
+     * The pull request states to include. When omitted or empty, only open pull requests are returned,
+     * preserving previous behavior. Providers that cannot express an arbitrary combination in a single
+     * query may query broadly and filter the normalized results to the requested states.
+     */
+    states?: GitPullRequestState[];
     startQuery?: string;
     includeFromArchivedRepos?: boolean;
     /**
@@ -33,6 +40,11 @@ export interface FetchIssuesData {
     authorLogin?: string;
     mentionLogin?: string;
     labelNames?: string[];
+    /**
+     * The issue states to include. When omitted or empty, only open issues are returned, preserving
+     * previous behavior.
+     */
+    states?: GitIssueState[];
     startQuery?: string;
     includeFromArchivedRepos?: boolean;
     /**

package/dist/types/exportedTypes/gitlab.d.ts

@@ -5,3 +5,15 @@ export interface GitLabGetIssueInput {
     name: string;
     number: string;
 }
+export interface GitLabGroup {
+    id: string;
+    path: string;
+    /**
+     * The full path of the group, including any parent groups (e.g. `parent/subgroup`).
+     * This is what a consumer needs to replicate GitLab's subgroup-prefix matching when
+     * filtering repos by group.
+     */
+    fullPath: string;
+    name: string;
+    webUrl: string;
+}

package/dist/types/exportedTypes/types.d.ts

@@ -71,6 +71,22 @@ export interface CursorPageInfo {
 export interface NumberedPageInfo {
     hasNextPage: boolean;
     nextPage: number | null;
+    /**
+     * The page number that produced this result (1-based). Populated by numbered-page providers
+     * (Bitbucket, Bitbucket Server, Azure DevOps). Cursor-based providers (GitHub, GitLab, Jira)
+     * cannot express a current page and leave this `undefined`.
+     */
+    currentPage?: number | null;
+    /**
+     * Total number of pages, when the provider reports a total item count. Left `undefined` when the
+     * provider does not expose totals.
+     */
+    totalPages?: number | null;
+    /**
+     * Total number of items across all pages, when the provider reports it. Left `undefined` when the
+     * provider does not expose totals.
+     */
+    totalCount?: number | null;
 }
 export type Result<T> = {
     data: T;

package/dist/types/internalTypes/bitbucket.d.ts

@@ -158,7 +158,7 @@ export interface User extends UserStub {
     account_status: string;
     location: string | null;
 }
-export type PullRequestState = 'OPEN' | 'MERGED' | 'DECLINED';
+export type PullRequestState = 'OPEN' | 'MERGED' | 'DECLINED' | 'SUPERSEDED';
 export type BitbucketPullRequestParticipant = {
     type: 'participant';
     user: UserStub;

package/dist/types/internalTypes/github.d.ts

@@ -218,6 +218,7 @@ export type GraphQLPullRequest = (GraphQLObjectWithDatabaseId | GraphQLObjectWit
         };
         sshUrl: string;
         url: string;
+        isFork: boolean;
     };
     repository: {
         id: string;

package/dist/types/internalTypes/gitlab.d.ts

@@ -59,3 +59,10 @@ export interface RESTTreeItem {
     path: string;
     mode: string;
 }
+export interface RESTGroup {
+    id: number;
+    name: string;
+    path: string;
+    full_path: string;
+    web_url: string;
+}

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+import { GitPullRequest, GitPullRequestState } from './types/exportedTypes/gitProvider';
 import { CursorPageInfo, FieldMap, NumberedPageInfo } from './types/exportedTypes/types';
 export declare const getRequestHeaders: (token?: string, basicAuth?: boolean) => Record<string, string>;
 export declare const toFieldMap: <T, K extends keyof T = keyof T>(fields?: K[] | undefined) => Partial<import("./types/exportedTypes/types").FullFieldMap<T>> | undefined;
@@ -16,5 +17,21 @@ export declare const followCursors: <T>(fn: (cursor?: number | string | null) =>
 export type MaybePromiseArr<T> = (Promise<T | undefined> | T | undefined)[];
 export declare function nonnullSettled<T>(arr: MaybePromiseArr<T>): Promise<T[]>;
 export declare function flatSettled<T>(arr: MaybePromiseArr<(T | undefined)[]>): Promise<T[]>;
+/**
+ * Resolves a requested page size against a provider's fallback default and optional maximum.
+ * A missing, zero, negative, or NaN pageSize falls back to `fallback`. When `max` is provided, a
+ * valid pageSize is clamped to it; when omitted, the pageSize is used as-is (no clamping).
+ */
+export declare const resolvePageSize: (pageSize: number | null | undefined, { fallback, max }: {
+    fallback: number;
+    max?: number | undefined;
+}) => number;
+export declare const filterPullRequestsByStates: (pullRequests: GitPullRequest[], states?: GitPullRequestState[]) => GitPullRequest[];
 export declare function getSettledValue<T>(promise: PromiseSettledResult<Awaited<T | undefined>>): T | undefined;
 export declare function getSettledValue<T>(promise: PromiseSettledResult<Awaited<T | undefined>> | undefined, defaultValue: NonNullable<T>): NonNullable<T>;
+/**
+ * Runs `fn` over `items` in parallel within fixed-size batches, limiting the
+ * number of in-flight promises at any time. This avoids thundering-herd issues
+ * when a single page of work fans out to many independent async calls.
+ */
+export declare function runInParallelBatches<T>(items: T[], batchSize: number, fn: (item: T) => Promise<unknown>): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitkraken/provider-apis",
-  "version": "0.48.0",
+  "version": "0.50.0",
   "description": "An SDK around different third-party APIs that accepts and returns data in a common format.",
   "author": "Axosoft, LLC dba GitKraken",
   "license": "SEE LICENSE IN LICENSE",
@@ -67,6 +67,7 @@
     "jackspeak": "2.1.1",
     "handlebars": "4.7.9",
     "serialize-javascript": "7.0.5",
-    "typedoc/minimatch": "9.0.9"
+    "typedoc/minimatch": "9.0.9",
+    "js-yaml": "4.2.0"
   }
 }