@gitkraken/core-gitlens 0.3.1 → 0.4.100

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

@@ -0,0 +1,60 @@
+import type { PullRequestStateFilter } from '../../../git/models/pullRequest.js';
+import type { IntegrationIds } from '../constants.js';
+import type { ProviderSweepTarget, PullRequestSweepOptions } from '../manager.js';
+import type { GitHostIntegration } from '../models/gitHostIntegration.js';
+import type { IntegrationResult } from '../models/integration.js';
+import type { PullRequestFilter } from '../providerFilters.js';
+import type { ProviderPullRequest, ProviderReposInput, ProviderRepository } from '../providers/models.js';
+import type { ProviderWarning } from '../results.js';
+/**
+ * The all-pages reads: a provider read run repeatedly until it runs out of pages, as opposed to the single-page
+ * reads the facade's paged surface exposes. `sweepPullRequests` and `broadenIssues` are built on these.
+ *
+ * A drain's job is to keep going where a single page would stop, so what distinguishes it is its failure
+ * bookkeeping rather than its loop: it must return the prefix it did read plus enough signal for the caller to
+ * know the result is not authoritative — `truncated` when pages remain unread (a page backstop, or a provider
+ * claiming another page while handing back no usable cursor), `fetchFailed` when a page or scope failed
+ * outright. Discarding the prefix on a late failure, or returning it as if complete, are the two mistakes these
+ * exist to prevent.
+ */
+/**
+ * Runs a result-returning read and captures failure as a neutral {@link ProviderWarning} rather than
+ * letting it throw or silently vanish. Handles both a returned `{ error }` (the read cores' contract)
+ * and a hard throw; a soft warning (`{ value, error }`) yields the value *and* a warning.
+ */
+export declare function runCaptured<T>(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined, fn: () => Promise<IntegrationResult<T>>, options?: {
+    warnOnMissingSession?: boolean;
+}): Promise<{
+    value?: T;
+    warning?: ProviderWarning;
+}>;
+/**
+ * Drains every page of the user's pull requests for one git-host integration, threading the opaque
+ * next-cursor the provider returns (so it works for both page- and cursor-based hosts). Stops at
+ * `maxPages` (marking `truncated`) or on a hard read failure (marking `fetchFailed`), keeping the
+ * pages fetched so far. A soft warning (`{ value, error }`) is recorded but the drain continues.
+ */
+export declare function drainPullRequests(integration: GitHostIntegration, id: IntegrationIds, domain: string | undefined, repos: ProviderReposInput, state: PullRequestStateFilter[] | undefined, filters: PullRequestFilter[] | undefined, includeReviewRequested: boolean, connectionId: string | undefined, maxPages: number, attributeUnavailableProvider: boolean): Promise<{
+    items: ProviderPullRequest[];
+    warnings: ProviderWarning[];
+    fetchFailed: boolean;
+    truncated: boolean;
+    failedProvider: boolean;
+}>;
+/**
+ * Drains every page of repositories under an org for one git-host integration, threading the opaque
+ * next-cursor the provider returns. Stops at `maxPages` (marking `truncated`) or on a hard read failure
+ * (marking `fetchFailed`), keeping the pages fetched so far.
+ */
+export declare function drainRepositories(integration: GitHostIntegration, id: IntegrationIds, domain: string | undefined, org: string, project: string | undefined, connectionId: string | undefined, maxPages: number): Promise<{
+    repos: ProviderRepository[];
+    warnings: ProviderWarning[];
+    fetchFailed: boolean;
+    truncated: boolean;
+}>;
+export declare function resolvePullRequestSweepTargets(options: PullRequestSweepOptions | undefined): {
+    targets: readonly ProviderSweepTarget[];
+    attributeUnavailableProviders: boolean;
+};
+export declare function getCurrentAccountId(integration: GitHostIntegration, connectionId: string | undefined): Promise<string | undefined>;
+//# sourceMappingURL=drains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drains.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/drains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE1G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrD;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAClC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EACvC,OAAO,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC,CAmBnD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,WAAW,EAAE,kBAAkB,EAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,sBAAsB,EAAE,GAAG,SAAS,EAC3C,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACxC,sBAAsB,EAAE,OAAO,EAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,EAChB,4BAA4B,EAAE,OAAO,GACnC,OAAO,CAAC;IACV,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;CACxB,CAAC,CAqID;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,WAAW,EAAE,kBAAkB,EAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC;IACV,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC,CA+DD;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,GAAG;IAC7F,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,6BAA6B,EAAE,OAAO,CAAC;CACvC,CA2BA;AAED,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B"}

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

