@gitkraken/core-gitlens 0.6.0 → 0.7.0

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

@@ -1,156 +1,107 @@
-import { effectiveIssueSort } from '../../../git/utils/issue.utils.js';
-import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
-import { runCaptured } from './drains.js';
-import { resolveIssueSearchCriteria, resolveIssueSearchScope } from './filters.js';
-import { drainFlatPagesToRequestedPage, refusedPage, resolveContinuation, resolveCurrentPage, usableCursor, } from './paging.js';
-import { gitHostOnlySurfaceWarning, issueSearchCapResultWarning, issuesUnsupportedWarning, otherWarning, truncationWarning, unsupportedIssueSearchCriteriaWarning, unusableSearchScopeMessage, } from './warnings.js';
+import { effectiveIssueSort } from "../../../git/utils/issue.utils.js";
+import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain } from "../utils/integration.utils.js";
+import { drainFlatPagesToRequestedPage, refusedPage, resolveContinuation, resolveCurrentPage, usableCursor } from "./paging.js";
+import { gitHostOnlySurfaceWarning, issueSearchCapResultWarning, issuesUnsupportedWarning, otherWarning, truncationWarning, unsupportedIssueSearchCriteriaWarning, unusableSearchScopeMessage } from "./warnings.js";
+import { runCaptured } from "./drains.js";
+import { resolveIssueSearchCriteria, resolveIssueSearchScope } from "./filters.js";
+//#region ../plus/integrations/src/reads/searchIssues.ts
 /**
- * The FILTERED issue search: issues matching structured criteria over a repository/org scope, with no forced
- * relationship to the current user.
- *
- * A sibling of `listIssuesPage` rather than a mode of it, deliberately. That read is already two divergent
- * branches (a cursor-composite account-wide path and a page-draining repo-scoped one) around a documented
- * contract where `filters` REPLACES the provider's definition of "my issues". This search answers a different
- * question — its relationships include two that are not about the user at all — and routes around the SDK's
- * repo-scoped read entirely, whose over-limit recovery walk can spend up to 128 requests and still return an
- * incomplete set. Folding the two together would multiply that branch matrix and put every existing consumer of
- * `listIssuesPage` at risk; keeping them siblings shares the primitives below without sharing the branch space,
- * for the same reason `broaden.ts`, `sweeps.ts` and `issueTracker.ts` are separate files.
- *
- * Contract details worth knowing before calling:
- * - Ordering is `criteria.sort`, most-recently-updated-first by default, and validated like every other criterion
- *   against `getSupportedFilters().issueSearch.sorts`. SOME order is always requested — a "show the N most recent"
- *   policy at the provider's result ceiling is only correct under a guaranteed one, and the ceiling warning names
- *   the key it selected the window under. A key the provider can't express refuses the read rather than serving a
- *   differently-ordered result; do not change it mid-pagination (a cursor is bound to the order it was made under,
- *   and threading it under a different key is refused with a warning + `fetchFailed` — drop the cursor and read
- *   from the first page instead).
- * - Paging is cursor-only. `page` alone walks 1..N internally (O(N) requests); a page past the last one is an
- *   empty page N, never page N−1 relabeled.
- * - At the provider's result ceiling the read SUCCEEDS and reports an omission carrying the total match count,
- *   so a consumer can say how many were withheld. It never falls back to a per-repository recovery walk.
- */
-export async function searchIssuesPage(ctx, options) {
-    const page = Math.max(1, Math.trunc(options.page ?? 1));
-    // Cursor-only, so a refusal can't claim the requested position — it reports page 1, per
-    // ProviderPageInfo.currentPage.
-    const refused = (warning) => refusedPage(1, [warning], true);
-    if (isIssuesHostIntegrationId(options.providerId)) {
-        return refused(gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Filtered issue search'));
-    }
-    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(1, early.warnings, early.fetchFailed);
-    }
-    if (!isGitHostIntegration(integration)) {
-        return refused(gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Filtered issue search'));
-    }
-    await ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);
-    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
-    const warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);
-    if (!integration.supportsIssues) {
-        return refused(issuesUnsupportedWarning(options.providerId, domain, options.connectionId));
-    }
-    const resolved = resolveIssueSearchCriteria(options.providerId, options.criteria);
-    if (resolved.rejection != null) {
-        return refused(unsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, resolved.rejection));
-    }
-    // AFTER the criteria check, which is what reports a provider with no filtered issue search at all: that is
-    // the more fundamental refusal, and answering "your scope name is malformed" to a caller whose provider has
-    // no such search names the wrong defect. Matches the pull-request twin, which probes existence first.
-    const scope = resolveIssueSearchScope(options.repos, options.org, options.criteria);
-    switch (scope.rejection?.reason) {
-        case 'unscoped':
-            return refused(otherWarning(options.providerId, domain, options.connectionId, 'A filtered issue search must be scoped: pass `repos`, `org`, or a relationship to the current user (`authored`/`assigned`/`mentioned`). `any-assignee` and `unassigned` are not scopes — either one alone matches every such issue on the host.'));
-        case 'repo-ids':
-            // A search query names repositories by PATH, so repository ids can't be expressed as a scope. Refusing
-            // is the only honest answer: dropping them would search the whole org (or the whole host) as if the
-            // caller had asked for that.
-            return refused(otherWarning(options.providerId, domain, options.connectionId, 'A filtered issue search cannot be scoped by repository id; pass repository descriptors (namespace + name) instead.'));
-        // A scope the query cannot spell, refused rather than sanitized — see `isUsableSearchScopeName`.
-        case 'unusable-scope':
-            return refused(otherWarning(options.providerId, domain, options.connectionId, unusableSearchScopeMessage('issue search scopes', scope.rejection.scopes)));
-    }
-    const readPage = (cursor) => runCaptured(options.providerId, domain, options.connectionId, () => integration.searchIssuesPageResult({
-        repos: scope.repos,
-        org: options.org,
-        criteria: options.criteria,
-        cursor: cursor,
-        pageSize: options.itemsPerPage,
-    }, undefined, options.connectionId), { warnOnMissingSession: warnOnMissingSession });
-    const first = await readPage(options.cursor);
-    const warnings = first.warning != null ? [first.warning] : [];
-    // The largest total any page reported. Folded across the walk so a cap detected on page 1 is still reportable
-    // after paging on to page N — the one thing this read accumulates that its sibling doesn't.
-    let totalCount = first.value?.totalCount;
-    const drained = await drainFlatPagesToRequestedPage(first, {
-        requestedPage: page,
-        suppliedCursor: options.cursor,
-        warnings: warnings,
-        readPage: readPage,
-        fold: p => {
-            if (p.totalCount != null) {
-                totalCount = Math.max(totalCount ?? 0, p.totalCount);
-            }
-        },
-    });
-    const { value, currentPage, requestedPageMissing } = drained;
-    const pageFetchFailed = drained.fetchFailed;
-    // A provider that doesn't implement the search hook returns `undefined` with no error. Surface that as an
-    // explicit unsupported warning + fetchFailed rather than a silent empty success, so a caller isn't left
-    // unable to tell it apart from an account with no matching issues. `getSupportedFilters().issueSearch`
-    // declares this ahead of the read, so a consumer that checks it never reaches here.
-    if (value == null && warnings.length === 0) {
-        return refused(unsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, {
-            reason: 'unsupported-search',
-        }));
-    }
-    const items = requestedPageMissing ? [] : (value?.values ?? []);
-    // Cursor-only: `hasMore` without a real cursor is a dead end, so report it as terminal-but-incomplete rather
-    // than inviting the caller to page forever.
-    const continuation = resolveContinuation({
-        hasMore: requestedPageMissing ? false : (value?.hasMore ?? false),
-        cursor: requestedPageMissing ? undefined : usableCursor(value?.cursor),
-        truncated: drained.truncated,
-    }, undefined);
-    const truncated = continuation.truncated;
-    // Only reachable when nothing else already explained the incompleteness — and a failed page always warns
-    // first, so a read that gets here SUCCEEDED. That is why the cause below is unconditionally `exhausted` and
-    // `fetchFailed` is never set from here.
-    if (truncated && warnings.length === 0) {
-        // The result ceiling is the one truncation cause this read can EXPLAIN with a number, so it gets its own
-        // warning carrying the total. Anything else truncated (an unusable continuation, a provider that stopped
-        // advancing) falls back to the generic wording.
-        warnings.push(issueSearchCapResultWarning(options.providerId, domain, options.connectionId, totalCount, effectiveIssueSort(options.criteria?.sort)) ??
-            truncationWarning(options.providerId, domain, options.connectionId, 'Issue search', 
-            // `exhausted`: this read exposes no budget the caller could raise, so nothing it could call
-            // would return the withheld items.
-            'exhausted'));
-    }
-    return {
-        items: items,
-        warnings: warnings,
-        page: {
-            // Positional, per ProviderPageInfo.currentPage. A requested page past the terminal cursor is reported
-            // as that empty page N; otherwise this read is cursor-only, so a `page` the caller didn't pair with a
-            // cursor is never echoed.
-            currentPage: requestedPageMissing
-                ? page
-                : resolveCurrentPage({
-                    providerPage: currentPage,
-                    requestedPage: page,
-                    suppliedCursor: options.cursor,
-                    pageAdvanceable: false,
-                }),
-            itemsPerPage: items.length,
-            truncated: truncated || undefined,
-        },
-        hasMore: continuation.hasMore,
-        cursor: continuation.cursor,
-        fetchFailed: pageFetchFailed || undefined,
-    };
+* The FILTERED issue search: issues matching structured criteria over a repository/org scope, with no forced
+* relationship to the current user.
+*
+* A sibling of `listIssuesPage` rather than a mode of it, deliberately. That read is already two divergent
+* branches (a cursor-composite account-wide path and a page-draining repo-scoped one) around a documented
+* contract where `filters` REPLACES the provider's definition of "my issues". This search answers a different
+* question — its relationships include two that are not about the user at all — and routes around the SDK's
+* repo-scoped read entirely, whose over-limit recovery walk can spend up to 128 requests and still return an
+* incomplete set. Folding the two together would multiply that branch matrix and put every existing consumer of
+* `listIssuesPage` at risk; keeping them siblings shares the primitives below without sharing the branch space,
+* for the same reason `broaden.ts`, `sweeps.ts` and `issueTracker.ts` are separate files.
+*
+* Contract details worth knowing before calling:
+* - Ordering is `criteria.sort`, most-recently-updated-first by default, and validated like every other criterion
+*   against `getSupportedFilters().issueSearch.sorts`. SOME order is always requested — a "show the N most recent"
+*   policy at the provider's result ceiling is only correct under a guaranteed one, and the ceiling warning names
+*   the key it selected the window under. A key the provider can't express refuses the read rather than serving a
+*   differently-ordered result; do not change it mid-pagination (a cursor is bound to the order it was made under,
+*   and threading it under a different key is refused with a warning + `fetchFailed` — drop the cursor and read
+*   from the first page instead).
+* - Paging is cursor-only. `page` alone walks 1..N internally (O(N) requests); a page past the last one is an
+*   empty page N, never page N−1 relabeled.
+* - At the provider's result ceiling the read SUCCEEDS and reports an omission carrying the total match count,
+*   so a consumer can say how many were withheld. It never falls back to a per-repository recovery walk.
+*/
+async function searchIssuesPage(ctx, options) {
+	const page = Math.max(1, Math.trunc(options.page ?? 1));
+	const refused = (warning) => refusedPage(1, [warning], true);
+	if (isIssuesHostIntegrationId(options.providerId)) return refused(gitHostOnlySurfaceWarning(options.providerId, void 0, options.connectionId, "Filtered issue search"));
+	const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
+	if (integration == null) {
+		const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
+		return refusedPage(1, early.warnings, early.fetchFailed);
+	}
+	if (!isGitHostIntegration(integration)) return refused(gitHostOnlySurfaceWarning(options.providerId, void 0, options.connectionId, "Filtered issue search"));
+	await ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);
+	const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
+	const warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);
+	if (!integration.supportsIssues) return refused(issuesUnsupportedWarning(options.providerId, domain, options.connectionId));
+	const resolved = resolveIssueSearchCriteria(options.providerId, options.criteria);
+	if (resolved.rejection != null) return refused(unsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, resolved.rejection));
+	const scope = resolveIssueSearchScope(options.repos, options.org, options.criteria);
+	switch (scope.rejection?.reason) {
+		case "unscoped": return refused(otherWarning(options.providerId, domain, options.connectionId, "A filtered issue search must be scoped: pass `repos`, `org`, or a relationship to the current user (`authored`/`assigned`/`mentioned`). `any-assignee` and `unassigned` are not scopes — either one alone matches every such issue on the host."));
+		case "repo-ids": return refused(otherWarning(options.providerId, domain, options.connectionId, "A filtered issue search cannot be scoped by repository id; pass repository descriptors (namespace + name) instead."));
+		case "unusable-scope": return refused(otherWarning(options.providerId, domain, options.connectionId, unusableSearchScopeMessage("issue search scopes", scope.rejection.scopes)));
+	}
+	const readPage = (cursor) => runCaptured(options.providerId, domain, options.connectionId, () => integration.searchIssuesPageResult({
+		repos: scope.repos,
+		org: options.org,
+		criteria: options.criteria,
+		cursor,
+		pageSize: options.itemsPerPage
+	}, void 0, options.connectionId), { warnOnMissingSession });
+	const first = await readPage(options.cursor);
+	const warnings = first.warning != null ? [first.warning] : [];
+	let totalCount = first.value?.totalCount;
+	const drained = await drainFlatPagesToRequestedPage(first, {
+		requestedPage: page,
+		suppliedCursor: options.cursor,
+		warnings,
+		readPage,
+		fold: (p) => {
+			if (p.totalCount != null) totalCount = Math.max(totalCount ?? 0, p.totalCount);
+		}
+	});
+	const { value, currentPage, requestedPageMissing } = drained;
+	const pageFetchFailed = drained.fetchFailed;
+	if (value == null && warnings.length === 0) return refused(unsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, { reason: "unsupported-search" }));
+	const items = requestedPageMissing ? [] : value?.values ?? [];
+	const continuation = resolveContinuation({
+		hasMore: requestedPageMissing ? false : value?.hasMore ?? false,
+		cursor: requestedPageMissing ? void 0 : usableCursor(value?.cursor),
+		truncated: drained.truncated
+	}, void 0);
+	const truncated = continuation.truncated;
+	if (truncated && warnings.length === 0) warnings.push(issueSearchCapResultWarning(options.providerId, domain, options.connectionId, totalCount, effectiveIssueSort(options.criteria?.sort)) ?? truncationWarning(options.providerId, domain, options.connectionId, "Issue search", "exhausted"));
+	return {
+		items,
+		warnings,
+		page: {
+			currentPage: requestedPageMissing ? page : resolveCurrentPage({
+				providerPage: currentPage,
+				requestedPage: page,
+				suppliedCursor: options.cursor,
+				pageAdvanceable: false
+			}),
+			itemsPerPage: items.length,
+			truncated: truncated || void 0
+		},
+		hasMore: continuation.hasMore,
+		cursor: continuation.cursor,
+		fetchFailed: pageFetchFailed || void 0
+	};
 }
