@gitkraken/core-gitlens 0.4.0 → 0.4.100

package/dist/plus/integrations/providers/models.d.ts

@@ -1,13 +1,60 @@
-import type { Account, ActionablePullRequest, AnyEntityIdentifierInput, AzureDevOps, AzureOrganization, AzureProject, AzureSetPullRequestInput, Bitbucket, BitbucketServer, BitbucketWorkspaceStub, EnterpriseOptions, GetRepoInput, GitHub, GitLab, GitMergeStrategy, GitPullRequest, GitRepository, Jira, JiraProject, JiraResource, Linear, LinearOrganization, LinearTeam, NumberedPageInput, Issue as ProviderApiIssue, PullRequestWithUniqueID, RequestFunction, RequestOptions, Response, SetPullRequestInput, Trello } from '@gitkraken/provider-apis';
-import { GitBuildStatusState, GitPullRequestMergeableState, GitPullRequestReviewState, GitPullRequestState } from '@gitkraken/provider-apis';
+import type { Account, ActionablePullRequest, AnyEntityIdentifierInput, AzureDevOps, AzureOrganization, AzureProject, AzureSetPullRequestInput, Bitbucket, BitbucketServer, BitbucketWorkspaceStub, CollectionMetadata, CursorPageInput, EnterpriseOptions, GetRepoInput, GitBuildStatusState as GitBuildStatusStateType, GitHub, GitIssueState as GitIssueStateType, GitLab, GitLabGroup, GitMergeStrategy, GitPullRequest, GitPullRequestMergeableState as GitPullRequestMergeableStateType, GitPullRequestReviewState as GitPullRequestReviewStateType, GitPullRequestState as GitPullRequestStateType, GitRepository, Jira, JiraProject, JiraResource, Linear, LinearOrganization, LinearTeam, NumberedPageInput, Organization, Issue as ProviderApiIssue, PullRequestWithUniqueID, RequestFunction, RequestOptions, Response, SetPullRequestInput, Trello } from '@gitkraken/provider-apis';
 import type { Account as UserAccount } from '../../../git/models/author.js';
-import type { IssueMember, IssueProject, IssueShape } from '../../../git/models/issue.js';
+import type { IssueMember, IssueProject, IssueShape, IssueStateFilter } from '../../../git/models/issue.js';
 import { Issue } from '../../../git/models/issue.js';
-import type { PullRequestMember, PullRequestRefs, PullRequestRepositoryIdentityDescriptor, PullRequestReviewer, PullRequestState } from '../../../git/models/pullRequest.js';
+import type { PullRequestMember, PullRequestRefs, PullRequestRepositoryIdentityDescriptor, PullRequestReviewer, PullRequestState, PullRequestStateFilter } from '../../../git/models/pullRequest.js';
 import { PullRequest, PullRequestMergeableState, PullRequestReviewDecision, PullRequestReviewState, PullRequestStatusCheckRollupState } from '../../../git/models/pullRequest.js';
 import type { Provider, ProviderReference } from '../../../git/models/remoteProvider.js';
+import type { ProviderScope } from '../../../git/models/resourceDescriptor.js';
+import type { PagedResult } from '../../../utils/paging.js';
 import type { IntegrationIds } from '../constants.js';
 import type { Integration, IntegrationType } from '../models/integration.js';
