@gitkraken/core-gitlens 0.4.0 → 0.4.101

package/dist/plus/integrations/reads/pullRequests.d.ts

@@ -0,0 +1,32 @@
+import type { PullRequestShape, PullRequestStateFilter } from '../../../git/models/pullRequest.js';
+import type { IntegrationIds } from '../constants.js';
+import type { ProviderReposInput, PullRequestFilter } from '../providers/models.js';
+import type { ProviderPagedResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function listPullRequestsPage(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    repos?: ProviderReposInput;
+    states?: PullRequestStateFilter[];
+    /**
+     * PR relationship filters (e.g. `[Author, Assignee, ReviewRequested]`). On repo-scoped reads members
+     * combine as provider query constraints (normally an intersection); on account-wide reads they form an
+     * exact OR union. The whole set is validated against the selected path's capability.
+     */
+    filters?: PullRequestFilter[];
+    /**
+     * Account-wide only: include review-requested PRs when the provider's native "my PRs" query omits them.
+     * This extends the provider-native result; it is not a narrowing filter.
+     */
+    includeReviewRequested?: boolean;
+    page?: number;
+    cursor?: string;
+    itemsPerPage?: number;
+    forceSync?: boolean;
+    connectionId?: string;
+    /**
+     * Explicit self-managed host domain when no configured connection supplies one. The value must come
+     * from the trusted authentication configuration, not repository or remote data.
+     */
+    domain?: string;
+}): Promise<ProviderPagedResult<PullRequestShape>>;
+//# sourceMappingURL=pullRequests.d.ts.map

package/dist/plus/integrations/reads/pullRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pullRequests.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/pullRequests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAuB,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEzG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAMzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAmBxD,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAyMhD"}

package/dist/plus/integrations/reads/pullRequests.js