@@ -0,0 +1,255 @@
+import { mergeAssessmentInto } from '../collectionMetadata.js';
+import { supportedOrderedCloudIntegrationIds } from '../constants.js';
+import { getProviderPullRequestIdentity } from '../providers/models.js';
+import { appendDedupedWarning, toProviderWarning } from '../results.js';
+import { isIssuesHostIntegrationId } from '../utils/integration.utils.js';
+import { noConnectionWarning, truncationWarning } from './warnings.js';
+/**
+ * The all-pages reads: a provider read run repeatedly until it runs out of pages, as opposed to the single-page
+ * reads the facade's paged surface exposes. `sweepPullRequests` and `broadenIssues` are built on these.
+ *
+ * A drain's job is to keep going where a single page would stop, so what distinguishes it is its failure
+ * bookkeeping rather than its loop: it must return the prefix it did read plus enough signal for the caller to
+ * know the result is not authoritative — `truncated` when pages remain unread (a page backstop, or a provider
+ * claiming another page while handing back no usable cursor), `fetchFailed` when a page or scope failed
+ * outright. Discarding the prefix on a late failure, or returning it as if complete, are the two mistakes these
+ * exist to prevent.
+ */
+/**
+ * Runs a result-returning read and captures failure as a neutral {@link ProviderWarning} rather than
+ * letting it throw or silently vanish. Handles both a returned `{ error }` (the read cores' contract)
+ * and a hard throw; a soft warning (`{ value, error }`) yields the value *and* a warning.
+ */
+export async function runCaptured(id, domain, connectionId, fn, options) {
+    try {
+        const result = await fn();
+        if (result == null) {
+            // The read core returns undefined only when it couldn't resolve a session. For a per-connection
+            // or explicit-domain read that means the requested target is gone or its authentication is invalid,
+            // which must not be reported as an empty account. The untargeted primary path legitimately yields
+            // nothing when the provider isn't connected, so leave it as an empty result.
+            return connectionId != null || options?.warnOnMissingSession
+                ? { warning: noConnectionWarning(id, domain, connectionId) }
+                : {};
+        }
+        if (result.error != null) {
+            return { value: result.value, warning: toProviderWarning(id, domain, connectionId, result.error) };
+        }
+        return { value: result.value };
+    }
+    catch (ex) {
+        return { warning: toProviderWarning(id, domain, connectionId, ex) };
+    }
+}
+/**
+ * Drains every page of the user's pull requests for one git-host integration, threading the opaque
+ * next-cursor the provider returns (so it works for both page- and cursor-based hosts). Stops at
+ * `maxPages` (marking `truncated`) or on a hard read failure (marking `fetchFailed`), keeping the
+ * pages fetched so far. A soft warning (`{ value, error }`) is recorded but the drain continues.
+ */
+export async function drainPullRequests(integration, id, domain, repos, state, filters, includeReviewRequested, connectionId, maxPages, attributeUnavailableProvider) {
+    const items = [];
+    const itemIndexByIdentity = new Map();
+    const warnings = [];
+    let cursor;
+    let page = 0;
+    // SDK metadata failures across pages mean the collection is incomplete even when no page threw; carry
+    // this through the terminal returns instead of resetting it to false at the last page.
+    let fetchFailed = false;
+    let truncated = false;
+    // With no repos this is an account-wide "my PRs" sweep. The repo-scoped core rejects an empty `repos`
+    // input, so read the provider-native account-wide core instead.
+    const accountWide = repos.length === 0;
+    for (;;) {
+        page++;
+        // Snapshot the mutable loop cursor so the read closure doesn't capture a later-reassigned value.
+        const pageCursor = cursor;
+        const { value, warning } = await runCaptured(id, domain, connectionId, () => accountWide
+            ? integration.getMyPullRequestsForUserResult({
+                state: state,
+                cursor: pageCursor,
+                includeReviewRequested: includeReviewRequested,
+                filters: filters,
+                summary: true,
+            }, connectionId)
+            : integration.getMyPullRequestsForReposResult(repos, { state: state, filters: filters, cursor: pageCursor }, connectionId));
+        if (warning != null) {
+            appendDedupedWarning(warnings, warning);
+        }
+        if (value == null) {
+            // An implicit sweep may silently skip a provider that has no session before it yields data.
+            // Once a page has been returned, however, losing that session leaves an unread tail and must
+            // be attributed even when the provider wasn't explicitly requested.
+            const sessionLostAfterProgress = warning == null && page > 1;
+            const unavailable = warning == null && (attributeUnavailableProvider || sessionLostAfterProgress);
+            if (unavailable) {
+                appendDedupedWarning(warnings, noConnectionWarning(id, domain, connectionId));
+            }
+            // `warning` set → a hard read failure (incomplete items); otherwise not connected / no session.
+            return {
+                items: items,
+                warnings: warnings,
+                fetchFailed: fetchFailed || warning != null || unavailable,
+                truncated: truncated || sessionLostAfterProgress,
+                // Only a top-level first-page rejection means the provider itself failed. A later-page or
+                // per-scope failure still yielded a usable provider slice and stays represented separately.
+                failedProvider: page === 1 && (warning != null || unavailable),
+            };
+        }
+        // Composite account-wide queries can surface the same PR on different relationship/state pages
+        // (for example authored + review-requested, or closed + merged). Keep the first stable position but
+        // replace its value with the latest representation so a later, richer merged state wins. A provider
+        // row without a canonical URL falls back to repository-scoped identity; a row with neither stays
+        // unkeyed and is retained so unrelated incomplete rows are never collapsed.
+        for (const pullRequest of value.values) {
+            const identity = getProviderPullRequestIdentity(pullRequest);
+            if (identity == null) {
+                items.push(pullRequest);
+                continue;
+            }
+            const existingIndex = itemIndexByIdentity.get(identity);
+            if (existingIndex == null) {
+                itemIndexByIdentity.set(identity, items.length);
+                items.push(pullRequest);
+            }
+            else {
+                items[existingIndex] = pullRequest;
+            }
+        }
+        // Assess this page's SDK metadata: append scope-aware warnings (deduped across pages), and remember
+        // whether a structured failure or incompleteness occurred.
+        const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, value.metadata);
+        fetchFailed = fetchFailed || assessment.fetchFailed;
+        const pageTruncated = value.truncated === true ||
+            value.paging?.truncated === true ||
+            assessment.truncated;
+        truncated = truncated || pageTruncated;
+        if (pageTruncated && !assessment.truncated) {
+            appendDedupedWarning(warnings, truncationWarning(id, domain, connectionId, 'Pull request'));
+        }
+        if (!(value.paging?.more ?? false)) {
+            // A read that can't confirm completeness (single-page provider reads with no `hasNextPage`)
+            // sets `paging.truncated`; propagate it (and any top-level `truncated` and SDK incompleteness)
+            // so the sweep doesn't claim an all-pages result.
+            return {
+                items: items,
+                warnings: warnings,
+                fetchFailed: fetchFailed,
+                truncated: truncated,
+                failedProvider: false,
+            };
+        }
+        if (page >= maxPages) {
+            appendDedupedWarning(warnings, truncationWarning(id, domain, connectionId, 'Pull request'));
+            return {
+                items: items,
+                warnings: warnings,
+                fetchFailed: fetchFailed,
+                truncated: true,
+                failedProvider: false,
+            };
+        }
+        const nextCursor = value.paging?.cursor;
+        if (nextCursor == null || nextCursor === '{}') {
+            // Provider says there is more but didn't return a usable cursor; stop rather than refetch the same page.
+            appendDedupedWarning(warnings, truncationWarning(id, domain, connectionId, 'Pull request'));
+            return {
+                items: items,
+                warnings: warnings,
+                fetchFailed: fetchFailed,
+                truncated: true,
+                failedProvider: false,
+            };
+        }
+        cursor = nextCursor;
+    }
+}
+/**
+ * Drains every page of repositories under an org for one git-host integration, threading the opaque
+ * next-cursor the provider returns. Stops at `maxPages` (marking `truncated`) or on a hard read failure
+ * (marking `fetchFailed`), keeping the pages fetched so far.
+ */
+export async function drainRepositories(integration, id, domain, org, project, connectionId, maxPages) {
+    const repos = [];
+    const warnings = [];
+    let fetchFailed = false;
+    let truncated = false;
+    let cursor;
+    let page = 0;
+    for (;;) {
+        page++;
+        const pageCursor = cursor;
+        const { value, warning } = await runCaptured(id, domain, connectionId, () => integration.getRepositoriesForOrgResult(org, {
+            project: project,
+            cursor: pageCursor,
+            connectionId: connectionId,
+        }), { warnOnMissingSession: true });
+        if (warning != null) {
+            warnings.push(warning);
+        }
+        if (value == null) {
+            const interruptedAfterProgress = page > 1;
+            if (interruptedAfterProgress && warning == null) {
+                appendDedupedWarning(warnings, truncationWarning(id, domain, connectionId, 'Repository'));
+            }
+            return {
+                repos: repos,
+                warnings: warnings,
+                fetchFailed: fetchFailed || warning != null || interruptedAfterProgress,
+                truncated: truncated || interruptedAfterProgress,
+            };
+        }
+        repos.push(...value.values);
+        const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, value.metadata);
+        fetchFailed = fetchFailed || assessment.fetchFailed;
+        truncated = truncated || value.truncated === true || value.paging?.truncated === true || assessment.truncated;
+        if (!(value.paging?.more ?? false)) {
+            return {
+                repos: repos,
+                warnings: warnings,
+                fetchFailed: fetchFailed,
+                truncated: truncated,
+            };
+        }
+        if (page >= maxPages) {
+            return { repos: repos, warnings: warnings, fetchFailed: fetchFailed, truncated: true };
+        }
+        const nextCursor = value.paging?.cursor;
+        if (nextCursor == null || nextCursor === '{}') {
+            // Provider says there is more but didn't return a usable cursor; stop rather than refetch the same page.
+            return { repos: repos, warnings: warnings, fetchFailed: fetchFailed, truncated: true };
+        }
+        cursor = nextCursor;
+    }
+}
+export function resolvePullRequestSweepTargets(options) {
+    if (options?.targets != null) {
+        if (options.providerIds != null || options.connectionId != null) {
+            throw new TypeError("Pull request sweep 'targets' cannot be combined with 'providerIds' or 'connectionId'");
+        }
+        const seenProviderIds = new Set();
+        for (const target of options.targets) {
+            if (seenProviderIds.has(target.providerId)) {
+                throw new TypeError(`Pull request sweep targets must contain at most one target per provider; duplicate '${target.providerId}'`);
+            }
+            seenProviderIds.add(target.providerId);
+        }
+        return { targets: options.targets, attributeUnavailableProviders: true };
+    }
+    const providerIds = options?.providerIds ?? supportedOrderedCloudIntegrationIds.filter(id => !isIssuesHostIntegrationId(id));
+    const connectionId = providerIds.length === 1 ? options?.connectionId : undefined;
+    return {
+        targets: providerIds.map(providerId => ({ providerId: providerId, connectionId: connectionId })),
+        attributeUnavailableProviders: options?.providerIds != null,
+    };
+}
+export async function getCurrentAccountId(integration, connectionId) {
+    try {
+        return (await integration.getCurrentAccount({ connectionId: connectionId }))?.id;
+    }
+    catch {
+        // Authorship is optional enrichment; don't turn a successful PR read into a failure if identity lookup fails.
+        return undefined;
+    }
+}
+//# sourceMappingURL=drains.js.map

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

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

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