+//#endregion
+export { searchIssuesPage };
+
 //# sourceMappingURL=searchIssues.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"searchIssues.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/searchIssues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAIvE,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACN,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,qCAAqC,EACrC,0BAA0B,GAC1B,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,GAAwB,EACxB,OAuBC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,wFAAwF;IACxF,gCAAgC;IAChC,MAAM,OAAO,GAAG,CAAC,OAAwB,EAAE,EAAE,CAAC,WAAW,CAAa,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAE1F,IAAI,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,OAAO,OAAO,CACb,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,uBAAuB,CAAC,CACvG,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9G,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACzB,qGAAqG;QACrG,iFAAiF;QACjF,MAAM,KAAK,GAAG,GAAG,CAAC,6BAA6B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1G,OAAO,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,OAAO,OAAO,CACb,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,uBAAuB,CAAC,CACvG,CAAC;IACH,CAAC;IAED,MAAM,GAAG,CAAC,uBAAuB,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAExF,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxG,MAAM,oBAAoB,GAAG,6BAA6B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/F,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClF,IAAI,QAAQ,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAChC,OAAO,OAAO,CACb,qCAAqC,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,CAC3G,CAAC;IACH,CAAC;IAED,2GAA2G;IAC3G,4GAA4G;IAC5G,sGAAsG;IACtG,MAAM,KAAK,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpF,QAAQ,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACjC,KAAK,UAAU;YACd,OAAO,OAAO,CACb,YAAY,CACX,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,iPAAiP,CACjP,CACD,CAAC;QACH,KAAK,UAAU;YACd,uGAAuG;YACvG,oGAAoG;YACpG,6BAA6B;YAC7B,OAAO,OAAO,CACb,YAAY,CACX,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,oHAAoH,CACpH,CACD,CAAC;QACH,iGAAiG;QACjG,KAAK,gBAAgB;YACpB,OAAO,OAAO,CACb,YAAY,CACX,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,0BAA0B,CAAC,qBAAqB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CACzE,CACD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAA0B,EAAE,EAAE,CAC/C,WAAW,CACV,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,GAAG,EAAE,CACJ,WAAW,CAAC,sBAAsB,CACjC;QACC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,OAAO,CAAC,YAAY;KAC9B,EACD,SAAS,EACT,OAAO,CAAC,YAAY,CACpB,EACF,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAC9C,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,8GAA8G;IAC9G,4FAA4F;IAC5F,IAAI,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC,KAAK,EAAE;QAC1D,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,OAAO,CAAC,MAAM;QAC9B,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,CAAC,CAAC,EAAE;YACT,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;gBAC1B,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YACtD,CAAC;QACF,CAAC;KACD,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC;IAC7D,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAE5C,0GAA0G;IAC1G,wGAAwG;IACxG,uGAAuG;IACvG,oFAAoF;IACpF,IAAI,KAAK,IAAI,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,OAAO,CACb,qCAAqC,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;YACvF,MAAM,EAAE,oBAAoB;SAC5B,CAAC,CACF,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IAChE,6GAA6G;IAC7G,4CAA4C;IAC5C,MAAM,YAAY,GAAG,mBAAmB,CACvC;QACC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC;QACjE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC;QACtE,SAAS,EAAE,OAAO,CAAC,SAAS;KAC5B,EACD,SAAS,CACT,CAAC;IACF,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;IACzC,yGAAyG;IACzG,4GAA4G;IAC5G,wCAAwC;IACxC,IAAI,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,yGAAyG;QACzG,yGAAyG;QACzG,gDAAgD;QAChD,QAAQ,CAAC,IAAI,CACZ,2BAA2B,CAC1B,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,UAAU,EACV,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAC1C;YACA,iBAAiB,CAChB,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,cAAc;YACd,4FAA4F;YAC5F,mCAAmC;YACnC,WAAW,CACX,CACF,CAAC;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE;YACL,sGAAsG;YACtG,sGAAsG;YACtG,0BAA0B;YAC1B,WAAW,EAAE,oBAAoB;gBAChC,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,kBAAkB,CAAC;oBACnB,YAAY,EAAE,WAAW;oBACzB,aAAa,EAAE,IAAI;oBACnB,cAAc,EAAE,OAAO,CAAC,MAAM;oBAC9B,eAAe,EAAE,KAAK;iBACtB,CAAC;YACJ,YAAY,EAAE,KAAK,CAAC,MAAM;YAC1B,SAAS,EAAE,SAAS,IAAI,SAAS;SACjC;QACD,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,WAAW,EAAE,eAAe,IAAI,SAAS;KACzC,CAAC;AACH,CAAC"}
