@gitkraken/provider-apis 0.51.0 → 0.53.0

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

@@ -182,6 +182,7 @@ export declare class AzureDevOps extends EnterpriseProvider implements GitProvid
         includeRemoteInfo?: boolean;
     } & GetReposInput, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
     }>;
     private getPullRequestsForProjectBase;
     getPullRequestsForProject(input: {
@@ -215,6 +216,7 @@ export declare class AzureDevOps extends EnterpriseProvider implements GitProvid
         includeRemoteInfo?: boolean;
     }, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
     }>;
     getAzurePullRequestLastMergeStatus(input: {
         repo: GetRepoInput;

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;
@@ -180,6 +193,7 @@ export declare class Bitbucket extends Provider implements GitProvider {
         pageSize?: number;
     } & GetReposInput, options?: Options): Promise<{
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
     }>;
     getAccountsForWorkspace(input: {
         workspace: string;

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

@@ -72,6 +72,7 @@ export declare class BitbucketServer extends EnterpriseProvider implements GitPr
         pageSize?: number;
     } & GetReposInput, options?: EnterpriseOptions): Promise<{
         data: GitPullRequest[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
     }>;
     getPullRequestsForCurrentUser(input: {
         reviewerLogin?: string;

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';
@@ -273,6 +273,18 @@ 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` to scope to a specific assignee, or left unfiltered for the "all assignees" broaden.
+     * Without `scope`, GitLab defaults to `created_by_me`, which is too narrow for a "my issues" read.
+     *
+     * 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/providers/jira/jira.d.ts

@@ -29,6 +29,7 @@ export declare class Jira extends Provider implements IssueProvider {
             hasNextPage: boolean;
             endCursor: string;
         };
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
         data: {
             id: string;
             key: string;
@@ -47,6 +48,7 @@ export declare class Jira extends Provider implements IssueProvider {
             hasNextPage: boolean;
             endCursor: string;
         };
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
         data: {
             id: string;
             name: string;

package/dist/providers/trello/trello.d.ts

@@ -56,6 +56,7 @@ export declare class Trello extends Provider implements IssueProvider {
         }>;
     }, options?: EnterpriseOptions): Promise<{
         data: Issue[];
+        metadata: import("../../types/exportedTypes/types").CollectionMetadata;
     }>;
     private updateIssue;
     setIssueStatus(input: {

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,10 @@ export interface GetIssueInput {
 export type GetIssuesForReposInput = GetReposInput | {
     repoIds: (string | number)[];
 };
+export type GetIssuesForCurrentUserInput = CursorPageInput | ({
+    scope?: 'assigned_to_me' | 'all';
+    assigneeUsername?: string;
+} & NumberedPageInput);
 export interface IssueTransition {
     id: string;
     name: string;

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

@@ -88,12 +88,50 @@ export interface NumberedPageInfo {
      */
     totalCount?: number | null;
 }
+export type CollectionCompleteness = 'complete' | 'partial' | 'unknown';
+export type CollectionScopeFailureKind = 'authentication' | 'rate-limit' | 'not-found' | 'network' | 'provider' | 'unknown';
+export interface CollectionScope {
+    providerId?: string;
+    resourceId?: string;
+    projectId?: string;
+    repositoryId?: string;
+}
+export interface CollectionScopeFailure {
+    scope?: CollectionScope;
+    kind: CollectionScopeFailureKind;
+    message?: string;
+}
+/**
+ * Additional facts about a collection result that are independent from provider-native pagination.
+ *
+ * `pageInfo` remains the only source of cursor/numbered-page continuation. For paged results,
+ * `completeness` describes whether the returned page is known to fully cover the requested scope for
+ * that call; it does not imply that the entire collection has been exhausted.
+ */
+export interface CollectionMetadata {
+    /**
+     * Whether the SDK knows the returned collection fully covers the requested scope.
+     *
+     * - `complete`: no known omissions for the requested scope.
+     * - `partial`: the SDK knows items were omitted (for example due to a provider cap, a dropped
+     *   sub-scope, or another explicit provider signal).
+     * - `unknown`: the upstream API does not expose enough information to assert completeness.
+     */
+    completeness: CollectionCompleteness;
+    /**
+     * Per-scope failures captured while still returning successful data from other scopes.
+     * These are structured provider facts only; callers decide how to warn, retry, or recover.
+     */
+    failures?: CollectionScopeFailure[];
+}
 export type Result<T> = {
     data: T;
+    metadata?: CollectionMetadata;
 };
 export type PagedResult<T> = {
     pageInfo: CursorPageInfo | NumberedPageInfo;
     data: T[];
+    metadata?: CollectionMetadata;
 };
 export type FullFieldMap<T> = Record<keyof T, boolean>;
 export type FieldMap<T> = Partial<FullFieldMap<T>>;

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
-import { GitPullRequest, GitPullRequestState } from './types/exportedTypes/gitProvider';
-import { CursorPageInfo, FieldMap, NumberedPageInfo } from './types/exportedTypes/types';
+import { GetRepoInput, GitPullRequest, GitPullRequestState } from './types/exportedTypes/gitProvider';
+import { CollectionCompleteness, CollectionMetadata, CollectionScope, CollectionScopeFailure, CollectionScopeFailureKind, 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;
 /**
@@ -27,6 +27,54 @@ export declare const resolvePageSize: (pageSize: number | null | undefined, { fa
     max?: number | undefined;
 }) => number;
 export declare const filterPullRequestsByStates: (pullRequests: GitPullRequest[], states?: GitPullRequestState[]) => GitPullRequest[];
+export declare const getErrorStatusCode: (error: unknown) => number | undefined;
+export declare const getCollectionFailureKind: (error: unknown) => CollectionScopeFailureKind;
+export declare const createCollectionFailure: (scope: CollectionScopeFailure['scope'], error: unknown) => CollectionScopeFailure;
+export declare const createCollectionMetadata: (completeness: CollectionCompleteness, failures?: CollectionScopeFailure[]) => CollectionMetadata;
+/**
+ * Combines two completeness signals into the more degraded of the two. A multi-scope fan-out is only
+ * as complete as its least-complete scope, so `partial` (a known omission) outranks `unknown` (the
+ * provider can't assert completeness), which outranks `complete`.
+ */
+export declare const mergeCompleteness: (a: CollectionCompleteness, b: CollectionCompleteness) => CollectionCompleteness;
+/**
+ * Stable scope identifier for a repo fan-out failure: the provider repository id when known, else a
+ * `namespace/name` fallback. Returns `undefined` when no repo is in scope (for example an Azure
+ * project fan-out with no repo filter).
+ */
+export declare const getRepoScopeId: (repo: GetRepoInput | undefined) => string | undefined;
+export interface CollectScopeSuccess<S, R> {
+    scope: S;
+    result: R;
+}
+export interface CollectAcrossScopesResult<S, R> {
+    successes: CollectScopeSuccess<S, Exclude<R, undefined>>[];
+    metadata: CollectionMetadata;
+}
+/**
+ * Runs `run` over every requested `scope` in parallel and aggregates the outcomes into common
+ * collection metadata, without throwing when individual scopes fail.
+ *
+ * - A scope whose `run` rejects is recorded as a per-scope failure (built from `failureScope`) and
+ *   degrades completeness to `partial`.
+ * - A scope whose `run` resolves to `undefined` is skipped entirely: no data, no failure, and no
+ *   effect on completeness (used when a scope is filtered out before any request is made).
+ * - A scope that resolves to a value contributes its `completeness` signal (defaulting to `complete`)
+ *   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, 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.51.0",
+  "version": "0.53.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",