@@ -0,0 +1,81 @@
+import type { IntegrationIds } from '../constants.js';
+import type { IssueFilter, PullRequestFilter } from '../providerFilters.js';
+/**
+ * Validation of a caller-supplied relationship filter set against what a provider can express server-side.
+ *
+ * Every one of these is ALL-OR-NOTHING, and deliberately so: dropping the members a provider can't express
+ * would silently widen the read past what was asked for (requesting Author+Mention on a host without Mention
+ * would return every authored item rather than the requested set), and narrowing the returned page afterward
+ * would leave `items` describing a different result set than the `hasMore`/`cursor` the provider produced with
+ * it. So an inexpressible set is refused whole, and the caller surfaces a warning instead of reading unfiltered.
+ *
+ * The three differ only in WHICH capability they check, because they govern three different provider queries —
+ * see `IntegrationManager.getSupportedFilters`, which exposes the same capability table so a consumer can
+ * intersect against it and never reach a refusal.
+ */
+export interface ResolvedFilters<T> {
+    filters?: T[];
+    unsupported: boolean;
+}
+/**
+ * Validates a repo-scoped PR filter set, so an unsupported filter never trips the read core's "Unsupported
+ * filters" guard. `unsupported: true` when the caller DID request filters and the provider can't express even
+ * ONE of them — the exact negation of the read core's `providerSupportsPullRequestFilters` (`every`), so this
+ * can only ever pre-empt that guard, never disagree with it.
+ *
+ * Returns `{ filters }` (possibly undefined when none were requested — an unfiltered read is intended). Genuine
+ * "my pull requests" self-scoping is delivered by the account-wide path
+ * (`GitHostIntegration.getMyPullRequestsForUserResult`); this only governs the optional repo-scoped narrowing.
+ */
+export declare function resolvePullRequestFilters(id: IntegrationIds, filters: PullRequestFilter[] | undefined): ResolvedFilters<PullRequestFilter>;
+/**
+ * Validates an account-wide PR relationship union independently from the repo-scoped capability. Dropping an
+ * unsupported member would change the requested OR set, so validation is all-or-nothing.
+ */
+export declare function resolveAccountWidePullRequestFilters(id: IntegrationIds, filters: PullRequestFilter[] | undefined): ResolvedFilters<PullRequestFilter>;
+/**
+ * Validates a caller-provided issue filter set against what the provider's ACCOUNT-WIDE issue read can express
+ * server-side (`ProviderMetadata.supportedAccountWideIssueFilters`), which is a different — usually narrower —
+ * set than the repo-scoped `ProviderMetadata.supportedIssueFilters`.
+ *
+ * Dropping the unexpressible members would silently widen the read back toward the provider's own union
+ * (authored ∪ assigned ∪ mentioned for GitHub), which is the opposite of what a caller narrowing to
+ * `[Assignee]` asked for.
+ */
+export declare function resolveAccountWideIssueFilters(id: IntegrationIds, filters: IssueFilter[] | undefined): ResolvedFilters<IssueFilter>;
+/**
+ * The filters `listPullRequestsPage`/`listIssuesPage` (and the sweeps) accept for a provider, so a caller can
+ * narrow to what the provider can express BEFORE issuing the read.
+ *
+ * This matters because the filter contract is all-or-nothing: a set containing even one unsupported filter is
+ * refused outright ({@link resolvePullRequestFilters}) rather than silently narrowed, since falling through to
+ * an unfiltered fetch would return every PR instead of the user's. Without this accessor a consumer had to
+ * hardcode its own copy of the table — reachable only by importing the internal `providers/models.js`
+ * subpath — and a copy that drifts turns a supported read into an empty page with `fetchFailed`.
+ *
+ * Empty means "no filter of that kind is expressible": either the provider has no such surface (issue trackers
+ * have no pull requests; Bitbucket exposes no issues) or its metadata declares none. Callers should treat it as
+ * "don't pass filters", not as an error. Returns copies, so mutating the result can't corrupt the metadata.
+ *
+ * `issues` and `issuesAccountWide` are separate because the repo-scoped and account-wide issue reads are
+ * different provider queries with different filter surfaces, and the same `filters` input is validated against
+ * whichever one the read uses (`repos` present or not). `issuesAccountWide` is generally the narrower of the
+ * two: GitLab, for instance, can express `Assignee` and `Author` account-wide, but not `Mention`.
+ *
+ * That split describes the GIT-HOST reads only. An issue tracker (Jira/Linear/Trello) has neither — its issues
+ * live under resource → project — so it reports its filters under `issues`, which is what
+ * {@link IntegrationService.listIssueTrackerIssuesPage} validates against, and leaves `issuesAccountWide`
+ * empty. Reading a tracker's capability off `issuesAccountWide` therefore under-reports it.
+ *
+ * Note this is a CAPABILITY table — "what the provider can express" — not a recommendation. A consumer
+ * matching another tool's behavior may deliberately pass fewer filters than are listed here (or none, where an
+ * already-scoped read would only be narrowed by them). Intersecting against this table is what keeps a
+ * filtered read from being refused; it isn't a directive to use every filter in it.
+ */
+export declare function getSupportedFilters(providerId: IntegrationIds): {
+    pullRequests: PullRequestFilter[];
+    pullRequestsAccountWide: PullRequestFilter[];
+    issues: IssueFilter[];
+    issuesAccountWide: IssueFilter[];
+};
+//# sourceMappingURL=filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACtC,eAAe,CAAC,iBAAiB,CAAC,CAOpC;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACtC,eAAe,CAAC,iBAAiB,CAAC,CAOpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC7C,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,GAChC,eAAe,CAAC,WAAW,CAAC,CAO9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG;IAChE,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,uBAAuB,EAAE,iBAAiB,EAAE,CAAC;IAC7C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iBAAiB,EAAE,WAAW,EAAE,CAAC;CACjC,CAQA"}

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

