@gitkraken/core-gitlens 0.6.0 → 0.7.1

package/dist/plus/integrations/models/issuesIntegration.d.ts

@@ -1,75 +1,76 @@
-import type { Account } from '../../../git/models/author.js';
-import type { Issue, IssueShape } from '../../../git/models/issue.js';
-import type { ResourceDescriptor } from '../../../git/models/resourceDescriptor.js';
-import type { ProviderAuthenticationSession } from '../authentication/models.js';
-import type { IntegrationIds } from '../constants.js';
-import type { ProviderApiCollectionResult } from '../providers/models.js';
-import type { Integration, IntegrationResult, IntegrationType } from './integration.js';
-import { IntegrationBase } from './integration.js';
-import type { IssuesForProjectOptions, ProjectIssuesDrain } from './issueReads.js';
+import { ResourceDescriptor } from "../../../git/models/resourceDescriptor.js";
+import { Issue, IssueShape } from "../../../git/models/issue.js";
+import { Account } from "../../../git/models/author.js";
+import { ProviderAuthenticationSession } from "../authentication/models.js";
+import { IntegrationIds } from "../constants.js";
+import { IssuesForProjectOptions, ProjectIssuesDrain } from "./issueReads.js";
+import { Integration, IntegrationBase, IntegrationResult, IntegrationType } from "./integration.js";
+import { ProviderApiCollectionResult } from "../providers/models.js";
+//#region ../plus/integrations/src/models/issuesIntegration.d.ts
 export declare function isIssuesIntegration(integration: Integration): integration is IssuesIntegration;
 export declare abstract class IssuesIntegration<ID extends IntegrationIds = IntegrationIds, T extends ResourceDescriptor = ResourceDescriptor> extends IntegrationBase<ID> {
-    readonly type: IntegrationType;
-    get supportsIssueLookupByResourceId(): boolean;
-    getIssueByResourceIdResult(resourceId: string, id: string, options?: {
-        connectionId?: string;
-        expiryOverride?: boolean | number;
-        resourceUrl?: string;
-    }): Promise<IntegrationResult<Issue | undefined>>;
-    protected getProviderIssueByResourceId?(_session: ProviderAuthenticationSession, _resourceId: string, _id: string, _resourceUrl: string | undefined): Promise<Issue | undefined>;
-    getAccountForResource(resource: T, connectionId?: string): Promise<Account | undefined>;
-    /**
-     * Result-returning core of {@link getAccountForResource}. Recovers a thrown error into `{ error }` so
-     * callers can preserve its classification (e.g. a 401/403 → an `auth` warning that drives re-auth)
-     * instead of collapsing every failure into an untyped `undefined`. Gated here (not on the wrapper) so
-     * direct callers such as the ProviderBackend facade share the same dedup as `getAccountForResource`.
-     */
-    getAccountForResourceResult(resource: T, connectionId?: string): Promise<IntegrationResult<Account | undefined>>;
-    protected abstract getProviderAccountForResource(session: ProviderAuthenticationSession, resource: T): Promise<Account | undefined>;
-    getResourcesForUser(connectionId?: string): Promise<T[] | undefined>;
-    /**
-     * Result-returning core of {@link getResourcesForUser}. Recovers thrown errors into `{ error }` so callers
-     * can surface them as warnings rather than silently swallowing them to `undefined`. Gated here (not on the
-     * wrapper) so direct callers such as the ProviderBackend facade share the same dedup as `getResourcesForUser`.
-     */
-    getResourcesForUserResult(connectionId?: string): Promise<IntegrationResult<T[] | undefined>>;
-    protected abstract getProviderResourcesForUser(session: ProviderAuthenticationSession): Promise<T[] | undefined>;
-    /**
-     * Project discovery for a set of resources, returning the SDK collection `{ values, metadata }` (completeness
-     * + per-resource failures) so callers can warn on failed resources and set `fetchFailed` without discarding
-     * the resources that succeeded. Thrown errors are recovered into `{ error }` for the same reason: a caller
-     * surfaces them as a warning rather than swallowing them to `undefined`.
-     */
-    getProjectsForResourcesWithMetadataResult(resources: T[], connectionId?: string): Promise<IntegrationResult<ProviderApiCollectionResult<T> | undefined>>;
-    /**
-     * Metadata-aware provider project discovery. The default wraps the array-returning
-     * {@link getProviderProjectsForResources} in `{ values }` with no metadata, so providers without a
-     * fan-out completeness signal (Linear, Trello) need no change; Jira overrides it to preserve the SDK's
-     * per-resource completeness/failures.
-     */
-    protected getProviderProjectsForResourcesWithMetadata(session: ProviderAuthenticationSession, resources: T[]): Promise<ProviderApiCollectionResult<T>>;
-    protected abstract getProviderProjectsForResources(session: ProviderAuthenticationSession, resources: T[]): Promise<T[] | undefined>;
-    getIssuesForProject(project: T, options?: IssuesForProjectOptions, connectionId?: string): Promise<IssueShape[] | undefined>;
-    /**
-     * Result-returning core of {@link getIssuesForProject}. Recovers thrown errors into `{ error }` so callers
-     * (e.g. the ProviderBackend facade) can surface a per-provider warning instead of a silent empty read —
-     * important for providers that throw on unsupported operations (e.g. Linear's not-implemented issue read).
-     */
-    getIssuesForProjectResult(project: T, options?: IssuesForProjectOptions, connectionId?: string): Promise<IntegrationResult<IssueShape[] | undefined>>;
-    /**
-     * Truncation-aware variant of {@link getIssuesForProjectResult}. A provider that drains a project's issues
-     * with an internal page backstop (Jira/Linear) overrides {@link getProviderIssuesForProjectWithTruncation}
-     * to report when that backstop was hit, so the facade can surface an incomplete project read instead of
-     * publishing it as complete. The default reports `truncated: false`.
-     */
-    getIssuesForProjectWithTruncationResult(project: T, options?: IssuesForProjectOptions, connectionId?: string): Promise<IntegrationResult<ProjectIssuesDrain | undefined>>;
-    protected abstract getProviderIssuesForProject(session: ProviderAuthenticationSession, project: T, options?: IssuesForProjectOptions): Promise<IssueShape[] | undefined>;
-    /**
-     * Truncation-aware core of {@link getProviderIssuesForProject}. The default wraps the plain read and
-     * reports `truncated: false`; a provider whose per-project drain is capped by a page backstop overrides
-     * this to report incompleteness. Optional metadata lets providers surface structured per-project failures
-     * (e.g. a page-level auth rejection) without discarding the already-fetched prefix.
-     */
-    protected getProviderIssuesForProjectWithTruncation(session: ProviderAuthenticationSession, project: T, options?: IssuesForProjectOptions): Promise<ProjectIssuesDrain | undefined>;
+  readonly type: IntegrationType;
+  get supportsIssueLookupByResourceId(): boolean;
+  getIssueByResourceIdResult(resourceId: string, id: string, options?: {
+    connectionId?: string;
+    expiryOverride?: boolean | number;
+    resourceUrl?: string;
+  }): Promise<IntegrationResult<Issue | undefined>>;
+  protected getProviderIssueByResourceId?(_session: ProviderAuthenticationSession, _resourceId: string, _id: string, _resourceUrl: string | undefined): Promise<Issue | undefined>;
+  getAccountForResource(resource: T, connectionId?: string): Promise<Account | undefined>;
+  /**
+   * Result-returning core of {@link getAccountForResource}. Recovers a thrown error into `{ error }` so
+   * callers can preserve its classification (e.g. a 401/403 → an `auth` warning that drives re-auth)
+   * instead of collapsing every failure into an untyped `undefined`. Gated here (not on the wrapper) so
+   * direct callers such as the ProviderBackend facade share the same dedup as `getAccountForResource`.
+   */
+  getAccountForResourceResult(resource: T, connectionId?: string): Promise<IntegrationResult<Account | undefined>>;
+  protected abstract getProviderAccountForResource(session: ProviderAuthenticationSession, resource: T): Promise<Account | undefined>;
+  getResourcesForUser(connectionId?: string): Promise<T[] | undefined>;
+  /**
+   * Result-returning core of {@link getResourcesForUser}. Recovers thrown errors into `{ error }` so callers
+   * can surface them as warnings rather than silently swallowing them to `undefined`. Gated here (not on the
+   * wrapper) so direct callers such as the ProviderBackend facade share the same dedup as `getResourcesForUser`.
+   */
+  getResourcesForUserResult(connectionId?: string): Promise<IntegrationResult<T[] | undefined>>;
+  protected abstract getProviderResourcesForUser(session: ProviderAuthenticationSession): Promise<T[] | undefined>;
+  /**
+   * Project discovery for a set of resources, returning the SDK collection `{ values, metadata }` (completeness
+   * + per-resource failures) so callers can warn on failed resources and set `fetchFailed` without discarding
+   * the resources that succeeded. Thrown errors are recovered into `{ error }` for the same reason: a caller
+   * surfaces them as a warning rather than swallowing them to `undefined`.
+   */
+  getProjectsForResourcesWithMetadataResult(resources: T[], connectionId?: string): Promise<IntegrationResult<ProviderApiCollectionResult<T> | undefined>>;
+  /**
+   * Metadata-aware provider project discovery. The default wraps the array-returning
+   * {@link getProviderProjectsForResources} in `{ values }` with no metadata, so providers without a
+   * fan-out completeness signal (Linear, Trello) need no change; Jira overrides it to preserve the SDK's
+   * per-resource completeness/failures.
+   */
+  protected getProviderProjectsForResourcesWithMetadata(session: ProviderAuthenticationSession, resources: T[]): Promise<ProviderApiCollectionResult<T>>;
+  protected abstract getProviderProjectsForResources(session: ProviderAuthenticationSession, resources: T[]): Promise<T[] | undefined>;
+  getIssuesForProject(project: T, options?: IssuesForProjectOptions, connectionId?: string): Promise<IssueShape[] | undefined>;
+  /**
+   * Result-returning core of {@link getIssuesForProject}. Recovers thrown errors into `{ error }` so callers
+   * (e.g. the ProviderBackend facade) can surface a per-provider warning instead of a silent empty read —
+   * important for providers that throw on unsupported operations (e.g. Linear's not-implemented issue read).
+   */
+  getIssuesForProjectResult(project: T, options?: IssuesForProjectOptions, connectionId?: string): Promise<IntegrationResult<IssueShape[] | undefined>>;
+  /**
+   * Truncation-aware variant of {@link getIssuesForProjectResult}. A provider that drains a project's issues
+   * with an internal page backstop (Jira/Linear) overrides {@link getProviderIssuesForProjectWithTruncation}
+   * to report when that backstop was hit, so the facade can surface an incomplete project read instead of
+   * publishing it as complete. The default reports `truncated: false`.
+   */
+  getIssuesForProjectWithTruncationResult(project: T, options?: IssuesForProjectOptions, connectionId?: string): Promise<IntegrationResult<ProjectIssuesDrain | undefined>>;
+  protected abstract getProviderIssuesForProject(session: ProviderAuthenticationSession, project: T, options?: IssuesForProjectOptions): Promise<IssueShape[] | undefined>;
+  /**
+   * Truncation-aware core of {@link getProviderIssuesForProject}. The default wraps the plain read and
+   * reports `truncated: false`; a provider whose per-project drain is capped by a page backstop overrides
+   * this to report incompleteness. Optional metadata lets providers surface structured per-project failures
+   * (e.g. a page-level auth rejection) without discarding the already-fetched prefix.
+   */
+  protected getProviderIssuesForProjectWithTruncation(session: ProviderAuthenticationSession, project: T, options?: IssuesForProjectOptions): Promise<ProjectIssuesDrain | undefined>;
 }
