@gitkraken/core-gitlens 0.6.0 → 0.7.1

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

@@ -1,116 +1,100 @@
-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 { mergeAssessmentInto } from "../collectionMetadata.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;
+	let lastMetadata = first.value?.metadata;
+	let limitReached = first.value?.limitReached === true;
+	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);
+			lastMetadata = p.metadata;
+			limitReached ||= p.limitReached === true;
+		}
+	});
+	const { value, currentPage, requestedPageMissing } = drained;
+	const assessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, lastMetadata);
+	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 || assessment.truncated;
+	if (truncated && warnings.length === 0) warnings.push(pullRequestSearchCapResultWarning(options.providerId, domain, options.connectionId, totalCount, options.criteria?.sort ?? "updated:desc", limitReached) ?? 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 || assessment.fetchFailed || void 0
+	};
 }
+//#endregion
+export { searchPullRequestsPage };
+
 //# sourceMappingURL=searchPullRequests.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"searchPullRequests.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/searchPullRequests.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"searchPullRequests.js","names":[],"sources":["../../../../../plus/integrations/src/reads/searchPullRequests.ts"],"sourcesContent":["import type { PullRequestSearchCriteria, PullRequestShape } from '@gitlens/git/models/pullRequest.js';\nimport { defaultPullRequestSort } from '@gitlens/git/models/pullRequest.js';\nimport { mergeAssessmentInto } from '../collectionMetadata.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 { resolvePullRequestSearchCriteria, resolvePullRequestSearchScope } from './filters.js';\nimport {\n\tdrainFlatPagesToRequestedPage,\n\trefusedPage,\n\tresolveContinuation,\n\tresolveCurrentPage,\n\tusableCursor,\n} from './paging.js';\nimport {\n\tgitHostOnlySurfaceWarning,\n\totherWarning,\n\tpullRequestSearchCapResultWarning,\n\ttruncationWarning,\n\tunsupportedPullRequestSearchCriteriaWarning,\n\tunusableSearchScopeMessage,\n} from './warnings.js';\n\n/**\n * Pull requests matching structured criteria over a repository/organization or current-user relationship scope.\n *\n * The read is deliberately separate from `listPullRequestsPage`: the list has provider-specific \"my PRs\"\n * semantics and no text channel, while this method promises a sanitized query, an ordering the caller chooses\n * (`criteria.sort`, defaulting to most-recently-updated-first) and that is applied to the merged page as a whole,\n * one upstream request per cursor-threaded page, and a quantified omission at the provider's result ceiling that\n * names the order the reachable window was selected under.\n */\nexport async function searchPullRequestsPage(\n\tctx: ProviderReadContext,\n\toptions: {\n\t\tproviderId: IntegrationIds;\n\t\trepos?: ProviderReposInput;\n\t\torg?: string;\n\t\tcriteria?: PullRequestSearchCriteria;\n\t\tpage?: number;\n\t\tcursor?: string;\n\t\t/** Per relationship × state facet, not per page; see {@link IntegrationManager.searchPullRequestsPage}. */\n\t\titemsPerPage?: number;\n\t\tforceSync?: boolean;\n\t\tconnectionId?: string;\n\t\tdomain?: string;\n\t\t/** See {@link IntegrationManager.searchPullRequestsPage}. */\n\t\tsummary?: boolean;\n\t},\n): Promise<ProviderPagedResult<PullRequestShape>> {\n\tconst page = Math.max(1, Math.trunc(options.page ?? 1));\n\tconst refused = (warning: ProviderWarning) => refusedPage<PullRequestShape>(1, [warning], true);\n\n\tif (isIssuesHostIntegrationId(options.providerId)) {\n\t\treturn refused(\n\t\t\tgitHostOnlySurfaceWarning(\n\t\t\t\toptions.providerId,\n\t\t\t\tundefined,\n\t\t\t\toptions.connectionId,\n\t\t\t\t'Filtered pull request search',\n\t\t\t),\n\t\t);\n\t}\n\n\tconst integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);\n\tif (integration == null) {\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(\n\t\t\t\toptions.providerId,\n\t\t\t\tundefined,\n\t\t\t\toptions.connectionId,\n\t\t\t\t'Filtered pull request search',\n\t\t\t),\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\tconst resolved = resolvePullRequestSearchCriteria(options.providerId, options.criteria);\n\tif (resolved.rejection != null) {\n\t\treturn refused(\n\t\t\tunsupportedPullRequestSearchCriteriaWarning(\n\t\t\t\toptions.providerId,\n\t\t\t\tdomain,\n\t\t\t\toptions.connectionId,\n\t\t\t\tresolved.rejection,\n\t\t\t),\n\t\t);\n\t}\n\n\tconst scope = resolvePullRequestSearchScope(options.providerId, 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 pull request search must be scoped: pass `repos`, `org`, or at least one current-user relationship.',\n\t\t\t\t),\n\t\t\t);\n\t\tcase 'repo-ids':\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 pull request search cannot be scoped by repository id; pass repository descriptors (namespace + name) instead.',\n\t\t\t\t),\n\t\t\t);\n\t\tcase 'unsupported-repository-scope':\n\t\tcase 'unsupported-organization-scope':\n\t\t\treturn refused(\n\t\t\t\tunsupportedPullRequestSearchCriteriaWarning(options.providerId, domain, options.connectionId, {\n\t\t\t\t\treason: 'unsupported-criteria',\n\t\t\t\t\tcriteria: [\n\t\t\t\t\t\tscope.rejection.reason === 'unsupported-repository-scope'\n\t\t\t\t\t\t\t? 'repositoryScope'\n\t\t\t\t\t\t\t: 'organizationScope',\n\t\t\t\t\t],\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('pull request 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.searchPullRequestsPageResult(\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\tsummary: options.summary,\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\tlet totalCount = first.value?.totalCount;\n\t// Facets whose rows are missing while their siblings answered. A page reports the walk's completeness so far, not\n\t// just its own requests: a failure dropped for good repeats on every later page, while one that recovered on a\n\t// retry drops out because its rows came back. So the latest page read is the one to assess, including when a later\n\t// page fails the walk outright — never union the pages, which would bring a recovered failure back.\n\tlet lastMetadata = first.value?.metadata;\n\tlet limitReached = first.value?.limitReached === true;\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\tlastMetadata = p.metadata;\n\t\t\tlimitReached ||= p.limitReached === true;\n\t\t},\n\t});\n\tconst { value, currentPage, requestedPageMissing } = drained;\n\tconst assessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, lastMetadata);\n\n\tif (value == null && warnings.length === 0) {\n\t\treturn refused(\n\t\t\tunsupportedPullRequestSearchCriteriaWarning(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\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\t// A facet that failed while its siblings answered leaves the result incomplete, as `listPullRequestsPage` reports\n\t// it; its warning is already in `warnings`, so it adds no generic one below.\n\tconst truncated = continuation.truncated || assessment.truncated;\n\tif (truncated && warnings.length === 0) {\n\t\twarnings.push(\n\t\t\tpullRequestSearchCapResultWarning(\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\toptions.criteria?.sort ?? defaultPullRequestSort,\n\t\t\t\tlimitReached,\n\t\t\t) ??\n\t\t\t\ttruncationWarning(options.providerId, domain, options.connectionId, 'Pull request search', 'exhausted'),\n\t\t);\n\t}\n\n\treturn {\n\t\titems: items,\n\t\twarnings: warnings,\n\t\tpage: {\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: drained.fetchFailed || assessment.fetchFailed || undefined,\n\t};\n}\n"],"mappings":"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"}

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

@@ -1,11 +1,13 @@
-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';
+import { PullRequestShape } from "../../../git/models/pullRequest.js";
+import { ProviderSweepResult } from "../results.js";
+import { ProviderReadContext } from "./context.js";
+import { ClosedPullRequestSweepOptions, PullRequestSweepOptions } from "../manager.js";
+//#region ../plus/integrations/src/reads/sweeps.d.ts
 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>>;
+//#endregion
 //# sourceMappingURL=sweeps.d.ts.map