@gitkraken/provider-apis 0.52.0 → 0.54.0

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

@@ -1,6 +1,6 @@
 import { RefreshTokenResponse } from '../../types/exportedTypes/bitbucket';
 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 { NumberedPageInfo, Result } from '../../types/exportedTypes/types';
 import { BitbucketRepositoryRole } from '../../types/internalTypes/bitbucket';
 import { GitProvider } from '../gitProvider';
 import { Provider } from '../provider';
@@ -159,6 +159,19 @@ export declare class Bitbucket extends Provider implements GitProvider {
         pageInfo: NumberedPageInfo;
         data: GitPullRequest[];
     }>;
+    /**
+     * Bitbucket Cloud exposes no native workspace-level "PRs where this user is a reviewer" endpoint.
+     * This helper provides a workspace-scoped call surface by fanning out the existing repo-scoped
+     * reviewer query across either the provided repo subset or every accessible repo in the workspace.
+     */
+    getPullRequestsForReviewerAndWorkspace(input: {
+        reviewerId: string;
+        workspaceSlug: string;
+        repos?: GetRepoInput[];
+        states?: GitPullRequestState[];
+        query?: string;
+        pageSize?: number;
+    }, options?: Options): Promise<Result<GitPullRequest[]>>;
     private getPullRequestsForRepoBase;
     getPullRequestsForRepo(input: {
         repo: GetRepoInput;

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

@@ -1,6 +1,6 @@
 import { BitbucketServerMergeStrategy } from '../../types/exportedTypes/bitbucket';
 import { Account, EnterpriseOptions, GetRepoErrorData, GetRepoInput, GetReposInput, GitPullRequest, GitPullRequestState, GitRepository, NumberedPageInput, Options, SetPullRequestInput, User } from '../../types/exportedTypes/gitProvider';
-import { Result } from '../../types/exportedTypes/types';
+import { NumberedPageInfo, Result } from '../../types/exportedTypes/types';
 import { BitbucketServerPullRequest } from '../../types/internalTypes/bitbucketServer';
 import { GitProvider } from '../gitProvider';
 import { EnterpriseProvider } from '../provider';
@@ -58,11 +58,7 @@ export declare class BitbucketServer extends EnterpriseProvider implements GitPr
         reviewerLogin?: string;
         states?: GitPullRequestState[];
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number | null;
-            currentPage: number | null;
-        };
+        pageInfo: NumberedPageInfo;
         data: GitPullRequest[];
     }>;
     getPullRequestsForRepos(input: {
@@ -78,11 +74,7 @@ export declare class BitbucketServer extends EnterpriseProvider implements GitPr
         reviewerLogin?: string;
         states?: GitPullRequestState[];
     } & NumberedPageInput, options?: EnterpriseOptions): Promise<{
-        pageInfo: {
-            hasNextPage: boolean;
-            nextPage: number | null;
-            currentPage: number | null;
-        };
+        pageInfo: NumberedPageInfo;
         data: GitPullRequest[];
     }>;
     closePullRequest(input: {

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

@@ -233,6 +233,7 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
             endCursor: string | null;
         };
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata | undefined;
     }>;
     searchIssues(input: {
         query: string;
@@ -245,6 +246,7 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
             endCursor: string | null;
         };
         data: Issue[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata | undefined;
     }>;
     /**
      * Returns pull requests that were created by, are assigned to, or have been requested to be reviewed by the user.
@@ -255,12 +257,14 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
         includeFromArchivedRepos?: boolean;
         labelNames?: string[];
         maxPageSize?: number;
+        states?: GitPullRequestState[];
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
             endCursor: string | null;
         };
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata | undefined;
     }>;
     getPullRequestsForRepos(input: FetchPullRequestsData & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
@@ -268,6 +272,7 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
             endCursor: string | null;
         };
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata | undefined;
     }>;
     getPullRequestForRepo(input: {
         repo: GetRepoInput;
@@ -400,12 +405,14 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
         includeFromArchivedRepos?: boolean;
         maxPageSize?: number;
         labelNames?: string[];
+        states?: GitIssueState[];
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: boolean;
             endCursor: string;
         };
         data: Issue[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata | undefined;
     }>;
     setPullRequestLabels(input: {
         pullRequest: SetPullRequestInput;
@@ -417,6 +424,7 @@ export declare class GitHub extends EnterpriseProvider implements GitProvider, I
             endCursor: string | null;
         };
         data: Issue[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata | undefined;
     }>;
     closeIssueWithReason(input: {
         issue: SetIssueInput;

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

@@ -12,7 +12,7 @@ export declare const minimumFeatureVersions: {
     PR_REVIEW_FULL_DATABASE_ID: number[];
     PR_REVIEW_COMMENT_FULL_DATABASE_ID: number[];
 };
-export declare const MAX_PR_PAGE_SIZE = 15;
+export declare const MAX_PR_PAGE_SIZE = 100;
 export declare const MAX_ISSUE_PAGE_SIZE = 100;
 type MinimumFeatureVersions = typeof minimumFeatureVersions;
 export declare const GHOST_AUTHOR: GraphQLUser;

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, GitPullRequestState, GitRepository, GitTreeItem, NumberedPageInput, PullRequestDescription, ResolveReviewThreadInput, SetAccountInput, SetLabelInput, SetMilestoneInput, SetPullRequestDescriptionInput, SetPullRequestInput } from '../../types/exportedTypes/gitProvider';
 import { GitLabGetIssueInput, PullRequestAssociation } from '../../types/exportedTypes/gitlab';
-import { GitIssueState, Issue, SetIssueInput } from '../../types/exportedTypes/issueProvider';
-import { NumberedPageInfo, Result } from '../../types/exportedTypes/types';
+import { GetIssuesForCurrentUserInput, GitIssueState, Issue, SetIssueInput } from '../../types/exportedTypes/issueProvider';
+import { NumberedPageInfo, PagedResult, Result } from '../../types/exportedTypes/types';
 import { GitProvider } from '../gitProvider';
 import { IssueProvider } from '../issueProvider';
 import { EnterpriseProvider } from '../provider';
@@ -154,6 +154,7 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         includeFromArchivedRepos?: boolean;
         labelNames?: string[];
         repos?: GetRepoInput[];
+        states?: GitPullRequestState[];
     } & CursorPageInput, options?: EnterpriseOptions): Promise<{
         pageInfo: {
             hasNextPage: false;
@@ -273,6 +274,20 @@ export declare class GitLab extends EnterpriseProvider implements GitProvider, I
         };
         data: Issue[];
     }>;
+    /**
+     * Account-wide "my issues" read via REST `GET /issues` (GitLab's GraphQL API has no top-level, cross-project
+     * issue field, so this is the only account-wide issue endpoint). Open issues only (`state=opened`).
+     *
+     * `scope` controls breadth: `assigned_to_me` returns issues assigned to the token's user (GitLab scopes to the
+     * current user server-side, no username needed); `all` returns every issue visible to the user and is combined
+     * with `assigneeUsername` and/or `authorUsername` to narrow the read.
+     * Without `scope`, GitLab defaults to `created_by_me`, which is too narrow for a "my issues" read.
+     * GitLab's REST endpoint has no first-class mention filter here, so mentions are intentionally unsupported rather
+     * than approximated via search.
+     *
+     * Numbered pagination (`page`/`per_page` + the `x-next-page` header); one page per call — follow `pageInfo`.
+     */
+    getIssuesForCurrentUser(input?: GetIssuesForCurrentUserInput, options?: EnterpriseOptions): Promise<PagedResult<Issue>>;
     private setIssueState;
     closeIssue(input: {
         issue: SetIssueInput;

package/dist/providers/issueProvider.d.ts

@@ -1,8 +1,9 @@
 import { GetRepoInput, Options, SetAccountInput, SetLabelInput, SetMilestoneInput } from '../types/exportedTypes/gitProvider';
-import { GetIssueInput, GetIssuesForReposInput, Issue, SetIssueInput, SetStatusInput } from '../types/exportedTypes/issueProvider';
+import { GetIssueInput, GetIssuesForCurrentUserInput, GetIssuesForReposInput, Issue, SetIssueInput, SetStatusInput } from '../types/exportedTypes/issueProvider';
 import { PagedResult, Result } from '../types/exportedTypes/types';
 export interface IssueProvider {
     getIssue?(input: GetIssueInput, options: Options): Promise<Result<Issue>>;
+    getIssuesForCurrentUser?(input: GetIssuesForCurrentUserInput, options: Options): Promise<PagedResult<Issue>>;
     getIssuesForRepo?(input: {
         repo: GetRepoInput;
     }, options: Options): Promise<PagedResult<Issue>>;

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

@@ -349,6 +349,12 @@ export interface CursorPageInput {
     cursor?: string | null;
 }
 export interface NumberedPageInput {
+    /**
+     * The 1-based page number to request. Numbered-page providers translate this to their native
+     * pagination unit where needed (for example Bitbucket Server's `start` offset). Note that some
+     * Bitbucket Server endpoints still consume `page` as a raw `start` offset and have not yet been
+     * migrated to this contract.
+     */
     page?: number | null;
     /**
      * The number of items to request per page. Honored by all numbered-page providers (Bitbucket,

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

@@ -1,4 +1,4 @@
-import { Account, GetReposInput, GitLabel, GitMilestone } from './gitProvider';
+import { Account, CursorPageInput, GetReposInput, GitLabel, GitMilestone, NumberedPageInput } from './gitProvider';
 export declare enum GitIssueState {
     Open = "OPEN",
     Closed = "CLOSED"
@@ -13,6 +13,11 @@ export interface GetIssueInput {
 export type GetIssuesForReposInput = GetReposInput | {
     repoIds: (string | number)[];
 };
+export interface GetIssuesForCurrentUserInput extends CursorPageInput, NumberedPageInput {
+    scope?: 'assigned_to_me' | 'all';
+    assigneeUsername?: string;
+    authorUsername?: string;
+}
 export interface IssueTransition {
     id: string;
     name: string;

package/dist/utils.d.ts

@@ -63,11 +63,17 @@ export interface CollectAcrossScopesResult<S, R> {
  *   and is returned in `successes` for the caller to shape into its own data type.
  *
  * An empty `scopes` list yields `complete` metadata with no failures.
+ *
+ * By default every scope runs concurrently (`Promise.all`). Pass `concurrency` to cap the number of
+ * in-flight `run` calls via `runInParallelBatches`, which avoids thundering-herd rate limiting when a
+ * caller fans out over a large scope list (a workspace's repos, projects, or resources). Scope order
+ * in `successes` is preserved either way. A `concurrency` that isn't a positive integer throws.
  */
-export declare function collectAcrossScopes<S, R>(scopes: S[], { run, failureScope, completeness, }: {
+export declare function collectAcrossScopes<S, R>(scopes: S[], { run, failureScope, completeness, concurrency, }: {
     run: (scope: S) => Promise<R | undefined>;
     failureScope: (scope: S) => CollectionScope;
     completeness?: (result: Exclude<R, undefined>) => CollectionCompleteness;
+    concurrency?: number;
 }): Promise<CollectAcrossScopesResult<S, R>>;
 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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitkraken/provider-apis",
-  "version": "0.52.0",
+  "version": "0.54.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",