@gitkraken/core-gitlens 0.9.3 → 0.9.5

package/dist/plus/integrations/providers/linearIssuesEtag.js

@@ -0,0 +1,94 @@
+//#region ../plus/integrations/src/providers/linearIssuesEtag.ts
+const linearGraphQLUrl = "https://api.linear.app/graphql";
+/** The most issue numbers one cheap check asks of one team. */
+const linearIssuesEtagMaxNumbers = 50;
+/**
+* Archived issues are left out of Linear's `issues` connection unless asked for, so `includeArchived` keeps an archived
+* issue answerable here as the full read's `issue(id:)` answers it.
+*/
+const linearIssuesEtagQuery = `
+	query GetIssuesEtagFields($teamKey: String!, $numbers: [Float!]!) {
+		issues(
+			first: 50
+			includeArchived: true
+			filter: { team: { key: { eq: $teamKey } }, number: { in: $numbers } }
+		) {
+			pageInfo {
+				hasNextPage
+			}
+			nodes {
+				identifier
+				number
+				updatedAt
+				archivedAt
+				state {
+					type
+				}
+			}
+		}
+	}
+`;
+/**
+* The cheap check behind the batch issue read's etags: the change state of up to {@link linearIssuesEtagMaxNumbers}
+* issues of one team in ONE GraphQL request, where the full read sends provider-apis' `issue(id:)` once per issue.
+* Linear returns only the issues it found, in its own order, so a caller matches them by number, never by position.
+*
+* Sent as provider-apis sends every Linear request: the token as the whole `Authorization` header, with no scheme.
+* GraphQL `errors` reject the whole request, as provider-apis rejects them, but keep the response so a throttling
+* code is still classified as one. A next page also rejects it: with every number unique within a team, more
+* issues than were asked for means the filter was not applied as written.
+*/
+async function requestLinearIssuesEtagFields(request, accessToken, teamKey, numbers) {
+	const response = await request({
+		url: linearGraphQLUrl,
+		method: "POST",
+		headers: {
+			Authorization: accessToken,
+			"Content-Type": "application/json"
+		},
+		body: JSON.stringify({
+			query: linearIssuesEtagQuery,
+			variables: {
+				teamKey,
+				numbers
+			}
+		})
+	});
+	const body = response.body;
+	if (body?.errors != null) {
+		const error = /* @__PURE__ */ new Error(`Linear GraphQL errors: ${JSON.stringify(body.errors)}`);
+		Object.assign(error, { response });
+		throw error;
+	}
+	const issues = body?.data?.issues;
+	if (!Array.isArray(issues?.nodes)) throw new Error("Linear returned no issues");
+	if (issues.pageInfo?.hasNextPage !== false) throw new Error("Linear returned more issues than were asked for");
+	return issues.nodes;
+}
+/**
+* A cheap-checked issue's change state, as the fields the full row's etag reads. The full read's row is provider-apis'
+* Linear issue normalizer (0.61.0) then `fromProviderIssue`, so this mirrors both:
+*
+* - provider-apis maps `state.type` to a category — `completed` and `canceled` to `DONE`, `started` to `IN_PROGRESS`,
+*   anything else (`backlog`, `unstarted`, `triage`) to `TO_DO`, and no state to none — and sets `closedDate` from
+*   `archivedAt` (a falsy value reads as none);
+* - `fromProviderIssue` closes an issue that has a `closedDate` or a `DONE` category, so an archived issue is closed
+*   whatever its state.
+*
+* Throws on a missing or unparseable `updatedAt`, so the target falls through to the full read rather than matching an
+* etag the full row would compute from a fallback date (`fromProviderIssue` falls back to `closedDate`, then
+* `createdDate`).
+*/
+function toLinearIssueEtagFields(issue) {
+	const updatedDate = new Date(issue.updatedAt || NaN);
+	if (Number.isNaN(updatedDate.getTime())) throw new Error(`Linear returned no update time for ${issue.identifier}`);
+	const type = issue.state?.type;
+	return {
+		state: Boolean(issue.archivedAt) || type === "completed" || type === "canceled" ? "closed" : "opened",
+		updatedDate
+	};
+}
+//#endregion
+export { linearIssuesEtagMaxNumbers, requestLinearIssuesEtagFields, toLinearIssueEtagFields };
+
+//# sourceMappingURL=linearIssuesEtag.js.map

