@ascribed/review 0.1.2-next.2

package/dist/github/marker.js

@@ -0,0 +1,156 @@
+// Comments GitHub can't anchor to a line go on the pull request's
+// conversation, each ending with a hidden marker naming its block:
+//
+//   <!-- ascribe:anchor guides/install.md:12-14 build=site -->
+//
+// Several can share one body (a review's), one after another. A review's
+// summary goes before them, ended by another marker:
+//
+//   Looks good, a few notes below.
+//
+//   <!-- ascribe:summary -->
+//
+// A comment quotes its block's source, or its text as the page shows it,
+// escaped so GitHub shows it as written; the marker of one that quotes the
+// shown text ends ` quote=text`.
+const MARKER = /<!-- ascribe:anchor (\S+)(?: build=(\S+))?( quote=text)? -->/g;
+/**
+ * The summary a pending review starts with. GitHub can't edit the summary of
+ * a pending review created without one, so the session's reviews start with
+ * this, which reading and submitting remove.
+ */
+export const PLACEHOLDER = "<!-- ascribe:review -->";
+/** Ends a review's summary when anchored comments follow it. */
+export const SUMMARY_END = "<!-- ascribe:summary -->";
+/** `body` without the placeholder summary. */
+export function withoutPlaceholder(body) {
+    return body.split(PLACEHOLDER).join("").trim();
+}
+/**
+ * The marker for a block. Without a build (or with `""`), the comment is on
+ * every build's page. `shown` marks a quote of the shown text.
+ */
+export function marker(source, build, shown = false) {
+    return `<!-- ascribe:anchor ${source}${build === undefined || build === "" ? "" : ` build=${build}`}${shown ? " quote=text" : ""} -->`;
+}
+/** Joins a mention or reference sign to what follows, so GitHub doesn't link it. */
+const JOINER = "\u2060";
+/**
+ * Plain text as Markdown that GitHub shows as the text: punctuation
+ * escaped, `@name` and `#123` not linked, line breaks and leading spaces
+ * kept.
+ */
+export function escapeText(text) {
+    const lines = text.split(/\r?\n/).map((line) => {
+        const indent = /^ */.exec(line)?.[0].length ?? 0;
+        const rest = line
+            .slice(indent)
+            .replace(/[!-/:-@[-`{-~]/g, (c) => (c === "<" ? "&lt;" : `\\${c}`))
+            .replace(/[@#]/g, `$&${JOINER}`);
+        return "\u00a0".repeat(indent) + rest;
+    });
+    // A backslash at the end of a line breaks it, but not before a blank line.
+    return lines
+        .map((line, i) => (line !== "" && (lines[i + 1] ?? "") !== "" ? `${line}\\` : line))
+        .join("\n");
+}
+/** Text that `escapeText` wrote, as it was. */
+export function unescapeText(text) {
+    return text
+        .split(/\r?\n/)
+        .map((line) => {
+        const trailing = /\\*$/.exec(line)?.[0].length ?? 0;
+        const unbroken = trailing % 2 === 1 ? line.slice(0, -1) : line;
+        const indent = /^\u00a0*/.exec(unbroken)?.[0].length ?? 0;
+        return (" ".repeat(indent) +
+            unbroken
+                .slice(indent)
+                .replace(new RegExp(`([@#])${JOINER}`, "g"), "$1")
+                .replace(/\\([!-/:-@[-`{-~])|&lt;/g, (_, c) => c ?? "<"));
+    })
+        .join("\n");
+}
+/**
+ * Writes a section: the block's text quoted, the comment, a line linking the
+ * block's lines, and the marker.
+ */
+export function formatSection(options) {
+    const parts = [];
+    const shown = options.shown === true;
+    if (options.quote !== undefined && options.quote.trim() !== "") {
+        parts.push((shown ? escapeText(options.quote) : options.quote)
+            .split(/\r?\n/)
+            .map((line) => (line === "" ? ">" : `> ${line}`))
+            .join("\n"));
+    }
+    parts.push(options.body.trim());
+    const end = marker(options.source, options.build, shown);
+    parts.push(options.link === undefined
+        ? end
+        : `<sub>On [${options.link.label.replace(/[[\]]/g, "\\$&")}](${options.link.url})</sub>\n${end}`);
+    return parts.join("\n\n");
+}
+/**
+ * Splits a body into its summary, its marked sections, and the text after
+ * the last marker (`rest`), which isn't anchored either.
+ */
+export function parseSections(text) {
+    let body = withoutPlaceholder(text);
+    let summary = "";
+    // The summary ends before the first comment, if it's there at all.
+    const end = body.indexOf(SUMMARY_END);
+    const first = body.search(new RegExp(MARKER.source));
+    if (end >= 0 && (first < 0 || end < first)) {
+        summary = body.slice(0, end).trim();
+        body = body.slice(end + SUMMARY_END.length).trim();
+    }
+    const sections = [];
+    let start = 0;
+    for (const match of body.matchAll(MARKER)) {
+        const source = match[1] ?? "";
+        const text = body.slice(start, match.index);
+        start = match.index + match[0].length;
+        const { body: comment, quote } = unwrap(text);
+        sections.push({
+            source,
+            build: match[2],
+            body: comment,
+            quote: quote !== undefined && match[3] !== undefined ? unescapeText(quote) : quote,
+        });
+    }
+    return { summary, sections, rest: body.slice(start).trim() };
+}
+function unwrap(text) {
+    let rest = text.replace(/\s*<sub>On \[[^\n]*\]\([^\n)]*\)<\/sub>\s*$/, "").trim();
+    let quote;
+    const lines = rest.split(/\r?\n/);
+    let quoted = 0;
+    while (quoted < lines.length && /^>( |$)/.test(lines[quoted] ?? ""))
+        quoted++;
+    if (quoted > 0 && quoted < lines.length && (lines[quoted] ?? "").trim() === "") {
+        quote = lines
+            .slice(0, quoted)
+            .map((line) => line.replace(/^> ?/, ""))
+            .join("\n");
+        rest = lines
+            .slice(quoted + 1)
+            .join("\n")
+            .trim();
+    }
+    return { body: rest, quote };
+}
+/**
+ * Joins a summary and sections into one body: the summary first, so it
+ * doesn't read as a remark on the last section.
+ */
+export function joinSections(sections, summary) {
+    const held = sections.filter((part) => part.trim() !== "");
+    // A marker in the summary would be read as one of Ascribe's.
+    const lead = (summary ?? "").trim().replace(/(<!--\s*ascribe):/g, `$1${JOINER}:`);
+    if (lead === "")
+        return held.join("\n\n");
+    if (held.length === 0)
+        return lead;
+    return [lead, SUMMARY_END, ...held].join("\n\n");
+}
+//# sourceMappingURL=marker.js.map

package/dist/github/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../../src/github/marker.ts"],"names":[],"mappings":"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"}

package/dist/github/queries.d.ts

@@ -0,0 +1,16 @@
+export declare const FIND_PULL_REQUEST = "\nquery FindPullRequest($owner: String!, $name: String!, $head: String!) {\n  repository(owner: $owner, name: $name) {\n    pullRequests(headRefName: $head, states: [OPEN], first: 20, orderBy: { field: CREATED_AT, direction: DESC }) {\n      nodes {\n        id\n        number\n        url\n        baseRefName\n        baseRefOid\n        headRefName\n        headRefOid\n        headRepositoryOwner { login }\n        headRepository { name }\n      }\n    }\n  }\n}";
+export declare const REVIEW_THREADS = "\nquery ReviewThreads($owner: String!, $name: String!, $number: Int!, $after: String) {\n  repository(owner: $owner, name: $name) {\n    pullRequest(number: $number) {\n      reviewThreads(first: 100, after: $after) {\n        pageInfo { hasNextPage endCursor }\n        nodes { ...ReviewThread }\n      }\n    }\n  }\n}\n\nfragment ReviewThread on PullRequestReviewThread {\n  id\n  path\n  line\n  startLine\n  originalLine\n  originalStartLine\n  diffSide\n  startDiffSide\n  isResolved\n  isOutdated\n  subjectType\n  viewerCanResolve\n  viewerCanUnresolve\n  viewerCanReply\n  comments(first: 100) {\n    pageInfo { hasNextPage endCursor }\n    nodes { ...ReviewComment }\n  }\n}\n\nfragment ReviewComment on PullRequestReviewComment {\n  id\n  body\n  createdAt\n  url\n  state\n  diffHunk\n  author { login avatarUrl }\n  commit { oid }\n  originalCommit { oid }\n}";
+export declare const THREAD_COMMENTS = "\nquery ThreadComments($id: ID!, $after: String) {\n  node(id: $id) {\n    ... on PullRequestReviewThread {\n      comments(first: 100, after: $after) {\n        pageInfo { hasNextPage endCursor }\n        nodes { ...ReviewComment }\n      }\n    }\n  }\n}\n\nfragment ReviewComment on PullRequestReviewComment {\n  id\n  body\n  createdAt\n  url\n  state\n  diffHunk\n  author { login avatarUrl }\n  commit { oid }\n  originalCommit { oid }\n}";
+export declare const CONVERSATION = "\nquery Conversation($owner: String!, $name: String!, $number: Int!, $after: String) {\n  repository(owner: $owner, name: $name) {\n    pullRequest(number: $number) {\n      comments(first: 100, after: $after) {\n        pageInfo { hasNextPage endCursor }\n        nodes { id body createdAt url author { login avatarUrl } }\n      }\n    }\n  }\n}";
+export declare const REVIEWS = "\nquery Reviews($owner: String!, $name: String!, $number: Int!, $after: String) {\n  repository(owner: $owner, name: $name) {\n    pullRequest(number: $number) {\n      reviews(first: 100, after: $after) {\n        pageInfo { hasNextPage endCursor }\n        nodes { id state body createdAt url viewerDidAuthor author { login avatarUrl } }\n      }\n    }\n  }\n}";
+export declare const FILES = "\nquery Files($owner: String!, $name: String!, $number: Int!, $after: String) {\n  repository(owner: $owner, name: $name) {\n    pullRequest(number: $number) {\n      files(first: 100, after: $after) {\n        pageInfo { hasNextPage endCursor }\n        nodes { path }\n      }\n    }\n  }\n}";
+export declare const ADD_REVIEW = "\nmutation AddReview($pullRequestId: ID!, $commit: GitObjectID, $body: String!) {\n  addPullRequestReview(input: { pullRequestId: $pullRequestId, commitOID: $commit, body: $body }) {\n    pullRequestReview { id }\n  }\n}";
+export declare const ADD_THREAD = "\nmutation AddThread($reviewId: ID!, $path: String!, $body: String!, $line: Int!, $startLine: Int) {\n  addPullRequestReviewThread(\n    input: { pullRequestReviewId: $reviewId, path: $path, body: $body, line: $line, side: RIGHT, startLine: $startLine, subjectType: LINE }\n  ) {\n    thread { ...ReviewThread }\n  }\n}\n\nfragment ReviewThread on PullRequestReviewThread {\n  id\n  path\n  line\n  startLine\n  originalLine\n  originalStartLine\n  diffSide\n  startDiffSide\n  isResolved\n  isOutdated\n  subjectType\n  viewerCanResolve\n  viewerCanUnresolve\n  viewerCanReply\n  comments(first: 100) {\n    pageInfo { hasNextPage endCursor }\n    nodes { ...ReviewComment }\n  }\n}\n\nfragment ReviewComment on PullRequestReviewComment {\n  id\n  body\n  createdAt\n  url\n  state\n  diffHunk\n  author { login avatarUrl }\n  commit { oid }\n  originalCommit { oid }\n}";
+export declare const ADD_REPLY = "\nmutation AddReply($threadId: ID!, $body: String!, $reviewId: ID) {\n  addPullRequestReviewThreadReply(\n    input: { pullRequestReviewThreadId: $threadId, body: $body, pullRequestReviewId: $reviewId }\n  ) {\n    comment { ...ReviewComment }\n  }\n}\n\nfragment ReviewComment on PullRequestReviewComment {\n  id\n  body\n  createdAt\n  url\n  state\n  diffHunk\n  author { login avatarUrl }\n  commit { oid }\n  originalCommit { oid }\n}";
+export declare const DELETE_COMMENT = "\nmutation DeleteComment($id: ID!) {\n  deletePullRequestReviewComment(input: { id: $id }) { clientMutationId }\n}";
+export declare const RESOLVE = "\nmutation Resolve($threadId: ID!) {\n  resolveReviewThread(input: { threadId: $threadId }) {\n    thread { id isResolved viewerCanResolve viewerCanUnresolve }\n  }\n}";
+export declare const UNRESOLVE = "\nmutation Unresolve($threadId: ID!) {\n  unresolveReviewThread(input: { threadId: $threadId }) {\n    thread { id isResolved viewerCanResolve viewerCanUnresolve }\n  }\n}";
+export declare const UPDATE_REVIEW = "\nmutation UpdateReview($reviewId: ID!, $body: String!) {\n  updatePullRequestReview(input: { pullRequestReviewId: $reviewId, body: $body }) {\n    pullRequestReview { id }\n  }\n}";
+export declare const SUBMIT_REVIEW = "\nmutation SubmitReview($reviewId: ID!, $event: PullRequestReviewEvent!, $body: String) {\n  submitPullRequestReview(input: { pullRequestReviewId: $reviewId, event: $event, body: $body }) {\n    pullRequestReview { id state }\n  }\n}";
+export declare const DELETE_REVIEW = "\nmutation DeleteReview($reviewId: ID!) {\n  deletePullRequestReview(input: { pullRequestReviewId: $reviewId }) { clientMutationId }\n}";
+export declare const VIEWER = "\nquery Viewer {\n  viewer { login }\n}";

package/dist/github/queries.js

@@ -0,0 +1,174 @@
+// The GraphQL documents this package sends.
+const AUTHOR = "author { login avatarUrl }";
+const COMMENT = `
+fragment ReviewComment on PullRequestReviewComment {
+  id
+  body
+  createdAt
+  url
+  state
+  diffHunk
+  ${AUTHOR}
+  commit { oid }
+  originalCommit { oid }
+}`;
+const THREAD = `
+fragment ReviewThread on PullRequestReviewThread {
+  id
+  path
+  line
+  startLine
+  originalLine
+  originalStartLine
+  diffSide
+  startDiffSide
+  isResolved
+  isOutdated
+  subjectType
+  viewerCanResolve
+  viewerCanUnresolve
+  viewerCanReply
+  comments(first: 100) {
+    pageInfo { hasNextPage endCursor }
+    nodes { ...ReviewComment }
+  }
+}`;
+const PAGE = "pageInfo { hasNextPage endCursor }";
+export const FIND_PULL_REQUEST = `
+query FindPullRequest($owner: String!, $name: String!, $head: String!) {
+  repository(owner: $owner, name: $name) {
+    pullRequests(headRefName: $head, states: [OPEN], first: 20, orderBy: { field: CREATED_AT, direction: DESC }) {
+      nodes {
+        id
+        number
+        url
+        baseRefName
+        baseRefOid
+        headRefName
+        headRefOid
+        headRepositoryOwner { login }
+        headRepository { name }
+      }
+    }
+  }
+}`;
+export const REVIEW_THREADS = `
+query ReviewThreads($owner: String!, $name: String!, $number: Int!, $after: String) {
+  repository(owner: $owner, name: $name) {
+    pullRequest(number: $number) {
+      reviewThreads(first: 100, after: $after) {
+        ${PAGE}
+        nodes { ...ReviewThread }
+      }
+    }
+  }
+}
+${THREAD}
+${COMMENT}`;
+export const THREAD_COMMENTS = `
+query ThreadComments($id: ID!, $after: String) {
+  node(id: $id) {
+    ... on PullRequestReviewThread {
+      comments(first: 100, after: $after) {
+        ${PAGE}
+        nodes { ...ReviewComment }
+      }
+    }
+  }
+}
+${COMMENT}`;
+export const CONVERSATION = `
+query Conversation($owner: String!, $name: String!, $number: Int!, $after: String) {
+  repository(owner: $owner, name: $name) {
+    pullRequest(number: $number) {
+      comments(first: 100, after: $after) {
+        ${PAGE}
+        nodes { id body createdAt url ${AUTHOR} }
+      }
+    }
+  }
+}`;
+export const REVIEWS = `
+query Reviews($owner: String!, $name: String!, $number: Int!, $after: String) {
+  repository(owner: $owner, name: $name) {
+    pullRequest(number: $number) {
+      reviews(first: 100, after: $after) {
+        ${PAGE}
+        nodes { id state body createdAt url viewerDidAuthor ${AUTHOR} }
+      }
+    }
+  }
+}`;
+export const FILES = `
+query Files($owner: String!, $name: String!, $number: Int!, $after: String) {
+  repository(owner: $owner, name: $name) {
+    pullRequest(number: $number) {
+      files(first: 100, after: $after) {
+        ${PAGE}
+        nodes { path }
+      }
+    }
+  }
+}`;
+export const ADD_REVIEW = `
+mutation AddReview($pullRequestId: ID!, $commit: GitObjectID, $body: String!) {
+  addPullRequestReview(input: { pullRequestId: $pullRequestId, commitOID: $commit, body: $body }) {
+    pullRequestReview { id }
+  }
+}`;
+export const ADD_THREAD = `
+mutation AddThread($reviewId: ID!, $path: String!, $body: String!, $line: Int!, $startLine: Int) {
+  addPullRequestReviewThread(
+    input: { pullRequestReviewId: $reviewId, path: $path, body: $body, line: $line, side: RIGHT, startLine: $startLine, subjectType: LINE }
+  ) {
+    thread { ...ReviewThread }
+  }
+}
+${THREAD}
+${COMMENT}`;
+export const ADD_REPLY = `
+mutation AddReply($threadId: ID!, $body: String!, $reviewId: ID) {
+  addPullRequestReviewThreadReply(
+    input: { pullRequestReviewThreadId: $threadId, body: $body, pullRequestReviewId: $reviewId }
+  ) {
+    comment { ...ReviewComment }
+  }
+}
+${COMMENT}`;
+export const DELETE_COMMENT = `
+mutation DeleteComment($id: ID!) {
+  deletePullRequestReviewComment(input: { id: $id }) { clientMutationId }
+}`;
+export const RESOLVE = `
+mutation Resolve($threadId: ID!) {
+  resolveReviewThread(input: { threadId: $threadId }) {
+    thread { id isResolved viewerCanResolve viewerCanUnresolve }
+  }
+}`;
+export const UNRESOLVE = `
+mutation Unresolve($threadId: ID!) {
+  unresolveReviewThread(input: { threadId: $threadId }) {
+    thread { id isResolved viewerCanResolve viewerCanUnresolve }
+  }
+}`;
+export const UPDATE_REVIEW = `
+mutation UpdateReview($reviewId: ID!, $body: String!) {
+  updatePullRequestReview(input: { pullRequestReviewId: $reviewId, body: $body }) {
+    pullRequestReview { id }
+  }
+}`;
+export const SUBMIT_REVIEW = `
+mutation SubmitReview($reviewId: ID!, $event: PullRequestReviewEvent!, $body: String) {
+  submitPullRequestReview(input: { pullRequestReviewId: $reviewId, event: $event, body: $body }) {
+    pullRequestReview { id state }
+  }
+}`;
+export const DELETE_REVIEW = `
+mutation DeleteReview($reviewId: ID!) {
+  deletePullRequestReview(input: { pullRequestReviewId: $reviewId }) { clientMutationId }
+}`;
+export const VIEWER = `
+query Viewer {
+  viewer { login }
+}`;
+//# sourceMappingURL=queries.js.map

package/dist/github/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/github/queries.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,MAAM,GAAG,4BAA4B,CAAC;AAE5C,MAAM,OAAO,GAAG;;;;;;;;IAQZ,MAAM;;;EAGR,CAAC;AAEH,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;EAoBb,CAAC;AAEH,MAAM,IAAI,GAAG,oCAAoC,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;EAiB/B,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;UAKpB,IAAI;;;;;;EAMZ,MAAM;EACN,OAAO,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;UAKrB,IAAI;;;;;;EAMZ,OAAO,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;UAKlB,IAAI;wCAC0B,MAAM;;;;EAI5C,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;UAKb,IAAI;8DACgD,MAAM;;;;EAIlE,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;UAKX,IAAI;;;;;EAKZ,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;EAKxB,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;EAQxB,MAAM;EACN,OAAO,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;EAQvB,OAAO,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,cAAc,GAAG;;;EAG5B,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;EAKrB,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;EAKvB,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;EAK3B,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;EAK3B,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;;;EAG3B,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;;;EAGpB,CAAC"}

package/dist/github/read.d.ts

@@ -0,0 +1,84 @@
+import type { Thread, ThreadComment } from "../shared/types.js";
+import type { GitHubTransport } from "./transport.js";
+/** A pull request, by repository and number. */
+export interface PullRequestKey {
+    owner: string;
+    name: string;
+    number: number;
+}
+interface Page<T> {
+    pageInfo: {
+        hasNextPage: boolean;
+        endCursor: string | null;
+    };
+    nodes: (T | null)[];
+}
+interface RawAuthor {
+    login: string;
+    avatarUrl?: string | null;
+}
+interface RawComment {
+    id: string;
+    body: string;
+    createdAt: string;
+    url: string;
+    state: "PENDING" | "SUBMITTED";
+    diffHunk: string;
+    author: RawAuthor | null;
+    commit: {
+        oid: string;
+    } | null;
+    originalCommit: {
+        oid: string;
+    } | null;
+}
+/** A review thread as the API returns it. */
+export interface RawThread {
+    id: string;
+    path: string;
+    line: number | null;
+    startLine: number | null;
+    originalLine: number | null;
+    originalStartLine: number | null;
+    diffSide: "LEFT" | "RIGHT";
+    startDiffSide: "LEFT" | "RIGHT" | null;
+    isResolved: boolean;
+    isOutdated: boolean;
+    subjectType: "LINE" | "FILE";
+    viewerCanResolve: boolean;
+    viewerCanUnresolve: boolean;
+    viewerCanReply: boolean;
+    comments: Page<RawComment>;
+}
+interface RawConversationComment {
+    id: string;
+    body: string;
+    createdAt: string;
+    url: string;
+    author: RawAuthor | null;
+}
+/** A review, as the API returns it. */
+export interface RawReview extends RawConversationComment {
+    state: "PENDING" | "COMMENTED" | "APPROVED" | "CHANGES_REQUESTED" | "DISMISSED";
+    viewerDidAuthor: boolean;
+}
+/** Every review thread, each with all its comments. */
+export declare function readReviewThreads(transport: GitHubTransport, key: PullRequestKey): Promise<RawThread[]>;
+/** Reads the comments past a thread's first page into it. */
+export declare function readRestOfComments(transport: GitHubTransport, thread: RawThread): Promise<void>;
+/** The pull request's conversation comments. */
+export declare function readConversation(transport: GitHubTransport, key: PullRequestKey): Promise<RawConversationComment[]>;
+/** The pull request's reviews, the viewer's pending one included. */
+export declare function readReviews(transport: GitHubTransport, key: PullRequestKey): Promise<RawReview[]>;
+/** The repository paths of the files the pull request changes. */
+export declare function readFiles(transport: GitHubTransport, key: PullRequestKey): Promise<Set<string>>;
+/** A comment of a review thread. */
+export declare function toComment(raw: RawComment): ThreadComment;
+/** A review thread. */
+export declare function toThread(raw: RawThread): Thread;
+/**
+ * The anchored comments in a conversation comment's or a review's body, as
+ * threads. `contentPrefix` is the content root's path in the repository.
+ */
+export declare function markedThreads(raw: RawConversationComment, contentPrefix: string, pending: boolean): Thread[];
+export {};

package/dist/github/read.js

@@ -0,0 +1,141 @@
+// Reading a pull request's threads, reviews, and files, page by page.
+import { parseSource } from "../place/anchor.js";
+import { parseSections } from "./marker.js";
+import { CONVERSATION, FILES, REVIEW_THREADS, REVIEWS, THREAD_COMMENTS } from "./queries.js";
+/** Reads every page of one of the pull request's connections. */
+async function readAll(transport, query, key, field) {
+    const items = [];
+    let after = null;
+    for (;;) {
+        const data = await transport.graphql(query, { ...key, after });
+        const page = data.repository?.pullRequest?.[field];
+        if (page === undefined)
+            break;
+        for (const node of page.nodes)
+            if (node !== null)
+                items.push(node);
+        if (!page.pageInfo.hasNextPage || page.pageInfo.endCursor === null)
+            break;
+        after = page.pageInfo.endCursor;
+    }
+    return items;
+}
+/** Every review thread, each with all its comments. */
+export async function readReviewThreads(transport, key) {
+    const threads = await readAll(transport, REVIEW_THREADS, key, "reviewThreads");
+    for (const thread of threads)
+        await readRestOfComments(transport, thread);
+    return threads;
+}
+/** Reads the comments past a thread's first page into it. */
+export async function readRestOfComments(transport, thread) {
+    let page = thread.comments;
+    while (page.pageInfo.hasNextPage && page.pageInfo.endCursor !== null) {
+        const data = await transport.graphql(THREAD_COMMENTS, { id: thread.id, after: page.pageInfo.endCursor });
+        if (data.node === null)
+            break;
+        page = data.node.comments;
+        thread.comments.nodes.push(...page.nodes);
+    }
+    thread.comments.pageInfo = page.pageInfo;
+}
+/** The pull request's conversation comments. */
+export function readConversation(transport, key) {
+    return readAll(transport, CONVERSATION, key, "comments");
+}
+/** The pull request's reviews, the viewer's pending one included. */
+export function readReviews(transport, key) {
+    return readAll(transport, REVIEWS, key, "reviews");
+}
+/** The repository paths of the files the pull request changes. */
+export async function readFiles(transport, key) {
+    const files = await readAll(transport, FILES, key, "files");
+    return new Set(files.map((file) => file.path));
+}
+function author(raw) {
+    return raw === null ? null : { login: raw.login, avatarUrl: raw.avatarUrl ?? undefined };
+}
+/** A comment of a review thread. */
+export function toComment(raw) {
+    return {
+        id: raw.id,
+        author: author(raw.author),
+        body: raw.body,
+        createdAt: raw.createdAt,
+        url: raw.url,
+        pending: raw.state === "PENDING",
+    };
+}
+/** A review thread. */
+export function toThread(raw) {
+    const comments = raw.comments.nodes.filter((node) => node !== null);
+    const first = comments[0];
+    return {
+        id: raw.id,
+        kind: "review",
+        repositoryPath: raw.path,
+        subject: raw.subjectType === "FILE" ? "file" : "line",
+        side: raw.diffSide,
+        line: raw.line,
+        startLine: raw.startLine,
+        originalLine: raw.originalLine,
+        originalStartLine: raw.originalStartLine,
+        commit: first?.commit?.oid,
+        originalCommit: first?.originalCommit?.oid,
+        resolved: raw.isResolved,
+        outdated: raw.isOutdated,
+        canResolve: raw.viewerCanResolve,
+        canUnresolve: raw.viewerCanUnresolve,
+        canReply: raw.viewerCanReply,
+        comments: comments.map(toComment),
+        diffHunk: first?.diffHunk,
+        marker: undefined,
+        quote: undefined,
+    };
+}
+/**
+ * The anchored comments in a conversation comment's or a review's body, as
+ * threads. `contentPrefix` is the content root's path in the repository.
+ */
+export function markedThreads(raw, contentPrefix, pending) {
+    const threads = [];
+    const { sections } = parseSections(raw.body);
+    sections.forEach((section, index) => {
+        const range = parseSource(section.source);
+        if (range === undefined)
+            return;
+        threads.push({
+            id: sections.length === 1 ? raw.id : `${raw.id}#${index}`,
+            kind: "conversation",
+            repositoryPath: `${contentPrefix}${range.path}`,
+            subject: "line",
+            side: "RIGHT",
+            line: range.last,
+            startLine: range.first === range.last ? null : range.first,
+            originalLine: range.last,
+            originalStartLine: range.first === range.last ? null : range.first,
+            commit: undefined,
+            originalCommit: undefined,
+            resolved: false,
+            outdated: false,
+            canResolve: false,
+            canUnresolve: false,
+            canReply: false,
+            comments: [
+                {
+                    id: sections.length === 1 ? raw.id : `${raw.id}#${index}`,
+                    author: author(raw.author),
+                    body: section.body,
+                    createdAt: raw.createdAt,
+                    url: raw.url,
+                    pending,
+                },
+            ],
+            diffHunk: undefined,
+            marker: { source: section.source, build: section.build },
+            quote: section.quote,
+        });
+    });
+    return threads;
+}
+//# sourceMappingURL=read.js.map

package/dist/github/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/github/read.ts"],"names":[],"mappings":"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"}

package/dist/github/repository.d.ts

@@ -0,0 +1,30 @@
+/** A repository on a GitHub host. */
+export interface RepositoryRef {
+    /** `github.com`, or a GitHub Enterprise Server host. */
+    host: string;
+    owner: string;
+    name: string;
+}
+/**
+ * The repository a remote URL names, or `undefined` if it isn't a GitHub-style
+ * URL: `https://host/owner/name(.git)`, `git@host:owner/name(.git)`, or
+ * `ssh://git@host[:port]/owner/name(.git)`.
+ */
+export declare function parseRemote(url: string): RepositoryRef | undefined;
+/** The checkout's branch and the repositories a pull request for it could be in. */
+export interface CheckoutInfo {
+    /** The repository's top-level directory. */
+    root: string;
+    /** The local branch, or `undefined` when `HEAD` is detached. */
+    branch: string | undefined;
+    /** The branch's name on its remote (its upstream's name, or the same name). */
+    headRef: string | undefined;
+    /** The repository the branch is pushed to. */
+    head: RepositoryRef | undefined;
+    /** Where to look for the pull request: an `upstream` remote first, then `head`. */
+    bases: RepositoryRef[];
+    /** The commit `HEAD` names. */
+    headOid: string;
+}
+/** Reads the checkout at `cwd`. Rejects with a `git` error if it isn't a repository. */
+export declare function readCheckout(cwd: string): Promise<CheckoutInfo>;