+//#endregion
 //# sourceMappingURL=issuesIntegration.d.ts.map

package/dist/plus/integrations/models/issuesIntegration.js

@@ -1,188 +1,162 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { gate } from '../../../utils/decorators/gate.js';
-import { trace } from '../../../utils/decorators/log.js';
-import { getScopedLogger } from '../../../utils/logger.scoped.js';
-import { IntegrationReadUnavailableError, toError } from '../errors.js';
-import { IntegrationBase } from './integration.js';
-export function isIssuesIntegration(integration) {
-    return integration.type === 'issues';
-}
-export class IssuesIntegration extends IntegrationBase {
-    type = 'issues';
-    get supportsIssueLookupByResourceId() {
-        return this.getProviderIssueByResourceId != null;
-    }
-    getIssueByResourceIdResult(resourceId, id, options) {
-        const getProviderIssue = this.getProviderIssueByResourceId;
-        if (getProviderIssue == null) {
-            return Promise.resolve({
-                error: new IntegrationReadUnavailableError(this.name, 'does not support direct issue reads by resource id'),
-            });
-        }
-        const { resourceUrl, ...readOptions } = options ?? {};
-        const resource = { key: resourceId, resourceId: resourceId, resourceUrl: resourceUrl };
-        return this.getIssueResultCore(resource, id, readOptions, session => getProviderIssue.call(this, session, resourceId, id, resourceUrl));
-    }
-    async getAccountForResource(resource, connectionId) {
-        return (await this.getAccountForResourceResult(resource, connectionId))?.value;
-    }
-    /**
-     * Result-returning core of {@link getAccountForResource}. Recovers a thrown error into `{ error }` so
-     * callers can preserve its classification (e.g. a 401/403 → an `auth` warning that drives re-auth)
-     * instead of collapsing every failure into an untyped `undefined`. Gated here (not on the wrapper) so
-     * direct callers such as the ProviderBackend facade share the same dedup as `getAccountForResource`.
-     */
-    async getAccountForResourceResult(resource, connectionId) {
-        const scope = getScopedLogger();
-        // `connectionId` targets a specific account (multi-account); omitted reads the primary.
-        const session = await this.resolveReadSession(connectionId, scope);
-        if (session == null)
-            return undefined;
-        try {
-            const account = await this.getProviderAccountForResource(session, resource);
-            this.resetRequestExceptionCount('getAccountForResource');
-            return { value: account };
-        }
-        catch (ex) {
-            this.handleProviderException('getAccountForResource', ex, { connectionId: connectionId });
-            return { error: toError(ex) };
-        }
-    }
-    async getResourcesForUser(connectionId) {
-        return (await this.getResourcesForUserResult(connectionId))?.value;
-    }
-    /**
-     * Result-returning core of {@link getResourcesForUser}. Recovers thrown errors into `{ error }` so callers
-     * can surface them as warnings rather than silently swallowing them to `undefined`. Gated here (not on the
-     * wrapper) so direct callers such as the ProviderBackend facade share the same dedup as `getResourcesForUser`.
-     */
-    async getResourcesForUserResult(connectionId) {
-        const scope = getScopedLogger();
-        // `connectionId` targets a specific account (multi-account); omitted reads the primary.
-        const session = await this.resolveReadSession(connectionId, scope);
-        if (session == null)
-            return undefined;
-        try {
-            const resources = await this.getProviderResourcesForUser(session);
-            this.resetRequestExceptionCount('getResourcesForUser');
-            return { value: resources };
-        }
-        catch (ex) {
-            this.handleProviderException('getResourcesForUser', ex, { connectionId: connectionId });
-            return { error: toError(ex) };
-        }
-    }
-    /**
-     * Project discovery for a set of resources, returning the SDK collection `{ values, metadata }` (completeness
-     * + per-resource failures) so callers can warn on failed resources and set `fetchFailed` without discarding
-     * the resources that succeeded. Thrown errors are recovered into `{ error }` for the same reason: a caller
-     * surfaces them as a warning rather than swallowing them to `undefined`.
-     */
-    async getProjectsForResourcesWithMetadataResult(resources, connectionId) {
-        const scope = getScopedLogger();
-        // `connectionId` targets a specific account (multi-account); omitted reads the primary.
-        const session = await this.resolveReadSession(connectionId, scope);
-        if (session == null)
-            return undefined;
-        try {
-            const projects = await this.getProviderProjectsForResourcesWithMetadata(session, resources);
-            this.resetRequestExceptionCount('getProjectsForResources');
-            return { value: projects };
-        }
-        catch (ex) {
-            this.handleProviderException('getProjectsForResources', ex, { connectionId: connectionId });
-            return { error: toError(ex) };
-        }
-    }
-    /**
-     * Metadata-aware provider project discovery. The default wraps the array-returning
-     * {@link getProviderProjectsForResources} in `{ values }` with no metadata, so providers without a
-     * fan-out completeness signal (Linear, Trello) need no change; Jira overrides it to preserve the SDK's
-     * per-resource completeness/failures.
-     */
-    async getProviderProjectsForResourcesWithMetadata(session, resources) {
-        const projects = await this.getProviderProjectsForResources(session, resources);
-        return { values: projects ?? [] };
-    }
-    async getIssuesForProject(project, options, connectionId) {
-        return (await this.getIssuesForProjectResult(project, options, connectionId))?.value;
-    }
-    /**
-     * Result-returning core of {@link getIssuesForProject}. Recovers thrown errors into `{ error }` so callers
-     * (e.g. the ProviderBackend facade) can surface a per-provider warning instead of a silent empty read —
-     * important for providers that throw on unsupported operations (e.g. Linear's not-implemented issue read).
-     */
-    async getIssuesForProjectResult(project, options, connectionId) {
-        const scope = getScopedLogger();
-        // `connectionId` targets a specific account (multi-account); omitted reads the primary.
-        const session = await this.resolveReadSession(connectionId, scope);
-        if (session == null)
-            return undefined;
-        try {
-            const issues = await this.getProviderIssuesForProject(session, project, options);
-            this.resetRequestExceptionCount('getIssuesForProject');
-            return { value: issues };
-        }
-        catch (ex) {
-            this.handleProviderException('getIssuesForProject', ex, { connectionId: connectionId });
-            return { error: toError(ex) };
-        }
-    }
-    /**
-     * Truncation-aware variant of {@link getIssuesForProjectResult}. A provider that drains a project's issues
-     * with an internal page backstop (Jira/Linear) overrides {@link getProviderIssuesForProjectWithTruncation}
-     * to report when that backstop was hit, so the facade can surface an incomplete project read instead of
-     * publishing it as complete. The default reports `truncated: false`.
-     */
-    async getIssuesForProjectWithTruncationResult(project, options, connectionId) {
-        const scope = getScopedLogger();
-        const session = await this.resolveReadSession(connectionId, scope);
-        if (session == null)
-            return undefined;
-        try {
-            const result = await this.getProviderIssuesForProjectWithTruncation(session, project, options);
-            this.resetRequestExceptionCount('getIssuesForProject');
-            return { value: result };
-        }
-        catch (ex) {
-            this.handleProviderException('getIssuesForProject', ex, { connectionId: connectionId });
-            return { error: toError(ex) };
-        }
-    }
-    /**
-     * Truncation-aware core of {@link getProviderIssuesForProject}. The default wraps the plain read and
-     * reports `truncated: false`; a provider whose per-project drain is capped by a page backstop overrides
-     * this to report incompleteness. Optional metadata lets providers surface structured per-project failures
-     * (e.g. a page-level auth rejection) without discarding the already-fetched prefix.
-     */
-    async getProviderIssuesForProjectWithTruncation(session, project, options) {
-        const values = await this.getProviderIssuesForProject(session, project, options);
-        if (values == null)
-            return undefined;
-        return { values: values, truncated: false };
-    }
+import { getScopedLogger } from "../../../utils/logger.scoped.js";
+import { trace } from "../../../utils/decorators/log.js";
+import __decorate from "../../../_virtual/@oxc-project+runtime/helpers/esm/decorate.js";
+import { gate } from "../../../utils/decorators/gate.js";
+import { IntegrationReadUnavailableError, toError } from "../errors.js";
+import { IntegrationBase } from "./integration.js";
+//#region ../plus/integrations/src/models/issuesIntegration.ts
+function isIssuesIntegration(integration) {
+	return integration.type === "issues";
 }
-__decorate([
-    trace()
-], IssuesIntegration.prototype, "getAccountForResource", null);
-__decorate([
-    gate()
-], IssuesIntegration.prototype, "getAccountForResourceResult", null);
-__decorate([
-    trace()
-], IssuesIntegration.prototype, "getResourcesForUser", null);
-__decorate([
-    gate()
-], IssuesIntegration.prototype, "getResourcesForUserResult", null);
-__decorate([
-    trace()
-], IssuesIntegration.prototype, "getProjectsForResourcesWithMetadataResult", null);
-__decorate([
-    trace()
-], IssuesIntegration.prototype, "getIssuesForProject", null);
+var IssuesIntegration = class extends IntegrationBase {
+	type = "issues";
+	get supportsIssueLookupByResourceId() {
+		return this.getProviderIssueByResourceId != null;
+	}
+	getIssueByResourceIdResult(resourceId, id, options) {
+		const getProviderIssue = this.getProviderIssueByResourceId;
+		if (getProviderIssue == null) return Promise.resolve({ error: new IntegrationReadUnavailableError(this.name, "does not support direct issue reads by resource id") });
+		const { resourceUrl, ...readOptions } = options ?? {};
+		const resource = {
+			key: resourceId,
+			resourceId,
+			resourceUrl
+		};
+		return this.getIssueResultCore(resource, id, readOptions, (session) => getProviderIssue.call(this, session, resourceId, id, resourceUrl));
+	}
+	async getAccountForResource(resource, connectionId) {
+		return (await this.getAccountForResourceResult(resource, connectionId))?.value;
+	}
+	/**
+	* Result-returning core of {@link getAccountForResource}. Recovers a thrown error into `{ error }` so
+	* callers can preserve its classification (e.g. a 401/403 → an `auth` warning that drives re-auth)
+	* instead of collapsing every failure into an untyped `undefined`. Gated here (not on the wrapper) so
+	* direct callers such as the ProviderBackend facade share the same dedup as `getAccountForResource`.
+	*/
+	async getAccountForResourceResult(resource, connectionId) {
+		const scope = getScopedLogger();
+		const session = await this.resolveReadSession(connectionId, scope);
+		if (session == null) return void 0;
+		try {
+			const account = await this.getProviderAccountForResource(session, resource);
+			this.resetRequestExceptionCount("getAccountForResource");
+			return { value: account };
+		} catch (ex) {
+			this.handleProviderException("getAccountForResource", ex, { connectionId });
+			return { error: toError(ex) };
+		}
+	}
+	async getResourcesForUser(connectionId) {
+		return (await this.getResourcesForUserResult(connectionId))?.value;
+	}
+	/**
+	* Result-returning core of {@link getResourcesForUser}. Recovers thrown errors into `{ error }` so callers
+	* can surface them as warnings rather than silently swallowing them to `undefined`. Gated here (not on the
+	* wrapper) so direct callers such as the ProviderBackend facade share the same dedup as `getResourcesForUser`.
+	*/
+	async getResourcesForUserResult(connectionId) {
+		const scope = getScopedLogger();
+		const session = await this.resolveReadSession(connectionId, scope);
+		if (session == null) return void 0;
+		try {
+			const resources = await this.getProviderResourcesForUser(session);
+			this.resetRequestExceptionCount("getResourcesForUser");
+			return { value: resources };
+		} catch (ex) {
+			this.handleProviderException("getResourcesForUser", ex, { connectionId });
+			return { error: toError(ex) };
+		}
+	}
+	/**
+	* Project discovery for a set of resources, returning the SDK collection `{ values, metadata }` (completeness
+	* + per-resource failures) so callers can warn on failed resources and set `fetchFailed` without discarding
+	* the resources that succeeded. Thrown errors are recovered into `{ error }` for the same reason: a caller
+	* surfaces them as a warning rather than swallowing them to `undefined`.
+	*/
+	async getProjectsForResourcesWithMetadataResult(resources, connectionId) {
+		const scope = getScopedLogger();
+		const session = await this.resolveReadSession(connectionId, scope);
+		if (session == null) return void 0;
+		try {
+			const projects = await this.getProviderProjectsForResourcesWithMetadata(session, resources);
+			this.resetRequestExceptionCount("getProjectsForResources");
+			return { value: projects };
+		} catch (ex) {
+			this.handleProviderException("getProjectsForResources", ex, { connectionId });
+			return { error: toError(ex) };
+		}
+	}
+	/**
+	* Metadata-aware provider project discovery. The default wraps the array-returning
+	* {@link getProviderProjectsForResources} in `{ values }` with no metadata, so providers without a
+	* fan-out completeness signal (Linear, Trello) need no change; Jira overrides it to preserve the SDK's
+	* per-resource completeness/failures.
+	*/
+	async getProviderProjectsForResourcesWithMetadata(session, resources) {
+		return { values: await this.getProviderProjectsForResources(session, resources) ?? [] };
+	}
+	async getIssuesForProject(project, options, connectionId) {
+		return (await this.getIssuesForProjectResult(project, options, connectionId))?.value;
+	}
+	/**
+	* Result-returning core of {@link getIssuesForProject}. Recovers thrown errors into `{ error }` so callers
+	* (e.g. the ProviderBackend facade) can surface a per-provider warning instead of a silent empty read —
+	* important for providers that throw on unsupported operations (e.g. Linear's not-implemented issue read).
+	*/
+	async getIssuesForProjectResult(project, options, connectionId) {
+		const scope = getScopedLogger();
+		const session = await this.resolveReadSession(connectionId, scope);
+		if (session == null) return void 0;
+		try {
+			const issues = await this.getProviderIssuesForProject(session, project, options);
+			this.resetRequestExceptionCount("getIssuesForProject");
+			return { value: issues };
+		} catch (ex) {
+			this.handleProviderException("getIssuesForProject", ex, { connectionId });
+			return { error: toError(ex) };
+		}
+	}
+	/**
+	* Truncation-aware variant of {@link getIssuesForProjectResult}. A provider that drains a project's issues
+	* with an internal page backstop (Jira/Linear) overrides {@link getProviderIssuesForProjectWithTruncation}
+	* to report when that backstop was hit, so the facade can surface an incomplete project read instead of
+	* publishing it as complete. The default reports `truncated: false`.
+	*/
+	async getIssuesForProjectWithTruncationResult(project, options, connectionId) {
+		const scope = getScopedLogger();
+		const session = await this.resolveReadSession(connectionId, scope);
+		if (session == null) return void 0;
+		try {
+			const result = await this.getProviderIssuesForProjectWithTruncation(session, project, options);
+			this.resetRequestExceptionCount("getIssuesForProject");
+			return { value: result };
+		} catch (ex) {
+			this.handleProviderException("getIssuesForProject", ex, { connectionId });
+			return { error: toError(ex) };
+		}
+	}
+	/**
+	* Truncation-aware core of {@link getProviderIssuesForProject}. The default wraps the plain read and
+	* reports `truncated: false`; a provider whose per-project drain is capped by a page backstop overrides
+	* this to report incompleteness. Optional metadata lets providers surface structured per-project failures
+	* (e.g. a page-level auth rejection) without discarding the already-fetched prefix.
+	*/
+	async getProviderIssuesForProjectWithTruncation(session, project, options) {
+		const values = await this.getProviderIssuesForProject(session, project, options);
+		if (values == null) return void 0;
+		return {
+			values,
+			truncated: false
+		};
+	}
+};
+__decorate([trace()], IssuesIntegration.prototype, "getAccountForResource", null);
+__decorate([gate()], IssuesIntegration.prototype, "getAccountForResourceResult", null);
+__decorate([trace()], IssuesIntegration.prototype, "getResourcesForUser", null);
+__decorate([gate()], IssuesIntegration.prototype, "getResourcesForUserResult", null);
+__decorate([trace()], IssuesIntegration.prototype, "getProjectsForResourcesWithMetadataResult", null);
+__decorate([trace()], IssuesIntegration.prototype, "getIssuesForProject", null);
+//#endregion
+export { IssuesIntegration, isIssuesIntegration };
+
 //# sourceMappingURL=issuesIntegration.js.map

package/dist/plus/integrations/models/issuesIntegration.js.map

@@ -1 +1 @@
-{"version":3,"file":"issuesIntegration.js","sourceRoot":"","sources":["../../../../src/plus/integrations/models/issuesIntegration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"issuesIntegration.js","names":[],"sources":["../../../../../plus/integrations/src/models/issuesIntegration.ts"],"sourcesContent":["import type { Account } from '@gitlens/git/models/author.js';\nimport type { Issue, IssueShape } from '@gitlens/git/models/issue.js';\nimport type { ResourceDescriptor } from '@gitlens/git/models/resourceDescriptor.js';\nimport { gate } from '@gitlens/utils/decorators/gate.js';\nimport { trace } from '@gitlens/utils/decorators/log.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport type { ProviderAuthenticationSession } from '../authentication/models.js';\nimport type { IntegrationIds } from '../constants.js';\nimport { IntegrationReadUnavailableError, toError } from '../errors.js';\nimport type { ProviderApiCollectionResult } from '../providers/models.js';\nimport type { Integration, IntegrationResult, IntegrationType } from './integration.js';\nimport { IntegrationBase } from './integration.js';\nimport type { IssuesForProjectOptions, ProjectIssuesDrain } from './issueReads.js';\n\nexport function isIssuesIntegration(integration: Integration): integration is IssuesIntegration {\n\treturn integration.type === 'issues';\n}\n\nexport abstract class IssuesIntegration<\n\tID extends IntegrationIds = IntegrationIds,\n\tT extends ResourceDescriptor = ResourceDescriptor,\n> extends IntegrationBase<ID> {\n\treadonly type: IntegrationType = 'issues';\n\n\tget supportsIssueLookupByResourceId(): boolean {\n\t\treturn this.getProviderIssueByResourceId != null;\n\t}\n\n\tgetIssueByResourceIdResult(\n\t\tresourceId: string,\n\t\tid: string,\n\t\toptions?: { connectionId?: string; expiryOverride?: boolean | number; resourceUrl?: string },\n\t): Promise<IntegrationResult<Issue | undefined>> {\n\t\tconst getProviderIssue = this.getProviderIssueByResourceId;\n\t\tif (getProviderIssue == null) {\n\t\t\treturn Promise.resolve({\n\t\t\t\terror: new IntegrationReadUnavailableError(\n\t\t\t\t\tthis.name,\n\t\t\t\t\t'does not support direct issue reads by resource id',\n\t\t\t\t),\n\t\t\t});\n\t\t}\n\n\t\tconst { resourceUrl, ...readOptions } = options ?? {};\n\t\tconst resource = { key: resourceId, resourceId: resourceId, resourceUrl: resourceUrl };\n\t\treturn this.getIssueResultCore(resource, id, readOptions, session =>\n\t\t\tgetProviderIssue.call(this, session, resourceId, id, resourceUrl),\n\t\t);\n\t}\n\n\tprotected getProviderIssueByResourceId?(\n\t\t_session: ProviderAuthenticationSession,\n\t\t_resourceId: string,\n\t\t_id: string,\n\t\t_resourceUrl: string | undefined,\n\t): Promise<Issue | undefined>;\n\n\t@trace()\n\tasync getAccountForResource(resource: T, connectionId?: string): Promise<Account | undefined> {\n\t\treturn (await this.getAccountForResourceResult(resource, connectionId))?.value;\n\t}\n\n\t/**\n\t * Result-returning core of {@link getAccountForResource}. Recovers a thrown error into `{ error }` so\n\t * callers can preserve its classification (e.g. a 401/403 → an `auth` warning that drives re-auth)\n\t * instead of collapsing every failure into an untyped `undefined`. Gated here (not on the wrapper) so\n\t * direct callers such as the ProviderBackend facade share the same dedup as `getAccountForResource`.\n\t */\n\t@gate()\n\tasync getAccountForResourceResult(\n\t\tresource: T,\n\t\tconnectionId?: string,\n\t): Promise<IntegrationResult<Account | undefined>> {\n\t\tconst scope = getScopedLogger();\n\t\t// `connectionId` targets a specific account (multi-account); omitted reads the primary.\n\t\tconst session = await this.resolveReadSession(connectionId, scope);\n\t\tif (session == null) return undefined;\n\n\t\ttry {\n\t\t\tconst account = await this.getProviderAccountForResource(session, resource);\n\t\t\tthis.resetRequestExceptionCount('getAccountForResource');\n\t\t\treturn { value: account };\n\t\t} catch (ex) {\n\t\t\tthis.handleProviderException('getAccountForResource', ex, { connectionId: connectionId });\n\t\t\treturn { error: toError(ex) };\n\t\t}\n\t}\n\n\tprotected abstract getProviderAccountForResource(\n\t\tsession: ProviderAuthenticationSession,\n\t\tresource: T,\n\t): Promise<Account | undefined>;\n\n\t@trace()\n\tasync getResourcesForUser(connectionId?: string): Promise<T[] | undefined> {\n\t\treturn (await this.getResourcesForUserResult(connectionId))?.value;\n\t}\n\n\t/**\n\t * Result-returning core of {@link getResourcesForUser}. Recovers thrown errors into `{ error }` so callers\n\t * can surface them as warnings rather than silently swallowing them to `undefined`. Gated here (not on the\n\t * wrapper) so direct callers such as the ProviderBackend facade share the same dedup as `getResourcesForUser`.\n\t */\n\t@gate()\n\tasync getResourcesForUserResult(connectionId?: string): Promise<IntegrationResult<T[] | undefined>> {\n\t\tconst scope = getScopedLogger();\n\t\t// `connectionId` targets a specific account (multi-account); omitted reads the primary.\n\t\tconst session = await this.resolveReadSession(connectionId, scope);\n\t\tif (session == null) return undefined;\n\n\t\ttry {\n\t\t\tconst resources = await this.getProviderResourcesForUser(session);\n\t\t\tthis.resetRequestExceptionCount('getResourcesForUser');\n\t\t\treturn { value: resources };\n\t\t} catch (ex) {\n\t\t\tthis.handleProviderException('getResourcesForUser', ex, { connectionId: connectionId });\n\t\t\treturn { error: toError(ex) };\n\t\t}\n\t}\n\n\tprotected abstract getProviderResourcesForUser(session: ProviderAuthenticationSession): Promise<T[] | undefined>;\n\n\t/**\n\t * Project discovery for a set of resources, returning the SDK collection `{ values, metadata }` (completeness\n\t * + per-resource failures) so callers can warn on failed resources and set `fetchFailed` without discarding\n\t * the resources that succeeded. Thrown errors are recovered into `{ error }` for the same reason: a caller\n\t * surfaces them as a warning rather than swallowing them to `undefined`.\n\t */\n\t@trace()\n\tasync getProjectsForResourcesWithMetadataResult(\n\t\tresources: T[],\n\t\tconnectionId?: string,\n\t): Promise<IntegrationResult<ProviderApiCollectionResult<T> | undefined>> {\n\t\tconst scope = getScopedLogger();\n\t\t// `connectionId` targets a specific account (multi-account); omitted reads the primary.\n\t\tconst session = await this.resolveReadSession(connectionId, scope);\n\t\tif (session == null) return undefined;\n\n\t\ttry {\n\t\t\tconst projects = await this.getProviderProjectsForResourcesWithMetadata(session, resources);\n\t\t\tthis.resetRequestExceptionCount('getProjectsForResources');\n\t\t\treturn { value: projects };\n\t\t} catch (ex) {\n\t\t\tthis.handleProviderException('getProjectsForResources', ex, { connectionId: connectionId });\n\t\t\treturn { error: toError(ex) };\n\t\t}\n\t}\n\n\t/**\n\t * Metadata-aware provider project discovery. The default wraps the array-returning\n\t * {@link getProviderProjectsForResources} in `{ values }` with no metadata, so providers without a\n\t * fan-out completeness signal (Linear, Trello) need no change; Jira overrides it to preserve the SDK's\n\t * per-resource completeness/failures.\n\t */\n\tprotected async getProviderProjectsForResourcesWithMetadata(\n\t\tsession: ProviderAuthenticationSession,\n\t\tresources: T[],\n\t): Promise<ProviderApiCollectionResult<T>> {\n\t\tconst projects = await this.getProviderProjectsForResources(session, resources);\n\t\treturn { values: projects ?? [] };\n\t}\n\n\tprotected abstract getProviderProjectsForResources(\n\t\tsession: ProviderAuthenticationSession,\n\t\tresources: T[],\n\t): Promise<T[] | undefined>;\n\n\t@trace()\n\tasync getIssuesForProject(\n\t\tproject: T,\n\t\toptions?: IssuesForProjectOptions,\n\t\tconnectionId?: string,\n\t): Promise<IssueShape[] | undefined> {\n\t\treturn (await this.getIssuesForProjectResult(project, options, connectionId))?.value;\n\t}\n\n\t/**\n\t * Result-returning core of {@link getIssuesForProject}. Recovers thrown errors into `{ error }` so callers\n\t * (e.g. the ProviderBackend facade) can surface a per-provider warning instead of a silent empty read —\n\t * important for providers that throw on unsupported operations (e.g. Linear's not-implemented issue read).\n\t */\n\tasync getIssuesForProjectResult(\n\t\tproject: T,\n\t\toptions?: IssuesForProjectOptions,\n\t\tconnectionId?: string,\n\t): Promise<IntegrationResult<IssueShape[] | undefined>> {\n\t\tconst scope = getScopedLogger();\n\t\t// `connectionId` targets a specific account (multi-account); omitted reads the primary.\n\t\tconst session = await this.resolveReadSession(connectionId, scope);\n\t\tif (session == null) return undefined;\n\n\t\ttry {\n\t\t\tconst issues = await this.getProviderIssuesForProject(session, project, options);\n\t\t\tthis.resetRequestExceptionCount('getIssuesForProject');\n\t\t\treturn { value: issues };\n\t\t} catch (ex) {\n\t\t\tthis.handleProviderException('getIssuesForProject', ex, { connectionId: connectionId });\n\t\t\treturn { error: toError(ex) };\n\t\t}\n\t}\n\n\t/**\n\t * Truncation-aware variant of {@link getIssuesForProjectResult}. A provider that drains a project's issues\n\t * with an internal page backstop (Jira/Linear) overrides {@link getProviderIssuesForProjectWithTruncation}\n\t * to report when that backstop was hit, so the facade can surface an incomplete project read instead of\n\t * publishing it as complete. The default reports `truncated: false`.\n\t */\n\tasync getIssuesForProjectWithTruncationResult(\n\t\tproject: T,\n\t\toptions?: IssuesForProjectOptions,\n\t\tconnectionId?: string,\n\t): Promise<IntegrationResult<ProjectIssuesDrain | undefined>> {\n\t\tconst scope = getScopedLogger();\n\t\tconst session = await this.resolveReadSession(connectionId, scope);\n\t\tif (session == null) return undefined;\n\n\t\ttry {\n\t\t\tconst result = await this.getProviderIssuesForProjectWithTruncation(session, project, options);\n\t\t\tthis.resetRequestExceptionCount('getIssuesForProject');\n\t\t\treturn { value: result };\n\t\t} catch (ex) {\n\t\t\tthis.handleProviderException('getIssuesForProject', ex, { connectionId: connectionId });\n\t\t\treturn { error: toError(ex) };\n\t\t}\n\t}\n\n\tprotected abstract getProviderIssuesForProject(\n\t\tsession: ProviderAuthenticationSession,\n\t\tproject: T,\n\t\toptions?: IssuesForProjectOptions,\n\t): Promise<IssueShape[] | undefined>;\n\n\t/**\n\t * Truncation-aware core of {@link getProviderIssuesForProject}. The default wraps the plain read and\n\t * reports `truncated: false`; a provider whose per-project drain is capped by a page backstop overrides\n\t * this to report incompleteness. Optional metadata lets providers surface structured per-project failures\n\t * (e.g. a page-level auth rejection) without discarding the already-fetched prefix.\n\t */\n\tprotected async getProviderIssuesForProjectWithTruncation(\n\t\tsession: ProviderAuthenticationSession,\n\t\tproject: T,\n\t\toptions?: IssuesForProjectOptions,\n\t): Promise<ProjectIssuesDrain | undefined> {\n\t\tconst values = await this.getProviderIssuesForProject(session, project, options);\n\t\tif (values == null) return undefined;\n\t\treturn { values: values, truncated: false };\n\t}\n}\n"],"mappings":"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"}

package/dist/plus/integrations/models/pullRequestReads.d.ts

@@ -1,4 +1,6 @@
-import type { PullRequestShape } from '../../../git/models/pullRequest.js';
+import { PullRequestShape } from "../../../git/models/pullRequest.js";
+import { CollectionMetadata } from "@gitkraken/provider-apis";
+//#region ../plus/integrations/src/models/pullRequestReads.d.ts
 /**
  * One provider page of the filtered pull-request search, before the facade turns it into a neutral
  * paged result with warnings.
@@ -6,13 +8,39 @@ import type { PullRequestShape } from '../../../git/models/pullRequest.js';
  * `totalCount` is the provider-reported pre-ceiling facet count, not the number of rows that remain reachable
  * after a provider limit. It stays optional because absence means "not reported", never zero. Together with
  * `truncated` it lets the facade distinguish GitHub's quantified ceiling from another unusable continuation.
+ *
+ * `metadata` carries the facets whose rows are missing from the walk so far — Bitbucket Data Center reads every
+ * facet as its own request, so one can be refused (a repository the token can't see) without the others. It
+ * describes the whole walk rather than one page: a facet that failed on this page is reported here and retried on
+ * the next, and one whose retry failed too is dropped and reported on every later page, since its hole is still in
+ * the result. A retry that succeeds recovers the rows, so it drops out. The last page read is therefore the one to
+ * assess; the facade reports each failure as a warning with `fetchFailed`, and a page where EVERY facet failed
+ * throws instead.
  */
 export type ProviderPullRequestSearchPage = {
-    values: PullRequestShape[];
-    truncated: boolean;
-    cursor?: string;
-    hasMore: boolean;
-    page: number;
-    totalCount?: number;
+  values: PullRequestShape[];
+  truncated: boolean;
+  cursor?: string;
+  hasMore: boolean;
+  page: number;
+  totalCount?: number;
+  metadata?: CollectionMetadata;
+  /** See `ProviderIssueSearchPage.limitReached`. */
+  limitReached?: boolean;
+};
+/**
+ * One scope's pull-request count, as the provider reports it.
+ *
+ * `lowerBound` marks a count that stopped before the scope was exhausted: a provider with no count query
+ * (Bitbucket Data Center) counts by reading, within a budget, so past it `count` is how many matched in what was
+ * read — a floor, never the total.
+ *
+ * An `Error` in its place refuses that ONE scope for its own reasons (Azure DevOps Server refusing a scope it can't
+ * search): the facade warns and drops only it, as it does for a scope it refuses itself.
+ */
+export type ProviderPullRequestCount = {
+  count: number | undefined;
+  lowerBound?: boolean;
 };
+//#endregion
 //# sourceMappingURL=pullRequestReads.d.ts.map

package/dist/plus/integrations/models/pullRequestReads.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=pullRequestReads.js.map