+import { IssueFilter, PullRequestFilter } from '../providerFilters.js';
+export { IssueFilter, PullRequestFilter } from '../providerFilters.js';
+import type { ProviderRepositoryShape } from '../results.js';
+export type { ProviderOrganization, ProviderRepositoryShape } from '../results.js';
+type GitBuildStatusState = GitBuildStatusStateType;
+type GitIssueState = GitIssueStateType;
+type GitPullRequestMergeableState = GitPullRequestMergeableStateType;
+type GitPullRequestReviewState = GitPullRequestReviewStateType;
+type GitPullRequestState = GitPullRequestStateType;
+export declare const GitBuildStatusState: {
+    readonly ActionRequired: GitBuildStatusState;
+    readonly Cancelled: GitBuildStatusState;
+    readonly Error: GitBuildStatusState;
+    readonly Failed: GitBuildStatusState;
+    readonly Pending: GitBuildStatusState;
+    readonly Running: GitBuildStatusState;
+    readonly Skipped: GitBuildStatusState;
+    readonly Success: GitBuildStatusState;
+    readonly Warning: GitBuildStatusState;
+    readonly OptionalActionRequired: GitBuildStatusState;
+};
+export declare const GitIssueState: {
+    readonly Open: GitIssueState;
+    readonly Closed: GitIssueState;
+};
+export declare const GitPullRequestState: {
+    readonly Open: GitPullRequestState;
+    readonly Closed: GitPullRequestState;
+    readonly Merged: GitPullRequestState;
+};
+export declare const GitPullRequestReviewState: {
+    readonly Approved: GitPullRequestReviewState;
+    readonly ChangesRequested: GitPullRequestReviewState;
+    readonly Commented: GitPullRequestReviewState;
+    readonly ReviewRequested: GitPullRequestReviewState;
+};
+export declare const GitPullRequestMergeableState: {
+    readonly Behind: GitPullRequestMergeableState;
+    readonly Blocked: GitPullRequestMergeableState;
+    readonly Conflicts: GitPullRequestMergeableState;
+    readonly FailingChecks: GitPullRequestMergeableState;
+    readonly Mergeable: GitPullRequestMergeableState;
+    readonly Unknown: GitPullRequestMergeableState;
+    readonly UnknownAndBlocked: GitPullRequestMergeableState;
+    readonly Unstable: GitPullRequestMergeableState;
+};
 /**
  * Forward-only host type — the package only sets `EnrichablePullRequest.enrichable`
  * for the host to consume. Typed as `any` to avoid duplicating the host's
@@ -28,22 +75,63 @@ export type ProviderLinearOrganization = LinearOrganization;
 export type ProviderAzureProject = AzureProject;
 export type ProviderAzureResource = AzureOrganization;
 export type ProviderBitbucketResource = BitbucketWorkspaceStub;
-export declare const ProviderPullRequestReviewState: typeof GitPullRequestReviewState;
-export declare const ProviderBuildStatusState: typeof GitBuildStatusState;
+export type ProviderGitHubOrganization = Organization;
+export type ProviderGitLabGroup = GitLabGroup;
+/**
+ * Returns an account-wide PR identity. Provider PR ids are commonly scoped to a repository or organization,
+ * so an id alone is never safe for deduplication across a multi-repository fan-out. Repository identity wins
+ * when available so the same row still deduplicates when a later facet adds or removes its URL.
+ */
+export declare function getProviderPullRequestIdentity(pr: Pick<ProviderPullRequest, 'id' | 'repository' | 'url'>): string | undefined;
+export type ProviderHierarchyResult<T> = PagedResult<T> & {
+    readonly truncated?: boolean;
+    /**
+     * SDK collection metadata merged across the drained pages. Independent from the local `truncated` backstop:
+     * a page-drain backstop stays visible even if every fetched page reported `complete`, and SDK
+     * incompleteness is preserved even when the drain finished within its page budget.
+     */
+    readonly metadata?: CollectionMetadata;
+};
+/**
+ * A normalized {@link PagedResult} that additionally carries the SDK's collection {@link CollectionMetadata}
+ * (completeness + per-scope failures). Named to avoid colliding with the public ProviderBackend
+ * `ProviderPagedResult` in `results.ts`: this is the integration-local carrier between the `ProvidersApi`
+ * boundary and the code that maps metadata into warnings/truncation. `metadata` is optional so providers and
+ * test doubles that predate the SDK metadata contract keep behaving exactly as before.
+ */
+export type ProviderApiPagedResult<T> = PagedResult<T> & {
+    readonly metadata?: CollectionMetadata;
+};
+/**
+ * A non-paged collection result carrying SDK {@link CollectionMetadata}. Used for fan-out reads that return a
+ * flat set of values with completeness/failure metadata but no provider-native pagination (e.g. Jira project
+ * discovery across resources, Trello board search).
+ */
+export type ProviderApiCollectionResult<T> = {
+    readonly values: NonNullable<T>[];
+    readonly metadata?: CollectionMetadata;
+};
+export declare const ProviderPullRequestReviewState: {
+    readonly Approved: GitPullRequestReviewState;
+    readonly ChangesRequested: GitPullRequestReviewState;
+    readonly Commented: GitPullRequestReviewState;
+    readonly ReviewRequested: GitPullRequestReviewState;
+};
+export declare const ProviderBuildStatusState: {
+    readonly ActionRequired: GitBuildStatusState;
+    readonly Cancelled: GitBuildStatusState;
+    readonly Error: GitBuildStatusState;
+    readonly Failed: GitBuildStatusState;
+    readonly Pending: GitBuildStatusState;
+    readonly Running: GitBuildStatusState;
+    readonly Skipped: GitBuildStatusState;
+    readonly Success: GitBuildStatusState;
+    readonly Warning: GitBuildStatusState;
+    readonly OptionalActionRequired: GitBuildStatusState;
+};
 export type ProviderRequestFunction = RequestFunction;
 export type ProviderRequestResponse<T> = Response<T>;
 export type ProviderRequestOptions = RequestOptions;
