@gitkraken/core-gitlens 0.9.3 → 0.9.5

package/dist/git/utils/pullRequest.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"pullRequest.utils.js","names":[],"sources":["../../../../git/src/utils/pullRequest.utils.ts"],"sourcesContent":["import type {\n\tPullRequest,\n\tPullRequestComparisonRefs,\n\tPullRequestRefs,\n\tPullRequestRepositoryIdentityDescriptor,\n\tPullRequestShape,\n\tPullRequestSortField,\n\tPullRequestSorting,\n\tPullRequestStackInfo,\n} from '../models/pullRequest.js';\nimport { shortenRevision } from './revision.utils.js';\n\n/** How many pull requests a merge action affects — unstacked is always 1; a stacked merge lands either\n *  just this layer and everything below it (`position`), or the whole stack (`wholeStack`). The one\n *  source every merge-confirmation and merge-action label counts from, so they can't drift apart.\n *  Takes only the two fields it needs (not the full {@link PullRequestStackInfo}) since callers on the\n *  webview side carry narrower serialized stack shapes. */\nexport function getStackedMergeCount(\n\tstack: Pick<PullRequestStackInfo, 'position' | 'size'> | undefined,\n\toptions?: { wholeStack?: boolean },\n): number {\n\tif (stack == null) return 1;\n\treturn options?.wholeStack ? stack.size : stack.position;\n}\n\n/**\n * How each sort field is read off a {@link PullRequestShape}, for the filtered PR search, which MERGES its\n * relationship × state facets in the facade and so has to order the union itself instead of trusting the\n * per-facet server order. Only the fields the shape carries appear — the same rule as `getIssueComparator`, and\n * the reason {@link PullRequestSortField} is just these two.\n */\nconst pullRequestSortValues: Partial<\n\tRecord<PullRequestSortField, (pr: PullRequestShape) => number | Date | string | undefined>\n> = {\n\tcreated: pr => pr.createdDate,\n\tupdated: pr => pr.updatedDate,\n};\n\n/**\n * A comparator for one sort key over normalized pull requests, or `undefined` when the field isn't derivable\n * from a {@link PullRequestShape} — the signal that the key is only honorable on a SINGLE-origin read where the\n * provider already ordered the page. Missing values sort LAST in both directions (partitioned before any\n * arithmetic so two missing values compare equal, exactly as `getIssueComparator` does).\n *\n * Note it orders whatever it is handed. Sorting a page already capped at the result ceiling does not make it the\n * top N.\n */\nexport function getPullRequestComparator(\n\tsort: PullRequestSorting,\n): ((a: PullRequestShape, b: PullRequestShape) => number) | undefined {\n\tconst [field, direction] = sort.split(':') as [PullRequestSortField, 'asc' | 'desc'];\n\tconst getValue = pullRequestSortValues[field];\n\tif (getValue == null) return undefined;\n\n\treturn (a, b) => {\n\t\tconst left = toComparable(getValue(a));\n\t\tconst right = toComparable(getValue(b));\n\t\tif (left == null || right == null) {\n\t\t\tif (left == null && right == null) return 0;\n\n\t\t\treturn left == null ? 1 : -1;\n\t\t}\n\n\t\tconst ordered = left < right ? -1 : left > right ? 1 : 0;\n\t\treturn direction === 'asc' ? ordered : -ordered;\n\t};\n}\n\nfunction toComparable(value: number | Date | string | undefined): number | string | undefined {\n\treturn value instanceof Date ? value.getTime() : value;\n}\n\nexport interface PullRequestUrlIdentity<TProvider extends string = string> {\n\tprovider?: TProvider;\n\n\townerAndRepo?: string;\n\tprNumber: string;\n}\n\nexport function getComparisonRefsForPullRequest(repoPath: string, prRefs: PullRequestRefs): PullRequestComparisonRefs {\n\tconst refs: PullRequestComparisonRefs = {\n\t\trepoPath: repoPath,\n\t\tbase: { ref: prRefs.base.sha, label: `${prRefs.base.branch} (${shortenRevision(prRefs.base.sha)})` },\n\t\thead: { ref: prRefs.head.sha, label: prRefs.head.branch },\n\t};\n\treturn refs;\n}\n\nexport function getPullRequestIdentityFromMaybeUrl(search: string): PullRequestUrlIdentity | undefined {\n\tlet prNumber: string | undefined = undefined;\n\n\tlet match = search.match(/(?:\\/)(\\d+)/); // any number starting with \"/\"\n\tif (match != null) {\n\t\tprNumber = match[1];\n\t}\n\n\tif (prNumber == null) {\n\t\tmatch = search.match(/^#?(\\d+)$/); // just a number or with a leading \"#\"\n\t\tif (match != null) {\n\t\t\tprNumber = match[1];\n\t\t}\n\t}\n\n\treturn prNumber == null ? undefined : { ownerAndRepo: undefined, prNumber: prNumber, provider: undefined };\n}\n\n/** A pull request's display number from its url, or `undefined` for a url naming no pull request. Anchors\n *  on the provider's pull request path segment (GitHub `pull`, Bitbucket `pull-requests`, GitLab\n *  `merge_requests`, Azure `pullrequest`) so a digit-leading owner (`github.com/1Password/x/pull/123`)\n *  can't win. */\nexport function getPullRequestNumberFromUrl(url: string): string | undefined {\n\t// No loose fallback: `getPullRequestIdentityFromMaybeUrl` scans for any `/<digits>`, which reads a bare\n\t// repository url like `github.com/1Password/sdk` as pull request #1. Callers that hold a real pull\n\t// request fall back to its id instead, and the one that asks whether a pasted url names a pull request\n\t// needs \"no\" for an answer.\n\treturn url.match(/(?:pull|pull-requests|merge_requests|pullrequest)\\/(\\d+)(?:\\b|\\/|$)/)?.[1];\n}\n\nexport function getRepositoryIdentityForPullRequest(\n\tpr: PullRequest,\n\theadRepo: boolean = true,\n): PullRequestRepositoryIdentityDescriptor {\n\tif (headRepo) {\n\t\treturn {\n\t\t\tremote: {\n\t\t\t\turl: pr.refs?.head?.url,\n\t\t\t\tdomain: pr.provider.domain,\n\t\t\t},\n\t\t\tname: `${pr.refs?.head?.owner ?? pr.repository.owner}/${pr.refs?.head?.repo ?? pr.repository.repo}`,\n\t\t\tprovider: {\n\t\t\t\tid: pr.provider.id,\n\t\t\t\tdomain: pr.provider.domain,\n\t\t\t\trepoDomain: pr.refs?.head?.owner ?? pr.repository.owner,\n\t\t\t\trepoName: pr.refs?.head?.repo ?? pr.repository.repo,\n\t\t\t},\n\t\t};\n\t}\n\n\treturn {\n\t\tremote: {\n\t\t\turl: pr.refs?.base?.url ?? pr.url,\n\t\t\tdomain: pr.provider.domain,\n\t\t},\n\t\tname: `${pr.refs?.base?.owner ?? pr.repository.owner}/${pr.refs?.base?.repo ?? pr.repository.repo}`,\n\t\tprovider: {\n\t\t\tid: pr.provider.id,\n\t\t\tdomain: pr.provider.domain,\n\t\t\trepoDomain: pr.refs?.base?.owner ?? pr.repository.owner,\n\t\t\trepoName: pr.refs?.base?.repo ?? pr.repository.repo,\n\t\t\trepoOwnerDomain: pr.refs?.base?.owner ?? pr.repository.owner,\n\t\t},\n\t};\n}\n\nexport function isMaybeNonSpecificPullRequestSearchUrl(search: string): boolean {\n\treturn getPullRequestIdentityFromMaybeUrl(search) != null;\n}\n\nexport function serializePullRequest(value: PullRequest): PullRequestShape {\n\tconst serialized: PullRequestShape = {\n\t\ttype: value.type,\n\t\tprovider: {\n\t\t\tid: value.provider.id,\n\t\t\tname: value.provider.name,\n\t\t\tdomain: value.provider.domain,\n\t\t\ticon: value.provider.icon,\n\t\t},\n\t\tid: value.id,\n\t\tnodeId: value.nodeId,\n\t\tnumber: value.number,\n\t\ttitle: value.title,\n\t\tbody: value.body,\n\t\turl: value.url,\n\t\tcreatedDate: value.createdDate,\n\t\tupdatedDate: value.updatedDate,\n\t\tclosedDate: value.closedDate,\n\t\tclosed: value.closed,\n\t\tauthor: {\n\t\t\tid: value.author.id,\n\t\t\tname: value.author.name,\n\t\t\tusername: value.author.username,\n\t\t\tavatarUrl: value.author.avatarUrl,\n\t\t\turl: value.author.url,\n\t\t},\n\t\tstate: value.state,\n\t\tmergedDate: value.mergedDate,\n\t\tmergeableState: value.mergeableState,\n\t\trefs: value.refs\n\t\t\t? {\n\t\t\t\t\thead: {\n\t\t\t\t\t\texists: value.refs.head.exists,\n\t\t\t\t\t\towner: value.refs.head.owner,\n\t\t\t\t\t\trepo: value.refs.head.repo,\n\t\t\t\t\t\tsha: value.refs.head.sha,\n\t\t\t\t\t\tbranch: value.refs.head.branch,\n\t\t\t\t\t\turl: value.refs.head.url,\n\t\t\t\t\t\tcloneHttps: value.refs.head.cloneHttps,\n\t\t\t\t\t\tcloneSsh: value.refs.head.cloneSsh,\n\t\t\t\t\t\tisFork: value.refs.head.isFork,\n\t\t\t\t\t},\n\t\t\t\t\tbase: {\n\t\t\t\t\t\texists: value.refs.base.exists,\n\t\t\t\t\t\towner: value.refs.base.owner,\n\t\t\t\t\t\trepo: value.refs.base.repo,\n\t\t\t\t\t\tsha: value.refs.base.sha,\n\t\t\t\t\t\tbranch: value.refs.base.branch,\n\t\t\t\t\t\turl: value.refs.base.url,\n\t\t\t\t\t\tcloneHttps: value.refs.base.cloneHttps,\n\t\t\t\t\t\tcloneSsh: value.refs.base.cloneSsh,\n\t\t\t\t\t\tisFork: value.refs.base.isFork,\n\t\t\t\t\t},\n\t\t\t\t\tisCrossRepository: value.refs.isCrossRepository,\n\t\t\t\t}\n\t\t\t: undefined,\n\t\tisDraft: value.isDraft,\n\t\tadditions: value.additions,\n\t\tdeletions: value.deletions,\n\t\tcommentsCount: value.commentsCount,\n\t\tthumbsUpCount: value.thumbsUpCount,\n\t\treviewDecision: value.reviewDecision,\n\t\treviewRequests: value.reviewRequests,\n\t\tlatestReviews: value.latestReviews,\n\t\tassignees: value.assignees,\n\t\tauthoredByMe: value.authoredByMe,\n\t\tproject: value.project\n\t\t\t? {\n\t\t\t\t\tid: value.project.id,\n\t\t\t\t\tname: value.project.name,\n\t\t\t\t\tresourceId: value.project.resourceId,\n\t\t\t\t\tresourceName: value.project.resourceName,\n\t\t\t\t}\n\t\t\t: undefined,\n\t\tstack: value.stack\n\t\t\t? {\n\t\t\t\t\tid: value.stack.id,\n\t\t\t\t\tnumber: value.stack.number,\n\t\t\t\t\tsize: value.stack.size,\n\t\t\t\t\tposition: value.stack.position,\n\t\t\t\t\tbaseRef: value.stack.baseRef,\n\t\t\t\t}\n\t\t\t: undefined,\n\t};\n\treturn serialized;\n}\n"],"mappings":"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"}
+{"version":3,"file":"pullRequest.utils.js","names":[],"sources":["../../../../git/src/utils/pullRequest.utils.ts"],"sourcesContent":["import type {\n\tPullRequest,\n\tPullRequestComparisonRefs,\n\tPullRequestRefs,\n\tPullRequestRepositoryIdentityDescriptor,\n\tPullRequestShape,\n\tPullRequestSortField,\n\tPullRequestSorting,\n\tPullRequestStackInfo,\n} from '../models/pullRequest.js';\nimport { shortenRevision } from './revision.utils.js';\n\n/** How many pull requests a merge action affects — unstacked is always 1; a stacked merge lands either\n *  just this layer and everything below it (`position`), or the whole stack (`wholeStack`). The one\n *  source every merge-confirmation and merge-action label counts from, so they can't drift apart.\n *  Takes only the two fields it needs (not the full {@link PullRequestStackInfo}) since callers on the\n *  webview side carry narrower serialized stack shapes. */\nexport function getStackedMergeCount(\n\tstack: Pick<PullRequestStackInfo, 'position' | 'size'> | undefined,\n\toptions?: { wholeStack?: boolean },\n): number {\n\tif (stack == null) return 1;\n\treturn options?.wholeStack ? stack.size : stack.position;\n}\n\n/**\n * How each sort field is read off a {@link PullRequestShape}, for the filtered PR search, which MERGES its\n * relationship × state facets in the facade and so has to order the union itself instead of trusting the\n * per-facet server order. Only the fields the shape carries appear — the same rule as `getIssueComparator`, and\n * the reason {@link PullRequestSortField} is just these two.\n */\nconst pullRequestSortValues: Partial<\n\tRecord<PullRequestSortField, (pr: PullRequestShape) => number | Date | string | undefined>\n> = {\n\tcreated: pr => pr.createdDate,\n\tupdated: pr => pr.updatedDate,\n};\n\n/**\n * A comparator for one sort key over normalized pull requests, or `undefined` when the field isn't derivable\n * from a {@link PullRequestShape} — the signal that the key is only honorable on a SINGLE-origin read where the\n * provider already ordered the page. Missing values sort LAST in both directions (partitioned before any\n * arithmetic so two missing values compare equal, exactly as `getIssueComparator` does).\n *\n * Note it orders whatever it is handed. Sorting a page already capped at the result ceiling does not make it the\n * top N.\n */\nexport function getPullRequestComparator(\n\tsort: PullRequestSorting,\n): ((a: PullRequestShape, b: PullRequestShape) => number) | undefined {\n\tconst [field, direction] = sort.split(':') as [PullRequestSortField, 'asc' | 'desc'];\n\tconst getValue = pullRequestSortValues[field];\n\tif (getValue == null) return undefined;\n\n\treturn (a, b) => {\n\t\tconst left = toComparable(getValue(a));\n\t\tconst right = toComparable(getValue(b));\n\t\tif (left == null || right == null) {\n\t\t\tif (left == null && right == null) return 0;\n\n\t\t\treturn left == null ? 1 : -1;\n\t\t}\n\n\t\tconst ordered = left < right ? -1 : left > right ? 1 : 0;\n\t\treturn direction === 'asc' ? ordered : -ordered;\n\t};\n}\n\nfunction toComparable(value: number | Date | string | undefined): number | string | undefined {\n\treturn value instanceof Date ? value.getTime() : value;\n}\n\nexport interface PullRequestUrlIdentity<TProvider extends string = string> {\n\tprovider?: TProvider;\n\n\townerAndRepo?: string;\n\tprNumber: string;\n}\n\nexport function getComparisonRefsForPullRequest(repoPath: string, prRefs: PullRequestRefs): PullRequestComparisonRefs {\n\tconst refs: PullRequestComparisonRefs = {\n\t\trepoPath: repoPath,\n\t\tbase: { ref: prRefs.base.sha, label: `${prRefs.base.branch} (${shortenRevision(prRefs.base.sha)})` },\n\t\thead: { ref: prRefs.head.sha, label: prRefs.head.branch },\n\t};\n\treturn refs;\n}\n\nexport function getPullRequestIdentityFromMaybeUrl(search: string): PullRequestUrlIdentity | undefined {\n\tlet prNumber: string | undefined = undefined;\n\n\tlet match = search.match(/(?:\\/)(\\d+)/); // any number starting with \"/\"\n\tif (match != null) {\n\t\tprNumber = match[1];\n\t}\n\n\tif (prNumber == null) {\n\t\tmatch = search.match(/^#?(\\d+)$/); // just a number or with a leading \"#\"\n\t\tif (match != null) {\n\t\t\tprNumber = match[1];\n\t\t}\n\t}\n\n\treturn prNumber == null ? undefined : { ownerAndRepo: undefined, prNumber: prNumber, provider: undefined };\n}\n\n/** A pull request's display number from its url, or `undefined` for a url naming no pull request. Anchors\n *  on the provider's pull request path segment (GitHub `pull`, Bitbucket `pull-requests`, GitLab\n *  `merge_requests`, Azure `pullrequest`) so a digit-leading owner (`github.com/1Password/x/pull/123`)\n *  can't win. */\nexport function getPullRequestNumberFromUrl(url: string): string | undefined {\n\t// No loose fallback: `getPullRequestIdentityFromMaybeUrl` scans for any `/<digits>`, which reads a bare\n\t// repository url like `github.com/1Password/sdk` as pull request #1. Callers that hold a real pull\n\t// request fall back to its id instead, and the one that asks whether a pasted url names a pull request\n\t// needs \"no\" for an answer.\n\treturn url.match(/(?:pull|pull-requests|merge_requests|pullrequest)\\/(\\d+)(?:\\b|\\/|$)/)?.[1];\n}\n\nexport function getRepositoryIdentityForPullRequest(\n\tpr: PullRequest,\n\theadRepo: boolean = true,\n): PullRequestRepositoryIdentityDescriptor {\n\tif (headRepo) {\n\t\treturn {\n\t\t\tremote: {\n\t\t\t\turl: pr.refs?.head?.url,\n\t\t\t\tdomain: pr.provider.domain,\n\t\t\t},\n\t\t\tname: `${pr.refs?.head?.owner ?? pr.repository.owner}/${pr.refs?.head?.repo ?? pr.repository.repo}`,\n\t\t\tprovider: {\n\t\t\t\tid: pr.provider.id,\n\t\t\t\tdomain: pr.provider.domain,\n\t\t\t\trepoDomain: pr.refs?.head?.owner ?? pr.repository.owner,\n\t\t\t\trepoName: pr.refs?.head?.repo ?? pr.repository.repo,\n\t\t\t},\n\t\t};\n\t}\n\n\treturn {\n\t\tremote: {\n\t\t\turl: pr.refs?.base?.url ?? pr.url,\n\t\t\tdomain: pr.provider.domain,\n\t\t},\n\t\tname: `${pr.refs?.base?.owner ?? pr.repository.owner}/${pr.refs?.base?.repo ?? pr.repository.repo}`,\n\t\tprovider: {\n\t\t\tid: pr.provider.id,\n\t\t\tdomain: pr.provider.domain,\n\t\t\trepoDomain: pr.refs?.base?.owner ?? pr.repository.owner,\n\t\t\trepoName: pr.refs?.base?.repo ?? pr.repository.repo,\n\t\t\trepoOwnerDomain: pr.refs?.base?.owner ?? pr.repository.owner,\n\t\t},\n\t};\n}\n\nexport function isMaybeNonSpecificPullRequestSearchUrl(search: string): boolean {\n\treturn getPullRequestIdentityFromMaybeUrl(search) != null;\n}\n\n/**\n * Deliberately leaves `projection` out: this copy drops `filesChanged`, `repository` and the class-only check rollup,\n * commit count and `viewerCanUpdate`, so a tag would have field presence report as fetched what the copy no longer has.\n */\nexport function serializePullRequest(value: PullRequest): PullRequestShape {\n\tconst serialized: PullRequestShape = {\n\t\ttype: value.type,\n\t\tprovider: {\n\t\t\tid: value.provider.id,\n\t\t\tname: value.provider.name,\n\t\t\tdomain: value.provider.domain,\n\t\t\ticon: value.provider.icon,\n\t\t},\n\t\tid: value.id,\n\t\tnodeId: value.nodeId,\n\t\tnumber: value.number,\n\t\ttitle: value.title,\n\t\tbody: value.body,\n\t\turl: value.url,\n\t\tcreatedDate: value.createdDate,\n\t\tupdatedDate: value.updatedDate,\n\t\tclosedDate: value.closedDate,\n\t\tclosed: value.closed,\n\t\tauthor: {\n\t\t\tid: value.author.id,\n\t\t\tname: value.author.name,\n\t\t\tusername: value.author.username,\n\t\t\tavatarUrl: value.author.avatarUrl,\n\t\t\turl: value.author.url,\n\t\t},\n\t\tstate: value.state,\n\t\tmergedDate: value.mergedDate,\n\t\tmergeableState: value.mergeableState,\n\t\trefs: value.refs\n\t\t\t? {\n\t\t\t\t\thead: {\n\t\t\t\t\t\texists: value.refs.head.exists,\n\t\t\t\t\t\towner: value.refs.head.owner,\n\t\t\t\t\t\trepo: value.refs.head.repo,\n\t\t\t\t\t\tsha: value.refs.head.sha,\n\t\t\t\t\t\tbranch: value.refs.head.branch,\n\t\t\t\t\t\turl: value.refs.head.url,\n\t\t\t\t\t\tcloneHttps: value.refs.head.cloneHttps,\n\t\t\t\t\t\tcloneSsh: value.refs.head.cloneSsh,\n\t\t\t\t\t\tisFork: value.refs.head.isFork,\n\t\t\t\t\t},\n\t\t\t\t\tbase: {\n\t\t\t\t\t\texists: value.refs.base.exists,\n\t\t\t\t\t\towner: value.refs.base.owner,\n\t\t\t\t\t\trepo: value.refs.base.repo,\n\t\t\t\t\t\tsha: value.refs.base.sha,\n\t\t\t\t\t\tbranch: value.refs.base.branch,\n\t\t\t\t\t\turl: value.refs.base.url,\n\t\t\t\t\t\tcloneHttps: value.refs.base.cloneHttps,\n\t\t\t\t\t\tcloneSsh: value.refs.base.cloneSsh,\n\t\t\t\t\t\tisFork: value.refs.base.isFork,\n\t\t\t\t\t},\n\t\t\t\t\tisCrossRepository: value.refs.isCrossRepository,\n\t\t\t\t}\n\t\t\t: undefined,\n\t\tisDraft: value.isDraft,\n\t\tadditions: value.additions,\n\t\tdeletions: value.deletions,\n\t\tcommentsCount: value.commentsCount,\n\t\tthumbsUpCount: value.thumbsUpCount,\n\t\treviewDecision: value.reviewDecision,\n\t\treviewRequests: value.reviewRequests,\n\t\tlatestReviews: value.latestReviews,\n\t\tassignees: value.assignees,\n\t\tauthoredByMe: value.authoredByMe,\n\t\tviewer: value.viewer != null ? { id: value.viewer.id, username: value.viewer.username } : undefined,\n\t\tproject: value.project\n\t\t\t? {\n\t\t\t\t\tid: value.project.id,\n\t\t\t\t\tname: value.project.name,\n\t\t\t\t\tresourceId: value.project.resourceId,\n\t\t\t\t\tresourceName: value.project.resourceName,\n\t\t\t\t}\n\t\t\t: undefined,\n\t\tstack: value.stack\n\t\t\t? {\n\t\t\t\t\tid: value.stack.id,\n\t\t\t\t\tnumber: value.stack.number,\n\t\t\t\t\tsize: value.stack.size,\n\t\t\t\t\tposition: value.stack.position,\n\t\t\t\t\tbaseRef: value.stack.baseRef,\n\t\t\t\t}\n\t\t\t: undefined,\n\t};\n\treturn serialized;\n}\n"],"mappings":"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"}