+{"version":3,"file":"searchIssues.js","names":[],"sources":["../../../../../plus/integrations/src/reads/searchIssues.ts"],"sourcesContent":["import type { IssueSearchCriteria, IssueShape } from '@gitlens/git/models/issue.js';\nimport { effectiveIssueSort } from '@gitlens/git/utils/issue.utils.js';\nimport type { IntegrationIds } from '../constants.js';\nimport type { ProviderReposInput } from '../providers/models.js';\nimport type { ProviderPagedResult, ProviderWarning } from '../results.js';\nimport {\n\tisGitHostIntegration,\n\tisIssuesHostIntegrationId,\n\twarnOnMissingSessionForDomain,\n} from '../utils/integration.utils.js';\nimport type { ProviderReadContext } from './context.js';\nimport { runCaptured } from './drains.js';\nimport { resolveIssueSearchCriteria, resolveIssueSearchScope } from './filters.js';\nimport {\n\tdrainFlatPagesToRequestedPage,\n\trefusedPage,\n\tresolveContinuation,\n\tresolveCurrentPage,\n\tusableCursor,\n} from './paging.js';\nimport {\n\tgitHostOnlySurfaceWarning,\n\tissueSearchCapResultWarning,\n\tissuesUnsupportedWarning,\n\totherWarning,\n\ttruncationWarning,\n\tunsupportedIssueSearchCriteriaWarning,\n\tunusableSearchScopeMessage,\n} from './warnings.js';\n\n/**\n * The FILTERED issue search: issues matching structured criteria over a repository/org scope, with no forced\n * relationship to the current user.\n *\n * A sibling of `listIssuesPage` rather than a mode of it, deliberately. That read is already two divergent\n * branches (a cursor-composite account-wide path and a page-draining repo-scoped one) around a documented\n * contract where `filters` REPLACES the provider's definition of \"my issues\". This search answers a different\n * question — its relationships include two that are not about the user at all — and routes around the SDK's\n * repo-scoped read entirely, whose over-limit recovery walk can spend up to 128 requests and still return an\n * incomplete set. Folding the two together would multiply that branch matrix and put every existing consumer of\n * `listIssuesPage` at risk; keeping them siblings shares the primitives below without sharing the branch space,\n * for the same reason `broaden.ts`, `sweeps.ts` and `issueTracker.ts` are separate files.\n *\n * Contract details worth knowing before calling:\n * - Ordering is `criteria.sort`, most-recently-updated-first by default, and validated like every other criterion\n *   against `getSupportedFilters().issueSearch.sorts`. SOME order is always requested — a \"show the N most recent\"\n *   policy at the provider's result ceiling is only correct under a guaranteed one, and the ceiling warning names\n *   the key it selected the window under. A key the provider can't express refuses the read rather than serving a\n *   differently-ordered result; do not change it mid-pagination (a cursor is bound to the order it was made under,\n *   and threading it under a different key is refused with a warning + `fetchFailed` — drop the cursor and read\n *   from the first page instead).\n * - Paging is cursor-only. `page` alone walks 1..N internally (O(N) requests); a page past the last one is an\n *   empty page N, never page N−1 relabeled.\n * - At the provider's result ceiling the read SUCCEEDS and reports an omission carrying the total match count,\n *   so a consumer can say how many were withheld. It never falls back to a per-repository recovery walk.\n */\nexport async function searchIssuesPage(\n\tctx: ProviderReadContext,\n\toptions: {\n\t\tproviderId: IntegrationIds;\n\t\t/** Repositories to search. Combines with `org`; both become scope constraints on the same query. */\n\t\trepos?: ProviderReposInput;\n\t\t/** Organization/account to search. Combines with `repos`. */\n\t\torg?: string;\n\t\t/**\n\t\t * What to narrow on, validated against `getSupportedFilters().issueSearch` before the read runs. A\n\t\t * criterion the provider can't express server-side refuses the whole read (warning + `fetchFailed`)\n\t\t * rather than serving a list that was never narrowed.\n\t\t */\n\t\tcriteria?: IssueSearchCriteria;\n\t\tpage?: number;\n\t\tcursor?: string;\n\t\t/** Per relationship, not per page; see {@link IntegrationManager.searchIssuesPage}. */\n\t\titemsPerPage?: number;\n\t\tforceSync?: boolean;\n\t\tconnectionId?: string;\n\t\t/**\n\t\t * Explicit self-managed host domain. Used only when the requested connection has no configured domain;\n\t\t * it must come from the trusted authentication configuration, not repository or remote data.\n\t\t */\n\t\tdomain?: string;\n\t},\n): Promise<ProviderPagedResult<IssueShape>> {\n\tconst page = Math.max(1, Math.trunc(options.page ?? 1));\n\t// Cursor-only, so a refusal can't claim the requested position — it reports page 1, per\n\t// ProviderPageInfo.currentPage.\n\tconst refused = (warning: ProviderWarning) => refusedPage<IssueShape>(1, [warning], true);\n\n\tif (isIssuesHostIntegrationId(options.providerId)) {\n\t\treturn refused(\n\t\t\tgitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Filtered issue search'),\n\t\t);\n\t}\n\n\tconst integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);\n\tif (integration == null) {\n\t\t// A supplied connection or domain that no longer resolves is a broken target, not an empty account —\n\t\t// surface a no-connection warning + fetchFailed rather than a silent empty page.\n\t\tconst early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);\n\t\treturn refusedPage(1, early.warnings, early.fetchFailed);\n\t}\n\tif (!isGitHostIntegration(integration)) {\n\t\treturn refused(\n\t\t\tgitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Filtered issue search'),\n\t\t);\n\t}\n\n\tawait ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);\n\n\tconst domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);\n\tconst warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);\n\n\tif (!integration.supportsIssues) {\n\t\treturn refused(issuesUnsupportedWarning(options.providerId, domain, options.connectionId));\n\t}\n\n\tconst resolved = resolveIssueSearchCriteria(options.providerId, options.criteria);\n\tif (resolved.rejection != null) {\n\t\treturn refused(\n\t\t\tunsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, resolved.rejection),\n\t\t);\n\t}\n\n\t// AFTER the criteria check, which is what reports a provider with no filtered issue search at all: that is\n\t// the more fundamental refusal, and answering \"your scope name is malformed\" to a caller whose provider has\n\t// no such search names the wrong defect. Matches the pull-request twin, which probes existence first.\n\tconst scope = resolveIssueSearchScope(options.repos, options.org, options.criteria);\n\tswitch (scope.rejection?.reason) {\n\t\tcase 'unscoped':\n\t\t\treturn refused(\n\t\t\t\totherWarning(\n\t\t\t\t\toptions.providerId,\n\t\t\t\t\tdomain,\n\t\t\t\t\toptions.connectionId,\n\t\t\t\t\t'A filtered issue search must be scoped: pass `repos`, `org`, or a relationship to the current user (`authored`/`assigned`/`mentioned`). `any-assignee` and `unassigned` are not scopes — either one alone matches every such issue on the host.',\n\t\t\t\t),\n\t\t\t);\n\t\tcase 'repo-ids':\n\t\t\t// A search query names repositories by PATH, so repository ids can't be expressed as a scope. Refusing\n\t\t\t// is the only honest answer: dropping them would search the whole org (or the whole host) as if the\n\t\t\t// caller had asked for that.\n\t\t\treturn refused(\n\t\t\t\totherWarning(\n\t\t\t\t\toptions.providerId,\n\t\t\t\t\tdomain,\n\t\t\t\t\toptions.connectionId,\n\t\t\t\t\t'A filtered issue search cannot be scoped by repository id; pass repository descriptors (namespace + name) instead.',\n\t\t\t\t),\n\t\t\t);\n\t\t// A scope the query cannot spell, refused rather than sanitized — see `isUsableSearchScopeName`.\n\t\tcase 'unusable-scope':\n\t\t\treturn refused(\n\t\t\t\totherWarning(\n\t\t\t\t\toptions.providerId,\n\t\t\t\t\tdomain,\n\t\t\t\t\toptions.connectionId,\n\t\t\t\t\tunusableSearchScopeMessage('issue search scopes', scope.rejection.scopes),\n\t\t\t\t),\n\t\t\t);\n\t}\n\n\tconst readPage = (cursor: string | undefined) =>\n\t\trunCaptured(\n\t\t\toptions.providerId,\n\t\t\tdomain,\n\t\t\toptions.connectionId,\n\t\t\t() =>\n\t\t\t\tintegration.searchIssuesPageResult(\n\t\t\t\t\t{\n\t\t\t\t\t\trepos: scope.repos,\n\t\t\t\t\t\torg: options.org,\n\t\t\t\t\t\tcriteria: options.criteria,\n\t\t\t\t\t\tcursor: cursor,\n\t\t\t\t\t\tpageSize: options.itemsPerPage,\n\t\t\t\t\t},\n\t\t\t\t\tundefined,\n\t\t\t\t\toptions.connectionId,\n\t\t\t\t),\n\t\t\t{ warnOnMissingSession: warnOnMissingSession },\n\t\t);\n\n\tconst first = await readPage(options.cursor);\n\tconst warnings = first.warning != null ? [first.warning] : [];\n\t// The largest total any page reported. Folded across the walk so a cap detected on page 1 is still reportable\n\t// after paging on to page N — the one thing this read accumulates that its sibling doesn't.\n\tlet totalCount = first.value?.totalCount;\n\tconst drained = await drainFlatPagesToRequestedPage(first, {\n\t\trequestedPage: page,\n\t\tsuppliedCursor: options.cursor,\n\t\twarnings: warnings,\n\t\treadPage: readPage,\n\t\tfold: p => {\n\t\t\tif (p.totalCount != null) {\n\t\t\t\ttotalCount = Math.max(totalCount ?? 0, p.totalCount);\n\t\t\t}\n\t\t},\n\t});\n\tconst { value, currentPage, requestedPageMissing } = drained;\n\tconst pageFetchFailed = drained.fetchFailed;\n\n\t// A provider that doesn't implement the search hook returns `undefined` with no error. Surface that as an\n\t// explicit unsupported warning + fetchFailed rather than a silent empty success, so a caller isn't left\n\t// unable to tell it apart from an account with no matching issues. `getSupportedFilters().issueSearch`\n\t// declares this ahead of the read, so a consumer that checks it never reaches here.\n\tif (value == null && warnings.length === 0) {\n\t\treturn refused(\n\t\t\tunsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, {\n\t\t\t\treason: 'unsupported-search',\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst items = requestedPageMissing ? [] : (value?.values ?? []);\n\t// Cursor-only: `hasMore` without a real cursor is a dead end, so report it as terminal-but-incomplete rather\n\t// than inviting the caller to page forever.\n\tconst continuation = resolveContinuation(\n\t\t{\n\t\t\thasMore: requestedPageMissing ? false : (value?.hasMore ?? false),\n\t\t\tcursor: requestedPageMissing ? undefined : usableCursor(value?.cursor),\n\t\t\ttruncated: drained.truncated,\n\t\t},\n\t\tundefined,\n\t);\n\tconst truncated = continuation.truncated;\n\t// Only reachable when nothing else already explained the incompleteness — and a failed page always warns\n\t// first, so a read that gets here SUCCEEDED. That is why the cause below is unconditionally `exhausted` and\n\t// `fetchFailed` is never set from here.\n\tif (truncated && warnings.length === 0) {\n\t\t// The result ceiling is the one truncation cause this read can EXPLAIN with a number, so it gets its own\n\t\t// warning carrying the total. Anything else truncated (an unusable continuation, a provider that stopped\n\t\t// advancing) falls back to the generic wording.\n\t\twarnings.push(\n\t\t\tissueSearchCapResultWarning(\n\t\t\t\toptions.providerId,\n\t\t\t\tdomain,\n\t\t\t\toptions.connectionId,\n\t\t\t\ttotalCount,\n\t\t\t\teffectiveIssueSort(options.criteria?.sort),\n\t\t\t) ??\n\t\t\t\ttruncationWarning(\n\t\t\t\t\toptions.providerId,\n\t\t\t\t\tdomain,\n\t\t\t\t\toptions.connectionId,\n\t\t\t\t\t'Issue search',\n\t\t\t\t\t// `exhausted`: this read exposes no budget the caller could raise, so nothing it could call\n\t\t\t\t\t// would return the withheld items.\n\t\t\t\t\t'exhausted',\n\t\t\t\t),\n\t\t);\n\t}\n\n\treturn {\n\t\titems: items,\n\t\twarnings: warnings,\n\t\tpage: {\n\t\t\t// Positional, per ProviderPageInfo.currentPage. A requested page past the terminal cursor is reported\n\t\t\t// as that empty page N; otherwise this read is cursor-only, so a `page` the caller didn't pair with a\n\t\t\t// cursor is never echoed.\n\t\t\tcurrentPage: requestedPageMissing\n\t\t\t\t? page\n\t\t\t\t: resolveCurrentPage({\n\t\t\t\t\t\tproviderPage: currentPage,\n\t\t\t\t\t\trequestedPage: page,\n\t\t\t\t\t\tsuppliedCursor: options.cursor,\n\t\t\t\t\t\tpageAdvanceable: false,\n\t\t\t\t\t}),\n\t\t\titemsPerPage: items.length,\n\t\t\ttruncated: truncated || undefined,\n\t\t},\n\t\thasMore: continuation.hasMore,\n\t\tcursor: continuation.cursor,\n\t\tfetchFailed: pageFetchFailed || undefined,\n\t};\n}\n"],"mappings":"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"}

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

