@gitkraken/core-gitlens 0.6.0 → 0.7.0

package/dist/plus/integrations/collectionMetadata.js

@@ -1,285 +1,235 @@
-// Matched by its `code` discriminator rather than by `instanceof`: the SDK ships one bundle per entry point, so
-// the class reached through the root is not the same object as the one reached through `/providers`.
-import { isInvalidRequestError, isUnsupportedSortError } from '@gitkraken/provider-apis';
-import { AuthenticationError, RequestClientError, RequestNotFoundError, RequestRateLimitError, } from '../../git/errors.js';
-import { isRateLimitResponse } from './errors.js';
-import { appendDedupedWarning } from './results.js';
+import { AuthenticationError, RequestClientError, RequestNotFoundError, RequestRateLimitError } from "../../git/errors.js";
+import { isRateLimitResponse } from "./errors.js";
+import { appendDedupedWarning } from "./results.js";
+import { isInvalidRequestError, isUnsupportedSortError } from "@gitkraken/provider-apis";
+//#region ../plus/integrations/src/collectionMetadata.ts
 /**
- * Re-throws an error that is a fact about the CALL rather than about one scope of a fan-out.
- *
- * Every provider fan-out catches per-scope rejections and records them as {@link CollectionScopeFailure}s, which is
- * right for auth, rate limits and a missing project: those really did happen to one scope, and the siblings that
- * succeeded must survive. A caller-contract error is the opposite — it is identical for every scope and was decided
- * before any request went out — so degrading it would hand back N indistinguishable failures and an empty `partial`
- * page, describing an invalid call as an incomplete read.
- *
- * Today that means the SDK's `UnsupportedSortError` and `InvalidRequestError` — the two codes it lists in its own
- * `CALLER_CONTRACT_ERROR_CODES`, both documented as "never degraded into a `CollectionScopeFailure` or an
- * omission". The second covers arguments rejected before the first request goes out: a project key list longer
- * than one Jira search can carry (or an empty one), a non-integer `pageSize`, an unknown current-user filter, or a
- * Jira Server read with no `baseUrl` to address. Called from every fan-out rather than spelled out in each, so a
- * fan-out added later inherits the rule instead of silently omitting it — which is exactly how Azure's
- * account-wide drain came to degrade it while its three siblings did not.
- */
-export function throwIfCallerContractError(ex) {
-    if (isUnsupportedSortError(ex) || isInvalidRequestError(ex))
-        throw ex;
+* Re-throws an error that is a fact about the CALL rather than about one scope of a fan-out.
+*
+* Every provider fan-out catches per-scope rejections and records them as {@link CollectionScopeFailure}s, which is
+* right for auth, rate limits and a missing project: those really did happen to one scope, and the siblings that
+* succeeded must survive. A caller-contract error is the opposite — it is identical for every scope and was decided
+* before any request went out — so degrading it would hand back N indistinguishable failures and an empty `partial`
+* page, describing an invalid call as an incomplete read.
+*
+* Today that means the SDK's `UnsupportedSortError` and `InvalidRequestError` — the two codes it lists in its own
+* `CALLER_CONTRACT_ERROR_CODES`, both documented as "never degraded into a `CollectionScopeFailure` or an
+* omission". The second covers arguments rejected before the first request goes out: a project key list longer
+* than one Jira search can carry (or an empty one), a non-integer `pageSize`, an unknown current-user filter, or a
+* Jira Server read with no `baseUrl` to address. Called from every fan-out rather than spelled out in each, so a
+* fan-out added later inherits the rule instead of silently omitting it — which is exactly how Azure's
+* account-wide drain came to degrade it while its three siblings did not.
+*/
+function throwIfCallerContractError(ex) {
+	if (isUnsupportedSortError(ex) || isInvalidRequestError(ex)) throw ex;
 }
 /**
- * Maps a caught GitLens request error to the SDK collection failure vocabulary used inside provider fan-outs.
- */
-export function toCollectionFailureKind(ex) {
-    if (ex instanceof AuthenticationError)
-        return 'authentication';
-    if (ex instanceof RequestRateLimitError)
-        return 'rate-limit';
-    if (ex instanceof RequestNotFoundError)
-        return 'not-found';
-    return 'provider';
+* Maps a caught GitLens request error to the SDK collection failure vocabulary used inside provider fan-outs.
+*/
+function toCollectionFailureKind(ex) {
+	if (ex instanceof AuthenticationError) return "authentication";
+	if (ex instanceof RequestRateLimitError) return "rate-limit";
+	if (ex instanceof RequestNotFoundError) return "not-found";
+	return "provider";
 }
 /** Builds a structured SDK scope failure from a caught GitLens request error. */
-export function toCollectionScopeFailure(scope, ex) {
-    return {
-        scope: scope,
-        kind: toCollectionFailureKind(ex),
-        ...(ex instanceof Error && ex.message ? { message: ex.message } : {}),
-    };
+function toCollectionScopeFailure(scope, ex) {
+	return {
+		scope,
+		kind: toCollectionFailureKind(ex),
+		...ex instanceof Error && ex.message ? { message: ex.message } : {}
+	};
 }
 function collectionFailureKindToWarningKind(kind) {
-    switch (kind) {
-        case 'authentication':
-            return 'auth';
-        case 'rate-limit':
-            return 'rate-limit';
-        case 'not-found':
-            return 'not-found';
-        default:
-            return 'other';
-    }
+	switch (kind) {
+		case "authentication": return "auth";
+		case "rate-limit": return "rate-limit";
+		case "not-found": return "not-found";
+		default: return "other";
+	}
 }
 function getCollectionFailureStatus(message) {
-    if (message == null)
-        return undefined;
-    const match = /\((\d{3})\)/.exec(message) ?? /^(?:HTTP\s+)?(\d{3})\b/i.exec(message.trim());
-    return match != null ? Number(match[1]) : undefined;
+	if (message == null) return void 0;
+	const match = /\((\d{3})\)/.exec(message) ?? /^(?:HTTP\s+)?(\d{3})\b/i.exec(message.trim());
+	return match != null ? Number(match[1]) : void 0;
 }
 function toCollectionFailureWarningKind(failure) {
-    const mapped = collectionFailureKindToWarningKind(failure.kind);
-    if (mapped !== 'other' || (failure.kind !== 'provider' && failure.kind !== 'unknown'))
-        return mapped;
-    // provider-apis currently groups several HTTP statuses under `provider` in partial fan-outs. The custom
-    // fetch adapter retains the status in `message`, so recover the same neutral classification the thrown-error
-    // path exposes instead of downgrading these structured failures to `other`.
-    const status = getCollectionFailureStatus(failure.message);
-    switch (status) {
-        case 401:
-            return 'auth';
-        case 403:
-            return isRateLimitResponse({ status: status, message: failure.message }) ? 'rate-limit' : 'auth';
-        case 404:
-        case 410:
-        case 422:
-            return 'not-found';
-        case 429:
-            return 'rate-limit';
-        default:
-            return mapped;
-    }
+	const mapped = collectionFailureKindToWarningKind(failure.kind);
+	if (mapped !== "other" || failure.kind !== "provider" && failure.kind !== "unknown") return mapped;
+	const status = getCollectionFailureStatus(failure.message);
+	switch (status) {
+		case 401: return "auth";
+		case 403: return isRateLimitResponse({
+			status,
+			message: failure.message
+		}) ? "rate-limit" : "auth";
+		case 404:
+		case 410:
+		case 422: return "not-found";
+		case 429: return "rate-limit";
+		default: return mapped;
+	}
 }
-export function toCollectionFailureError(failure, tokenWithInfo) {
-    const error = new Error(failure.message ?? 'Provider request failed');
-    const kind = toCollectionFailureWarningKind(failure);
-    const { accessToken, ...tokenInfo } = tokenWithInfo;
-    if (kind === 'auth')
-        return new AuthenticationError(tokenInfo, error.message, error);
-    if (kind === 'rate-limit')
-        return new RequestRateLimitError(error, accessToken, undefined);
-    if (kind === 'not-found')
-        return new RequestNotFoundError(error);
-    const status = getCollectionFailureStatus(failure.message);
-    if (kind === 'other' && status != null && status >= 400 && status < 500) {
-        return new RequestClientError(error);
-    }
-    return error;
+function toCollectionFailureError(failure, tokenWithInfo) {
+	const error = new Error(failure.message ?? "Provider request failed");
+	const kind = toCollectionFailureWarningKind(failure);
+	const { accessToken, ...tokenInfo } = tokenWithInfo;
+	if (kind === "auth") return new AuthenticationError(tokenInfo, error.message, error);
+	if (kind === "rate-limit") return new RequestRateLimitError(error, accessToken, void 0);
+	if (kind === "not-found") return new RequestNotFoundError(error);
+	const status = getCollectionFailureStatus(failure.message);
+	if (kind === "other" && status != null && status >= 400 && status < 500) return new RequestClientError(error);
+	return error;
 }
 /** ` (resource r, project p, repository o/n)` for the scope IDs present; empty when the scope names none. */
 function collectionScopeText(scope) {
-    const parts = [];
-    if (scope?.resourceId != null) {
-        parts.push(`resource ${scope.resourceId}`);
-    }
-    if (scope?.projectId != null) {
-        parts.push(`project ${scope.projectId}`);
-    }
-    if (scope?.repositoryId != null) {
-        parts.push(`repository ${scope.repositoryId}`);
-    }
-    return parts.length ? ` (${parts.join(', ')})` : '';
+	const parts = [];
+	if (scope?.resourceId != null) parts.push(`resource ${scope.resourceId}`);
+	if (scope?.projectId != null) parts.push(`project ${scope.projectId}`);
+	if (scope?.repositoryId != null) parts.push(`repository ${scope.repositoryId}`);
+	return parts.length ? ` (${parts.join(", ")})` : "";
 }
 function collectionFailureMessage(failure) {
-    const detail = failure.message != null ? `: ${failure.message}` : '';
-    return `Failed to read ${failure.kind} scope${collectionScopeText(failure.scope)}${detail}`;
+	const detail = failure.message != null ? `: ${failure.message}` : "";
+	return `Failed to read ${failure.kind} scope${collectionScopeText(failure.scope)}${detail}`;
 }
 /**
- * Explains one omission in the consumer's terms — what was left out and, where the SDK reports it, how much.
- *
- * An omission is a completeness fact, never a failure: the read succeeded, and the provider (or the SDK's own
- * recovery budget) is what withheld results. That is why these never contribute to `fetchFailed`. Whether a
- * retry would recover anything is a separate question this layer cannot answer — see the `recovery` note on
- * {@link toProviderWarningOmission}.
- */
+* Explains one omission in the consumer's terms — what was left out and, where the SDK reports it, how much.
+*
+* An omission is a completeness fact, never a failure: the read succeeded, and the provider (or the SDK's own
+* recovery budget) is what withheld results. That is why these never contribute to `fetchFailed`. Whether a
+* retry would recover anything is a separate question this layer cannot answer — see the `recovery` note on
+* {@link toProviderWarningOmission}.
+*/
 function collectionOmissionMessage(omission) {
-    const scopeText = collectionScopeText(omission.scope);
-    switch (omission.kind) {
-        case 'provider-limit':
-            // `totalCount` is the only figure saying how much was withheld; both fields are optional, so degrade
-            // through the shapes the SDK can actually emit rather than printing `undefined`.
-            if (omission.totalCount != null && omission.limit != null) {
-                return `Search${scopeText} matched ${omission.totalCount} results, but the provider exposes at most ${omission.limit}`;
-            }
-            if (omission.limit != null) {
-                return `Search${scopeText} exceeded the provider limit of ${omission.limit} results`;
-            }
-            return `Search${scopeText} exceeded the provider's result limit`;
-        case 'recovery-budget':
-            return `Stopped recovering omitted results${scopeText} after reaching the request budget${omission.limit != null ? ` of ${omission.limit} requests` : ''}`;
-        case 'pagination-incomplete':
-            return `More results are available${scopeText} than this read returned`;
-        default:
-            // `CollectionOmissionKind` is a closed union, so this is unreachable today. Kept as a compile-time
-            // guard rather than a silent fallback: an SDK bump that adds a kind breaks the build here instead
-            // of quietly degrading it to a vague message.
-            omission.kind;
-            return `Some results were omitted${scopeText}; the read is incomplete`;
-    }
+	const scopeText = collectionScopeText(omission.scope);
+	switch (omission.kind) {
+		case "provider-limit":
+			if (omission.totalCount != null && omission.limit != null) return `Search${scopeText} matched ${omission.totalCount} results, but the provider exposes at most ${omission.limit}`;
+			if (omission.limit != null) return `Search${scopeText} exceeded the provider limit of ${omission.limit} results`;
+			return `Search${scopeText} exceeded the provider's result limit`;
+		case "recovery-budget": return `Stopped recovering omitted results${scopeText} after reaching the request budget${omission.limit != null ? ` of ${omission.limit} requests` : ""}`;
+		case "pagination-incomplete": return `More results are available${scopeText} than this read returned`;
+		default:
+			omission.kind;
+			return `Some results were omitted${scopeText}; the read is incomplete`;
+	}
 }
 /**
- * Forwards an SDK omission as the structured signal consumers read instead of parsing {@link
- * collectionOmissionMessage}'s prose.
- *
- * `results.ts` re-spells `CollectionOmissionKind` rather than importing it, so the published warning surface
- * carries no `@gitkraken/provider-apis` types (see the export block in `index.ts`). The return type is what
- * keeps the two unions honest: an SDK bump that adds a member fails to compile here, alongside
- * `collectionOmissionMessage`'s `satisfies never`.
- *
- * `scope` is copied because the SDK's own object is retained and re-merged across drained pages
- * (`providerPaging.ts`), and this one crosses the package boundary.
- *
- * `recovery` is always `'none'`, deliberately, and a scoped `pagination-incomplete` is why it looks wrong: the
- * SDK emits that one shape from situations with opposite remedies and says so itself — "Either the read
- * deliberately took one page per scope, or the provider advertised another page it gave no way to reach." Its
- * `collectAcrossScopes` producers (Azure, Bitbucket, Bitbucket Server) are the first, its `drainAcrossScopes`
- * producers (GitLab, Jira) the second, and those report an omission only when a cursor STALLED — so re-reading
- * that scope stalls at the identical page. Nothing in `CollectionOmission` separates the two, so claiming
- * recoverability would ship the dead-end button `recovery` exists to prevent. Making the recoverable case
- * claimable needs provider-apis to say whether a scope was drained or merely sampled: a fact to forward, not
- * to guess here.
- */
+* Forwards an SDK omission as the structured signal consumers read instead of parsing {@link
+* collectionOmissionMessage}'s prose.
+*
+* `results.ts` re-spells `CollectionOmissionKind` rather than importing it, so the published warning surface
+* carries no `@gitkraken/provider-apis` types (see the export block in `index.ts`). The return type is what
+* keeps the two unions honest: an SDK bump that adds a member fails to compile here, alongside
+* `collectionOmissionMessage`'s `satisfies never`.
+*
+* `scope` is copied because the SDK's own object is retained and re-merged across drained pages
+* (`providerPaging.ts`), and this one crosses the package boundary.
+*
+* `recovery` is always `'none'`, deliberately, and a scoped `pagination-incomplete` is why it looks wrong: the
+* SDK emits that one shape from situations with opposite remedies and says so itself — "Either the read
+* deliberately took one page per scope, or the provider advertised another page it gave no way to reach." Its
+* `collectAcrossScopes` producers (Azure, Bitbucket, Bitbucket Server) are the first, its `drainAcrossScopes`
+* producers (GitLab, Jira) the second, and those report an omission only when a cursor STALLED — so re-reading
+* that scope stalls at the identical page. Nothing in `CollectionOmission` separates the two, so claiming
+* recoverability would ship the dead-end button `recovery` exists to prevent. Making the recoverable case
+* claimable needs provider-apis to say whether a scope was drained or merely sampled: a fact to forward, not
+* to guess here.
+*/
 function toProviderWarningOmission(omission) {
-    return {
-        kind: omission.kind,
-        recovery: 'none',
-        ...(omission.limit != null ? { limit: omission.limit } : {}),
-        // The SDK types this `number | null | undefined`; normalize to one absence for consumers.
-        ...(omission.totalCount != null ? { totalCount: omission.totalCount } : {}),
-        ...(omission.scope != null ? { scope: { ...omission.scope } } : {}),
-    };
+	return {
+		kind: omission.kind,
+		recovery: "none",
+		...omission.limit != null ? { limit: omission.limit } : {},
+		...omission.totalCount != null ? { totalCount: omission.totalCount } : {},
+		...omission.scope != null ? { scope: { ...omission.scope } } : {}
+	};
 }
 /**
- * Whether SDK metadata describes a read that may be missing results.
- *
- * A reported omission counts on its own rather than deferring to `completeness`. The SDK does couple the
- * two — every site that emits an omission degrades completeness in the same call — so today the omission
- * clause changes no outcome. It is defensive: the two facts arrive as independent fields, and a read that
- * names what it left out must not be publishable as whole if a future producer sets only one of them.
- *
- * This is the single definition of "may be missing results", shared with `getPagedResult`, so one metadata
- * object cannot be truncated at one layer and complete at another.
- */
-export function isIncompleteCollection(metadata) {
-    if (metadata == null)
-        return false;
-    return metadata.completeness !== 'complete' || (metadata.omissions?.length ?? 0) > 0;
+* Whether SDK metadata describes a read that may be missing results.
+*
+* A reported omission counts on its own rather than deferring to `completeness`. The SDK does couple the
+* two — every site that emits an omission degrades completeness in the same call — so today the omission
+* clause changes no outcome. It is defensive: the two facts arrive as independent fields, and a read that
+* names what it left out must not be publishable as whole if a future producer sets only one of them.
+*
+* This is the single definition of "may be missing results", shared with `getPagedResult`, so one metadata
+* object cannot be truncated at one layer and complete at another.
+*/
+function isIncompleteCollection(metadata) {
+	if (metadata == null) return false;
+	return metadata.completeness !== "complete" || (metadata.omissions?.length ?? 0) > 0;
 }
 /** Converts internal SDK collection metadata into neutral provider facade signals. */
-export function assessCollectionMetadata(providerId, domain, connectionId, metadata) {
-    if (metadata == null)
-        return { warnings: [], fetchFailed: false, truncated: false };
-    const warnings = [];
-    const failures = metadata.failures ?? [];
-    for (const failure of failures) {
-        const kind = toCollectionFailureWarningKind(failure);
-        appendDedupedWarning(warnings, {
-            providerId: providerId,
-            domain: domain,
-            connectionId: connectionId,
-            message: collectionFailureMessage(failure),
-            kind: kind,
-            isAuth: kind === 'auth',
-        });
-    }
-    // Omissions explain WHY a read is incomplete when nothing failed — a provider cap, an exhausted recovery
-    // budget, an undrained scope. They classify as `other`, never `auth`, and are deliberately excluded from
-    // `fetchFailed` below: the request itself succeeded. `omission` carries that same fact structurally, so a
-    // consumer can act on it without parsing the message.
-    const omissions = metadata.omissions ?? [];
-    for (const omission of omissions) {
-        appendDedupedWarning(warnings, {
-            providerId: providerId,
-            domain: domain,
-            connectionId: connectionId,
-            message: collectionOmissionMessage(omission),
-            kind: 'other',
-            isAuth: false,
-            omission: toProviderWarningOmission(omission),
-        });
-    }
-    const incomplete = isIncompleteCollection(metadata);
-    // Only fall back to the generic message when nothing more specific was reported; an omission already
-    // explains the incompleteness in the consumer's terms, so adding this on top would be noise.
-    //
-    // This one deliberately carries no `omission`: it fires precisely when the SDK reported incompleteness
-    // WITHOUT saying what was left out, so there is no structured fact to forward and synthesizing one would
-    // assert a specificity this layer does not have.
-    if (incomplete && failures.length === 0 && omissions.length === 0) {
-        appendDedupedWarning(warnings, {
-            providerId: providerId,
-            domain: domain,
-            connectionId: connectionId,
-            message: metadata.completeness === 'partial'
-                ? 'Some results were omitted; the read is incomplete'
-                : 'Result completeness could not be confirmed',
-            kind: 'other',
-            isAuth: false,
-        });
-    }
-    return { warnings: warnings, fetchFailed: failures.length > 0, truncated: incomplete };
+function assessCollectionMetadata(providerId, domain, connectionId, metadata) {
+	if (metadata == null) return {
+		warnings: [],
+		fetchFailed: false,
+		truncated: false
+	};
+	const warnings = [];
+	const failures = metadata.failures ?? [];
+	for (const failure of failures) {
+		const kind = toCollectionFailureWarningKind(failure);
+		appendDedupedWarning(warnings, {
+			providerId,
+			domain,
+			connectionId,
+			message: collectionFailureMessage(failure),
+			kind,
+			isAuth: kind === "auth"
+		});
+	}
+	const omissions = metadata.omissions ?? [];
+	for (const omission of omissions) appendDedupedWarning(warnings, {
+		providerId,
+		domain,
+		connectionId,
+		message: collectionOmissionMessage(omission),
+		kind: "other",
+		isAuth: false,
+		omission: toProviderWarningOmission(omission)
+	});
+	const incomplete = isIncompleteCollection(metadata);
+	if (incomplete && failures.length === 0 && omissions.length === 0) appendDedupedWarning(warnings, {
+		providerId,
+		domain,
+		connectionId,
+		message: metadata.completeness === "partial" ? "Some results were omitted; the read is incomplete" : "Result completeness could not be confirmed",
+		kind: "other",
+		isAuth: false
+	});
+	return {
+		warnings,
+		fetchFailed: failures.length > 0,
+		truncated: incomplete
+	};
 }
 /**
- * Appends neutral warnings derived from SDK metadata and returns its failure/truncation assessment.
- *
- * `reported` says whether the metadata described this read's incompleteness at all. A caller that would
- * otherwise add its own generic "this was truncated" warning uses it to stay quiet — the same rule
- * {@link assessCollectionMetadata} applies to its own generic fallback, one layer up: whatever the metadata
- * reported already names this provider and, unless it was that same fallback, says something a consumer can
- * act on. Restating it in a weaker vocabulary is how one gap becomes two warnings with two different verdicts.
- *
- * `truncated` is the near-synonym that must NOT be used for that question: it comes from
- * {@link isIncompleteCollection}, which does not consider failures, so metadata carrying a typed failure
- * alongside `completeness: 'complete'` reports `truncated: false` while having already appended the warning
- * that explains everything. Gating on it would restate exactly the case this field exists to keep quiet.
- */
-export function mergeAssessmentInto(warnings, providerId, domain, connectionId, metadata) {
-    const assessment = assessCollectionMetadata(providerId, domain, connectionId, metadata);
-    for (const warning of assessment.warnings) {
-        appendDedupedWarning(warnings, warning);
-    }
-    return {
-        fetchFailed: assessment.fetchFailed,
-        truncated: assessment.truncated,
-        // What the assessment PRODUCED, not what `appendDedupedWarning` accepted: a warning dropped as a
-        // duplicate is still one the consumer will see, so it still makes a restatement redundant.
-        reported: assessment.warnings.length > 0,
-    };
+* Appends neutral warnings derived from SDK metadata and returns its failure/truncation assessment.
+*
+* `reported` says whether the metadata described this read's incompleteness at all. A caller that would
+* otherwise add its own generic "this was truncated" warning uses it to stay quiet — the same rule
+* {@link assessCollectionMetadata} applies to its own generic fallback, one layer up: whatever the metadata
+* reported already names this provider and, unless it was that same fallback, says something a consumer can
+* act on. Restating it in a weaker vocabulary is how one gap becomes two warnings with two different verdicts.
+*
+* `truncated` is the near-synonym that must NOT be used for that question: it comes from
+* {@link isIncompleteCollection}, which does not consider failures, so metadata carrying a typed failure
+* alongside `completeness: 'complete'` reports `truncated: false` while having already appended the warning
+* that explains everything. Gating on it would restate exactly the case this field exists to keep quiet.
+*/
+function mergeAssessmentInto(warnings, providerId, domain, connectionId, metadata) {
+	const assessment = assessCollectionMetadata(providerId, domain, connectionId, metadata);
+	for (const warning of assessment.warnings) appendDedupedWarning(warnings, warning);
+	return {
+		fetchFailed: assessment.fetchFailed,
+		truncated: assessment.truncated,
+		reported: assessment.warnings.length > 0
+	};
 }
+//#endregion
+export { assessCollectionMetadata, isIncompleteCollection, mergeAssessmentInto, throwIfCallerContractError, toCollectionFailureError, toCollectionFailureKind, toCollectionScopeFailure };
+
 //# sourceMappingURL=collectionMetadata.js.map

package/dist/plus/integrations/collectionMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"collectionMetadata.js","sourceRoot":"","sources":["../../../src/plus/integrations/collectionMetadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collectionMetadata.js","names":[],"sources":["../../../../plus/integrations/src/collectionMetadata.ts"],"sourcesContent":["import type {\n\tCollectionMetadata,\n\tCollectionOmission,\n\tCollectionScope,\n\tCollectionScopeFailure,\n} from '@gitkraken/provider-apis';\n// Matched by its `code` discriminator rather than by `instanceof`: the SDK ships one bundle per entry point, so\n// the class reached through the root is not the same object as the one reached through `/providers`.\nimport { isInvalidRequestError, isUnsupportedSortError } from '@gitkraken/provider-apis';\nimport {\n\tAuthenticationError,\n\tRequestClientError,\n\tRequestNotFoundError,\n\tRequestRateLimitError,\n} from '@gitlens/git/errors.js';\nimport type { TokenWithInfo } from './authentication/models.js';\nimport type { IntegrationIds } from './constants.js';\nimport { isRateLimitResponse } from './errors.js';\nimport type { ProviderWarning, ProviderWarningOmission } from './results.js';\nimport { appendDedupedWarning } from './results.js';\n\n/**\n * Re-throws an error that is a fact about the CALL rather than about one scope of a fan-out.\n *\n * Every provider fan-out catches per-scope rejections and records them as {@link CollectionScopeFailure}s, which is\n * right for auth, rate limits and a missing project: those really did happen to one scope, and the siblings that\n * succeeded must survive. A caller-contract error is the opposite — it is identical for every scope and was decided\n * before any request went out — so degrading it would hand back N indistinguishable failures and an empty `partial`\n * page, describing an invalid call as an incomplete read.\n *\n * Today that means the SDK's `UnsupportedSortError` and `InvalidRequestError` — the two codes it lists in its own\n * `CALLER_CONTRACT_ERROR_CODES`, both documented as \"never degraded into a `CollectionScopeFailure` or an\n * omission\". The second covers arguments rejected before the first request goes out: a project key list longer\n * than one Jira search can carry (or an empty one), a non-integer `pageSize`, an unknown current-user filter, or a\n * Jira Server read with no `baseUrl` to address. Called from every fan-out rather than spelled out in each, so a\n * fan-out added later inherits the rule instead of silently omitting it — which is exactly how Azure's\n * account-wide drain came to degrade it while its three siblings did not.\n */\nexport function throwIfCallerContractError(ex: unknown): void {\n\tif (isUnsupportedSortError(ex) || isInvalidRequestError(ex)) throw ex;\n}\n\n/**\n * Maps a caught GitLens request error to the SDK collection failure vocabulary used inside provider fan-outs.\n */\nexport function toCollectionFailureKind(ex: unknown): CollectionScopeFailure['kind'] {\n\tif (ex instanceof AuthenticationError) return 'authentication';\n\tif (ex instanceof RequestRateLimitError) return 'rate-limit';\n\tif (ex instanceof RequestNotFoundError) return 'not-found';\n\treturn 'provider';\n}\n\n/** Builds a structured SDK scope failure from a caught GitLens request error. */\nexport function toCollectionScopeFailure(scope: CollectionScopeFailure['scope'], ex: unknown): CollectionScopeFailure {\n\treturn {\n\t\tscope: scope,\n\t\tkind: toCollectionFailureKind(ex),\n\t\t...(ex instanceof Error && ex.message ? { message: ex.message } : {}),\n\t};\n}\n\nfunction collectionFailureKindToWarningKind(kind: CollectionScopeFailure['kind']): ProviderWarning['kind'] {\n\tswitch (kind) {\n\t\tcase 'authentication':\n\t\t\treturn 'auth';\n\t\tcase 'rate-limit':\n\t\t\treturn 'rate-limit';\n\t\tcase 'not-found':\n\t\t\treturn 'not-found';\n\t\tdefault:\n\t\t\treturn 'other';\n\t}\n}\n\nfunction getCollectionFailureStatus(message: string | undefined): number | undefined {\n\tif (message == null) return undefined;\n\n\tconst match = /\\((\\d{3})\\)/.exec(message) ?? /^(?:HTTP\\s+)?(\\d{3})\\b/i.exec(message.trim());\n\treturn match != null ? Number(match[1]) : undefined;\n}\n\nfunction toCollectionFailureWarningKind(failure: CollectionScopeFailure): ProviderWarning['kind'] {\n\tconst mapped = collectionFailureKindToWarningKind(failure.kind);\n\tif (mapped !== 'other' || (failure.kind !== 'provider' && failure.kind !== 'unknown')) return mapped;\n\n\t// provider-apis currently groups several HTTP statuses under `provider` in partial fan-outs. The custom\n\t// fetch adapter retains the status in `message`, so recover the same neutral classification the thrown-error\n\t// path exposes instead of downgrading these structured failures to `other`.\n\tconst status = getCollectionFailureStatus(failure.message);\n\tswitch (status) {\n\t\tcase 401:\n\t\t\treturn 'auth';\n\t\tcase 403:\n\t\t\treturn isRateLimitResponse({ status: status, message: failure.message }) ? 'rate-limit' : 'auth';\n\t\tcase 404:\n\t\tcase 410:\n\t\tcase 422:\n\t\t\treturn 'not-found';\n\t\tcase 429:\n\t\t\treturn 'rate-limit';\n\t\tdefault:\n\t\t\treturn mapped;\n\t}\n}\n\nexport function toCollectionFailureError(failure: CollectionScopeFailure, tokenWithInfo: TokenWithInfo): Error {\n\tconst error = new Error(failure.message ?? 'Provider request failed');\n\tconst kind = toCollectionFailureWarningKind(failure);\n\tconst { accessToken, ...tokenInfo } = tokenWithInfo;\n\tif (kind === 'auth') return new AuthenticationError(tokenInfo, error.message, error);\n\tif (kind === 'rate-limit') return new RequestRateLimitError(error, accessToken, undefined);\n\tif (kind === 'not-found') return new RequestNotFoundError(error);\n\n\tconst status = getCollectionFailureStatus(failure.message);\n\tif (kind === 'other' && status != null && status >= 400 && status < 500) {\n\t\treturn new RequestClientError(error);\n\t}\n\n\treturn error;\n}\n\n/** ` (resource r, project p, repository o/n)` for the scope IDs present; empty when the scope names none. */\nfunction collectionScopeText(scope: CollectionScope | undefined): string {\n\tconst parts: string[] = [];\n\tif (scope?.resourceId != null) {\n\t\tparts.push(`resource ${scope.resourceId}`);\n\t}\n\tif (scope?.projectId != null) {\n\t\tparts.push(`project ${scope.projectId}`);\n\t}\n\tif (scope?.repositoryId != null) {\n\t\tparts.push(`repository ${scope.repositoryId}`);\n\t}\n\n\treturn parts.length ? ` (${parts.join(', ')})` : '';\n}\n\nfunction collectionFailureMessage(failure: CollectionScopeFailure): string {\n\tconst detail = failure.message != null ? `: ${failure.message}` : '';\n\treturn `Failed to read ${failure.kind} scope${collectionScopeText(failure.scope)}${detail}`;\n}\n\n/**\n * Explains one omission in the consumer's terms — what was left out and, where the SDK reports it, how much.\n *\n * An omission is a completeness fact, never a failure: the read succeeded, and the provider (or the SDK's own\n * recovery budget) is what withheld results. That is why these never contribute to `fetchFailed`. Whether a\n * retry would recover anything is a separate question this layer cannot answer — see the `recovery` note on\n * {@link toProviderWarningOmission}.\n */\nfunction collectionOmissionMessage(omission: CollectionOmission): string {\n\tconst scopeText = collectionScopeText(omission.scope);\n\tswitch (omission.kind) {\n\t\tcase 'provider-limit':\n\t\t\t// `totalCount` is the only figure saying how much was withheld; both fields are optional, so degrade\n\t\t\t// through the shapes the SDK can actually emit rather than printing `undefined`.\n\t\t\tif (omission.totalCount != null && omission.limit != null) {\n\t\t\t\treturn `Search${scopeText} matched ${omission.totalCount} results, but the provider exposes at most ${omission.limit}`;\n\t\t\t}\n\t\t\tif (omission.limit != null) {\n\t\t\t\treturn `Search${scopeText} exceeded the provider limit of ${omission.limit} results`;\n\t\t\t}\n\t\t\treturn `Search${scopeText} exceeded the provider's result limit`;\n\t\tcase 'recovery-budget':\n\t\t\treturn `Stopped recovering omitted results${scopeText} after reaching the request budget${\n\t\t\t\tomission.limit != null ? ` of ${omission.limit} requests` : ''\n\t\t\t}`;\n\t\tcase 'pagination-incomplete':\n\t\t\treturn `More results are available${scopeText} than this read returned`;\n\t\tdefault:\n\t\t\t// `CollectionOmissionKind` is a closed union, so this is unreachable today. Kept as a compile-time\n\t\t\t// guard rather than a silent fallback: an SDK bump that adds a kind breaks the build here instead\n\t\t\t// of quietly degrading it to a vague message.\n\t\t\tomission.kind satisfies never;\n\t\t\treturn `Some results were omitted${scopeText}; the read is incomplete`;\n\t}\n}\n\n/**\n * Forwards an SDK omission as the structured signal consumers read instead of parsing {@link\n * collectionOmissionMessage}'s prose.\n *\n * `results.ts` re-spells `CollectionOmissionKind` rather than importing it, so the published warning surface\n * carries no `@gitkraken/provider-apis` types (see the export block in `index.ts`). The return type is what\n * keeps the two unions honest: an SDK bump that adds a member fails to compile here, alongside\n * `collectionOmissionMessage`'s `satisfies never`.\n *\n * `scope` is copied because the SDK's own object is retained and re-merged across drained pages\n * (`providerPaging.ts`), and this one crosses the package boundary.\n *\n * `recovery` is always `'none'`, deliberately, and a scoped `pagination-incomplete` is why it looks wrong: the\n * SDK emits that one shape from situations with opposite remedies and says so itself — \"Either the read\n * deliberately took one page per scope, or the provider advertised another page it gave no way to reach.\" Its\n * `collectAcrossScopes` producers (Azure, Bitbucket, Bitbucket Server) are the first, its `drainAcrossScopes`\n * producers (GitLab, Jira) the second, and those report an omission only when a cursor STALLED — so re-reading\n * that scope stalls at the identical page. Nothing in `CollectionOmission` separates the two, so claiming\n * recoverability would ship the dead-end button `recovery` exists to prevent. Making the recoverable case\n * claimable needs provider-apis to say whether a scope was drained or merely sampled: a fact to forward, not\n * to guess here.\n */\nfunction toProviderWarningOmission(omission: CollectionOmission): ProviderWarningOmission {\n\treturn {\n\t\tkind: omission.kind,\n\t\trecovery: 'none',\n\t\t...(omission.limit != null ? { limit: omission.limit } : {}),\n\t\t// The SDK types this `number | null | undefined`; normalize to one absence for consumers.\n\t\t...(omission.totalCount != null ? { totalCount: omission.totalCount } : {}),\n\t\t...(omission.scope != null ? { scope: { ...omission.scope } } : {}),\n\t};\n}\n\n/**\n * Whether SDK metadata describes a read that may be missing results.\n *\n * A reported omission counts on its own rather than deferring to `completeness`. The SDK does couple the\n * two — every site that emits an omission degrades completeness in the same call — so today the omission\n * clause changes no outcome. It is defensive: the two facts arrive as independent fields, and a read that\n * names what it left out must not be publishable as whole if a future producer sets only one of them.\n *\n * This is the single definition of \"may be missing results\", shared with `getPagedResult`, so one metadata\n * object cannot be truncated at one layer and complete at another.\n */\nexport function isIncompleteCollection(metadata: CollectionMetadata | undefined): boolean {\n\tif (metadata == null) return false;\n\n\treturn metadata.completeness !== 'complete' || (metadata.omissions?.length ?? 0) > 0;\n}\n\n/** Converts internal SDK collection metadata into neutral provider facade signals. */\nexport function assessCollectionMetadata(\n\tproviderId: IntegrationIds,\n\tdomain: string | undefined,\n\tconnectionId: string | undefined,\n\tmetadata: CollectionMetadata | undefined,\n): { warnings: ProviderWarning[]; fetchFailed: boolean; truncated: boolean } {\n\tif (metadata == null) return { warnings: [], fetchFailed: false, truncated: false };\n\n\tconst warnings: ProviderWarning[] = [];\n\tconst failures = metadata.failures ?? [];\n\tfor (const failure of failures) {\n\t\tconst kind = toCollectionFailureWarningKind(failure);\n\t\tappendDedupedWarning(warnings, {\n\t\t\tproviderId: providerId,\n\t\t\tdomain: domain,\n\t\t\tconnectionId: connectionId,\n\t\t\tmessage: collectionFailureMessage(failure),\n\t\t\tkind: kind,\n\t\t\tisAuth: kind === 'auth',\n\t\t});\n\t}\n\n\t// Omissions explain WHY a read is incomplete when nothing failed — a provider cap, an exhausted recovery\n\t// budget, an undrained scope. They classify as `other`, never `auth`, and are deliberately excluded from\n\t// `fetchFailed` below: the request itself succeeded. `omission` carries that same fact structurally, so a\n\t// consumer can act on it without parsing the message.\n\tconst omissions = metadata.omissions ?? [];\n\tfor (const omission of omissions) {\n\t\tappendDedupedWarning(warnings, {\n\t\t\tproviderId: providerId,\n\t\t\tdomain: domain,\n\t\t\tconnectionId: connectionId,\n\t\t\tmessage: collectionOmissionMessage(omission),\n\t\t\tkind: 'other',\n\t\t\tisAuth: false,\n\t\t\tomission: toProviderWarningOmission(omission),\n\t\t});\n\t}\n\n\tconst incomplete = isIncompleteCollection(metadata);\n\t// Only fall back to the generic message when nothing more specific was reported; an omission already\n\t// explains the incompleteness in the consumer's terms, so adding this on top would be noise.\n\t//\n\t// This one deliberately carries no `omission`: it fires precisely when the SDK reported incompleteness\n\t// WITHOUT saying what was left out, so there is no structured fact to forward and synthesizing one would\n\t// assert a specificity this layer does not have.\n\tif (incomplete && failures.length === 0 && omissions.length === 0) {\n\t\tappendDedupedWarning(warnings, {\n\t\t\tproviderId: providerId,\n\t\t\tdomain: domain,\n\t\t\tconnectionId: connectionId,\n\t\t\tmessage:\n\t\t\t\tmetadata.completeness === 'partial'\n\t\t\t\t\t? 'Some results were omitted; the read is incomplete'\n\t\t\t\t\t: 'Result completeness could not be confirmed',\n\t\t\tkind: 'other',\n\t\t\tisAuth: false,\n\t\t});\n\t}\n\n\treturn { warnings: warnings, fetchFailed: failures.length > 0, truncated: incomplete };\n}\n\n/**\n * Appends neutral warnings derived from SDK metadata and returns its failure/truncation assessment.\n *\n * `reported` says whether the metadata described this read's incompleteness at all. A caller that would\n * otherwise add its own generic \"this was truncated\" warning uses it to stay quiet — the same rule\n * {@link assessCollectionMetadata} applies to its own generic fallback, one layer up: whatever the metadata\n * reported already names this provider and, unless it was that same fallback, says something a consumer can\n * act on. Restating it in a weaker vocabulary is how one gap becomes two warnings with two different verdicts.\n *\n * `truncated` is the near-synonym that must NOT be used for that question: it comes from\n * {@link isIncompleteCollection}, which does not consider failures, so metadata carrying a typed failure\n * alongside `completeness: 'complete'` reports `truncated: false` while having already appended the warning\n * that explains everything. Gating on it would restate exactly the case this field exists to keep quiet.\n */\nexport function mergeAssessmentInto(\n\twarnings: ProviderWarning[],\n\tproviderId: IntegrationIds,\n\tdomain: string | undefined,\n\tconnectionId: string | undefined,\n\tmetadata: CollectionMetadata | undefined,\n): { fetchFailed: boolean; truncated: boolean; reported: boolean } {\n\tconst assessment = assessCollectionMetadata(providerId, domain, connectionId, metadata);\n\tfor (const warning of assessment.warnings) {\n\t\tappendDedupedWarning(warnings, warning);\n\t}\n\treturn {\n\t\tfetchFailed: assessment.fetchFailed,\n\t\ttruncated: assessment.truncated,\n\t\t// What the assessment PRODUCED, not what `appendDedupedWarning` accepted: a warning dropped as a\n\t\t// duplicate is still one the consumer will see, so it still makes a restatement redundant.\n\t\treported: assessment.warnings.length > 0,\n\t};\n}\n"],"mappings":"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"}