package/dist/plus/git-github/api/github.d.ts

@@ -11,7 +11,7 @@ import { Account, UnidentifiedAuthor } from "../../../git/models/author.js";
 import { DefaultBranch } from "../../../git/models/defaultBranch.js";
 import { RepositoryMetadata } from "../../../git/models/repositoryMetadata.js";
 import { GitHubApiConfig } from "./config.js";
-import { GitHubBlame, GitHubBranch, GitHubCommit, GitHubCommitRef, GitHubContributor, GitHubPagedResult, GitHubPullRequestState, GitHubSshSigningKey, GitHubTag } from "../models.js";
+import { GitHubBlame, GitHubBranch, GitHubCommit, GitHubCommitRef, GitHubContributor, GitHubIssueEtagInclude, GitHubIssueEtagNode, GitHubPagedResult, GitHubPullRequestEtagInclude, GitHubPullRequestEtagNode, GitHubPullRequestState, GitHubSshSigningKey, GitHubTag } from "../models.js";
 import { GitHubTokenInfo } from "./token.js";
 import { Endpoints } from "@octokit/types";
 //#region ../plus/git-github/src/api/github.d.ts
@@ -270,6 +270,7 @@ export declare class GitHubApi {
     cursor?: string;
     hasMore: boolean;
     truncated: boolean;
+    totalCount?: number;
   }>;
   /**
    * The whole list rather than a page: this read has no cursor to hand back (its `IntegrationResult<T[]>` return
@@ -447,6 +448,37 @@ export declare class GitHubApi {
     baseUrl?: string;
     avatarSize?: number;
   }, cancellation?: AbortSignal): Promise<PromiseSettledResult<PullRequest | undefined>[]>;
+  /**
+   * The cheap check behind the batch reads' etags: {@link getPullRequestsBatch}'s aliased document, slot rules and
+   * failure handling, selecting only a pull request's change state ({@link gqlPullRequestEtagFragment}) — plus
+   * the selection of each of `etagIncludes` ({@link gqlPullRequestEtagIncludeFragments}). Returns the raw nodes:
+   * the caller maps them through the same conversions a full row takes, so both reads' etags agree.
+   *
+   * Declares no `$avatarSize`: nothing here selects an avatar, and GitHub rejects a document that declares a
+   * variable it never uses.
+   */
+  getPullRequestsEtagFieldsBatch(provider: Provider, token: GitHubTokenInfo, coordinates: readonly {
+    owner: string;
+    repo: string;
+    number: number;
+  }[], options?: {
+    baseUrl?: string;
+    etagIncludes?: readonly GitHubPullRequestEtagInclude[];
+  }, cancellation?: AbortSignal): Promise<PromiseSettledResult<GitHubPullRequestEtagNode | undefined>[]>;
+  /**
+   * The issue twin of {@link getPullRequestsEtagFieldsBatch}: {@link getIssuesBatch}'s aliased document, slot
+   * rules and failure handling, selecting only an issue's change state ({@link gqlIssueEtagFragment}) — plus the
+   * selection of each of `etagIncludes` ({@link gqlIssueEtagIncludeFragments}). Returns the raw nodes, and declares
+   * no `$avatarSize`, for the same reasons.
+   */
+  getIssuesEtagFieldsBatch(provider: Provider, token: GitHubTokenInfo, coordinates: readonly {
+    owner: string;
+    repo: string;
+    number: number;
+  }[], options?: {
+    baseUrl?: string;
+    etagIncludes?: readonly GitHubIssueEtagInclude[];
+  }, cancellation?: AbortSignal): Promise<PromiseSettledResult<GitHubIssueEtagNode | undefined>[]>;
   /**
    * Finds, for several branches in one request, every pull request whose head is that branch — in any state,
    * most recently updated first, up to `limit` per branch. Each target names the BASE repository the pull
@@ -460,9 +492,12 @@ export declare class GitHubApi {
    *
    * `headRefName` matches every fork's branch of that name too, so rows are kept only when their head
    * repository is the base repository itself (`headOwner` omitted) or a fork owned by `headOwner` — otherwise
-   * a `main` in the base repository would claim every fork's `main`. That filter runs after the server's
-   * `limit`, so `truncated` is set whenever the server matched more rows than it returned, since any of the
-   * unfetched ones might have passed it.
+   * a `main` in the base repository would claim every fork's `main`. The fork is matched by
+   * `headRepositoryOwner`, which GitHub keeps after the fork is deleted, so a deleted fork's pull request still
+   * matches its old owner. That filter runs after the server's `limit`, so `truncated` is set whenever the server
+   * matched more rows than it returned, since any of the unfetched ones might have passed it;
+   * {@link getPullRequestNumbersForBranch} settles such a target, though it can't see a deleted fork's pull
+   * request, so its caller keeps the rows matched here as well.
    *
    * Returns POSITIONALLY, with the same per-alias rules as {@link getPullRequestsBatch}: a missing base
    * repository (NOT_FOUND on a null repository) is a PROVEN "none" — an empty list — while any other error on
@@ -481,6 +516,31 @@ export declare class GitHubApi {
     pullRequests: PullRequest[];
     truncated: boolean;
   }>[]>;
+  /**
+   * The numbers of the pull requests into `owner/repo` whose head is `branch` in the repository `headOwner` owns
+   * — the base repository's owner when omitted — in any state, most recently updated first, at most `limit`.
+   * Only the numbers, so a caller resolves the rows through the same read as its by-number lookups.
+   *
+   * REST, because its `head` filter matches the head repository's OWNER and the branch on the server, before the
+   * page is cut, where GraphQL's `headRefName` matches the name across every fork: this settles a target
+   * {@link getPullRequestsForBranches} reported `truncated` only because other forks share its branch name.
+   * Keyed on the ref NAME like that read, so a merged pull request whose branch was deleted still matches; one
+   * whose fork was deleted has no head repository and matches nothing, so this can't prove such a pull request
+   * absent.
+   *
+   * Strict: an empty list means GitHub answered, and any failure throws, a 404 included — the caller has already
+   * read the base repository, so a missing one here proves nothing. A server error or timeout is left to the
+   * calling batch to report once (see `reportRequestFailure`), and an authentication failure prompts nothing,
+   * since one target's refusal isn't the credential's.
+   */
+  getPullRequestNumbersForBranch(provider: Provider, token: GitHubTokenInfo, owner: string, repo: string, branch: string, options: {
+    baseUrl?: string;
+    headOwner?: string;
+    limit: number;
+  }, cancellation?: AbortSignal): Promise<{
+    numbers: number[];
+    truncated: boolean;
+  }>;
   /**
    * The PR twin of {@link countIssues}: counts pull requests for several scopes in ONE request via aliased
    * `search` fields selecting only `issueCount` with `first: 0`. Same positional/undefined contract as the issue

package/dist/plus/git-github/api/github.js

@@ -303,6 +303,59 @@ repository {
 }
 `;
 /**
+* The change state a pull request's etag reads (see {@link GitHubPullRequestEtagNode}). Every selection is copied
+* from {@link gqlPullRequestFragment} — same arguments, same nesting — so the cheap read sees exactly the values
+* the full read maps; only a requested reviewer drops its avatar and URL, since its nullness is all the etag reads.
+* `merged` is not needed: `state` already reads `MERGED`.
+*/
+const gqlPullRequestEtagFragment = `
+id
+number
+state
+isDraft
+updatedAt
+headRefOid
+`;
+/**
+* The selection each {@link GitHubPullRequestEtagInclude} adds to {@link gqlPullRequestEtagFragment}, copied from
+* {@link gqlPullRequestFragment} like it.
+*/
+const gqlPullRequestEtagIncludeFragments = {
+	mergeable: `
+mergeable
+`,
+	reviewDecision: `
+reviewDecision
+`,
+	checks: `
+commits(last: 1) {
+	nodes {
+		commit {
+			statusCheckRollup {
+				state
+			}
+		}
+	}
+}
+`
+};
+/** The change state an issue's etag reads (see {@link GitHubIssueEtagNode}). */
+const gqlIssueEtagFragment = `
+id
+number
+state
+updatedAt
+`;
+/**
+* The selection each {@link GitHubIssueEtagInclude} adds to {@link gqlIssueEtagFragment}, copied from
+* {@link gqIssueFragment} like it.
+*/
+const gqlIssueEtagIncludeFragments = { reactions: `
+reactions(content: THUMBS_UP) {
+	totalCount
+}
+` };
+/**
 * What an alias's own errors say about its slot in an {@link AliasedGraphqlResult}: `'absent'` only when its node
 * is null and every error on it is NOT_FOUND; a rejection when a node arrived with an error, or on any other error
 * (even a NOT_FOUND nested under the node), since neither is trustworthy; `undefined` when the alias has no errors.
@@ -571,7 +624,7 @@ var GitHubApi = class {
 				number
 			}, scope);
 			if (rsp?.repository?.issue == null) return void 0;
-			return fromGitHubIssue(rsp.repository.issue, provider);
+			return fromGitHubIssue(rsp.repository.issue, provider, issueProjection("point", options));
 		} catch (ex) {
 			if (ex instanceof RequestNotFoundError) return void 0;
 			throw this.handleException(ex, provider, scope);
@@ -600,7 +653,7 @@ var GitHubApi = class {
 				number
 			}, scope);
 			if (rsp?.repository?.pullRequest == null) return void 0;
-			return fromGitHubPullRequestLite(rsp.repository.pullRequest, provider);
+			return fromGitHubPullRequestLite(rsp.repository.pullRequest, provider, "point");
 		} catch (ex) {
 			if (ex instanceof RequestNotFoundError) return void 0;
 			throw this.handleException(ex, provider, scope);
@@ -637,7 +690,7 @@ var GitHubApi = class {
 			}, scope))?.repository?.ref?.associatedPullRequests?.nodes?.filter((pr) => pr != null && (!pr.repository.isFork || pr.repository.owner.login === owner));
 			if (prs == null || prs.length === 0) return void 0;
 			if (prs.length > 1) prs.sort((a, b) => (a.repository.owner.login === owner ? -1 : 1) - (b.repository.owner.login === owner ? -1 : 1) || (a.state === "OPEN" ? -1 : 1) - (b.state === "OPEN" ? -1 : 1) || new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
-			return fromGitHubPullRequestLite(prs[0], provider);
+			return fromGitHubPullRequestLite(prs[0], provider, "point");
 		} catch (ex) {
 			if (ex instanceof RequestNotFoundError) return void 0;
 			throw this.handleException(ex, provider, scope);
@@ -674,7 +727,7 @@ var GitHubApi = class {
 			}, scope, cancellation))?.repository?.object?.associatedPullRequests?.nodes?.filter((pr) => pr != null && (!pr.repository.isFork || pr.repository.owner.login === owner));
 			if (prs == null || prs.length === 0) return void 0;
 			if (prs.length > 1) prs.sort((a, b) => (a.repository.owner.login === owner ? -1 : 1) - (b.repository.owner.login === owner ? -1 : 1) || (a.state === "MERGED" ? -1 : 1) - (b.state === "MERGED" ? -1 : 1) || new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
-			return fromGitHubPullRequestLite(prs[0], provider);
+			return fromGitHubPullRequestLite(prs[0], provider, "point");
 		} catch (ex) {
 			if (ex instanceof RequestNotFoundError) return void 0;
 			throw this.handleException(ex, provider, scope);
@@ -2040,10 +2093,11 @@ var GitHubApi = class {
 				truncated: false
 			};
 			return {
-				values: rsp.search.nodes.map((pr) => options?.summary ? fromGitHubPullRequestLite(pr, provider) : fromGitHubPullRequest(pr, provider)),
+				values: rsp.search.nodes.map((pr) => options?.summary ? fromGitHubPullRequestLite(pr, provider, "search-summary") : fromGitHubPullRequest(pr, provider, "search")),
 				cursor: rsp.search.pageInfo.endCursor ?? void 0,
 				hasMore: rsp.search.pageInfo.hasNextPage,
-				truncated: rsp.search.issueCount > 1e3 && !rsp.search.pageInfo.hasNextPage
+				truncated: rsp.search.issueCount > 1e3 && !rsp.search.pageInfo.hasNextPage,
+				totalCount: rsp.search.issueCount
 			};
 		} catch (ex) {
 			throw this.handleException(ex, provider, scope, options?.silent);
@@ -2124,7 +2178,8 @@ var GitHubApi = class {
 			cursor: options?.cursor,
 			pageSize: options?.pageSize,
 			sort: options?.sort,
-			legacySort: unsortedCursorSort
+			legacySort: unsortedCursorSort,
+			projection: "account"
 		}, cancellation);
 	}
 	/**
@@ -2176,7 +2231,8 @@ var GitHubApi = class {
 			cursor: options?.cursor,
 			pageSize: options?.pageSize,
 			sort,
-			legacySort: defaultIssueSort
+			legacySort: defaultIssueSort,
+			projection: "search"
 		}, cancellation);
 	}
 	/**
@@ -2295,7 +2351,7 @@ var GitHubApi = class {
 				try {
 					return {
 						status: "fulfilled",
-						value: fromGitHubIssue(node, provider)
+						value: fromGitHubIssue(node, provider, issueProjection("batch", options))
 					};
 				} catch (ex) {
 					scope?.warn(`failed to map issue; ${c.owner}/${c.repo}#${c.number}, ex=${ex}`);
@@ -2383,6 +2439,103 @@ var GitHubApi = class {
 		}
 	}
 	/**
+	* The cheap check behind the batch reads' etags: {@link getPullRequestsBatch}'s aliased document, slot rules and
+	* failure handling, selecting only a pull request's change state ({@link gqlPullRequestEtagFragment}) — plus
+	* the selection of each of `etagIncludes` ({@link gqlPullRequestEtagIncludeFragments}). Returns the raw nodes:
+	* the caller maps them through the same conversions a full row takes, so both reads' etags agree.
+	*
+	* Declares no `$avatarSize`: nothing here selects an avatar, and GitHub rejects a document that declares a
+	* variable it never uses.
+	*/
+	async getPullRequestsEtagFieldsBatch(provider, token, coordinates, options, cancellation) {
+		const scope = getScopedLogger();
+		if (coordinates.length === 0) return [];
+		const includeFragments = Array.from(new Set(options?.etagIncludes), (include) => gqlPullRequestEtagIncludeFragments[include]);
+		const query = `query getPullRequestsEtagFieldsBatch(
+				${coordinates.map((_, i) => `$o${i}: String!\n\t\t\t\t$n${i}: String!\n\t\t\t\t$k${i}: Int!`).join("\n				")}
+			) {
+				${coordinates.map((_, i) => `p${i}: repository(owner: $o${i}, name: $n${i}) {
+					pullRequest(number: $k${i}) {
+						${gqlPullRequestEtagFragment}
+						${includeFragments.join("")}
+					}
+				}`).join("\n				")}
+			}`;
+		const variables = { baseUrl: options?.baseUrl };
+		coordinates.forEach((c, i) => {
+			variables[`o${i}`] = c.owner;
+			variables[`n${i}`] = c.repo;
+			variables[`k${i}`] = c.number;
+		});
+		try {
+			const rsp = await this.graphql(provider, token, query, variables, scope, cancellation, "aliased");
+			if (rsp?.data == null) throw new Error("GitHub returned no data for the pull request etag batch");
+			return coordinates.map((_, i) => {
+				const alias = `p${i}`;
+				const node = rsp.data[alias]?.pullRequest;
+				const verdict = getAliasErrorVerdict(rsp.errors, alias, node);
+				if (verdict === "absent") return {
+					status: "fulfilled",
+					value: void 0
+				};
+				if (verdict != null) return verdict;
+				return {
+					status: "fulfilled",
+					value: node ?? void 0
+				};
+			});
+		} catch (ex) {
+			throw this.handleException(ex, provider, scope);
+		}
+	}
+	/**
+	* The issue twin of {@link getPullRequestsEtagFieldsBatch}: {@link getIssuesBatch}'s aliased document, slot
+	* rules and failure handling, selecting only an issue's change state ({@link gqlIssueEtagFragment}) — plus the
+	* selection of each of `etagIncludes` ({@link gqlIssueEtagIncludeFragments}). Returns the raw nodes, and declares
+	* no `$avatarSize`, for the same reasons.
+	*/
+	async getIssuesEtagFieldsBatch(provider, token, coordinates, options, cancellation) {
+		const scope = getScopedLogger();
+		if (coordinates.length === 0) return [];
+		const includeFragments = Array.from(new Set(options?.etagIncludes), (include) => gqlIssueEtagIncludeFragments[include]);
+		const query = `query getIssuesEtagFieldsBatch(
+				${coordinates.map((_, i) => `$o${i}: String!\n\t\t\t\t$n${i}: String!\n\t\t\t\t$k${i}: Int!`).join("\n				")}
+			) {
+				${coordinates.map((_, i) => `i${i}: repository(owner: $o${i}, name: $n${i}) {
+					issue(number: $k${i}) {
+						${gqlIssueEtagFragment}
+						${includeFragments.join("")}
+					}
+				}`).join("\n				")}
+			}`;
+		const variables = { baseUrl: options?.baseUrl };
+		coordinates.forEach((c, i) => {
+			variables[`o${i}`] = c.owner;
+			variables[`n${i}`] = c.repo;
+			variables[`k${i}`] = c.number;
+		});
+		try {
+			const rsp = await this.graphql(provider, token, query, variables, scope, cancellation, "aliased");
+			if (rsp?.data == null) throw new Error("GitHub returned no data for the issue etag batch");
+			return coordinates.map((_, i) => {
+				const alias = `i${i}`;
+				const node = rsp.data[alias]?.issue;
+				const verdict = getAliasErrorVerdict(rsp.errors, alias, node);
+				if (verdict === "absent") return {
+					status: "fulfilled",
+					value: void 0
+				};
+				if (verdict != null) return verdict;
+				return {
+					status: "fulfilled",
+					value: node ?? void 0
+				};
+			});
+		} catch (ex) {
+			throw this.handleException(ex, provider, scope);
+		}
+	}
+	/**
 	* Finds, for several branches in one request, every pull request whose head is that branch — in any state,
 	* most recently updated first, up to `limit` per branch. Each target names the BASE repository the pull
 	* requests are opened against, the head branch's short name and, for a branch that lives in a fork,
@@ -2395,9 +2548,12 @@ var GitHubApi = class {
 	*
 	* `headRefName` matches every fork's branch of that name too, so rows are kept only when their head
 	* repository is the base repository itself (`headOwner` omitted) or a fork owned by `headOwner` — otherwise
-	* a `main` in the base repository would claim every fork's `main`. That filter runs after the server's
-	* `limit`, so `truncated` is set whenever the server matched more rows than it returned, since any of the
-	* unfetched ones might have passed it.
+	* a `main` in the base repository would claim every fork's `main`. The fork is matched by
+	* `headRepositoryOwner`, which GitHub keeps after the fork is deleted, so a deleted fork's pull request still
+	* matches its old owner. That filter runs after the server's `limit`, so `truncated` is set whenever the server
+	* matched more rows than it returned, since any of the unfetched ones might have passed it;
+	* {@link getPullRequestNumbersForBranch} settles such a target, though it can't see a deleted fork's pull
+	* request, so its caller keeps the rows matched here as well.
 	*
 	* Returns POSITIONALLY, with the same per-alias rules as {@link getPullRequestsBatch}: a missing base
 	* repository (NOT_FOUND on a null repository) is a PROVEN "none" — an empty list — while any other error on
@@ -2478,6 +2634,45 @@ var GitHubApi = class {
 		}
 	}
 	/**
+	* The numbers of the pull requests into `owner/repo` whose head is `branch` in the repository `headOwner` owns
+	* — the base repository's owner when omitted — in any state, most recently updated first, at most `limit`.
+	* Only the numbers, so a caller resolves the rows through the same read as its by-number lookups.
+	*
+	* REST, because its `head` filter matches the head repository's OWNER and the branch on the server, before the
+	* page is cut, where GraphQL's `headRefName` matches the name across every fork: this settles a target
+	* {@link getPullRequestsForBranches} reported `truncated` only because other forks share its branch name.
+	* Keyed on the ref NAME like that read, so a merged pull request whose branch was deleted still matches; one
+	* whose fork was deleted has no head repository and matches nothing, so this can't prove such a pull request
+	* absent.
+	*
+	* Strict: an empty list means GitHub answered, and any failure throws, a 404 included — the caller has already
+	* read the base repository, so a missing one here proves nothing. A server error or timeout is left to the
+	* calling batch to report once (see `reportRequestFailure`), and an authentication failure prompts nothing,
+	* since one target's refusal isn't the credential's.
+	*/
+	async getPullRequestNumbersForBranch(provider, token, owner, repo, branch, options, cancellation) {
+		const scope = getScopedLogger();
+		try {
+			const rsp = await this.request(provider, token, "GET /repos/{owner}/{repo}/pulls", {
+				owner,
+				repo,
+				head: `${options.headOwner ?? owner}:${branch}`,
+				state: "all",
+				sort: "updated",
+				direction: "desc",
+				per_page: options.limit + 1,
+				baseUrl: options.baseUrl
+			}, scope, cancellation, true);
+			if (rsp?.data == null) throw new Error("GitHub returned no data for the pull requests by head");
+			return {
+				numbers: rsp.data.slice(0, options.limit).map((pr) => pr.number),
+				truncated: rsp.data.length > options.limit
+			};
+		} catch (ex) {
+			throw this.handleException(ex, provider, scope, true);
+		}
+	}
+	/**
 	* The PR twin of {@link countIssues}: counts pull requests for several scopes in ONE request via aliased
 	* `search` fields selecting only `issueCount` with `first: 0`. Same positional/undefined contract as the issue
 	* count.
@@ -2623,7 +2818,7 @@ var GitHubApi = class {
 				for (const node of rsp[s.alias]?.nodes ?? []) {
 					if (node?.id == null) continue;
 					try {
-						const issue = fromGitHubIssue(node, provider);
+						const issue = fromGitHubIssue(node, provider, issueProjection(options.projection, options));
 						if (seen?.has(issue.url) !== true) mapped.push(issue);
 					} catch (ex) {
 						scope?.warn(`skipped unmappable issue; id=${node.id}, url=${node.url}, ex=${ex}`);
@@ -2798,7 +2993,7 @@ var GitHubApi = class {
 			for (const facet of activeFacets) for (const node of rsp[facet.alias]?.nodes ?? []) {
 				if (node?.id == null) continue;
 				try {
-					pullRequests.push(options?.summary ? fromGitHubPullRequestLite(node, provider) : fromGitHubPullRequest(node, provider));
+					pullRequests.push(options?.summary ? fromGitHubPullRequestLite(node, provider, "search-summary") : fromGitHubPullRequest(node, provider, "search"));
 				} catch (ex) {
 					scope?.warn(`skipped unmappable pull request; id=${node.id}, url=${node.url}, ex=${ex}`);
 				}
@@ -2900,7 +3095,7 @@ var GitHubApi = class {
 			const rsp = await this.graphql(provider, token, query, variables, scope, cancellation);
 			if (rsp == null) return [];
 			const results = [];
-			for (const { alias } of stateSearches) for (const node of rsp[alias]?.nodes ?? []) results.push(fromGitHubPullRequest(node, provider));
+			for (const { alias } of stateSearches) for (const node of rsp[alias]?.nodes ?? []) results.push(fromGitHubPullRequest(node, provider, "text-search"));
 			return [...uniqueBy(filterPullRequestsBySearchState(results, include), (pr) => pr.url, (original, _current) => original)].slice(0, pageSize);
 		} catch (ex) {
 			throw this.handleException(ex, provider, scope);
@@ -3255,10 +3450,25 @@ __decorate([trace({ args: (provider, token) => ({
 	provider: provider.name,
 	token: `<token:${token.microHash}>`
 }) })], GitHubApi.prototype, "getPullRequestsBatch", null);
+__decorate([trace({ args: (provider, token) => ({
+	provider: provider.name,
+	token: `<token:${token.microHash}>`
+}) })], GitHubApi.prototype, "getPullRequestsEtagFieldsBatch", null);
+__decorate([trace({ args: (provider, token) => ({
+	provider: provider.name,
+	token: `<token:${token.microHash}>`
+}) })], GitHubApi.prototype, "getIssuesEtagFieldsBatch", null);
 __decorate([trace({ args: (provider, token) => ({
 	provider: provider.name,
 	token: `<token:${token.microHash}>`
 }) })], GitHubApi.prototype, "getPullRequestsForBranches", null);
+__decorate([trace({ args: (provider, token, owner, repo, branch) => ({
+	provider: provider.name,
+	token: `<token:${token.microHash}>`,
+	owner,
+	repo,
+	branch
+}) })], GitHubApi.prototype, "getPullRequestNumbersForBranch", null);
 __decorate([trace({ args: (provider, token) => ({
 	provider: provider.name,
 	token: `<token:${token.microHash}>`
@@ -3291,6 +3501,13 @@ __decorate([trace({ args: (provider, token, nodeId, expectedSourceSha) => ({
 	nodeId,
 	expectedSourceSha
 }) })], GitHubApi.prototype, "mergePullRequest", null);
+/**
+* Every issue read's presence table assumes the body was selected, so a read without `includeBody` is left
+* untagged (unknown) rather than claiming a description it never fetched.
+*/
+function issueProjection(projection, options) {
+	return options?.includeBody ? projection : void 0;
+}
 function isGitHubDotCom(options) {
 	return options?.baseUrl == null || options.baseUrl === "https://api.github.com";
 }