@@ -1,8 +1,9 @@
-import type { PullRequestSearchCriteria, PullRequestShape } from '../../../git/models/pullRequest.js';
-import type { IntegrationIds } from '../constants.js';
-import type { ProviderReposInput } from '../providers/models.js';
-import type { ProviderPagedResult } from '../results.js';
-import type { ProviderReadContext } from './context.js';
+import { PullRequestSearchCriteria, PullRequestShape } from "../../../git/models/pullRequest.js";
+import { IntegrationIds } from "../constants.js";
+import { ProviderPagedResult } from "../results.js";
+import { ProviderReposInput } from "../providers/models.js";
+import { ProviderReadContext } from "./context.js";
+//#region ../plus/integrations/src/reads/searchPullRequests.d.ts
 /**
  * Pull requests matching structured criteria over a repository/organization or current-user relationship scope.
  *
@@ -13,18 +14,19 @@ import type { ProviderReadContext } from './context.js';
  * names the order the reachable window was selected under.
  */
 export declare function searchPullRequestsPage(ctx: ProviderReadContext, options: {
-    providerId: IntegrationIds;
-    repos?: ProviderReposInput;
-    org?: string;
-    criteria?: PullRequestSearchCriteria;
-    page?: number;
-    cursor?: string;
-    /** Per relationship × state facet, not per page; see {@link IntegrationManager.searchPullRequestsPage}. */
-    itemsPerPage?: number;
-    forceSync?: boolean;
-    connectionId?: string;
-    domain?: string;
-    /** See {@link IntegrationManager.searchPullRequestsPage}. */
-    summary?: boolean;
+  providerId: IntegrationIds;
+  repos?: ProviderReposInput;
+  org?: string;
+  criteria?: PullRequestSearchCriteria;
+  page?: number;
+  cursor?: string;
+  /** Per relationship × state facet, not per page; see {@link IntegrationManager.searchPullRequestsPage}. */
+  itemsPerPage?: number;
+  forceSync?: boolean;
+  connectionId?: string;
+  domain?: string;
+  /** See {@link IntegrationManager.searchPullRequestsPage}. */
+  summary?: boolean;
 }): Promise<ProviderPagedResult<PullRequestShape>>;
