@gitkraken/core-gitlens 0.6.0 → 0.7.1

package/dist/plus/integrations/providers/utils/providerPaging.js

@@ -1,176 +1,151 @@
-import { isCancellationError } from '../../../../utils/cancellation.js';
-import { uniqueBy } from '../../../../utils/iterable.js';
-import { throwIfCallerContractError, toCollectionScopeFailure } from '../../collectionMetadata.js';
-import { collectionScopeKey } from '../../results.js';
+import { uniqueBy } from "../../../../utils/iterable.js";
+import { isCancellationError } from "../../../../utils/cancellation.js";
+import { collectionScopeKey } from "../../results.js";
+import { throwIfCallerContractError, toCollectionScopeFailure } from "../../collectionMetadata.js";
+//#region ../plus/integrations/src/providers/utils/providerPaging.ts
 /**
- * Encodes an opaque numeric paging token as the `{ value, type: 'page' }` cursor the paging layer uses.
- * The value is whatever the consumer round-trips unchanged: a 1-based page number for numbered-page reads,
- * or a provider offset (e.g. Bitbucket Server's `nextPageStart`) that is never reinterpreted here.
- */
-export function toPageCursor(page) {
-    return JSON.stringify({ value: page, type: 'page' });
+* Encodes an opaque numeric paging token as the `{ value, type: 'page' }` cursor the paging layer uses.
+* The value is whatever the consumer round-trips unchanged: a 1-based page number for numbered-page reads,
+* or a provider offset (e.g. Bitbucket Server's `nextPageStart`) that is never reinterpreted here.
+*/
+function toPageCursor(page) {
+	return JSON.stringify({
+		value: page,
+		type: "page"
+	});
 }
 /** Extracts the numeric paging token from a `{ value, type: 'page' }` cursor; undefined when absent/malformed. */
-export function parsePageCursor(cursor) {
-    if (cursor == null || cursor === '{}')
-        return undefined;
-    try {
-        const parsed = JSON.parse(cursor);
-        if (parsed.type === 'page' && typeof parsed.value === 'number')
-            return parsed.value;
-    }
-    catch { }
-    return undefined;
+function parsePageCursor(cursor) {
+	if (cursor == null || cursor === "{}") return void 0;
+	try {
+		const parsed = JSON.parse(cursor);
+		if (parsed.type === "page" && typeof parsed.value === "number") return parsed.value;
+	} catch {}
 }
 /** Preserves successful sibling scopes, but doesn't turn an all-scope provider failure into an empty success. */
-export function throwIfAllSettledFailed(results) {
-    if (results.some(result => result.status === 'fulfilled'))
-        return;
-    const rejected = results.find((result) => result.status === 'rejected');
-    if (rejected != null)
-        throw rejected.reason;
+function throwIfAllSettledFailed(results) {
+	if (results.some((result) => result.status === "fulfilled")) return;
+	const rejected = results.find((result) => result.status === "rejected");
+	if (rejected != null) throw rejected.reason;
 }
-export function flatSettledResultsOrThrow(results) {
-    throwIfAllSettledFailed(results);
-    const fulfilled = results.filter((result) => result.status === 'fulfilled');
-    return fulfilled.flatMap(result => result.value);
+function flatSettledResultsOrThrow(results) {
+	throwIfAllSettledFailed(results);
+	return results.filter((result) => result.status === "fulfilled").flatMap((result) => result.value);
 }
-export async function flatSettledOrThrow(promises) {
-    return flatSettledResultsOrThrow(await Promise.allSettled(promises));
+async function flatSettledOrThrow(promises) {
+	return flatSettledResultsOrThrow(await Promise.allSettled(promises));
 }
 /** Precedence for merged completeness: any known omission (`partial`) wins, then inability to confirm
- * (`unknown`), and only an all-`complete` set of pages stays `complete`. */
-const completenessRank = { partial: 2, unknown: 1, complete: 0 };
+* (`unknown`), and only an all-`complete` set of pages stays `complete`. */
+const completenessRank = {
+	partial: 2,
+	unknown: 1,
+	complete: 0
+};
 /** A stable key for deduplicating structurally-identical scope failures accumulated across drained pages. */
 function collectionFailureKey(failure) {
-    return [failure.kind, collectionScopeKey(failure.scope), failure.message ?? ''].join(' ');
+	return [
+		failure.kind,
+		collectionScopeKey(failure.scope),
+		failure.message ?? ""
+	].join(" ");
 }
 /**
- * A stable key for collapsing omissions accumulated across drained pages, matching the SDK's own
- * `dedupeOmissions`: kind plus scope IDs, deliberately WITHOUT `limit`/`totalCount`.
- *
- * Those counts are a re-measurement, not an identity. GitHub recomputes the match total on every request, so
- * one repository drained over several pages reports the same cap with a drifting total; keying on the total
- * would emit a near-identical warning per page ("matched 1393…", "matched 1402…") that
- * `appendDedupedWarning` cannot collapse, since the messages genuinely differ. Independently-scoped omissions
- * still stay distinct, which is the case that carries information.
- */
+* A stable key for collapsing omissions accumulated across drained pages, matching the SDK's own
+* `dedupeOmissions`: kind plus scope IDs, deliberately WITHOUT `limit`/`totalCount`.
+*
+* Those counts are a re-measurement, not an identity. GitHub recomputes the match total on every request, so
+* one repository drained over several pages reports the same cap with a drifting total; keying on the total
+* would emit a near-identical warning per page ("matched 1393…", "matched 1402…") that
+* `appendDedupedWarning` cannot collapse, since the messages genuinely differ. Independently-scoped omissions
+* still stay distinct, which is the case that carries information.
+*/
 function collectionOmissionKey(omission) {
-    return [omission.kind, collectionScopeKey(omission.scope)].join(' ');
+	return [omission.kind, collectionScopeKey(omission.scope)].join(" ");
 }
 /**
- * Merges SDK collection metadata across drained pages. Completeness follows {@link completenessRank};
- * failures are deduplicated by kind, scope IDs, and message, and omissions are collapsed per kind and scope
- * keeping the highest reported total ({@link collectionOmissionKey}). Both preserve first-reported order.
- * Returns `undefined` when no page supplied metadata, so metadata-free providers and test doubles keep
- * behaving as before.
- */
-export function mergeCollectionMetadata(base, next) {
-    if (base == null)
-        return next;
-    if (next == null)
-        return base;
-    const completeness = completenessRank[next.completeness] > completenessRank[base.completeness]
-        ? next.completeness
-        : base.completeness;
-    // First occurrence wins: a repeated failure carries no new information, since the message is part of its key.
-    const failures = [
-        ...uniqueBy([...(base.failures ?? []), ...(next.failures ?? [])], collectionFailureKey, original => original),
-    ];
-    // Highest total wins, so re-measuring one cap across pages collapses to a single omission holding the
-    // largest figure reported for it — the same rule the SDK applies in `createCollectionMetadata`.
-    const omissions = [
-        ...uniqueBy([...(base.omissions ?? []), ...(next.omissions ?? [])], collectionOmissionKey, (original, current) => ((current.totalCount ?? -1) > (original.totalCount ?? -1) ? current : undefined)),
-    ];
-    return {
-        completeness: completeness,
-        ...(failures.length ? { failures: failures } : {}),
-        ...(omissions.length ? { omissions: omissions } : {}),
-    };
+* Merges SDK collection metadata across drained pages. Completeness follows {@link completenessRank};
+* failures are deduplicated by kind, scope IDs, and message, and omissions are collapsed per kind and scope
+* keeping the highest reported total ({@link collectionOmissionKey}). Both preserve first-reported order.
+* Returns `undefined` when no page supplied metadata, so metadata-free providers and test doubles keep
+* behaving as before.
+*/
+function mergeCollectionMetadata(base, next) {
+	if (base == null) return next;
+	if (next == null) return base;
+	const completeness = completenessRank[next.completeness] > completenessRank[base.completeness] ? next.completeness : base.completeness;
+	const failures = [...uniqueBy([...base.failures ?? [], ...next.failures ?? []], collectionFailureKey, (original) => original)];
+	const omissions = [...uniqueBy([...base.omissions ?? [], ...next.omissions ?? []], collectionOmissionKey, (original, current) => (current.totalCount ?? -1) > (original.totalCount ?? -1) ? current : void 0)];
+	return {
+		completeness,
+		...failures.length ? { failures } : {},
+		...omissions.length ? { omissions } : {}
+	};
 }
 /**
- * Drains a provider paged fetcher into a single result while preserving enough metadata to
- * signal whether the defensive backstop interrupted the drain, and merging SDK collection metadata
- * ({@link mergeCollectionMetadata}) across the fetched pages.
- *
- * The local `truncated` flag and SDK `metadata` are distinct facts: a page-drain backstop must remain visible
- * even if every fetched page reported `complete`, and SDK incompleteness is preserved even when the drain
- * finished within its page budget.
- */
-export async function collectProviderPagedResult(fetch, maxPages = 20, scope) {
-    const values = [];
-    let cursor;
-    let metadata;
-    let truncated = false;
-    // Omit `metadata` entirely when no page supplied it, so a metadata-free drain stays deep-equal to its
-    // pre-metadata shape (and consumers never see an explicit `undefined`).
-    const build = (extra) => {
-        const mergedMetadata = extra?.metadata ?? metadata;
-        return {
-            values: values,
-            ...extra,
-            ...(truncated || extra?.truncated === true ? { truncated: true } : {}),
-            ...(mergedMetadata != null ? { metadata: mergedMetadata } : {}),
-        };
-    };
-    for (let page = 0; page < maxPages; page++) {
-        let result;
-        try {
-            result = await fetch(cursor);
-        }
-        catch (ex) {
-            if (isCancellationError(ex))
-                throw ex;
-            // A caller-contract error is not a fact about this scope, so it is never recorded as one — see
-            // `throwIfCallerContractError`. Checked alongside cancellation because both are errors that a
-            // per-scope failure would misdescribe.
-            throwIfCallerContractError(ex);
-            // When the caller supplied a scope, preserve the items already fetched from that scope and record the
-            // failure in collection metadata rather than re-throwing and discarding the prefix. Callers without a
-            // scope keep the legacy throw behavior.
-            if (scope == null)
-                throw ex;
-            return build({
-                truncated: true,
-                metadata: mergeCollectionMetadata(metadata, {
-                    completeness: 'partial',
-                    failures: [toCollectionScopeFailure(scope, ex)],
-                }),
-            });
-        }
-        if (result == null) {
-            if (page === 0)
-                return build();
-            return build({
-                truncated: true,
-                ...(scope != null
-                    ? {
-                        metadata: mergeCollectionMetadata(metadata, {
-                            completeness: 'partial',
-                            failures: [
-                                toCollectionScopeFailure(scope, new Error('Provider returned no page after advertising a continuation')),
-                            ],
-                        }),
-                    }
-                    : undefined),
-            });
-        }
-        values.push(...result.values);
-        metadata = mergeCollectionMetadata(metadata, result.metadata);
-        truncated ||= result.paging?.truncated === true;
-        if (!result.paging?.more)
-            return build();
-        if (result.paging.cursor === cursor) {
-            return build({ truncated: true });
-        }
-        cursor = result.paging.cursor;
-        if (cursor == null || cursor === '{}') {
-            return build({ truncated: true });
-        }
-        if (page === maxPages - 1) {
-            return build({ paging: result.paging, truncated: true });
-        }
-    }
-    return build();
+* Drains a provider paged fetcher into a single result while preserving enough metadata to
+* signal whether the defensive backstop interrupted the drain, and merging SDK collection metadata
+* ({@link mergeCollectionMetadata}) across the fetched pages.
+*
+* The local `truncated` flag and SDK `metadata` are distinct facts: a page-drain backstop must remain visible
+* even if every fetched page reported `complete`, and SDK incompleteness is preserved even when the drain
+* finished within its page budget.
+*/
+async function collectProviderPagedResult(fetch, maxPages = 20, scope) {
+	const values = [];
+	let cursor;
+	let metadata;
+	let truncated = false;
+	const build = (extra) => {
+		const mergedMetadata = extra?.metadata ?? metadata;
+		return {
+			values,
+			...extra,
+			...truncated || extra?.truncated === true ? { truncated: true } : {},
+			...mergedMetadata != null ? { metadata: mergedMetadata } : {}
+		};
+	};
+	for (let page = 0; page < maxPages; page++) {
+		let result;
+		try {
+			result = await fetch(cursor);
+		} catch (ex) {
+			if (isCancellationError(ex)) throw ex;
+			throwIfCallerContractError(ex);
+			if (scope == null) throw ex;
+			return build({
+				truncated: true,
+				metadata: mergeCollectionMetadata(metadata, {
+					completeness: "partial",
+					failures: [toCollectionScopeFailure(scope, ex)]
+				})
+			});
+		}
+		if (result == null) {
+			if (page === 0) return build();
+			return build({
+				truncated: true,
+				...scope != null ? { metadata: mergeCollectionMetadata(metadata, {
+					completeness: "partial",
+					failures: [toCollectionScopeFailure(scope, /* @__PURE__ */ new Error("Provider returned no page after advertising a continuation"))]
+				}) } : void 0
+			});
+		}
+		values.push(...result.values);
+		metadata = mergeCollectionMetadata(metadata, result.metadata);
+		truncated ||= result.paging?.truncated === true;
+		if (!result.paging?.more) return build();
+		if (result.paging.cursor === cursor) return build({ truncated: true });
+		cursor = result.paging.cursor;
+		if (cursor == null || cursor === "{}") return build({ truncated: true });
+		if (page === maxPages - 1) return build({
+			paging: result.paging,
+			truncated: true
+		});
+	}
+	return build();
 }
+//#endregion
+export { collectProviderPagedResult, flatSettledOrThrow, flatSettledResultsOrThrow, mergeCollectionMetadata, parsePageCursor, throwIfAllSettledFailed, toPageCursor };
+
 //# sourceMappingURL=providerPaging.js.map

package/dist/plus/integrations/providers/utils/providerPaging.js.map

@@ -1 +1 @@
-{"version":3,"file":"providerPaging.js","sourceRoot":"","sources":["../../../../../src/plus/integrations/providers/utils/providerPaging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"providerPaging.js","names":[],"sources":["../../../../../../plus/integrations/src/providers/utils/providerPaging.ts"],"sourcesContent":["import type {\n\tCollectionCompleteness,\n\tCollectionMetadata,\n\tCollectionOmission,\n\tCollectionScopeFailure,\n} from '@gitkraken/provider-apis';\nimport { isCancellationError } from '@gitlens/utils/cancellation.js';\nimport { uniqueBy } from '@gitlens/utils/iterable.js';\nimport { throwIfCallerContractError, toCollectionScopeFailure } from '../../collectionMetadata.js';\nimport { collectionScopeKey } from '../../results.js';\nimport type { ProviderApiPagedResult, ProviderHierarchyResult } from '../models.js';\n\n/**\n * Encodes an opaque numeric paging token as the `{ value, type: 'page' }` cursor the paging layer uses.\n * The value is whatever the consumer round-trips unchanged: a 1-based page number for numbered-page reads,\n * or a provider offset (e.g. Bitbucket Server's `nextPageStart`) that is never reinterpreted here.\n */\nexport function toPageCursor(page: number): string {\n\treturn JSON.stringify({ value: page, type: 'page' });\n}\n\n/** Extracts the numeric paging token from a `{ value, type: 'page' }` cursor; undefined when absent/malformed. */\nexport function parsePageCursor(cursor: string | undefined): number | undefined {\n\tif (cursor == null || cursor === '{}') return undefined;\n\n\ttry {\n\t\tconst parsed = JSON.parse(cursor) as { value?: unknown; type?: unknown };\n\t\tif (parsed.type === 'page' && typeof parsed.value === 'number') return parsed.value;\n\t} catch {}\n\n\treturn undefined;\n}\n\n/** Preserves successful sibling scopes, but doesn't turn an all-scope provider failure into an empty success. */\nexport function throwIfAllSettledFailed<T>(results: PromiseSettledResult<T>[]): void {\n\tif (results.some(result => result.status === 'fulfilled')) return;\n\n\tconst rejected = results.find((result): result is PromiseRejectedResult => result.status === 'rejected');\n\tif (rejected != null) throw rejected.reason;\n}\n\nexport function flatSettledResultsOrThrow<T>(results: PromiseSettledResult<T[]>[]): T[] {\n\tthrowIfAllSettledFailed(results);\n\n\tconst fulfilled = results.filter((result): result is PromiseFulfilledResult<T[]> => result.status === 'fulfilled');\n\treturn fulfilled.flatMap(result => result.value);\n}\n\nexport async function flatSettledOrThrow<T>(promises: Promise<T[]>[]): Promise<T[]> {\n\treturn flatSettledResultsOrThrow(await Promise.allSettled(promises));\n}\n\n/** Precedence for merged completeness: any known omission (`partial`) wins, then inability to confirm\n * (`unknown`), and only an all-`complete` set of pages stays `complete`. */\nconst completenessRank: Record<CollectionCompleteness, number> = { partial: 2, unknown: 1, complete: 0 };\n\n/** A stable key for deduplicating structurally-identical scope failures accumulated across drained pages. */\nfunction collectionFailureKey(failure: CollectionScopeFailure): string {\n\treturn [failure.kind, collectionScopeKey(failure.scope), failure.message ?? ''].join(' ');\n}\n\n/**\n * A stable key for collapsing omissions accumulated across drained pages, matching the SDK's own\n * `dedupeOmissions`: kind plus scope IDs, deliberately WITHOUT `limit`/`totalCount`.\n *\n * Those counts are a re-measurement, not an identity. GitHub recomputes the match total on every request, so\n * one repository drained over several pages reports the same cap with a drifting total; keying on the total\n * would emit a near-identical warning per page (\"matched 1393…\", \"matched 1402…\") that\n * `appendDedupedWarning` cannot collapse, since the messages genuinely differ. Independently-scoped omissions\n * still stay distinct, which is the case that carries information.\n */\nfunction collectionOmissionKey(omission: CollectionOmission): string {\n\treturn [omission.kind, collectionScopeKey(omission.scope)].join(' ');\n}\n\n/**\n * Merges SDK collection metadata across drained pages. Completeness follows {@link completenessRank};\n * failures are deduplicated by kind, scope IDs, and message, and omissions are collapsed per kind and scope\n * keeping the highest reported total ({@link collectionOmissionKey}). Both preserve first-reported order.\n * Returns `undefined` when no page supplied metadata, so metadata-free providers and test doubles keep\n * behaving as before.\n */\nexport function mergeCollectionMetadata(\n\tbase: CollectionMetadata | undefined,\n\tnext: CollectionMetadata | undefined,\n): CollectionMetadata | undefined {\n\tif (base == null) return next;\n\tif (next == null) return base;\n\n\tconst completeness =\n\t\tcompletenessRank[next.completeness] > completenessRank[base.completeness]\n\t\t\t? next.completeness\n\t\t\t: base.completeness;\n\n\t// First occurrence wins: a repeated failure carries no new information, since the message is part of its key.\n\tconst failures = [\n\t\t...uniqueBy([...(base.failures ?? []), ...(next.failures ?? [])], collectionFailureKey, original => original),\n\t];\n\t// Highest total wins, so re-measuring one cap across pages collapses to a single omission holding the\n\t// largest figure reported for it — the same rule the SDK applies in `createCollectionMetadata`.\n\tconst omissions = [\n\t\t...uniqueBy(\n\t\t\t[...(base.omissions ?? []), ...(next.omissions ?? [])],\n\t\t\tcollectionOmissionKey,\n\t\t\t(original, current) => ((current.totalCount ?? -1) > (original.totalCount ?? -1) ? current : undefined),\n\t\t),\n\t];\n\n\treturn {\n\t\tcompleteness: completeness,\n\t\t...(failures.length ? { failures: failures } : {}),\n\t\t...(omissions.length ? { omissions: omissions } : {}),\n\t};\n}\n\n/**\n * Drains a provider paged fetcher into a single result while preserving enough metadata to\n * signal whether the defensive backstop interrupted the drain, and merging SDK collection metadata\n * ({@link mergeCollectionMetadata}) across the fetched pages.\n *\n * The local `truncated` flag and SDK `metadata` are distinct facts: a page-drain backstop must remain visible\n * even if every fetched page reported `complete`, and SDK incompleteness is preserved even when the drain\n * finished within its page budget.\n */\nexport async function collectProviderPagedResult<T>(\n\tfetch: (cursor: string | undefined) => Promise<ProviderApiPagedResult<T> | undefined>,\n\tmaxPages = 20,\n\tscope?: CollectionScopeFailure['scope'],\n): Promise<ProviderHierarchyResult<T>> {\n\tconst values: NonNullable<T>[] = [];\n\tlet cursor: string | undefined;\n\tlet metadata: CollectionMetadata | undefined;\n\tlet truncated = false;\n\n\t// Omit `metadata` entirely when no page supplied it, so a metadata-free drain stays deep-equal to its\n\t// pre-metadata shape (and consumers never see an explicit `undefined`).\n\tconst build = (extra?: Partial<ProviderHierarchyResult<T>>): ProviderHierarchyResult<T> => {\n\t\tconst mergedMetadata = extra?.metadata ?? metadata;\n\t\treturn {\n\t\t\tvalues: values,\n\t\t\t...extra,\n\t\t\t...(truncated || extra?.truncated === true ? { truncated: true } : {}),\n\t\t\t...(mergedMetadata != null ? { metadata: mergedMetadata } : {}),\n\t\t};\n\t};\n\n\tfor (let page = 0; page < maxPages; page++) {\n\t\tlet result: ProviderApiPagedResult<T> | undefined;\n\t\ttry {\n\t\t\tresult = await fetch(cursor);\n\t\t} catch (ex) {\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\t// A caller-contract error is not a fact about this scope, so it is never recorded as one — see\n\t\t\t// `throwIfCallerContractError`. Checked alongside cancellation because both are errors that a\n\t\t\t// per-scope failure would misdescribe.\n\t\t\tthrowIfCallerContractError(ex);\n\n\t\t\t// When the caller supplied a scope, preserve the items already fetched from that scope and record the\n\t\t\t// failure in collection metadata rather than re-throwing and discarding the prefix. Callers without a\n\t\t\t// scope keep the legacy throw behavior.\n\t\t\tif (scope == null) throw ex;\n\t\t\treturn build({\n\t\t\t\ttruncated: true,\n\t\t\t\tmetadata: mergeCollectionMetadata(metadata, {\n\t\t\t\t\tcompleteness: 'partial',\n\t\t\t\t\tfailures: [toCollectionScopeFailure(scope, ex)],\n\t\t\t\t}),\n\t\t\t});\n\t\t}\n\t\tif (result == null) {\n\t\t\tif (page === 0) return build();\n\n\t\t\treturn build({\n\t\t\t\ttruncated: true,\n\t\t\t\t...(scope != null\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tmetadata: mergeCollectionMetadata(metadata, {\n\t\t\t\t\t\t\t\tcompleteness: 'partial',\n\t\t\t\t\t\t\t\tfailures: [\n\t\t\t\t\t\t\t\t\ttoCollectionScopeFailure(\n\t\t\t\t\t\t\t\t\t\tscope,\n\t\t\t\t\t\t\t\t\t\tnew Error('Provider returned no page after advertising a continuation'),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t}\n\t\t\t\t\t: undefined),\n\t\t\t});\n\t\t}\n\n\t\tvalues.push(...result.values);\n\t\tmetadata = mergeCollectionMetadata(metadata, result.metadata);\n\t\ttruncated ||= result.paging?.truncated === true;\n\n\t\tif (!result.paging?.more) return build();\n\n\t\tif (result.paging.cursor === cursor) {\n\t\t\treturn build({ truncated: true });\n\t\t}\n\n\t\tcursor = result.paging.cursor;\n\t\tif (cursor == null || cursor === '{}') {\n\t\t\treturn build({ truncated: true });\n\t\t}\n\t\tif (page === maxPages - 1) {\n\t\t\treturn build({ paging: result.paging, truncated: true });\n\t\t}\n\t}\n\n\treturn build();\n}\n"],"mappings":"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"}

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

@@ -1,30 +1,31 @@
-import type { AnyEntityIdentifierInput, EntityIdentifier } from '@gitkraken/provider-apis';
-import type { Issue, IssueShape } from '../../../git/models/issue.js';
-import type { PullRequest } from '../../../git/models/pullRequest.js';
-import type { IssueResourceDescriptor, RepositoryDescriptor, ResourceDescriptor } from '../../../git/models/resourceDescriptor.js';
-import type { IntegrationIds } from '../constants.js';
-import type { AzureProjectInputDescriptor } from './azure/models.js';
-import type { GitConfigEntityIdentifier } from './models.js';
+import { IssueResourceDescriptor, RepositoryDescriptor, ResourceDescriptor } from "../../../git/models/resourceDescriptor.js";
+import { Issue as Issue$1, IssueShape } from "../../../git/models/issue.js";
+import { PullRequest } from "../../../git/models/pullRequest.js";
+import { IntegrationIds } from "../constants.js";
+import { GitConfigEntityIdentifier } from "./models.js";
+import { AzureProjectInputDescriptor } from "./azure/models.js";
+import { AnyEntityIdentifierInput, EntityIdentifier } from "@gitkraken/provider-apis";
+//#region ../plus/integrations/src/providers/utils.d.ts
 export declare const EntityIdentifierProviderType: {
-    readonly Azure: 'azure';
-    readonly AzureDevOpsServer: 'azureDevOpsServer';
-    readonly Github: 'github';
-    readonly GithubEnterprise: 'githubEnterprise';
-    readonly Gitlab: 'gitlab';
-    readonly GitlabSelfHosted: 'gitlabSelfHosted';
-    readonly Bitbucket: 'bitbucket';
-    readonly BitbucketServer: 'bitbucketServer';
-    readonly Jira: 'jira';
-    readonly JiraServer: 'jiraServer';
-    readonly Linear: 'linear';
-    readonly Trello: 'trello';
+  readonly Azure: 'azure';
+  readonly AzureDevOpsServer: 'azureDevOpsServer';
+  readonly Github: 'github';
+  readonly GithubEnterprise: 'githubEnterprise';
+  readonly Gitlab: 'gitlab';
+  readonly GitlabSelfHosted: 'gitlabSelfHosted';
+  readonly Bitbucket: 'bitbucket';
+  readonly BitbucketServer: 'bitbucketServer';
+  readonly Jira: 'jira';
+  readonly JiraServer: 'jiraServer';
+  readonly Linear: 'linear';
+  readonly Trello: 'trello';
 };
 export declare const EntityType: {
-    readonly PullRequest: 'pr';
-    readonly Issue: 'issue';
+  readonly PullRequest: 'pr';
+  readonly Issue: 'issue';
 };
 export declare const EntityVersion: {
-    readonly One: '1';
+  readonly One: '1';
 };
 /**
  * Forward-compatible structural shape of the host's `LaunchpadItem`. The package
@@ -33,43 +34,54 @@ export declare const EntityVersion: {
  * many more fields. The declared shape only includes fields integrations inspect.
  */
 type LaunchpadItem = {
-    uuid: string;
-    type: 'issue' | 'pullrequest';
-    graphQLId?: string;
-    provider: {
-        id: string;
-        domain?: string;
+  uuid: string;
+  type: 'issue' | 'pullrequest';
+  graphQLId?: string;
+  provider: {
+    id: string;
+    domain?: string;
+  };
+  underlyingPullRequest?: {
+    id: string;
+    project?: {
+      id: string;
+      resourceName?: string;
     };
-    underlyingPullRequest?: {
-        id: string;
-        project?: {
-            id: string;
-            resourceName?: string;
-        };
-        repository?: {
-            id?: string;
-        };
+    repository?: {
+      id?: string;
     };
+  };
 };
-export declare function getEntityIdentifierInput(entity: Issue | PullRequest | LaunchpadItem): AnyEntityIdentifierInput;
+export declare function getEntityIdentifierInput(entity: Issue$1 | PullRequest | LaunchpadItem): AnyEntityIdentifierInput;
 export declare function getProviderIdFromEntityIdentifier(entityIdentifier: EntityIdentifier | AnyEntityIdentifierInput | GitConfigEntityIdentifier): IntegrationIds | undefined;
-export declare function encodeIssueOrPullRequestForGitConfig(entity: Issue | PullRequest, owner: RepositoryDescriptor | IssueResourceDescriptor): GitConfigEntityIdentifier;
+export declare function encodeIssueOrPullRequestForGitConfig(entity: Issue$1 | PullRequest, owner: RepositoryDescriptor | IssueResourceDescriptor): GitConfigEntityIdentifier;
 export declare function isGitConfigEntityIdentifier(entity: unknown): entity is GitConfigEntityIdentifier;
 export declare function isGitConfigEntityIdentifiers(entities: unknown): entities is GitConfigEntityIdentifier[];
 export declare function decodeEntityIdentifiersFromGitConfig(str: string): GitConfigEntityIdentifier[];
 interface IssueResolvableIntegration {
-    getIssue(owner: unknown, id: string): Promise<Issue | undefined>;
+  getIssue(owner: unknown, id: string): Promise<Issue$1 | undefined>;
 }
-export declare function getIssueFromGitConfigEntityIdentifier(resolveIntegration: (id: IntegrationIds) => Promise<IssueResolvableIntegration | undefined>, identifier: GitConfigEntityIdentifier, options?: {
-    /** Only return a value already in the local cache. No remote fetch — returns undefined on cache miss. */
-    cached?: boolean;
-    /**
-     * Host-supplied cache reader used when {@link cached} is set. The package is cache-agnostic, so the
-     * host (which owns the cache) provides this to satisfy a cache-only read. When omitted, `cached`
-     * yields undefined rather than falling through to a remote fetch.
-     */
-    peekCachedIssue?: (integration: IssueResolvableIntegration | undefined, resource: ResourceDescriptor, id: string) => Issue | undefined;
-}): Promise<Issue | undefined>;
+/**
+ * Resolves the issue a branch association names.
+ *
+ * `resolveIntegration` receives the identifier's `domain` alongside the integration id, so a host-keyed
+ * provider resolves the instance the association was encoded for rather than whichever connection is primary
+ * (#5872). It is `undefined` for a cloud provider, which has a single host.
+ */
+export declare function getIssueFromGitConfigEntityIdentifier(resolveIntegration: (id: IntegrationIds, domain?: string) => Promise<IssueResolvableIntegration | undefined>, identifier: GitConfigEntityIdentifier, options?: {
+  /** Legacy git-host associations need configured connections to prove their host is unambiguous. */
+  getConfiguredIntegrations?: (id: IntegrationIds) => readonly {
+    domain?: string;
+  }[];
+  /** Only return a value already in the local cache. No remote fetch — returns undefined on cache miss. */
+  cached?: boolean;
+  /**
+   * Host-supplied cache reader used when {@link cached} is set. The package is cache-agnostic, so the
+   * host (which owns the cache) provides this to satisfy a cache-only read. When omitted, `cached`
+   * yields undefined rather than falling through to a remote fetch.
+   */
+  peekCachedIssue?: (integration: IssueResolvableIntegration | undefined, resource: ResourceDescriptor, id: string) => Issue$1 | undefined;
+}): Promise<Issue$1 | undefined>;
 export declare function getIssueOwner(issue: IssueShape): RepositoryDescriptor | IssueResourceDescriptor | AzureProjectInputDescriptor | undefined;
-export {};
+//#endregion
 //# sourceMappingURL=utils.d.ts.map