@@ -0,0 +1,87 @@
+import { providersMetadata } from '../providers/models.js';
+/**
+ * Validates a repo-scoped PR filter set, so an unsupported filter never trips the read core's "Unsupported
+ * filters" guard. `unsupported: true` when the caller DID request filters and the provider can't express even
+ * ONE of them — the exact negation of the read core's `providerSupportsPullRequestFilters` (`every`), so this
+ * can only ever pre-empt that guard, never disagree with it.
+ *
+ * Returns `{ filters }` (possibly undefined when none were requested — an unfiltered read is intended). Genuine
+ * "my pull requests" self-scoping is delivered by the account-wide path
+ * (`GitHostIntegration.getMyPullRequestsForUserResult`); this only governs the optional repo-scoped narrowing.
+ */
+export function resolvePullRequestFilters(id, filters) {
+    if (filters == null || filters.length === 0)
+        return { unsupported: false };
+    const supported = providersMetadata[id]?.supportedPullRequestFilters;
+    if (supported == null || filters.some(f => !supported.includes(f)))
+        return { unsupported: true };
+    return { filters: filters, unsupported: false };
+}
+/**
+ * Validates an account-wide PR relationship union independently from the repo-scoped capability. Dropping an
+ * unsupported member would change the requested OR set, so validation is all-or-nothing.
+ */
+export function resolveAccountWidePullRequestFilters(id, filters) {
+    if (filters == null || filters.length === 0)
+        return { unsupported: false };
+    const supported = providersMetadata[id]?.supportedAccountWidePullRequestFilters;
+    if (supported == null || filters.some(f => !supported.includes(f)))
+        return { unsupported: true };
+    return { filters: [...new Set(filters)], unsupported: false };
+}
+/**
+ * Validates a caller-provided issue filter set against what the provider's ACCOUNT-WIDE issue read can express
+ * server-side (`ProviderMetadata.supportedAccountWideIssueFilters`), which is a different — usually narrower —
+ * set than the repo-scoped `ProviderMetadata.supportedIssueFilters`.
+ *
+ * Dropping the unexpressible members would silently widen the read back toward the provider's own union
+ * (authored ∪ assigned ∪ mentioned for GitHub), which is the opposite of what a caller narrowing to
+ * `[Assignee]` asked for.
+ */
+export function resolveAccountWideIssueFilters(id, filters) {
+    if (filters == null || filters.length === 0)
+        return { unsupported: false };
+    const supported = providersMetadata[id]?.supportedAccountWideIssueFilters;
+    if (supported == null || filters.some(f => !supported.includes(f)))
+        return { unsupported: true };
+    return { filters: filters, unsupported: false };
+}
+/**
+ * The filters `listPullRequestsPage`/`listIssuesPage` (and the sweeps) accept for a provider, so a caller can
+ * narrow to what the provider can express BEFORE issuing the read.
+ *
+ * This matters because the filter contract is all-or-nothing: a set containing even one unsupported filter is
+ * refused outright ({@link resolvePullRequestFilters}) rather than silently narrowed, since falling through to
+ * an unfiltered fetch would return every PR instead of the user's. Without this accessor a consumer had to
+ * hardcode its own copy of the table — reachable only by importing the internal `providers/models.js`
+ * subpath — and a copy that drifts turns a supported read into an empty page with `fetchFailed`.
+ *
+ * Empty means "no filter of that kind is expressible": either the provider has no such surface (issue trackers
+ * have no pull requests; Bitbucket exposes no issues) or its metadata declares none. Callers should treat it as
+ * "don't pass filters", not as an error. Returns copies, so mutating the result can't corrupt the metadata.
+ *
+ * `issues` and `issuesAccountWide` are separate because the repo-scoped and account-wide issue reads are
+ * different provider queries with different filter surfaces, and the same `filters` input is validated against
+ * whichever one the read uses (`repos` present or not). `issuesAccountWide` is generally the narrower of the
+ * two: GitLab, for instance, can express `Assignee` and `Author` account-wide, but not `Mention`.
+ *
+ * That split describes the GIT-HOST reads only. An issue tracker (Jira/Linear/Trello) has neither — its issues
+ * live under resource → project — so it reports its filters under `issues`, which is what
+ * {@link IntegrationService.listIssueTrackerIssuesPage} validates against, and leaves `issuesAccountWide`
+ * empty. Reading a tracker's capability off `issuesAccountWide` therefore under-reports it.
+ *
+ * Note this is a CAPABILITY table — "what the provider can express" — not a recommendation. A consumer
+ * matching another tool's behavior may deliberately pass fewer filters than are listed here (or none, where an
+ * already-scoped read would only be narrowed by them). Intersecting against this table is what keeps a
+ * filtered read from being refused; it isn't a directive to use every filter in it.
+ */
+export function getSupportedFilters(providerId) {
+    const metadata = providersMetadata[providerId];
+    return {
+        pullRequests: [...(metadata?.supportedPullRequestFilters ?? [])],
+        pullRequestsAccountWide: [...(metadata?.supportedAccountWidePullRequestFilters ?? [])],
+        issues: [...(metadata?.supportedIssueFilters ?? [])],
+        issuesAccountWide: [...(metadata?.supportedAccountWideIssueFilters ?? [])],
+    };
+}
+//# sourceMappingURL=filters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoB3D;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACxC,EAAkB,EAClB,OAAwC;IAExC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,2BAA2B,CAAC;IACrE,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CACnD,EAAkB,EAClB,OAAwC;IAExC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,sCAAsC,CAAC;IAChF,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B,CAC7C,EAAkB,EAClB,OAAkC;IAElC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,gCAAgC,CAAC;IAC1E,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA0B;IAM7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO;QACN,YAAY,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,2BAA2B,IAAI,EAAE,CAAC,CAAC;QAChE,uBAAuB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,sCAAsC,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACpD,iBAAiB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAgC,IAAI,EAAE,CAAC,CAAC;KAC1E,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,17 @@
+import { type IntegrationIds } from '../constants.js';
+import type { ListOrgsOptions, ListProjectsOptions } from '../manager.js';
+import type { ProviderOrganization, ProviderPagedResult, ProviderRepositoryShape, ProviderResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function listOrgs(ctx: ProviderReadContext, options?: ListOrgsOptions): Promise<ProviderResult<ProviderOrganization>>;
+export declare function listProjects(ctx: ProviderReadContext, options?: ListProjectsOptions): Promise<ProviderResult<ProviderOrganization>>;
+export declare function listRepos(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    org?: string;
+    project?: string;
+    page?: number;
+    cursor?: string;
+    itemsPerPage?: number;
+    connectionId?: string;
+    domain?: string;
+}): Promise<ProviderPagedResult<ProviderRepositoryShape>>;
+//# sourceMappingURL=hierarchy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.ts"],"names":[],"mappings":"AAEA,OAAO,EAGN,KAAK,cAAc,EAInB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG1E,OAAO,KAAK,EACX,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EAEd,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAYxD,wBAAsB,QAAQ,CAC7B,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAgH/C;AAED,wBAAsB,YAAY,CACjC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CA8I/C;AAED,wBAAsB,SAAS,CAC9B,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CAAC,CAkLvD"}