+//#endregion
 //# sourceMappingURL=searchPullRequests.d.ts.map

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

@@ -1,116 +1,94 @@
-import { defaultPullRequestSort } from '../../../git/models/pullRequest.js';
-import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
-import { runCaptured } from './drains.js';
-import { resolvePullRequestSearchCriteria, resolvePullRequestSearchScope } from './filters.js';
-import { drainFlatPagesToRequestedPage, refusedPage, resolveContinuation, resolveCurrentPage, usableCursor, } from './paging.js';
-import { gitHostOnlySurfaceWarning, otherWarning, pullRequestSearchCapResultWarning, truncationWarning, unsupportedPullRequestSearchCriteriaWarning, unusableSearchScopeMessage, } from './warnings.js';
+import "../../../git/models/pullRequest.js";
+import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain } from "../utils/integration.utils.js";
+import { drainFlatPagesToRequestedPage, refusedPage, resolveContinuation, resolveCurrentPage, usableCursor } from "./paging.js";
+import { gitHostOnlySurfaceWarning, otherWarning, pullRequestSearchCapResultWarning, truncationWarning, unsupportedPullRequestSearchCriteriaWarning, unusableSearchScopeMessage } from "./warnings.js";
+import { runCaptured } from "./drains.js";
+import { resolvePullRequestSearchCriteria, resolvePullRequestSearchScope } from "./filters.js";
+//#region ../plus/integrations/src/reads/searchPullRequests.ts
 /**
- * Pull requests matching structured criteria over a repository/organization or current-user relationship scope.
- *
- * The read is deliberately separate from `listPullRequestsPage`: the list has provider-specific "my PRs"
- * semantics and no text channel, while this method promises a sanitized query, an ordering the caller chooses
- * (`criteria.sort`, defaulting to most-recently-updated-first) and that is applied to the merged page as a whole,
- * one upstream request per cursor-threaded page, and a quantified omission at the provider's result ceiling that
- * names the order the reachable window was selected under.
- */
-export async function searchPullRequestsPage(ctx, options) {
-    const page = Math.max(1, Math.trunc(options.page ?? 1));
-    const refused = (warning) => refusedPage(1, [warning], true);
-    if (isIssuesHostIntegrationId(options.providerId)) {
-        return refused(gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Filtered pull request search'));
-    }
-    const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
-    if (integration == null) {
-        const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
-        return refusedPage(1, early.warnings, early.fetchFailed);
-    }
-    if (!isGitHostIntegration(integration)) {
-        return refused(gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Filtered pull request search'));
-    }
-    await ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);
-    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
-    const warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);
-    const resolved = resolvePullRequestSearchCriteria(options.providerId, options.criteria);
-    if (resolved.rejection != null) {
-        return refused(unsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, resolved.rejection));
-    }
-    const scope = resolvePullRequestSearchScope(options.providerId, options.repos, options.org, options.criteria);
-    switch (scope.rejection?.reason) {
-        case 'unscoped':
-            return refused(otherWarning(options.providerId, domain, options.connectionId, 'A filtered pull request search must be scoped: pass `repos`, `org`, or at least one current-user relationship.'));
-        case 'repo-ids':
-            return refused(otherWarning(options.providerId, domain, options.connectionId, 'A filtered pull request search cannot be scoped by repository id; pass repository descriptors (namespace + name) instead.'));
-        case 'unsupported-repository-scope':
-        case 'unsupported-organization-scope':
-            return refused(unsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, {
-                reason: 'unsupported-criteria',
-                criteria: [
-                    scope.rejection.reason === 'unsupported-repository-scope'
-                        ? 'repositoryScope'
-                        : 'organizationScope',
-                ],
-            }));
-        // A scope the query cannot spell, refused rather than sanitized — see `isUsableSearchScopeName`.
-        case 'unusable-scope':
-            return refused(otherWarning(options.providerId, domain, options.connectionId, unusableSearchScopeMessage('pull request search scopes', scope.rejection.scopes)));
-    }
-    const readPage = (cursor) => runCaptured(options.providerId, domain, options.connectionId, () => integration.searchPullRequestsPageResult({
-        repos: scope.repos,
-        org: options.org,
-        criteria: options.criteria,
-        cursor: cursor,
-        pageSize: options.itemsPerPage,
-        summary: options.summary,
-    }, undefined, options.connectionId), { warnOnMissingSession: warnOnMissingSession });
-    const first = await readPage(options.cursor);
-    const warnings = first.warning != null ? [first.warning] : [];
-    let totalCount = first.value?.totalCount;
-    const drained = await drainFlatPagesToRequestedPage(first, {
-        requestedPage: page,
-        suppliedCursor: options.cursor,
-        warnings: warnings,
-        readPage: readPage,
-        fold: p => {
-            if (p.totalCount != null) {
-                totalCount = Math.max(totalCount ?? 0, p.totalCount);
-            }
-        },
-    });
-    const { value, currentPage, requestedPageMissing } = drained;
-    if (value == null && warnings.length === 0) {
-        return refused(unsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, {
-            reason: 'unsupported-search',
-        }));
-    }
-    const items = requestedPageMissing ? [] : (value?.values ?? []);
-    const continuation = resolveContinuation({
-        hasMore: requestedPageMissing ? false : (value?.hasMore ?? false),
-        cursor: requestedPageMissing ? undefined : usableCursor(value?.cursor),
-        truncated: drained.truncated,
-    }, undefined);
-    const truncated = continuation.truncated;
-    if (truncated && warnings.length === 0) {
-        warnings.push(pullRequestSearchCapResultWarning(options.providerId, domain, options.connectionId, totalCount, options.criteria?.sort ?? defaultPullRequestSort) ??
-            truncationWarning(options.providerId, domain, options.connectionId, 'Pull request search', 'exhausted'));
-    }
-    return {
-        items: items,
-        warnings: warnings,
-        page: {
-            currentPage: requestedPageMissing
-                ? page
-                : resolveCurrentPage({
-                    providerPage: currentPage,
-                    requestedPage: page,
-                    suppliedCursor: options.cursor,
-                    pageAdvanceable: false,
-                }),
-            itemsPerPage: items.length,
-            truncated: truncated || undefined,
-        },
-        hasMore: continuation.hasMore,
-        cursor: continuation.cursor,
-        fetchFailed: drained.fetchFailed || undefined,
-    };
+* Pull requests matching structured criteria over a repository/organization or current-user relationship scope.
+*
+* The read is deliberately separate from `listPullRequestsPage`: the list has provider-specific "my PRs"
+* semantics and no text channel, while this method promises a sanitized query, an ordering the caller chooses
+* (`criteria.sort`, defaulting to most-recently-updated-first) and that is applied to the merged page as a whole,
+* one upstream request per cursor-threaded page, and a quantified omission at the provider's result ceiling that
+* names the order the reachable window was selected under.
+*/
+async function searchPullRequestsPage(ctx, options) {
+	const page = Math.max(1, Math.trunc(options.page ?? 1));
+	const refused = (warning) => refusedPage(1, [warning], true);
+	if (isIssuesHostIntegrationId(options.providerId)) return refused(gitHostOnlySurfaceWarning(options.providerId, void 0, options.connectionId, "Filtered pull request search"));
+	const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
+	if (integration == null) {
+		const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
+		return refusedPage(1, early.warnings, early.fetchFailed);
+	}
+	if (!isGitHostIntegration(integration)) return refused(gitHostOnlySurfaceWarning(options.providerId, void 0, options.connectionId, "Filtered pull request search"));
+	await ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);
+	const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
+	const warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);
+	const resolved = resolvePullRequestSearchCriteria(options.providerId, options.criteria);
+	if (resolved.rejection != null) return refused(unsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, resolved.rejection));
+	const scope = resolvePullRequestSearchScope(options.providerId, options.repos, options.org, options.criteria);
+	switch (scope.rejection?.reason) {
+		case "unscoped": return refused(otherWarning(options.providerId, domain, options.connectionId, "A filtered pull request search must be scoped: pass `repos`, `org`, or at least one current-user relationship."));
+		case "repo-ids": return refused(otherWarning(options.providerId, domain, options.connectionId, "A filtered pull request search cannot be scoped by repository id; pass repository descriptors (namespace + name) instead."));
+		case "unsupported-repository-scope":
+		case "unsupported-organization-scope": return refused(unsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, {
+			reason: "unsupported-criteria",
+			criteria: [scope.rejection.reason === "unsupported-repository-scope" ? "repositoryScope" : "organizationScope"]
+		}));
+		case "unusable-scope": return refused(otherWarning(options.providerId, domain, options.connectionId, unusableSearchScopeMessage("pull request search scopes", scope.rejection.scopes)));
+	}
+	const readPage = (cursor) => runCaptured(options.providerId, domain, options.connectionId, () => integration.searchPullRequestsPageResult({
+		repos: scope.repos,
+		org: options.org,
+		criteria: options.criteria,
+		cursor,
+		pageSize: options.itemsPerPage,
+		summary: options.summary
+	}, void 0, options.connectionId), { warnOnMissingSession });
+	const first = await readPage(options.cursor);
+	const warnings = first.warning != null ? [first.warning] : [];
+	let totalCount = first.value?.totalCount;
+	const drained = await drainFlatPagesToRequestedPage(first, {
+		requestedPage: page,
+		suppliedCursor: options.cursor,
+		warnings,
+		readPage,
+		fold: (p) => {
+			if (p.totalCount != null) totalCount = Math.max(totalCount ?? 0, p.totalCount);
+		}
+	});
+	const { value, currentPage, requestedPageMissing } = drained;
+	if (value == null && warnings.length === 0) return refused(unsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, { reason: "unsupported-search" }));
+	const items = requestedPageMissing ? [] : value?.values ?? [];
+	const continuation = resolveContinuation({
+		hasMore: requestedPageMissing ? false : value?.hasMore ?? false,
+		cursor: requestedPageMissing ? void 0 : usableCursor(value?.cursor),
+		truncated: drained.truncated
+	}, void 0);
+	const truncated = continuation.truncated;
+	if (truncated && warnings.length === 0) warnings.push(pullRequestSearchCapResultWarning(options.providerId, domain, options.connectionId, totalCount, options.criteria?.sort ?? "updated:desc") ?? truncationWarning(options.providerId, domain, options.connectionId, "Pull request search", "exhausted"));
+	return {
+		items,
+		warnings,
+		page: {
+			currentPage: requestedPageMissing ? page : resolveCurrentPage({
+				providerPage: currentPage,
+				requestedPage: page,
+				suppliedCursor: options.cursor,
+				pageAdvanceable: false
+			}),
+			itemsPerPage: items.length,
+			truncated: truncated || void 0
+		},
+		hasMore: continuation.hasMore,
+		cursor: continuation.cursor,
+		fetchFailed: drained.fetchFailed || void 0
+	};
 }
+//#endregion
+export { searchPullRequestsPage };
+
 //# sourceMappingURL=searchPullRequests.js.map