package/dist/plus/integrations/providers/linearIssuesEtag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linearIssuesEtag.js","names":[],"sources":["../../../../../plus/integrations/src/providers/linearIssuesEtag.ts"],"sourcesContent":["import type { IssueEtagFields } from '../models/integration.js';\nimport type { ProviderRequestFunction } from './models.js';\n\nconst linearGraphQLUrl = 'https://api.linear.app/graphql';\n\n/** The most issue numbers one cheap check asks of one team. */\nexport const linearIssuesEtagMaxNumbers = 50;\n\n/**\n * Archived issues are left out of Linear's `issues` connection unless asked for, so `includeArchived` keeps an archived\n * issue answerable here as the full read's `issue(id:)` answers it.\n */\nconst linearIssuesEtagQuery = `\n\tquery GetIssuesEtagFields($teamKey: String!, $numbers: [Float!]!) {\n\t\tissues(\n\t\t\tfirst: ${linearIssuesEtagMaxNumbers}\n\t\t\tincludeArchived: true\n\t\t\tfilter: { team: { key: { eq: $teamKey } }, number: { in: $numbers } }\n\t\t) {\n\t\t\tpageInfo {\n\t\t\t\thasNextPage\n\t\t\t}\n\t\t\tnodes {\n\t\t\t\tidentifier\n\t\t\t\tnumber\n\t\t\t\tupdatedAt\n\t\t\t\tarchivedAt\n\t\t\t\tstate {\n\t\t\t\t\ttype\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n`;\n\nexport type LinearIssueEtagNode = {\n\tidentifier: string;\n\tnumber: number;\n\tupdatedAt?: string | null;\n\tarchivedAt?: string | null;\n\tstate?: { type?: string | null } | null;\n};\n\ntype LinearIssuesEtagResponse = {\n\tdata?: {\n\t\tissues?: { pageInfo?: { hasNextPage?: boolean }; nodes?: LinearIssueEtagNode[] } | null;\n\t} | null;\n\terrors?: unknown[];\n};\n\n/**\n * The cheap check behind the batch issue read's etags: the change state of up to {@link linearIssuesEtagMaxNumbers}\n * issues of one team in ONE GraphQL request, where the full read sends provider-apis' `issue(id:)` once per issue.\n * Linear returns only the issues it found, in its own order, so a caller matches them by number, never by position.\n *\n * Sent as provider-apis sends every Linear request: the token as the whole `Authorization` header, with no scheme.\n * GraphQL `errors` reject the whole request, as provider-apis rejects them, but keep the response so a throttling\n * code is still classified as one. A next page also rejects it: with every number unique within a team, more\n * issues than were asked for means the filter was not applied as written.\n */\nexport async function requestLinearIssuesEtagFields(\n\trequest: ProviderRequestFunction,\n\taccessToken: string,\n\tteamKey: string,\n\tnumbers: readonly number[],\n): Promise<LinearIssueEtagNode[]> {\n\tconst response = await request<LinearIssuesEtagResponse | null>({\n\t\turl: linearGraphQLUrl,\n\t\tmethod: 'POST',\n\t\theaders: { Authorization: accessToken, 'Content-Type': 'application/json' },\n\t\tbody: JSON.stringify({ query: linearIssuesEtagQuery, variables: { teamKey: teamKey, numbers: numbers } }),\n\t});\n\n\tconst body = response.body;\n\tif (body?.errors != null) {\n\t\tconst error = new Error(`Linear GraphQL errors: ${JSON.stringify(body.errors)}`);\n\t\tObject.assign(error, { response: response });\n\t\tthrow error;\n\t}\n\n\tconst issues = body?.data?.issues;\n\tif (!Array.isArray(issues?.nodes)) throw new Error('Linear returned no issues');\n\tif (issues.pageInfo?.hasNextPage !== false) throw new Error('Linear returned more issues than were asked for');\n\n\treturn issues.nodes;\n}\n\n/**\n * A cheap-checked issue's change state, as the fields the full row's etag reads. The full read's row is provider-apis'\n * Linear issue normalizer (0.61.0) then `fromProviderIssue`, so this mirrors both:\n *\n * - provider-apis maps `state.type` to a category — `completed` and `canceled` to `DONE`, `started` to `IN_PROGRESS`,\n *   anything else (`backlog`, `unstarted`, `triage`) to `TO_DO`, and no state to none — and sets `closedDate` from\n *   `archivedAt` (a falsy value reads as none);\n * - `fromProviderIssue` closes an issue that has a `closedDate` or a `DONE` category, so an archived issue is closed\n *   whatever its state.\n *\n * Throws on a missing or unparseable `updatedAt`, so the target falls through to the full read rather than matching an\n * etag the full row would compute from a fallback date (`fromProviderIssue` falls back to `closedDate`, then\n * `createdDate`).\n */\nexport function toLinearIssueEtagFields(issue: LinearIssueEtagNode): IssueEtagFields {\n\tconst updatedDate = new Date(issue.updatedAt || Number.NaN);\n\tif (Number.isNaN(updatedDate.getTime())) {\n\t\tthrow new Error(`Linear returned no update time for ${issue.identifier}`);\n\t}\n\n\tconst type = issue.state?.type;\n\tconst closed = Boolean(issue.archivedAt) || type === 'completed' || type === 'canceled';\n\treturn { state: closed ? 'closed' : 'opened', updatedDate: updatedDate };\n}\n"],"mappings":";AAGA,MAAM,mBAAmB;;AAGzB,MAAa,6BAA6B;;;;;AAM1C,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgD9B,eAAsB,8BACrB,SACA,aACA,SACA,SACiC;CACjC,MAAM,WAAW,MAAM,QAAyC;EAC/D,KAAK;EACL,QAAQ;EACR,SAAS;GAAE,eAAe;GAAa,gBAAgB;EAAmB;EAC1E,MAAM,KAAK,UAAU;GAAE,OAAO;GAAuB,WAAW;IAAW;IAAkB;GAAQ;EAAE,CAAC;CACzG,CAAC;CAED,MAAM,OAAO,SAAS;CACtB,IAAI,MAAM,UAAU,MAAM;EACzB,MAAM,wBAAQ,IAAI,MAAM,0BAA0B,KAAK,UAAU,KAAK,MAAM,GAAG;EAC/E,OAAO,OAAO,OAAO,EAAY,SAAS,CAAC;EAC3C,MAAM;CACP;CAEA,MAAM,SAAS,MAAM,MAAM;CAC3B,IAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,GAAG,MAAM,IAAI,MAAM,2BAA2B;CAC9E,IAAI,OAAO,UAAU,gBAAgB,OAAO,MAAM,IAAI,MAAM,iDAAiD;CAE7G,OAAO,OAAO;AACf;;;;;;;;;;;;;;;AAgBA,SAAgB,wBAAwB,OAA6C;CACpF,MAAM,cAAc,IAAI,KAAK,MAAM,aAAa,GAAU;CAC1D,IAAI,OAAO,MAAM,YAAY,QAAQ,CAAC,GACrC,MAAM,IAAI,MAAM,sCAAsC,MAAM,YAAY;CAGzE,MAAM,OAAO,MAAM,OAAO;CAE1B,OAAO;EAAE,OADM,QAAQ,MAAM,UAAU,KAAK,SAAS,eAAe,SAAS,aACpD,WAAW;EAAuB;CAAY;AACxE"}

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