@@ -0,0 +1,151 @@
+import { mergeAssessmentInto } from '../collectionMetadata.js';
+import { fromProviderPullRequest, PagingMode, providersMetadata } from '../providers/models.js';
+import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
+import { getCurrentAccountId, runCaptured } from './drains.js';
+import { resolveAccountWidePullRequestFilters, resolvePullRequestFilters } from './filters.js';
+import { drainToRequestedPage, isPageNumberAdvanceable, pageToCursor, refusedPage, resolveContinuation, resolveCurrentPage, toProviderPageInfo, } from './paging.js';
+import { gitHostOnlySurfaceWarning, truncationWarning, unsupportedAccountWidePullRequestFiltersWarning, unsupportedFiltersWarning, } from './warnings.js';
+export async function listPullRequestsPage(ctx, options) {
+    const page = Math.max(1, options.page ?? 1);
+    if (isIssuesHostIntegrationId(options.providerId)) {
+        return refusedPage(page, [gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'pull request reads')], true);
+    }
+    const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
+    if (integration == null) {
+        // A supplied connection or domain that no longer resolves is a broken target, not an empty account —
+        // surface a no-connection warning + fetchFailed rather than a silent empty page.
+        const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
+        return refusedPage(page, early.warnings, early.fetchFailed);
+    }
+    if (!isGitHostIntegration(integration)) {
+        return refusedPage(page, [gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'pull request reads')], true);
+    }
+    await ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);
+    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
+    // With no repos this is an account-wide "my PRs" read; the repo-scoped core rejects an empty `repos`
+    // input, so route to the account-wide, inherently user-scoped core instead (see drainPullRequests).
+    // That provider-defined path takes no `pageSize`. A page-only request is handled by walking any opaque
+    // continuations it supplies below. Do NOT synthesize a page-number cursor for it: cursor-based queries
+    // (e.g. GitHub `involves:`) ignore a page number and would return their first page.
+    const accountWide = (options.repos?.length ?? 0) === 0;
+    const cursor = accountWide ? options.cursor : (options.cursor ?? pageToCursor(page));
+    const resolvedFilters = accountWide
+        ? resolveAccountWidePullRequestFilters(options.providerId, options.filters)
+        : resolvePullRequestFilters(options.providerId, options.filters);
+    if (resolvedFilters.unsupported) {
+        return refusedPage(page, [
+            accountWide
+                ? unsupportedAccountWidePullRequestFiltersWarning(options.providerId, domain, options.connectionId, options.filters ?? [])
+                : unsupportedFiltersWarning(options.providerId, domain, options.connectionId),
+        ], true);
+    }
+    const includeReviewRequested = accountWide ? (options.includeReviewRequested ?? false) : false;
+    const { value, warning } = await runCaptured(options.providerId, domain, options.connectionId, () => accountWide
+        ? integration.getMyPullRequestsForUserResult({
+            state: options.states,
+            cursor: cursor,
+            includeReviewRequested: includeReviewRequested,
+            filters: resolvedFilters.filters,
+            summary: true,
+        }, options.connectionId)
+        : integration.getMyPullRequestsForReposResult(options.repos ?? [], 
+        // Forward `page`/`pageSize` alongside the cursor so PagingMode.Repo hosts (GitLab, Bitbucket,
+        // Azure), whose per-repo cursor path ignores a synthesized page-number cursor, still honor the
+        // requested page and page size instead of always returning page 1. `filters` scopes the read to
+        // the current user (the core resolves the account for these), so it returns the user's PRs.
+        {
+            state: options.states,
+            filters: resolvedFilters.filters,
+            cursor: cursor,
+            page: options.page,
+            pageSize: options.itemsPerPage,
+        }, options.connectionId), {
+        warnOnMissingSession: warnOnMissingSessionForDomain(options.providerId, options.domain),
+    });
+    let items = value?.values ?? [];
+    // Cursor-only account-wide reads start at page 1; a page-only request is advanced through opaque
+    // continuations below. Repo-scoped reads report the requested page unless the provider reports its own.
+    let paged = toProviderPageInfo(items.length, value?.paging);
+    let allMetadata = value?.metadata;
+    // Convert the SDK collection metadata into scope-aware warnings + failure/truncation flags, appending
+    // them to any captured thrown-error warning without discarding the partial result's items.
+    const warnings = warning != null ? [warning] : [];
+    let pageFetchFailed = warning != null && value == null;
+    // Cursor-only reads ignore a synthesized page-number cursor, so a page-only request is advanced through
+    // the provider's own continuations (see drainToRequestedPage).
+    if ((accountWide || providersMetadata[options.providerId]?.pullRequestsPagingMode === PagingMode.Repos) &&
+        options.page != null &&
+        options.page > 1 &&
+        options.cursor == null &&
+        paged.page.currentPage === 1) {
+        const drained = await drainToRequestedPage({ items: items, paged: paged, metadata: allMetadata, fetchFailed: pageFetchFailed }, {
+            requestedPage: options.page,
+            itemsPerPage: options.itemsPerPage,
+            warnings: warnings,
+            readPage: (cursor) => runCaptured(options.providerId, domain, options.connectionId, () => accountWide
+                ? integration.getMyPullRequestsForUserResult({
+                    state: options.states,
+                    cursor: cursor,
+                    includeReviewRequested: includeReviewRequested,
+                    filters: resolvedFilters.filters,
+                    summary: true,
+                }, options.connectionId)
+                : integration.getMyPullRequestsForReposResult(options.repos ?? [], {
+                    state: options.states,
+                    filters: resolvedFilters.filters,
+                    cursor: cursor,
+                    pageSize: options.itemsPerPage,
+                }, options.connectionId), {
+                warnOnMissingSession: warnOnMissingSessionForDomain(options.providerId, options.domain),
+            }),
+        });
+        items = drained.items;
+        paged = drained.paged;
+        allMetadata = drained.metadata;
+        pageFetchFailed = drained.fetchFailed;
+    }
+    const assessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, allMetadata);
+    // Never advertise `hasMore` without a continuation the caller can act on. The account-wide read has no
+    // page to synthesize, and neither does a host that doesn't honor a page number — see
+    // {@link IntegrationService.isPageNumberAdvanceable} for which do and why absence of a declared mode
+    // does NOT count as one.
+    const pageAdvanceable = !accountWide && isPageNumberAdvanceable(providersMetadata[options.providerId]?.pullRequestsPagingMode);
+    const continuation = resolveContinuation(paged, pageAdvanceable ? paged.page.currentPage + 1 : undefined);
+    // A single-page provider read that couldn't confirm completeness sets `paging.truncated`; surface it
+    // as a terminal `page.truncated` (not `hasMore`, which has no cursor to advance) so the caller knows
+    // the page may be incomplete. Metadata incompleteness is an independent source of the same signal.
+    const truncated = continuation.truncated || assessment.truncated;
+    if (truncated && warnings.length === 0) {
+        warnings.push(truncationWarning(options.providerId, domain, options.connectionId, 'Pull request'));
+    }
+    const currentAccountId = items.some(pr => pr.author != null)
+        ? await getCurrentAccountId(integration, options.connectionId)
+        : undefined;
+    return {
+        // Normalize the raw provider-apis PRs to the GitLens-owned shape at the surface boundary.
+        items: items.map(pr => fromProviderPullRequest(pr, integration, { currentAccountId: currentAccountId })),
+        warnings: warnings,
+        // The account-wide read can't take a page size, so don't echo the requested `itemsPerPage` as if it
+        // had been applied — report what came back.
+        page: {
+            ...paged.page,
+            // Positional, per ProviderPageInfo.currentPage: the drain (above) already advanced `paged.page`,
+            // and a caller-threaded cursor advanced the provider, so neither leaves a cursor-only read stuck
+            // reporting page 1.
+            currentPage: resolveCurrentPage({
+                providerPage: paged.page.currentPage,
+                requestedPage: page,
+                suppliedCursor: options.cursor,
+                pageAdvanceable: pageAdvanceable,
+            }),
+            itemsPerPage: accountWide ? items.length : paged.page.itemsPerPage,
+            truncated: truncated || undefined,
+        },
+        hasMore: continuation.hasMore,
+        cursor: continuation.cursor,
+        // A metadata failure means items are incomplete even when the read didn't throw; a thrown error with
+        // no recovered value is the pre-existing failure case.
+        fetchFailed: assessment.fetchFailed || pageFetchFailed || undefined,
+    };
+}
+//# sourceMappingURL=pullRequests.js.map