-export declare enum PullRequestFilter {
-    Author = "author",
-    Assignee = "assignee",
-    ReviewRequested = "review-requested",
-    Mention = "mention"
-}
-export declare enum IssueFilter {
-    Author = "author",
-    Assignee = "assignee",
-    Mention = "mention"
-}
 export declare enum PagingMode {
     Project = "project",
     Repo = "repo",
@@ -66,15 +154,28 @@ export interface GetPullRequestsOptions {
     authorLogin?: string;
     assigneeLogins?: string[];
     reviewRequestedLogin?: string;
+    reviewerId?: string;
+    reviewerLogin?: string;
     mentionLogin?: string;
+    states?: GitPullRequestState[];
     query?: string;
     cursor?: string;
     baseUrl?: string;
+    page?: number;
+    pageSize?: number;
+    includeRemoteInfo?: boolean;
 }
 export interface GetPullRequestsForUserOptions {
     includeFromArchivedRepos?: boolean;
     cursor?: string;
     baseUrl?: string;
+    states?: GitPullRequestState[];
+    /**
+     * Items to request per page. Worth setting explicitly on an account-wide read that gets DRAINED: each
+     * provider falls back to its own historical page size when this is omitted, and GitHub's is 15
+     * (`MAX_PR_PAGE_SIZE`), so a drain pays ~7x the round trips of the 100 its search actually allows.
+     */
+    pageSize?: number;
 }
 export interface GetPullRequestsForUserInput extends GetPullRequestsForUserOptions {
     userId: string;
@@ -95,8 +196,11 @@ export interface GetIssuesOptions {
     authorLogin?: string;
     assigneeLogins?: string[];
     mentionLogin?: string;
+    states?: GitIssueState[];
     cursor?: string;
     baseUrl?: string;
+    page?: number;
+    pageSize?: number;
 }
 export interface GetIssuesForRepoInput extends GetIssuesOptions {
     repo: GetRepoInput;
@@ -126,6 +230,9 @@ export interface PageInfo {
     hasNextPage: boolean;
     endCursor?: string | null;
     nextPage?: number | null;
+    currentPage?: number | null;
+    totalPages?: number | null;
+    totalCount?: number | null;
 }
 export type GetRepoFn = (input: ProviderRepoInput, options?: EnterpriseOptions) => Promise<{
     data: ProviderRepository;
@@ -138,6 +245,7 @@ export type GetRepoOfProjectFn = (input: ProviderRepoInput & {
 export type GetPullRequestsForReposFn = (input: (GetPullRequestsForReposInput | GetPullRequestsForRepoIdsInput) & PagingInput, options?: EnterpriseOptions) => Promise<{
     data: ProviderPullRequest[];
     pageInfo?: PageInfo;
+    metadata?: CollectionMetadata;
 }>;
 export type GetPullRequestsForRepoFn = (input: GetPullRequestsForRepoInput & PagingInput, options?: EnterpriseOptions) => Promise<{
     data: ProviderPullRequest[];
@@ -154,8 +262,28 @@ export type GetPullRequestsForAzureProjectsFn = (input: {
     }[];
     authorLogin?: string;
     assigneeLogins?: string[];
+    reviewerId?: string;
+    states?: GitPullRequestState[];
+    repo?: ProviderRepoInput;
 }, options?: EnterpriseOptions) => Promise<{
     data: ProviderPullRequest[];
+    metadata?: CollectionMetadata;
+}>;
+/** Single Azure project PR read, paginated by number (unlike the aggregate {@link GetPullRequestsForAzureProjectsFn}). */
+export type GetPullRequestsForAzureProjectFn = (input: {
+    namespace: string;
+    project: string;
+    authorLogin?: string;
+    assigneeLogins?: string[];
+    reviewerId?: string;
+    states?: GitPullRequestState[];
+    repo?: ProviderRepoInput;
+} & PagingInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderPullRequest[];
+    pageInfo: {
+        hasNextPage: boolean;
+        nextPage: number | null;
+    };
 }>;
 export type MergePullRequestFn = ((input: {
     pullRequest: {
@@ -195,7 +323,13 @@ export type GetIssuesForReposFn = (input: (GetIssuesForReposInput | GetIssuesFor
     data: ProviderIssue[];
     pageInfo?: PageInfo;
 }>;
-export type GetIssuesForCurrentUserFn = (input: PagingInput, options?: EnterpriseOptions) => Promise<{
+export type GetIssuesForCurrentUserInput = PagingInput & {
+    scope?: 'assigned_to_me' | 'all';
+    assigneeUsername?: string;
+    authorUsername?: string;
+    pageSize?: number;
+};
+export type GetIssuesForCurrentUserFn = (input: GetIssuesForCurrentUserInput, options?: EnterpriseOptions) => Promise<{
     data: ProviderIssue[];
     pageInfo?: PageInfo;
 }>;
@@ -211,6 +345,34 @@ export type GetReposForAzureProjectFn = (input: GetReposForAzureProjectInput & P
     data: ProviderRepository[];
     pageInfo?: PageInfo;
 }>;
+export type GetOrgsForCurrentUserFn = (input?: CursorPageInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderGitHubOrganization[];
+    pageInfo?: PageInfo;
+}>;
+export type GetReposForOrgFn = (input: {
+    orgName: string;
+} & PagingInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderRepository[];
+    pageInfo?: PageInfo;
+}>;
+export type GetReposForWorkspaceFn = (input: {
+    workspace: string;
+} & PagingInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderRepository[];
+    pageInfo?: PageInfo;
+}>;
+export type GetReposForCurrentUserFn = (input: PagingInput & {
+    affiliations?: ('owner' | 'collaborator' | 'organization_member')[];
+}, options?: EnterpriseOptions) => Promise<{
+    data: ProviderRepository[];
+    pageInfo?: PageInfo;
+}>;
+export type GetGroupsForCurrentUserFn = (input?: {
+    topLevelOnly?: boolean;
+} & PagingInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderGitLabGroup[];
+    pageInfo?: PageInfo;
+}>;
 export type GetCurrentUserFn = (input: Record<string, never>, options?: EnterpriseOptions) => Promise<{
     data: ProviderAccount;
 }>;
@@ -233,10 +395,51 @@ export type GetLinearOrganizationFn = (options?: EnterpriseOptions) => Promise<{
 export type GetLinearTeamsForCurrentUserFn = (options?: EnterpriseOptions) => Promise<{
     data: LinearTeam[];
 }>;
+export type GetLinearIssuesFn = (input: {
+    teams?: string[];
+    projects?: string[];
+    labels?: string[];
+} & PagingInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderIssue[];
+    pageInfo?: PageInfo;
+}>;
+/**
+ * Linear's current-user (viewer) query. Its raw `@linear/sdk` User isn't a `ProviderAccount` (no
+ * username/avatar/url), so it's typed with the minimal fields the viewer query actually returns rather than
+ * importing `@linear/sdk` (which is bundled in the SDK dist and not a resolvable top-level dependency).
+ */
+export type GetLinearCurrentUserFn = (options?: EnterpriseOptions) => Promise<{
+    data: {
+        id: string;
+        name?: string | null;
+        email?: string | null;
+        displayName?: string | null;
+    };
+}>;
 export type GetJiraProjectsForResourcesFn = (input: {
     resourceIds: string[];
 }, options?: EnterpriseOptions) => Promise<{
     data: JiraProject[];
+    metadata?: CollectionMetadata;
+}>;
+export type GetJiraProjectsForResourceFn = (input: {
+    resourceId: string;
+} & CursorPageInput, options?: EnterpriseOptions) => Promise<{
+    data: JiraProject[];
+    pageInfo?: PageInfo;
+    metadata?: CollectionMetadata;
+}>;
+export type GetGitLabPullRequestsForUserAssociationFn = (input: {
+    username: string;
+    association: 'assigned' | 'authored' | 'reviewRequested';
+    includeFromArchivedRepos?: boolean;
+    labelNames?: string[];
+    repo?: ProviderRepoInput;
+    states?: GitPullRequestState[];
+    pageSize?: number;
+} & CursorPageInput, options?: EnterpriseOptions) => Promise<{
+    data: ProviderPullRequest[];
+    pageInfo?: PageInfo;
 }>;
 export type GetAzureResourcesForUserFn = (input: {
     userId: string;
@@ -250,12 +453,16 @@ export type GetAzureProjectsForResourceFn = (input: {
     data: AzureProject[];
     pageInfo?: PageInfo;
 }>;
-export type GetBitbucketResourcesForCurrentUserFn = (input: Record<string, never>, options?: EnterpriseOptions) => Promise<{
+export type GetBitbucketResourcesForCurrentUserFn = (input: {
+    page?: number;
+}, options?: EnterpriseOptions) => Promise<{
     data: BitbucketWorkspaceStub[];
+    pageInfo?: PageInfo;
 }>;
 export type GetBitbucketPullRequestsAuthoredByUserForWorkspaceFn = (input: {
     userId: string;
     workspaceSlug: string;
+    states?: GitPullRequestState[];
 } & NumberedPageInput, options?: EnterpriseOptions) => Promise<{
     pageInfo: {
         hasNextPage: boolean;
@@ -263,7 +470,9 @@ export type GetBitbucketPullRequestsAuthoredByUserForWorkspaceFn = (input: {
     };
     data: GitPullRequest[];
 }>;
-export type GetBitbucketServerPullRequestsForCurrentUserFn = (input: NumberedPageInput, options?: EnterpriseOptions) => Promise<{
+export type GetBitbucketServerPullRequestsForCurrentUserFn = (input: {
+    states?: GitPullRequestState[];
+} & NumberedPageInput, options?: EnterpriseOptions) => Promise<{
     pageInfo: {
         hasNextPage: boolean;
         nextPage: number | null;
@@ -276,6 +485,12 @@ export type GetIssuesForResourceForCurrentUserFn = (input: {
 }, options?: EnterpriseOptions) => Promise<{
     data: ProviderIssue[];
 }>;
+export type GetTrelloCurrentUserFn = Trello['getCurrentUser'];
+export type GetTrelloBoardsForCurrentUserFn = Trello['getBoardsForCurrentUser'];
+export type GetTrelloListsForBoardFn = Trello['getListsForTrelloBoard'];
+export type GetTrelloAccountForIdFn = Trello['getAccountForId'];
+export type GetTrelloIssuesForBoardFn = Trello['getIssuesForBoard'];
+export type GetTrelloLabelsForBoardFn = Trello['getLabelsForBoard'];
 export interface ProviderInfo extends ProviderMetadata {
     provider: GitHub | GitLab | Bitbucket | BitbucketServer | Jira | Linear | Trello | AzureDevOps;
     getRepoFn?: GetRepoFn;
@@ -283,7 +498,9 @@ export interface ProviderInfo extends ProviderMetadata {
     getPullRequestsForReposFn?: GetPullRequestsForReposFn;
     getPullRequestsForRepoFn?: GetPullRequestsForRepoFn;
     getPullRequestsForUserFn?: GetPullRequestsForUserFn;
+    getGitLabPullRequestsForUserAssociationFn?: GetGitLabPullRequestsForUserAssociationFn;
     getPullRequestsForAzureProjectsFn?: GetPullRequestsForAzureProjectsFn;
+    getPullRequestsForAzureProjectFn?: GetPullRequestsForAzureProjectFn;
     getIssueFn?: GetIssueFn;
     getIssuesForReposFn?: GetIssuesForReposFn;
     getIssuesForCurrentUserFn?: GetIssuesForCurrentUserFn;
@@ -295,16 +512,30 @@ export interface ProviderInfo extends ProviderMetadata {
     getJiraResourcesForCurrentUserFn?: GetJiraResourcesForCurrentUserFn;
     getLinearOrganizationFn?: GetLinearOrganizationFn;
     getLinearTeamsForCurrentUserFn?: GetLinearTeamsForCurrentUserFn;
+    getLinearIssuesFn?: GetLinearIssuesFn;
+    getLinearCurrentUserFn?: GetLinearCurrentUserFn;
     getAzureResourcesForUserFn?: GetAzureResourcesForUserFn;
     getBitbucketResourcesForCurrentUserFn?: GetBitbucketResourcesForCurrentUserFn;
     getBitbucketPullRequestsAuthoredByUserForWorkspaceFn?: GetBitbucketPullRequestsAuthoredByUserForWorkspaceFn;
     getBitbucketServerPullRequestsForCurrentUserFn?: GetBitbucketServerPullRequestsForCurrentUserFn;
     getJiraProjectsForResourcesFn?: GetJiraProjectsForResourcesFn;
+    getJiraProjectsForResourceFn?: GetJiraProjectsForResourceFn;
     getAzureProjectsForResourceFn?: GetAzureProjectsForResourceFn;
     getIssuesForProjectFn?: GetIssuesForProjectFn;
     getReposForAzureProjectFn?: GetReposForAzureProjectFn;
     getIssuesForResourceForCurrentUserFn?: GetIssuesForResourceForCurrentUserFn;
     mergePullRequestFn?: MergePullRequestFn;
+    getOrgsForCurrentUserFn?: GetOrgsForCurrentUserFn;
+    getReposForOrgFn?: GetReposForOrgFn;
+    getReposForWorkspaceFn?: GetReposForWorkspaceFn;
+    getReposForCurrentUserFn?: GetReposForCurrentUserFn;
+    getGroupsForCurrentUserFn?: GetGroupsForCurrentUserFn;
+    getTrelloCurrentUserFn?: GetTrelloCurrentUserFn;
+    getTrelloBoardsForCurrentUserFn?: GetTrelloBoardsForCurrentUserFn;
+    getTrelloListsForBoardFn?: GetTrelloListsForBoardFn;
+    getTrelloAccountForIdFn?: GetTrelloAccountForIdFn;
+    getTrelloIssuesForBoardFn?: GetTrelloIssuesForBoardFn;
+    getTrelloLabelsForBoardFn?: GetTrelloLabelsForBoardFn;
 }
 export interface ProviderMetadata {
     domain: string;
@@ -318,78 +549,127 @@ export interface ProviderMetadata {
     pullRequestsPagingMode?: PagingMode;
     scopes: string[];
     supportedPullRequestFilters?: PullRequestFilter[];
+    /**
+     * Relationship filters the ACCOUNT-WIDE pull-request read can express as an exact OR union.
+     * This is independent from `supportedPullRequestFilters`, which describes repo-scoped reads.
+     */
+    supportedAccountWidePullRequestFilters?: PullRequestFilter[];
+    /** Filters the REPO-scoped issue read can express. */
     supportedIssueFilters?: IssueFilter[];
+    /**
+     * Filters the ACCOUNT-WIDE issue read can express, which is NOT the same set as
+     * {@link ProviderMetadata.supportedIssueFilters}: the two reads are different provider queries.
+     *
+     * Unfiltered, each provider's account-wide read is that provider's own definition of "my issues" — GitHub/GHE
+     * union authored + assigned + mentioned, Azure drains assigned + authored, and GitLab reads assigned-to-me.
+     * A consumer replacing a narrower tool (`gk`'s `assignee:@me`) must select the `Assignee` filter wherever the
+     * provider's default is wider.
+     *
+     * A filter listed here narrows that read server-side. Absent/empty means the read can't be narrowed at all,
+     * so the facade refuses a filtered request rather than serving the unnarrowed union as if it had been
+     * filtered. GitLab lists `Assignee` and `Author` because the SDK's account-wide input exposes both username
+     * axes; it omits `Mention` because that REST read has no first-class mention filter.
+     */
+    supportedAccountWideIssueFilters?: IssueFilter[];
 }
 export type Providers = Record<IntegrationIds, ProviderInfo>;
 export type ProvidersMetadata = Record<IntegrationIds, ProviderMetadata>;
 export declare const providersMetadata: ProvidersMetadata;
 export declare function getReasonsForUserIssue(issue: ProviderIssue, userLogin: string): string[];
 export declare function toIssueShape(issue: ProviderIssue, provider: ProviderReference): IssueShape | undefined;
+/**
+ * Maps a raw provider-apis {@link ProviderRepository} to the GitLens-owned {@link ProviderRepositoryShape}
+ * the ProviderBackend `listRepos` facade surfaces, so consumers don't depend on the SDK repo type. The SDK's
+ * nullable fields (`webUrl`/`httpsUrl`/`sshUrl`/`defaultBranch`) collapse to `undefined`, matching the
+ * `?? undefined` convention in {@link toIssueShape}/{@link toAccount}.
+ */
+export declare function toProviderRepositoryShape(repo: ProviderRepository): ProviderRepositoryShape;
 export declare function issueFilterToReason(filter: IssueFilter): 'authored' | 'assigned' | 'mentioned';
 export declare function toAccount(account: ProviderAccount, provider: ProviderReference): UserAccount;
 export declare const toProviderBuildStatusState: {
-    success: GitBuildStatusState;
-    failed: GitBuildStatusState;
-    pending: GitBuildStatusState;
+    success: GitBuildStatusStateType;
+    failed: GitBuildStatusStateType;
+    pending: GitBuildStatusStateType;
 };
 export declare const fromProviderBuildStatusState: {
-    SUCCESS: PullRequestStatusCheckRollupState;
-    FAILED: PullRequestStatusCheckRollupState;
-    PENDING: PullRequestStatusCheckRollupState;
-    ACTION_REQUIRED: PullRequestStatusCheckRollupState;
-    ERROR: undefined;
-    CANCELLED: undefined;
-    OPTIONAL_ACTION_REQUIRED: undefined;
-    SKIPPED: undefined;
-    RUNNING: undefined;
-    WARNING: undefined;
+    [GitBuildStatusState.Success]: PullRequestStatusCheckRollupState;
+    [GitBuildStatusState.Failed]: PullRequestStatusCheckRollupState;
+    [GitBuildStatusState.Pending]: PullRequestStatusCheckRollupState;
+    [GitBuildStatusState.ActionRequired]: PullRequestStatusCheckRollupState;
+    [GitBuildStatusState.Error]: undefined;
+    [GitBuildStatusState.Cancelled]: undefined;
+    [GitBuildStatusState.OptionalActionRequired]: undefined;
+    [GitBuildStatusState.Skipped]: undefined;
+    [GitBuildStatusState.Running]: undefined;
+    [GitBuildStatusState.Warning]: undefined;
 };
 export declare const toProviderPullRequestReviewState: {
-    APPROVED: GitPullRequestReviewState;
-    CHANGES_REQUESTED: GitPullRequestReviewState;
-    COMMENTED: GitPullRequestReviewState;
-    REVIEW_REQUESTED: GitPullRequestReviewState;
+    APPROVED: GitPullRequestReviewStateType;
+    CHANGES_REQUESTED: GitPullRequestReviewStateType;
+    COMMENTED: GitPullRequestReviewStateType;
+    REVIEW_REQUESTED: GitPullRequestReviewStateType;
     DISMISSED: null;
     PENDING: null;
 };
 export declare const fromProviderPullRequestReviewState: {
-    APPROVED: PullRequestReviewState;
-    CHANGES_REQUESTED: PullRequestReviewState;
-    COMMENTED: PullRequestReviewState;
-    REVIEW_REQUESTED: PullRequestReviewState;
+    [GitPullRequestReviewState.Approved]: PullRequestReviewState;
+    [GitPullRequestReviewState.ChangesRequested]: PullRequestReviewState;
+    [GitPullRequestReviewState.Commented]: PullRequestReviewState;
+    [GitPullRequestReviewState.ReviewRequested]: PullRequestReviewState;
 };
 export declare const toProviderPullRequestMergeableState: {
-    Mergeable: GitPullRequestMergeableState;
-    Conflicting: GitPullRequestMergeableState;
-    Unknown: GitPullRequestMergeableState;
-    FailingChecks: GitPullRequestMergeableState;
-    BlockedByPolicy: GitPullRequestMergeableState;
+    Mergeable: GitPullRequestMergeableStateType;
+    Conflicting: GitPullRequestMergeableStateType;
+    Unknown: GitPullRequestMergeableStateType;
+    FailingChecks: GitPullRequestMergeableStateType;
+    BlockedByPolicy: GitPullRequestMergeableStateType;
 };
 export declare const fromProviderPullRequestMergeableState: {
-    MERGEABLE: PullRequestMergeableState;
-    CONFLICTS: PullRequestMergeableState;
-    BLOCKED: PullRequestMergeableState;
-    FAILING_CHECKS: PullRequestMergeableState;
-    UNKNOWN: PullRequestMergeableState;
-    BEHIND: PullRequestMergeableState;
-    UNKNOWN_AND_BLOCKED: PullRequestMergeableState;
-    UNSTABLE: PullRequestMergeableState;
+    [GitPullRequestMergeableState.Mergeable]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.Conflicts]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.Blocked]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.FailingChecks]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.Unknown]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.Behind]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.UnknownAndBlocked]: PullRequestMergeableState;
+    [GitPullRequestMergeableState.Unstable]: PullRequestMergeableState;
 };
 export declare function toProviderReviews(reviewers: PullRequestReviewer[]): ProviderPullRequest['reviews'];
 export declare function toReviewRequests(reviews: ProviderPullRequest['reviews']): PullRequestReviewer[] | undefined;
 export declare function toCompletedReviews(reviews: ProviderPullRequest['reviews']): PullRequestReviewer[] | undefined;
 export declare function toProviderReviewDecision(reviewDecision?: PullRequestReviewDecision, reviewers?: PullRequestReviewer[]): GitPullRequestReviewState | null;
 export declare const fromPullRequestReviewDecision: {
-    APPROVED: PullRequestReviewDecision;
-    CHANGES_REQUESTED: PullRequestReviewDecision;
-    COMMENTED: undefined;
-    REVIEW_REQUESTED: PullRequestReviewDecision;
+    [GitPullRequestReviewState.Approved]: PullRequestReviewDecision;
+    [GitPullRequestReviewState.ChangesRequested]: PullRequestReviewDecision;
+    [GitPullRequestReviewState.Commented]: undefined;
+    [GitPullRequestReviewState.ReviewRequested]: PullRequestReviewDecision;
 };
 export declare function toProviderPullRequestState(state: PullRequestState): GitPullRequestState;
 export declare function fromProviderPullRequestState(state: GitPullRequestState): PullRequestState;
+type PullRequestStateInput = PullRequestState | PullRequestStateFilter;
+/** Maps PR include/state filters to the SDK's `states` input. `undefined`/omitted preserves the open-only default. */
+export declare function toProviderPullRequestStates(state: PullRequestStateInput | PullRequestStateInput[] | undefined): GitPullRequestState[] | undefined;
+/** Maps an issue state filter to the SDK's `states` input. `undefined`/omitted preserves the open-only default. */
+export declare function toProviderIssueStates(state: IssueStateFilter | undefined): GitIssueState[] | undefined;
+/**
+ * Resolves a normalized {@link ProviderScope} to the provider-appropriate read inputs, dispatching on the
+ * provider's {@link PagingMode} (the authoritative per-provider scoping selector). Project-mode providers
+ * (Azure issues, Jira) produce `projectInputs` from `org` + `project`; repo/repos-mode providers produce a
+ * repo `GetRepoInput[]` from `scope.repos` (carrying `project` where relevant, e.g. Azure). This is the
+ * single public entry point consumers can use instead of hand-building the three underlying representations.
+ */
+export declare function resolveProviderScope(scope: ProviderScope, pagingMode: PagingMode | undefined): {
+    reposInput?: GetRepoInput[];
+    projectInputs?: {
+        namespace: string;
+        project: string;
+    }[];
+};
+export declare function providerPullRequestMatchesSearch(pr: ProviderPullRequest, search: string): boolean;
 export declare function toProviderPullRequest(pr: PullRequest): ProviderPullRequest;
 export declare function fromProviderPullRequest(pr: ProviderPullRequest, provider: Provider, options?: {
     project?: IssueProject;
+    currentAccountId?: string;
 }): PullRequest;
 export declare function fromProviderIssue(issue: ProviderIssue, integration: Integration, options?: {
     project?: IssueProject;
@@ -407,7 +687,7 @@ export type EnrichablePullRequest = ProviderPullRequest & {
     refs?: PullRequestRefs;
     underlyingPullRequest: PullRequest;
 };
-export declare const getActionablePullRequests: (pullRequests: PullRequestWithUniqueID[], currentUser: Pick<Account, "id"> | null, options?: {
+export declare const getActionablePullRequests: (pullRequests: PullRequestWithUniqueID[], currentUser: Pick<Account, 'id'> | null, options?: {
     enrichedItemsByUniqueId?: import("@gitkraken/provider-apis").EnrichedItemsByUniqueId;
     codeSuggestionsCountByPrUuid?: import("@gitkraken/provider-apis").CodeSuggestionsCountByPrUuid;
 }) => ActionablePullRequest[];
@@ -429,5 +709,4 @@ export declare function isGitLabDotCom(domain: string | null | undefined): boole
 export declare function isAzureCloudDomain(domain: string | undefined): boolean;
 export declare function isBitbucketCloudDomain(domain: string | undefined): boolean;
 export declare function supportsCodeSuggest(provider: ProviderReference): boolean;
-export {};
 //# sourceMappingURL=models.d.ts.map