@@ -2,15 +2,15 @@ import { PagedResult } from "../../../utils/paging.js";
 import { ProviderScope } from "../../../git/models/resourceDescriptor.js";
 import { Provider, ProviderReference } from "../../../git/models/remoteProvider.js";
 import { IssueOrPullRequestState } from "../../../git/models/issueOrPullRequest.js";
-import { Issue as Issue$1, IssueProject, IssueSearchCapabilities, IssueSearchCriteria, IssueSearchRelationship, IssueShape, IssueSortField, IssueSorting, IssueStateFilter } from "../../../git/models/issue.js";
-import { PullRequest, PullRequestFilter, PullRequestMergeableState, PullRequestRefs, PullRequestRepositoryIdentityDescriptor, PullRequestSearchCapabilities, PullRequestSearchCriteria, PullRequestSortField, PullRequestSorting, PullRequestStateFilter, PullRequestStatusCheckRollupState } from "../../../git/models/pullRequest.js";
+import { Issue as Issue$1, IssueProject, IssueProjection, IssueSearchCapabilities, IssueSearchCriteria, IssueSearchRelationship, IssueShape, IssueSortField, IssueSorting, IssueStateFilter } from "../../../git/models/issue.js";
+import { PullRequest, PullRequestFilter, PullRequestMergeableState, PullRequestProjection, PullRequestRefs, PullRequestRepositoryIdentityDescriptor, PullRequestSearchCapabilities, PullRequestSearchCriteria, PullRequestSortField, PullRequestSorting, PullRequestStateFilter, PullRequestStatusCheckRollupState } from "../../../git/models/pullRequest.js";
 import { Account as Account$1 } from "../../../git/models/author.js";
 import { IntegrationIds } from "../constants.js";
-import { IssueFilter } from "../providerFilters.js";
 import { ProviderOrganization, ProviderRepositoryShape } from "../results.js";
-import { Integration, IntegrationType } from "../models/integration.js";
+import { IssueFilter } from "../providerFilters.js";
 import { ProviderPullRequestReviews } from "./pullRequestReviews.js";