package/dist/plus/integrations/reads/pullRequests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pullRequests.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/pullRequests.ts"],"names":[],"mappings":"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"}

package/dist/plus/integrations/reads/resolveRepository.d.ts

@@ -0,0 +1,25 @@
+import type { IntegrationIds } from '../constants.js';
+import type { ResolveRepositoryResult } from '../results.js';
+import type { RepositoryResolutionContext } from './context.js';
+/**
+ * Resolution of a remote URL to a provider repository identity — the facade's equivalent of `gk repo resolve`.
+ *
+ * Unlike every other read here, this one's input is REPOSITORY data, so most of the code below is about not
+ * letting that data choose the credentials: an explicit cloud `providerId` must agree with the remote's canonical
+ * host, and a self-managed host resolves only against a domain the user already authenticated. The
+ * `host-mismatch` returns are those guards, not edge cases — resolving `owner/repo` against the wrong account
+ * would hand back a confidently wrong identity and seed the domain-keyed instance cache from remote data.
+ */
+export declare function resolveRepository(ctx: RepositoryResolutionContext, options: {
+    providerId?: IntegrationIds;
+    remoteUrl: string;
+    host?: string;
+    connectionId?: string;
+    /**
+     * Explicit self-managed host domain used to select the integration instance. Used only when the requested
+     * connection has no configured domain; it must come from the trusted authentication configuration, not
+     * repository or remote data.
+     */
+    domain?: string;
+}): Promise<ResolveRepositoryResult>;
+//# sourceMappingURL=resolveRepository.d.ts.map

package/dist/plus/integrations/reads/resolveRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRepository.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/resolveRepository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,KAAK,EAA4C,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAUvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAGhE;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,2BAA2B,EAChC,OAAO,EAAE;IACR,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,uBAAuB,CAAC,CA8KlC"}