-import { Account, ActionablePullRequest, AnyEntityIdentifierInput, AzureDevOps, AzureOrganization, AzureProject, AzureSetPullRequestInput, Bitbucket, BitbucketServer, BitbucketWorkspaceStub, CollectionMetadata, CursorPageInput, EnterpriseOptions, GetRepoInput, GitBuildStatusState as GitBuildStatusState$1, GitHub, GitHubPullRequestFieldMap, GitIssueState as GitIssueState$1, GitLab, GitLabGroup, GitMergeStrategy, GitPullRequest, GitPullRequestMergeableState as GitPullRequestMergeableState$1, GitPullRequestReviewState as GitPullRequestReviewState$1, GitPullRequestState as GitPullRequestState$1, GitRepository, Issue, Jira, JiraProject, JiraResource, JiraServer, JiraServerProject, Linear, LinearOrganization, LinearTeam, NumberedPageInput, Organization, PullRequestWithUniqueID, RequestFunction, RequestOptions, Response, SetPullRequestInput, Trello } from "@gitkraken/provider-apis";
+import { Integration, IntegrationType } from "../models/integration.js";
+import { Account, ActionablePullRequest, AnyEntityIdentifierInput, AzureDevOps, AzureOrganization, AzureProject, AzureSetPullRequestInput, Bitbucket, BitbucketServer, BitbucketWorkspaceStub, CollectionMetadata, CursorPageInput, EnterpriseOptions, GetRepoInput, GitBuildStatus, GitBuildStatusState as GitBuildStatusState$1, GitHub, GitHubPullRequestFieldMap, GitIssueState as GitIssueState$1, GitLab, GitLabGroup, GitMergeStrategy, GitPullRequest, GitPullRequestMergeableState as GitPullRequestMergeableState$1, GitPullRequestReviewState as GitPullRequestReviewState$1, GitPullRequestState as GitPullRequestState$1, GitRepository, Issue, Jira, JiraProject, JiraResource, JiraServer, JiraServerProject, Linear, LinearOrganization, LinearTeam, NumberedPageInput, Organization, PullRequestWithUniqueID, RequestFunction, RequestOptions, Response, SetPullRequestInput, Trello } from "@gitkraken/provider-apis";
 //#region ../plus/integrations/src/providers/models.d.ts
 type GitBuildStatusState = GitBuildStatusState$1;
 type GitIssueState = GitIssueState$1;
@@ -77,8 +77,13 @@ export type ProviderRepoInput = GetRepoInput;
  * from the parameter type.
  */
 export declare function isRepoIdsInput(input: unknown): input is (string | number)[];