package/dist/plus/integrations/reads/resolveRepository.js

@@ -0,0 +1,235 @@
+import { createRemoteProviderMatcher } from '../../../git/remotes/matcher.js';
+import { parseGitRemoteUrl } from '../../../git/utils/remote.utils.js';
+import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId } from '../constants.js';
+import { AuthenticationError, RequestNotFoundError } from '../errors.js';
+import { isIssuesIntegration } from '../models/issuesIntegration.js';
+import { isAzureCloudDomain, isBitbucketCloudDomain, isGitHubDotCom, isGitLabDotCom } from '../providers/models.js';
+import { toProviderWarning } from '../results.js';
+import { hostFromDomain } from '../utils/domain.utils.js';
+import { getIntegrationIdForRemote, isGitCloudHostIntegrationId, isGitSelfManagedHostIntegrationId, remoteProviderTypeForConfig, remoteProviderTypeForIntegration, } from '../utils/integration.utils.js';
+import { noConnectionWarning } from './warnings.js';
+/**
+ * Resolution of a remote URL to a provider repository identity — the facade's equivalent of `gk repo resolve`.
+ *
+ * Unlike every other read here, this one's input is REPOSITORY data, so most of the code below is about not
+ * letting that data choose the credentials: an explicit cloud `providerId` must agree with the remote's canonical
+ * host, and a self-managed host resolves only against a domain the user already authenticated. The
+ * `host-mismatch` returns are those guards, not edge cases — resolving `owner/repo` against the wrong account
+ * would hand back a confidently wrong identity and seed the domain-keyed instance cache from remote data.
+ */
+export async function resolveRepository(ctx, options) {
+    const result = (status) => ({
+        resolution: { status: status },
+    });
+    const [scheme, parsedDomain, path] = parseGitRemoteUrl(options.remoteUrl);
+    const parsedHost = hostFromDomain(parsedDomain);
+    const explicitHost = hostFromDomain(options.host);
+    if (parsedHost != null && explicitHost != null && parsedHost !== explicitHost) {
+        return result('host-mismatch');
+    }
+    const matcherDomain = parsedDomain || options.host || '';
+    // An explicit cloud provider must agree with the remote's canonical cloud host. Without this guard the
+    // synthetic matcher below can reinterpret, for example, a gitlab.com URL as GitHub and then resolve a
+    // homonymous owner/repo through the wrong account. Match once without caller configs/synthetic entries;
+    // Azure's matcher also normalizes ssh.dev.azure.com and vs-ssh.visualstudio.com to their web host.
+    if (options.providerId != null && isGitCloudHostIntegrationId(options.providerId)) {
+        const nativeProvider = createRemoteProviderMatcher([])(options.remoteUrl, matcherDomain, path, scheme);
+        const nativeId = nativeProvider != null ? getIntegrationIdForRemote(nativeProvider) : undefined;
+        const nativeDomain = nativeProvider?.domain ?? matcherDomain;
+        const canonicalHost = options.providerId === GitCloudHostIntegrationId.GitHub
+            ? isGitHubDotCom(nativeDomain)
+            : options.providerId === GitCloudHostIntegrationId.GitLab
+                ? isGitLabDotCom(nativeDomain)
+                : options.providerId === GitCloudHostIntegrationId.Bitbucket
+                    ? isBitbucketCloudDomain(nativeDomain)
+                    : isAzureCloudDomain(nativeDomain);
+        if (nativeId !== options.providerId || !canonicalHost)
+            return result('host-mismatch');
+    }
+    const provider = createRemoteProviderMatcher(buildMatcherConfigs(ctx, options, parsedDomain))(options.remoteUrl, matcherDomain, path, scheme);
+    if (provider == null)
+        return result('invalid-remote-url');
+    let id = options.providerId ?? getIntegrationIdForRemote(provider);
+    // Custom Azure DevOps Server domains matched via getRemoteConfigs return undefined from
+    // getIntegrationIdForRemote because the provider is marked custom; map them to the server id so the
+    // project-scoped lookup uses that host's configured connection and API base URL.
+    if (id == null && provider.id === 'azure-devops' && provider.custom) {
+        id = GitSelfManagedHostIntegrationId.AzureDevOpsServer;
+    }
+    if (id == null)
+        return result('unsupported-provider');
+    const owner = provider.owner;
+    const name = provider.repoName;
+    if (owner == null || name == null)
+        return result('invalid-remote-url');
+    // On a self-managed host, resolve only against a TRUSTED host: the pinned connection's configured
+    // domain, the explicit `domain`, or — when neither was supplied — a configured host matching the
+    // remote's. That last case keeps `remoteUrl` (repository-supplied) out of the trusted path: it selects
+    // among hosts the user already authenticated and can never introduce a new one. Resolving `owner/repo`
+    // against some other host's account would, if that host has the same owner/repo, return a confidently
+    // wrong identity — and would seed the domain-keyed integration cache (never evicted before dispose) with
+    // an entry derived from repository data.
+    const urlHost = hostFromDomain(provider.domain);
+    // Normalize BOTH sides before comparing: a stored connection domain is usually a full URL
+    // (`https://git.example.com`) while `urlHost` is already a bare host, so a raw compare would fail on
+    // scheme/trailing-slash alone and wrongly reject a correctly-configured connection.
+    let trustedHost = options.connectionId != null || options.domain != null
+        ? hostFromDomain(ctx.resolveDomainForRead(id, options.connectionId, options.domain))
+        : undefined;
+    if (isGitSelfManagedHostIntegrationId(id)) {
+        const configuredHosts = ctx.getConfigured(id).map(c => hostFromDomain(c.domain));
+        if (trustedHost == null && urlHost != null) {
+            trustedHost = configuredHosts.find(host => host === urlHost);
+        }
+        // A configured host that doesn't match the remote's is a genuine mismatch. With nothing configured
+        // there is no host to mismatch against — it's simply not connected, so fall through to the
+        // `unauthorized` path below (still WITHOUT resolving by the URL domain, so repo data can't seed the
+        // cache).
+        if (trustedHost == null && configuredHosts.length !== 0)
+            return result('host-mismatch');
+        if (trustedHost != null && urlHost != null && trustedHost !== urlHost)
+            return result('host-mismatch');
+    }
+    let integration;
+    try {
+        // Resolve the instance through the trusted target (as `getIntegrationForRead` does):
+        // `resolveReadSession` looks the session up against the instance's domain-scoped descriptor, so
+        // selecting the instance by the URL domain could miss the session and degrade to `no-connection`.
+        integration = isGitSelfManagedHostIntegrationId(id)
+            ? trustedHost != null
+                ? await ctx.getIntegrationForRead(id, options.connectionId, trustedHost)
+                : undefined
+            : await ctx.getIntegrationForDomain(id, provider.domain);
+    }
+    catch {
+        integration = undefined;
+    }
+    if (integration == null) {
+        // Attach a warning, as the thrown-AuthenticationError branch below does: a consumer driving auth
+        // recovery off `warning.kind` would otherwise get nothing for an unresolvable target.
+        return {
+            resolution: {
+                status: 'unauthorized',
+                warning: noConnectionWarning(id, provider.domain, options.connectionId),
+            },
+        };
+    }
+    // Issue trackers have no `getRepo` client; a git host without `getRepoFn` leaves `getRepoInfo`
+    // undefined. Either way this provider can't resolve repositories.
+    if (isIssuesIntegration(integration) || integration.getRepoInfo == null) {
+        return result('unsupported-provider');
+    }
+    // Azure repos are org + project scoped; the remote provider exposes project as `providerDesc.repoDomain`.
+    const project = provider.id === 'azure-devops' ? provider.providerDesc?.repoDomain : undefined;
+    const domain = provider.domain;
+    // Azure's lookup is project-scoped and returns `undefined` without one, which the connection-gap branch
+    // below would misreport as `unauthorized` (driving a pointless reconnect). A remote URL that carries no
+    // project simply can't address an Azure repo.
+    if (provider.id === 'azure-devops' && project == null)
+        return result('invalid-remote-url');
+    try {
+        const repo = await integration.getRepoInfo({
+            owner: owner,
+            name: name,
+            project: project,
+            connectionId: options.connectionId,
+        });
+        if (repo == null) {
+            // `getRepoInfo` returns undefined only when no session could be resolved (not connected, or the
+            // requested connection is gone) — a real 404 throws below. So this is a connection gap. Attach a
+            // warning so a consumer driving auth recovery off `warning.kind` sees the same signal it gets from
+            // the thrown-AuthenticationError branch below; without it, the most common unauthorized case is
+            // silent.
+            return {
+                resolution: {
+                    status: 'unauthorized',
+                    warning: noConnectionWarning(id, domain, options.connectionId),
+                },
+            };
+        }
+        // Prefer the provider's canonical namespace/name (GitHub's REST/GraphQL lookup follows the 301
+        // rename redirect, so a stale old name resolves to the new canonical identity), falling back to the
+        // parsed remote when the response omits them. `renamed` is a case-insensitive compare of input vs
+        // canonical, mirroring gkcli's `EqualFold`, so hosts that merely echo the input casing (e.g.
+        // Bitbucket Server/Azure) don't get spuriously flagged.
+        const canonicalOwner = repo.namespace || owner;
+        const canonicalName = repo.name || name;
+        const renamed = canonicalOwner.toLowerCase() !== owner.toLowerCase() || canonicalName.toLowerCase() !== name.toLowerCase();
+        const identity = {
+            providerId: id,
+            domain: domain,
+            owner: canonicalOwner,
+            name: canonicalName,
+            project: project,
+            remoteUrl: options.remoteUrl,
+            renamed: renamed,
+        };
+        return { resolution: { status: 'resolved', identity: identity } };
+    }
+    catch (ex) {
+        // Order matters: 404 throws RequestNotFoundError (not `undefined`), so check not-found before auth
+        // and before the generic 5xx/unknown bucket — never classify a 401/403 as not-found.
+        let resolution;
+        if (ex instanceof RequestNotFoundError) {
+            resolution = { status: 'not-found' };
+        }
+        else if (ex instanceof AuthenticationError) {
+            resolution = { status: 'unauthorized', warning: toProviderWarning(id, domain, options.connectionId, ex) };
+        }
+        else {
+            resolution = { status: 'undetermined', warning: toProviderWarning(id, domain, options.connectionId, ex) };
+        }
+        return { resolution: resolution };
+    }
+}
+/**
+ * The remote-matcher configs for this resolution: the user's own host remote configs (self-managed/custom
+ * domains), plus a synthetic exact-domain entry for an explicit `providerId` + host so a custom domain still maps
+ * to the right provider for path parsing.
+ */
+function buildMatcherConfigs(ctx, options, parsedDomain) {
+    const configs = [];
+    for (const cfg of ctx.getRemoteConfigs()) {
+        const type = remoteProviderTypeForConfig(cfg.type);
+        if (type == null)
+            continue;
+        // Forward both domain- and regex-based custom remotes (carrying any protocol override), so a
+        // regex-configured host resolves instead of falling through to `unsupported`.
+        if (cfg.domain) {
+            configs.push({ type: type, domain: cfg.domain, protocol: cfg.protocol });
+        }
+        else if (cfg.regex) {
+            configs.push({ type: type, regex: cfg.regex, protocol: cfg.protocol });
+        }
+    }
+    if (options.providerId == null)
+        return configs;
+    const type = remoteProviderTypeForIntegration(options.providerId);
+    const domain = parsedDomain || options.host;
+    if (type == null || !domain)
+        return configs;
+    // The synthetic exact-domain entry is unshifted to the front, so it wins the match over the user's own
+    // config for the same host. Carry that config's protocol override across (matched by domain or regex,
+    // mirroring `ignoreSSLErrors`) so a self-managed host configured for a custom protocol — e.g. plain
+    // `http` — isn't silently downgraded to the provider default here.
+    const lowerDomain = domain.toLowerCase();
+    const protocol = configs.find(c => {
+        if (c.type !== type)
+            return false;
+        if (c.domain != null)
+            return c.domain.toLowerCase() === lowerDomain;
+        // Truthy (not just non-null): an empty regex would compile to a match-everything pattern.
+        if (c.regex) {
+            try {
+                return new RegExp(c.regex, 'i').test(lowerDomain);
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    })?.protocol;
+    configs.unshift({ type: type, domain: domain, protocol: protocol });
+    return configs;
+}
+//# sourceMappingURL=resolveRepository.js.map

package/dist/plus/integrations/reads/resolveRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRepository.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/resolveRepository.ts"],"names":[],"mappings":"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"}

package/dist/plus/integrations/reads/sweeps.d.ts

@@ -0,0 +1,11 @@
+import type { PullRequestShape } from '../../../git/models/pullRequest.js';
+import type { ClosedPullRequestSweepOptions, PullRequestSweepOptions } from '../manager.js';
+import type { ProviderSweepResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function sweepPullRequests(ctx: ProviderReadContext, options?: PullRequestSweepOptions): Promise<ProviderSweepResult<PullRequestShape>>;
+/**
+ * Closed/merged counterpart of {@link sweepPullRequests}, feeding Kepler's Kanban "done" column. Applies
+ * the native cross-provider state filter (`Closed` + `Merged`) so it works beyond GitHub.
+ */
+export declare function sweepClosedPullRequests(ctx: ProviderReadContext, options?: ClosedPullRequestSweepOptions): Promise<ProviderSweepResult<PullRequestShape>>;
+//# sourceMappingURL=sweeps.d.ts.map

package/dist/plus/integrations/reads/sweeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweeps.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/sweeps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAI3E,OAAO,KAAK,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE5F,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAG1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA8BxD,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAmIhD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,6BAA6B,GACrC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAEhD"}

package/dist/plus/integrations/reads/sweeps.js

@@ -0,0 +1,125 @@
+import { mapBounded } from '../../../utils/promise.js';
+import { providerFanOutConcurrency } from '../constants.js';
+import { fromProviderPullRequest } from '../providers/models.js';
+import { appendDedupedWarning } from '../results.js';
+import { isGitHostIntegration, isIssuesHostIntegrationId } from '../utils/integration.utils.js';
+import { drainPullRequests, getCurrentAccountId, resolvePullRequestSweepTargets } from './drains.js';
+import { resolveAccountWidePullRequestFilters, resolvePullRequestFilters } from './filters.js';
+import { gitHostOnlySurfaceWarning, noConnectionWarning, unsupportedAccountWidePullRequestFiltersWarning, unsupportedFiltersWarning, } from './warnings.js';
+export async function sweepPullRequests(ctx, options) {
+    const { targets, attributeUnavailableProviders } = resolvePullRequestSweepTargets(options);
+    const maxPages = options?.maxPages ?? 100;
+    const repos = options?.repos ?? [];
+    const results = await mapBounded(targets, providerFanOutConcurrency, async (target) => {
+        const { providerId: id, connectionId, domain: requestedDomain } = target;
+        /** A target that never reached a drain: the provider itself failed, so its slice is empty and attributed. */
+        const rejectedTarget = (warnings) => ({
+            items: [],
+            warnings: warnings,
+            fetchFailed: true,
+            truncated: false,
+            providerId: id,
+            failedProvider: true,
+        });
+        if (isIssuesHostIntegrationId(id)) {
+            return rejectedTarget([
+                gitHostOnlySurfaceWarning(id, requestedDomain, connectionId, 'pull request sweeps'),
+            ]);
+        }
+        const integration = await ctx.getIntegrationForRead(id, connectionId, requestedDomain);
+        if (integration == null) {
+            // A requested connection that can't be resolved is a broken connection — surface it as a
+            // warning + fetchFailed rather than dropping the provider's slice silently.
+            const early = ctx.earlyReturnConnectionWarnings(id, connectionId, requestedDomain);
+            if (early.warnings.length === 0 && !attributeUnavailableProviders)
+                return undefined;
+            return rejectedTarget(early.warnings.length !== 0 ? early.warnings : [noConnectionWarning(id, requestedDomain, connectionId)]);
+        }
+        if (!isGitHostIntegration(integration)) {
+            return rejectedTarget([
+                gitHostOnlySurfaceWarning(id, requestedDomain, connectionId, 'pull request sweeps'),
+            ]);
+        }
+        await ctx.forceRefreshIfRequested(integration, options?.forceSync, connectionId);
+        const domain = ctx.domainForRead(integration, id, connectionId, requestedDomain);
+        const accountWide = repos.length === 0;
+        const requestedFilters = target.filters ?? options?.filters;
+        const resolved = accountWide
+            ? resolveAccountWidePullRequestFilters(id, requestedFilters)
+            : resolvePullRequestFilters(id, requestedFilters);
+        if (resolved.unsupported) {
+            return rejectedTarget([
+                accountWide
+                    ? unsupportedAccountWidePullRequestFiltersWarning(id, domain, connectionId, requestedFilters ?? [])
+                    : unsupportedFiltersWarning(id, domain, connectionId),
+            ]);
+        }
+        const drain = await drainPullRequests(integration, id, domain, repos, options?.states, resolved.filters, accountWide ? (options?.includeReviewRequested ?? false) : false, connectionId, maxPages, attributeUnavailableProviders);
+        const currentAccountId = drain.items.some(pr => pr.author != null)
+            ? await getCurrentAccountId(integration, connectionId)
+            : undefined;
+        // Normalize the raw provider-apis PRs to the GitLens-owned shape here, where the per-provider
+        // `integration` (the mapper's provider reference) is in scope; the aggregation below only sees drains.
+        return {
+            ...drain,
+            items: drain.items.map(pr => fromProviderPullRequest(pr, integration, { currentAccountId: currentAccountId })),
+            providerId: id,
+        };
+    });
+    const items = [];
+    const warnings = [];
+    const failedProviderIds = new Set();
+    const incompleteProviderIds = new Set();
+    let fetchFailed = false;
+    let truncated = false;
+    for (const drain of results) {
+        if (drain == null) {
+            continue;
+        }
+        items.push(...drain.items);
+        for (const w of drain.warnings) {
+            appendDedupedWarning(warnings, w);
+        }
+        if (drain.fetchFailed) {
+            fetchFailed = true;
+        }
+        if (drain.failedProvider) {
+            failedProviderIds.add(drain.providerId);
+        }
+        else if (drain.fetchFailed || drain.truncated) {
+            incompleteProviderIds.add(drain.providerId);
+        }
+        if (drain.truncated) {
+            truncated = true;
+        }
+    }
+    return {
+        items: items,
+        warnings: warnings,
+        // `allPages` asserts completeness — it must be false when any provider truncated (a single-page
+        // account-wide read that couldn't confirm it drained everything) OR a drain aborted on a read
+        // failure (its slice is incomplete). Either way the sweep did not read every page.
+        page: {
+            currentPage: 1,
+            itemsPerPage: items.length,
+            allPages: !truncated && !fetchFailed,
+            truncated: truncated || undefined,
+        },
+        // A sweep drains every page itself and exposes no cursor to resume — so `hasMore` must be false even
+        // when the read was incomplete. Terminal incompleteness is expressed through `page.truncated` +
+        // `allPages: false` + warnings; setting `hasMore: true` here would make a consumer that drains while
+        // `hasMore` re-run the identical sweep forever with no cursor to advance.
+        hasMore: false,
+        fetchFailed: fetchFailed || undefined,
+        failedProviderIds: [...failedProviderIds],
+        incompleteProviderIds: [...incompleteProviderIds],
+    };
+}
+/**
+ * Closed/merged counterpart of {@link sweepPullRequests}, feeding Kepler's Kanban "done" column. Applies
+ * the native cross-provider state filter (`Closed` + `Merged`) so it works beyond GitHub.
+ */
+export function sweepClosedPullRequests(ctx, options) {
+    return sweepPullRequests(ctx, { ...options, states: ['closed', 'merged'] });
+}
+//# sourceMappingURL=sweeps.js.map