-export type ProviderPullRequest = Omit<GitPullRequest, 'reviews'> & {
+/**
+ * provider-apis' pull request. `mergeableState` is optional because {@link toProviderPullRequest} also converts
+ * GitLens' own rows, and a read that didn't select it has none to give.
+ */
+export type ProviderPullRequest = Omit<GitPullRequest, 'reviews' | 'mergeableState'> & {
   reviews: ProviderPullRequestReviews;
+  mergeableState?: GitPullRequestMergeableState;
 };
 export type ProviderRepository = GitRepository;
 export type ProviderIssue = Issue;
@@ -98,7 +103,7 @@ export type ProviderGitLabGroup = GitLabGroup;
  * so an id alone is never safe for deduplication across a multi-repository fan-out. Repository identity wins
  * when available so the same row still deduplicates when a later facet adds or removes its URL.
  */
-export declare function getProviderPullRequestIdentity(pr: Pick<ProviderPullRequest, 'id' | 'repository' | 'url'>): string | undefined;
+export declare function getProviderPullRequestIdentity(pr: Pick<ProviderPullRequest, 'id' | 'repository' | 'url'> | Pick<PullRequest, 'id' | 'repository' | 'url'>): string | undefined;
 export type ProviderHierarchyResult<T> = PagedResult<T> & {
   readonly truncated?: boolean;
   /**
@@ -367,6 +372,8 @@ export type GetIssuesForCurrentUserInput = PagingInput & {
   assigneeUsername?: string;
   authorUsername?: string;
   pageSize?: number;
+  /** Linear only (GitLab's REST read has its own `state`, not threaded here). Omitted reads open issues. */
+  states?: GitIssueState[];
   /** See {@link GetIssuesOptions.sort}. */
   sort?: IssueSorting;
 };
@@ -440,6 +447,7 @@ export type GetLinearIssuesFn = (input: {
   teams?: string[];
   projects?: string[];
   labels?: string[];
+  states?: GitIssueState[];
 } & PagingInput, options?: EnterpriseOptions) => Promise<{
   data: ProviderIssue[];
   pageInfo?: PageInfo;
@@ -661,6 +669,16 @@ export interface ProviderMetadata {
    * honor, which is what makes intersecting against it sufficient.
    */
   supportedAccountWideIssueSorts?: IssueSorting[];
+  /**
+   * Whether an issue tracker's reads (the project-scoped read, which is `listIssueTrackerIssuesPage`, and its
+   * account-wide read) can be asked for a `state` other than open, and honor it server-side.
+   *
+   * A tracker read is open-only unless asked otherwise, so absent does not mean the read returns every state: it
+   * means only `'open'` is expressible, and `'closed'`/`'all'` are refused rather than served as the open list.
+   * Server-side, because each read drains to a page backstop: dropping states afterwards would let a project full
+   * of done work spend that budget before reaching the open issues.
+   */
+  supportsIssueStates?: boolean;
   /**
    * What the provider's FILTERED issue search (`searchIssuesPage`, and the `countIssues` probe over the same
    * criteria) can express server-side. A third, wider surface than either filter set above: it is not bound to
@@ -697,6 +715,7 @@ export declare const providersMetadata: ProvidersMetadata;
 export declare function getReasonsForUserIssue(issue: ProviderIssue, userLogin: string): string[];
 export declare function toIssueShape(issue: ProviderIssue, provider: ProviderReference, options?: {
   reliableStateCategory?: boolean;
+  projection?: IssueProjection;
 }): IssueShape | undefined;
 /**
  * Maps a raw provider-apis {@link ProviderRepository} to the GitLens-owned {@link ProviderRepositoryShape}
@@ -724,6 +743,13 @@ export declare const fromProviderBuildStatusState: {
   [GitBuildStatusState.Running]: undefined;
   [GitBuildStatusState.Warning]: undefined;
 };
+/** Rolls every check context up into one state, the way a provider's own rollup does: failed, errored, or
+ *  action-required fails; else pending or running is pending; else success — reading only the first context
+ *  would call a pull request passing on the strength of whichever check happens to come back first. States
+ *  carrying no verdict (cancelled, skipped, optional action required, warning) don't vote. Reads the raw
+ *  state rather than `fromProviderBuildStatusState`, which drops errored and running to `undefined` and
+ *  would let a lone success outvote a check still in flight. */
+export declare function toStatusCheckRollupState(statuses: GitBuildStatus[] | null | undefined): PullRequestStatusCheckRollupState | undefined;
 export declare const toProviderPullRequestMergeableState: {
   Mergeable: GitPullRequestMergeableState$1;
   Conflicting: GitPullRequestMergeableState$1;
@@ -746,7 +772,12 @@ export declare function fromProviderPullRequestState(state: GitPullRequestState)
 type PullRequestStateInput = IssueOrPullRequestState | PullRequestStateFilter;
 /** Maps PR include/state filters to the SDK's `states` input. `undefined`/omitted preserves the open-only default. */
 export declare function toProviderPullRequestStates(state: PullRequestStateInput | PullRequestStateInput[] | undefined): GitPullRequestState[] | undefined;
-/** Maps an issue state filter to the SDK's `states` input. `undefined`/omitted preserves the open-only default. */
+/**
+ * Maps an issue state filter to the SDK's `states` input. `undefined`/omitted preserves the open-only default.
+ *
+ * Throws on any other value, which only an untyped caller can pass: read as omitted it would serve open issues as
+ * the state that was asked for. Called before a read's first request, so the throw refuses the whole read.
+ */
 export declare function toProviderIssueStates(state: IssueStateFilter | undefined): GitIssueState[] | undefined;
 /**
  * Resolves a normalized {@link ProviderScope} to the provider-appropriate read inputs, dispatching on the
@@ -770,9 +801,40 @@ export declare function fromProviderPullRequest(pr: ProviderPullRequest, provide
     id: string;
     username?: string;
   };
+  projection?: PullRequestProjection;
+}): PullRequest;
+/**
+ * A GitLens-native row (GitHub's own reads) tagged for the read that returned it, with `authoredByMe` and `viewer`
+ * resolved by the same rule {@link fromProviderPullRequest} applies. Returns a copy: the mapper's row stays as it was
+ * built.
+ */
+export declare function stampNativePullRequest(pr: PullRequest, options: {
+  currentAccount?: {
+    id: string;
+    username?: string;
+  };
+  projection?: PullRequestProjection;
 }): PullRequest;
+/**
+ * A row of an account-wide read as a `PullRequest`. GitHub's are GitLens-native, which {@link stampNativePullRequest}
+ * tags; every other host's are provider-apis', which {@link fromProviderPullRequest} converts.
+ */
+export declare function toPullRequestRow(pr: ProviderPullRequest | PullRequest, provider: Provider, options: {
+  currentAccount?: {
+    id: string;
+    username?: string;
+  };
+  projection?: PullRequestProjection;
+}): PullRequest;
+/**
+ * By shape rather than by class, which a second copy of the model module fails: a native row is a `'pullrequest'` that
+ * names its provider, which provider-apis' rows never do. Both, so a key provider-apis adds later can't reroute its
+ * rows.
+ */
+export declare function isNativePullRequest(pr: ProviderPullRequest | PullRequest): pr is PullRequest;
 export declare function fromProviderIssue(issue: ProviderIssue, integration: Integration, options?: {
   project?: IssueProject;
+  projection?: IssueProjection;
 }): Issue$1;
 export declare function toProviderPullRequestWithUniqueId(pr: PullRequest): PullRequestWithUniqueID;
 export type ProviderActionablePullRequest = ActionablePullRequest;

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

@@ -78,7 +78,7 @@ function getProviderPullRequestIdentity(pr) {
 	const owner = typeof repository.owner === "string" ? repository.owner : repository.owner?.login;
 	const repositoryId = repository.id != null ? String(repository.id).trim() : "";
 	if (repositoryId !== "") return `repository:${repositoryId}:pull-request:${pr.id}`;
-	const name = repository.name?.trim() ?? "";
+	const name = (repository.name ?? repository.repo)?.trim() ?? "";
 	const namespace = (repository.namespace ?? owner)?.trim() ?? "";
 	const project = repository.project?.trim() ?? "";
 	if (name !== "" && (namespace !== "" || project !== "")) return `repository:${namespace}/${project}/${name}:pull-request:${pr.id}`;
@@ -515,7 +515,8 @@ const providersMetadata = {
 			"assignee",
 			"mention"
 		],
-		supportedIssueSorts: jiraIssueSorts
+		supportedIssueSorts: jiraIssueSorts,
+		supportsIssueStates: true
 	},
 	["jira-server"]: {
 		domain: "",
@@ -529,7 +530,8 @@ const providersMetadata = {
 			"assignee",
 			"mention"
 		],
-		supportedIssueSorts: jiraIssueSorts
+		supportedIssueSorts: jiraIssueSorts,
+		supportsIssueStates: true
 	},
 	["linear"]: {
 		domain: "linear.app",
@@ -539,7 +541,8 @@ const providersMetadata = {
 		iconKey: "linear",
 		scopes: [],
 		supportedIssueFilters: ["assignee"],
-		supportedIssueSorts: linearIssueSorts
+		supportedIssueSorts: linearIssueSorts,
+		supportsIssueStates: true
 	},
 	["trello"]: {
 		domain: "trello.com",
@@ -617,7 +620,7 @@ function toIssueShape(issue, provider, options) {
 		repository: issue.repository?.owner?.login != null ? {
 			owner: issue.repository.owner.login,
 			repo: issue.repository.name,
-			id: issue.repository.id
+			id: issue.repository.id || void 0
 		} : void 0,
 		labels: issue.labels.map((label) => ({
 			color: label.color ?? void 0,
@@ -628,7 +631,8 @@ function toIssueShape(issue, provider, options) {
 		body: issue.description ?? void 0,
 		bodyFormat: isJira ? "jira-wiki" : void 0,
 		issueType: issue.type ?? void 0,
-		iterations: toIssueIterations(issue)
+		iterations: toIssueIterations(issue),
+		...options?.projection != null ? { projection: options.projection } : {}
 	};
 }
 function toIssueIterations(issue) {
@@ -760,13 +764,19 @@ function toProviderPullRequestStates(state) {
 	const states = (Array.isArray(state) ? state : [state]).flatMap((s) => toProviderPullRequestStatesCore(s));
 	return states.length > 0 ? [...new Set(states)] : void 0;
 }
-/** Maps an issue state filter to the SDK's `states` input. `undefined`/omitted preserves the open-only default. */
+/**
+* Maps an issue state filter to the SDK's `states` input. `undefined`/omitted preserves the open-only default.
+*
+* Throws on any other value, which only an untyped caller can pass: read as omitted it would serve open issues as
+* the state that was asked for. Called before a read's first request, so the throw refuses the whole read.
+*/
 function toProviderIssueStates(state) {
 	switch (state) {
+		case void 0: return;
 		case "open": return [GitIssueState.Open];
 		case "closed": return [GitIssueState.Closed];
 		case "all": return [GitIssueState.Open, GitIssueState.Closed];
-		default: return;
+		default: throw new Error(`Unknown issue state; expected one of open, closed, all`);
 	}
 }
 /**
@@ -820,7 +830,7 @@ function toProviderPullRequest(pr) {
 		commentCount: pr.commentsCount ?? null,
 		upvoteCount: pr.thumbsUpCount ?? null,
 		commitCount: pr.commitCount ?? null,
-		fileCount: null,
+		fileCount: pr.filesChanged ?? null,
 		additions: pr.additions ?? null,
 		deletions: pr.deletions ?? null,
 		author: toProviderAccount(pr.author),
@@ -863,10 +873,10 @@ function toProviderPullRequest(pr) {
 			url: ""
 		}] } : null,
 		permissions: pr.viewerCanUpdate == null ? null : {
-			canMerge: pr.viewerCanUpdate === true && pr.repository.accessLevel != null && pr.repository.accessLevel >= 30,
+			canMerge: pr.viewerCanUpdate === true && (pr.repository.accessLevel == null || pr.repository.accessLevel >= 30),
 			canMergeAndBypassProtections: pr.viewerCanUpdate === true && pr.repository.accessLevel != null && pr.repository.accessLevel >= 100
 		},
-		mergeableState: pr.mergeableState ? toProviderPullRequestMergeableState[pr.mergeableState] : GitPullRequestMergeableState.Unknown
+		mergeableState: pr.mergeableState ? toProviderPullRequestMergeableState[pr.mergeableState] : void 0
 	};
 }
 function fromProviderPullRequest(pr, provider, options) {
@@ -879,8 +889,7 @@ function fromProviderPullRequest(pr, provider, options) {
 	return new PullRequest(provider, fromProviderAccount(pr.author), pr.id, pr.graphQLId || pr.id, pr.title, pr.url ?? "", {
 		owner: repositoryOwner,
 		repo: repositoryName,
-		accessLevel: 30,
-		id: repository?.id ?? ""
+		id: repository?.id || void 0
 	}, fromProviderPullRequestState(pr.state), pr.createdDate, pr.updatedDate, pr.closedDate ?? void 0, pr.mergedDate ?? void 0, pr.mergeableState ? fromProviderPullRequestMergeableState[pr.mergeableState] : void 0, pr.permissions?.canMerge || pr.permissions?.canMergeAndBypassProtections ? true : void 0, {
 		base: {
 			branch: pr.baseRef?.name ?? "",
@@ -904,7 +913,35 @@ function fromProviderPullRequest(pr, provider, options) {
 			isFork: headRepository?.isFork
 		},
 		isCrossRepository: pr.isCrossRepository
-	}, pr.isDraft, pr.additions ?? void 0, pr.deletions ?? void 0, pr.commentCount ?? void 0, pr.upvoteCount ?? void 0, pr.reviewDecision ? fromPullRequestReviewDecision[pr.reviewDecision] : void 0, toReviewRequests(pr.reviews), toCompletedReviews(pr.reviews), pr.assignees?.map(fromProviderAccount) ?? void 0, toStatusCheckRollupState(pr.headCommit?.buildStatuses), options?.project, pr.version, pr.commitCount ?? void 0, void 0, pr.fileCount ?? void 0, pr.description ?? void 0, pr.number, options?.currentAccount != null ? authoredByCurrentAccount(pr, provider, options.currentAccount) : void 0);
+	}, pr.isDraft, pr.additions ?? void 0, pr.deletions ?? void 0, pr.commentCount ?? void 0, pr.upvoteCount ?? void 0, pr.reviewDecision ? fromPullRequestReviewDecision[pr.reviewDecision] : void 0, toReviewRequests(pr.reviews), toCompletedReviews(pr.reviews), pr.assignees?.map(fromProviderAccount) ?? void 0, toStatusCheckRollupState(pr.headCommit?.buildStatuses), options?.project, pr.version, pr.commitCount ?? void 0, void 0, pr.fileCount ?? void 0, pr.description ?? void 0, pr.number, options?.currentAccount != null ? authoredByCurrentAccount(pr.author, provider, options.currentAccount) : void 0, options?.projection, options?.currentAccount);
+}
+/**
+* A GitLens-native row (GitHub's own reads) tagged for the read that returned it, with `authoredByMe` and `viewer`
+* resolved by the same rule {@link fromProviderPullRequest} applies. Returns a copy: the mapper's row stays as it was
+* built.
+*/
+function stampNativePullRequest(pr, options) {
+	return Object.assign(Object.create(PullRequest.prototype), pr, {
+		authoredByMe: options.currentAccount != null ? authoredByCurrentAccount(pr.author, pr.provider, options.currentAccount) : void 0,
+		viewer: options.currentAccount,
+		projection: options.projection
+	});
+}
+/**
+* A row of an account-wide read as a `PullRequest`. GitHub's are GitLens-native, which {@link stampNativePullRequest}
+* tags; every other host's are provider-apis', which {@link fromProviderPullRequest} converts.
+*/
+function toPullRequestRow(pr, provider, options) {
+	return isNativePullRequest(pr) ? stampNativePullRequest(pr, options) : fromProviderPullRequest(pr, provider, options);
+}
+/**
+* By shape rather than by class, which a second copy of the model module fails: a native row is a `'pullrequest'` that
+* names its provider, which provider-apis' rows never do. Both, so a key provider-apis adds later can't reroute its
+* rows.
+*/
+function isNativePullRequest(pr) {
+	const row = pr;
+	return row.type === "pullrequest" && row.provider != null && typeof row.provider === "object";
 }
 /**
 * GitLens' own GitHub GraphQL client keys people by login, while the current account's `id` is GitHub's
@@ -912,9 +949,9 @@ function fromProviderPullRequest(pr, provider, options) {
 * GitHub row shape, so the username fallback is safe there; elsewhere `toProviderAccount` fills `username`
 * from a display name that two people can share, so only GitHub and GitHub Enterprise get the fallback.
 */
-function authoredByCurrentAccount(pr, provider, currentAccount) {
-	if (pr.author?.id === currentAccount.id) return true;
-	return (provider.id === "github" || provider.id === "cloud-github-enterprise") && currentAccount.username != null && pr.author?.username === currentAccount.username;
+function authoredByCurrentAccount(author, provider, currentAccount) {
+	if (author?.id === currentAccount.id) return true;
+	return (provider.id === "github" || provider.id === "cloud-github-enterprise") && currentAccount.username != null && author?.username === currentAccount.username;
 }
 function fromProviderIssue(issue, integration, options) {
 	const identifier = toIssueIdentifier(issue.number);
@@ -922,7 +959,7 @@ function fromProviderIssue(issue, integration, options) {
 	return new Issue(integration, identifier, issue.graphQLId ?? issue.id, issue.title, issue.url ?? "", issue.createdDate, issue.updatedDate ?? issue.closedDate ?? issue.createdDate, closed, closed ? "closed" : "opened", fromProviderAccount(issue.author), issue.assignees?.map(fromProviderAccount) ?? void 0, issue.repository != null ? {
 		owner: issue.repository.owner.login ?? "",
 		repo: issue.repository.name,
-		id: issue.repository.id
+		id: issue.repository.id || void 0
 	} : void 0, issue.closedDate ?? void 0, issue.labels?.map((label) => ({
 		name: label.name,
 		color: label.color ?? void 0
@@ -936,12 +973,13 @@ function fromProviderIssue(issue, integration, options) {
 		name: issue.project.name,
 		resourceId: issue.project.resourceId,
 		resourceName: issue.project.namespace
-	} : void 0, identifier, issue.type ?? void 0, toIssueProviderState(issue.state, integration.id !== "jira"), integration.id === "jira" ? "jira-wiki" : void 0, toIssueIterations(issue));
+	} : void 0, identifier, issue.type ?? void 0, toIssueProviderState(issue.state, integration.id !== "jira"), integration.id === "jira" ? "jira-wiki" : void 0, toIssueIterations(issue), options?.projection);
 }
 function toProviderPullRequestWithUniqueId(pr) {
-	const { reviews, ...providerPr } = toProviderPullRequest(pr);
+	const { reviews, mergeableState, ...providerPr } = toProviderPullRequest(pr);
 	return {
 		...providerPr,
+		mergeableState: mergeableState ?? (pr.provider.id === "bitbucket" ? GitPullRequestMergeableState.Mergeable : GitPullRequestMergeableState.Unknown),
 		reviews: reviews?.filter((r) => r.state !== "DISMISSED") ?? null,
 		uuid: EntityIdentifierUtils.encode(getEntityIdentifierInput(pr))
 	};
@@ -965,6 +1003,6 @@ function supportsCodeSuggest(provider) {
 	return isGitHubDotCom(provider.domain);
 }
 //#endregion
-export { GitBuildStatusState, GitIssueState, GitPullRequestMergeableState, GitPullRequestReviewState, GitPullRequestState, IssueFilter, PagingMode, ProviderBuildStatusState, ProviderPullRequestReviewState, PullRequestFilter, fromProviderBuildStatusState, fromProviderIssue, fromProviderPullRequest, fromProviderPullRequestMergeableState, fromProviderPullRequestState, getActionablePullRequests, getProviderPullRequestIdentity, getReasonsForUserIssue, isAzureCloudDomain, isBitbucketCloudDomain, isGitHubDotCom, isGitLabDotCom, isRepoIdsInput, issueFilterToReason, providerPullRequestMatchesSearch, providersMetadata, resolveProviderScope, supportsCodeSuggest, toAccount, toIssueShape, toProviderBuildStatusState, toProviderIssueStates, toProviderPullRequest, toProviderPullRequestMergeableState, toProviderPullRequestState, toProviderPullRequestStates, toProviderPullRequestWithUniqueId, toProviderRepositoryShape };
+export { GitBuildStatusState, GitIssueState, GitPullRequestMergeableState, GitPullRequestReviewState, GitPullRequestState, IssueFilter, PagingMode, ProviderBuildStatusState, ProviderPullRequestReviewState, PullRequestFilter, fromProviderBuildStatusState, fromProviderIssue, fromProviderPullRequest, fromProviderPullRequestMergeableState, fromProviderPullRequestState, getActionablePullRequests, getProviderPullRequestIdentity, getReasonsForUserIssue, isAzureCloudDomain, isBitbucketCloudDomain, isGitHubDotCom, isGitLabDotCom, isNativePullRequest, isRepoIdsInput, issueFilterToReason, providerPullRequestMatchesSearch, providersMetadata, resolveProviderScope, stampNativePullRequest, supportsCodeSuggest, toAccount, toIssueShape, toProviderBuildStatusState, toProviderIssueStates, toProviderPullRequest, toProviderPullRequestMergeableState, toProviderPullRequestState, toProviderPullRequestStates, toProviderPullRequestWithUniqueId, toProviderRepositoryShape, toPullRequestRow, toStatusCheckRollupState };
 
 //# sourceMappingURL=models.js.map