@ascribed/review 0.1.2-next.2

package/dist/github/repository.js

@@ -0,0 +1,77 @@
+// The checkout's GitHub repository and branch, from git's configuration.
+import { git, gitMaybe } from "../shared/git.js";
+import { ReviewError } from "../shared/errors.js";
+/**
+ * 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 function parseRemote(url) {
+    const trimmed = url.trim();
+    let host;
+    let rest;
+    const scp = /^(?:[^@/]+@)?([^:/]+):(?!\/)(.+)$/.exec(trimmed);
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed)) {
+        let parsed;
+        try {
+            parsed = new URL(trimmed);
+        }
+        catch {
+            return undefined;
+        }
+        if (!["https:", "http:", "ssh:", "git:"].includes(parsed.protocol))
+            return undefined;
+        host = parsed.hostname;
+        rest = parsed.pathname;
+    }
+    else if (scp !== null) {
+        host = scp[1] ?? "";
+        rest = scp[2] ?? "";
+    }
+    else {
+        return undefined;
+    }
+    const parts = rest.replace(/^\/+|\/+$/g, "").split("/");
+    if (parts.length !== 2)
+        return undefined;
+    const owner = parts[0] ?? "";
+    const name = (parts[1] ?? "").replace(/\.git$/, "");
+    if (owner === "" || name === "")
+        return undefined;
+    // SSH connections to github.com sometimes go through ssh.github.com.
+    if (host === "ssh.github.com")
+        host = "github.com";
+    return { host: host.toLowerCase(), owner, name };
+}
+/** Reads the checkout at `cwd`. Rejects with a `git` error if it isn't a repository. */
+export async function readCheckout(cwd) {
+    const root = (await git(cwd, ["rev-parse", "--show-toplevel"])).trim();
+    const headOid = (await gitMaybe(root, ["rev-parse", "--verify", "--quiet", "HEAD"]))?.trim();
+    if (headOid === undefined || headOid === "") {
+        throw new ReviewError("git", "The repository has no commits yet.");
+    }
+    const branch = (await gitMaybe(root, ["symbolic-ref", "--quiet", "--short", "HEAD"]))?.trim();
+    if (branch === undefined || branch === "") {
+        return { root, branch: undefined, headRef: undefined, head: undefined, bases: [], headOid };
+    }
+    const config = async (key) => (await gitMaybe(root, ["config", "--get", key]))?.trim() || undefined;
+    const remoteName = (await config(`branch.${branch}.pushRemote`)) ??
+        (await config("remote.pushDefault")) ??
+        (await config(`branch.${branch}.remote`)) ??
+        "origin";
+    const merge = await config(`branch.${branch}.merge`);
+    const headRef = merge?.replace(/^refs\/heads\//, "") ?? branch;
+    const remoteUrl = async (name) => {
+        const url = await config(`remote.${name}.url`);
+        return url === undefined ? undefined : parseRemote(url);
+    };
+    const head = await remoteUrl(remoteName);
+    const bases = [];
+    const upstream = remoteName === "upstream" ? undefined : await remoteUrl("upstream");
+    if (upstream !== undefined)
+        bases.push(upstream);
+    if (head !== undefined)
+        bases.push(head);
+    return { root, branch, headRef, head, bases, headOid };
+}
+//# sourceMappingURL=repository.js.map

package/dist/github/repository.js.map

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

package/dist/github/requests.d.ts

@@ -0,0 +1,65 @@
+import type { PageRef } from "../place/place.js";
+import type { PullRequestInfo, ReviewSession } from "./session.js";
+/** The overlay's requests, one per `OverlayHost` method that reads or writes threads. */
+export type OverlayMethod = "load" | "commentTarget" | "comment" | "reply" | "allThreads" | "resolve" | "submit" | "discard";
+export declare const OVERLAY_METHODS: readonly OverlayMethod[];
+/** A changed page as `ascribe diff` lists it, with its title when the host knows it. */
+export interface ChangedPageRef {
+    path: string;
+    status: "added" | "removed" | "changed";
+    because: readonly string[];
+    title?: string | null;
+}
+/** What answering a request needs. */
+export interface RequestContext {
+    session: ReviewSession;
+    /** The page the overlay is on: its build and content path. */
+    page: {
+        build: string;
+        path: string;
+    } | undefined;
+    /** The page as the overlay last read it, with its anchors: comments are made on it. */
+    lastPage: PageRef | undefined;
+    /** The changed pages, for which pages show a thread. */
+    changedPages(): Promise<readonly ChangedPageRef[]>;
+    /**
+     * For a host whose pages are rendered from an editor's unsaved text: a
+     * file's text on disk (`saved`) and in the editor (`current`), by content
+     * path, or `undefined` when they're the same. The session counts lines on
+     * disk, so the page's blocks are moved to their lines there, and back.
+     */
+    unsaved?(path: string): Promise<{
+        saved: string;
+        current: string;
+    } | undefined>;
+}
+/** An answer: the result, the page read (for `load`), and whether the request changed the threads. */
+export interface Answer {
+    result: unknown;
+    page?: PageRef;
+    changed: boolean;
+}
+/** Answers one of the overlay's requests. Rejects with a `ReviewError`. */
+export declare function answerRequest(context: RequestContext, method: OverlayMethod, params: Record<string, unknown>): Promise<Answer>;
+/**
+ * The changed pages that show a file (a content path): the file's own page,
+ * and the pages that changed through it (an include). `[]` when none does.
+ */
+export declare function pagesShowing(file: string, pages: readonly ChangedPageRef[]): {
+    path: string;
+    title: string | null;
+}[];
+/**
+ * The git revision to compare with for a pull request's base: the remote
+ * branch, from the remote whose URL is the pull request's repository, when
+ * there is one; else the branch's name.
+ */
+export declare function pullRequestBase(remotes: readonly {
+    name: string;
+    repository: string | undefined;
+}[], repository: string, baseRefName: string): string;
+/**
+ * The git revision for the pull request's base in the checkout at `root`:
+ * `origin/main` when that remote branch exists, else the branch's name.
+ */
+export declare function baseRevision(root: string, pr: PullRequestInfo): Promise<string>;

package/dist/github/requests.js

@@ -0,0 +1,274 @@
+// Answering the overlay's requests (`OverlayHost`) from a review session, for
+// a host that keeps GitHub to itself and passes the overlay's requests on as
+// messages: the page preview's extension, or the site preview's dev server.
+// The parameters arrive as untyped messages, so each is checked here.
+import { anchorKey, parseSource } from "../place/anchor.js";
+import { lineHunks, shiftLine } from "../place/lines.js";
+import { ReviewError } from "../shared/errors.js";
+import { gitMaybe } from "../shared/git.js";
+import { parseRemote } from "./repository.js";
+export const OVERLAY_METHODS = [
+    "load",
+    "commentTarget",
+    "comment",
+    "reply",
+    "allThreads",
+    "resolve",
+    "submit",
+    "discard",
+];
+/** Answers one of the overlay's requests. Rejects with a `ReviewError`. */
+export async function answerRequest(context, method, params) {
+    const { session } = context;
+    switch (method) {
+        case "load": {
+            const page = context.page;
+            if (!page)
+                throw new ReviewError("not-found", "There's no page to review here.");
+            const shown = anchors(params["anchors"]);
+            const edits = await unsavedEdits(context, shown);
+            // The page's blocks at their lines on disk, and the way back.
+            const back = new Map();
+            for (const block of shown) {
+                const saved = toSaved(edits, block, false);
+                if (saved !== undefined && !back.has(anchorKey(saved)))
+                    back.set(anchorKey(saved), block);
+            }
+            const ref = {
+                build: page.build,
+                path: page.path,
+                anchors: edits.size === 0 ? shown : [...back.keys()].map((key) => fromKey(key)),
+                removed: anchors(params["removed"]),
+            };
+            const [placed, pending, viewer] = await Promise.all([
+                session.threads(ref),
+                session.pending(),
+                session.viewer(),
+            ]);
+            const threads = edits.size === 0
+                ? placed
+                : {
+                    ...placed,
+                    blocks: placed.blocks.map((block) => ({
+                        ...block,
+                        anchor: back.get(anchorKey(block.anchor)) ?? block.anchor,
+                    })),
+                };
+            const pr = session.pullRequest;
+            return {
+                result: { pullRequest: { number: pr.number, url: pr.url }, threads, pending, viewer },
+                page: ref,
+                changed: false,
+            };
+        }
+        case "commentTarget": {
+            const shown = anchor(params["anchor"]);
+            const saved = toSaved(await unsavedEdits(context, [shown]), shown, true);
+            if (saved === undefined)
+                return { result: { kind: "push-first", message: UNSAVED }, changed: false };
+            return { result: await session.commentTarget(saved), changed: false };
+        }
+        case "allThreads": {
+            const [threads, pages] = await Promise.all([
+                session.allThreads(),
+                context.changedPages().catch(() => []),
+            ]);
+            return {
+                result: threads.map((thread) => ({ thread, pages: pagesShowing(thread.path, pages) })),
+                changed: false,
+            };
+        }
+        case "comment": {
+            const shown = anchor(params["anchor"]);
+            const target = toSaved(await unsavedEdits(context, [shown]), shown, true);
+            if (target === undefined)
+                throw new ReviewError("push-first", UNSAVED);
+            const page = context.lastPage ?? {
+                build: context.page?.build ?? "",
+                path: context.page?.path ?? "",
+                anchors: [target],
+            };
+            const quote = typeof params["quote"] === "string" ? params["quote"] : undefined;
+            return {
+                result: await session.comment(target, text(params["body"]), page, quote),
+                changed: true,
+            };
+        }
+        case "reply":
+            return {
+                result: await session.reply(text(params["threadId"]), text(params["body"]), params["when"] === "now" ? "now" : "withReview"),
+                changed: true,
+            };
+        case "resolve":
+            await session.resolve(text(params["threadId"]), params["resolved"] === true);
+            return { result: null, changed: true };
+        case "submit": {
+            const body = typeof params["body"] === "string" ? params["body"] : undefined;
+            await session.submit(event(params["event"]), body);
+            return { result: null, changed: true };
+        }
+        case "discard":
+            await session.discard();
+            return { result: null, changed: true };
+    }
+}
+const UNSAVED = "This block has changes that aren't saved. Save the file, then comment.";
+/** The line changes from each shown file's text in the editor to its text on disk, where they differ. */
+async function unsavedEdits(context, shown) {
+    const edits = new Map();
+    if (!context.unsaved)
+        return edits;
+    const files = new Set();
+    for (const block of shown) {
+        const range = parseSource(block.source);
+        if (range)
+            files.add(range.path);
+        for (const include of block.via) {
+            const at = parseInclude(include);
+            if (at)
+                files.add(at.path);
+        }
+    }
+    for (const file of files) {
+        const text = await context.unsaved(file);
+        if (text === undefined)
+            continue;
+        const hunks = lineHunks(text.current, text.saved);
+        if (hunks.length > 0) {
+            edits.set(file, {
+                hunks,
+                sides: { old: text.current.split(/\r?\n/), new: text.saved.split(/\r?\n/) },
+            });
+        }
+    }
+    return edits;
+}
+/**
+ * A block's anchor with its lines on disk. `strict` (for commenting) wants
+ * every line of the block saved as it is; otherwise an edited block takes
+ * the lines its text has on disk. `undefined` when nothing of it is saved.
+ */
+function toSaved(edits, block, strict) {
+    if (edits.size === 0)
+        return block;
+    const range = parseSource(block.source);
+    if (range === undefined)
+        return block;
+    const edit = edits.get(range.path);
+    let source = block.source;
+    if (edit !== undefined) {
+        const lines = [];
+        for (let line = range.first; line <= range.last; line++) {
+            const moved = shiftLine(edit.hunks, line, edit.sides);
+            if (moved === undefined || moved.replaced) {
+                if (strict)
+                    return undefined;
+                if (moved === undefined)
+                    continue;
+            }
+            lines.push(moved.line);
+        }
+        if (lines.length === 0)
+            return undefined;
+        const colon = block.source.lastIndexOf(":");
+        source = `${block.source.slice(0, colon)}:${Math.min(...lines)}-${Math.max(...lines)}`;
+    }
+    const via = [];
+    for (const include of block.via) {
+        const at = parseInclude(include);
+        const includeEdit = at && edits.get(at.path);
+        if (!at || !includeEdit) {
+            via.push(include);
+            continue;
+        }
+        const moved = shiftLine(includeEdit.hunks, at.line, includeEdit.sides);
+        if (moved === undefined || (strict && moved.replaced))
+            return undefined;
+        via.push(`${include.slice(0, include.lastIndexOf(":"))}:${moved.line}`);
+    }
+    return { source, via };
+}
+/** An include, `<path>:<line>`, parsed, with its path decoded. */
+function parseInclude(include) {
+    const colon = include.lastIndexOf(":");
+    const line = Number(include.slice(colon + 1));
+    if (colon <= 0 || !Number.isInteger(line) || line < 1)
+        return undefined;
+    const range = parseSource(`${include.slice(0, colon)}:1-1`);
+    return range && { path: range.path, line };
+}
+/** The anchor `anchorKey` wrote. */
+function fromKey(key) {
+    const [source = "", ...via] = key.split(" ");
+    return { source, via };
+}
+/**
+ * The changed pages that show a file (a content path): the file's own page,
+ * and the pages that changed through it (an include). `[]` when none does.
+ */
+export function pagesShowing(file, pages) {
+    return pages
+        .filter((page) => page.status !== "removed")
+        .filter((page) => page.path === file || page.because.includes(file))
+        .sort((a, b) => Number(b.path === file) - Number(a.path === file))
+        .map((page) => ({ path: page.path, title: page.title ?? null }));
+}
+/**
+ * The git revision to compare with for a pull request's base: the remote
+ * branch, from the remote whose URL is the pull request's repository, when
+ * there is one; else the branch's name.
+ */
+export function pullRequestBase(remotes, repository, baseRefName) {
+    const remote = remotes.find((r) => r.repository === repository && r.name === "upstream") ??
+        remotes.find((r) => r.repository === repository && r.name === "origin") ??
+        remotes.find((r) => r.repository === repository);
+    return remote ? `${remote.name}/${baseRefName}` : baseRefName;
+}
+/**
+ * The git revision for the pull request's base in the checkout at `root`:
+ * `origin/main` when that remote branch exists, else the branch's name.
+ */
+export async function baseRevision(root, pr) {
+    const out = (await gitMaybe(root, ["remote", "-v"]).catch(() => undefined)) ?? "";
+    const remotes = out
+        .split("\n")
+        .map((line) => /^(\S+)\s+(\S+)\s+\(fetch\)$/.exec(line))
+        .filter((match) => match !== null)
+        .map((match) => {
+        const repository = parseRemote(match[2] ?? "");
+        return { name: match[1] ?? "", repository: repository && repoKey(repository) };
+    });
+    const revision = pullRequestBase(remotes, repoKey(pr.repository), pr.baseRefName);
+    if (revision !== pr.baseRefName) {
+        const exists = await gitMaybe(root, ["rev-parse", "--verify", "--quiet", revision]).catch(() => undefined);
+        if (exists !== undefined)
+            return revision;
+    }
+    return pr.baseRefName;
+}
+function repoKey(repository) {
+    return `${repository.host}/${repository.owner}/${repository.name}`.toLowerCase();
+}
+const EVENTS = ["COMMENT", "APPROVE", "REQUEST_CHANGES"];
+function event(value) {
+    if (EVENTS.includes(value))
+        return value;
+    throw new ReviewError("refused", `A review can't be submitted as ${String(value)}.`);
+}
+function text(value) {
+    if (typeof value !== "string")
+        throw new ReviewError("refused", "The request is missing text.");
+    return value;
+}
+function anchor(value) {
+    const record = value;
+    if (typeof record?.source !== "string") {
+        throw new ReviewError("refused", "The request is missing a block.");
+    }
+    const via = Array.isArray(record.via) ? record.via.filter((v) => typeof v === "string") : [];
+    return { source: record.source, via };
+}
+function anchors(value) {
+    return Array.isArray(value) ? value.map(anchor) : [];
+}
+//# sourceMappingURL=requests.js.map

package/dist/github/requests.js.map

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

package/dist/github/session.d.ts

@@ -0,0 +1,143 @@
+import { type Anchor } from "../place/anchor.js";
+import { type LocatedThread, type PageRef, type PlacedThreads } from "../place/place.js";
+import type { Thread, ThreadComment } from "../shared/types.js";
+import { type CheckoutInfo, type RepositoryRef } from "./repository.js";
+import { type GitHubTransport } from "./transport.js";
+/** How the local `HEAD` relates to the pull request's head commit. */
+export type LocalState = 
+/** `HEAD` is the pull request's head commit. */
+"same"
+/** The pull request has commits `HEAD` doesn't: pull them. */
+ | "behind"
+/** `HEAD` has commits the pull request doesn't: push them. */
+ | "ahead"
+/** Both have commits the other doesn't. */
+ | "diverged"
+/** The pull request's head commit isn't in the local repository: fetch it. */
+ | "missing";
+/** The pull request for the checkout. */
+export interface PullRequestInfo {
+    /** Its GraphQL node id. */
+    id: string;
+    number: number;
+    url: string;
+    repository: RepositoryRef;
+    baseRefName: string;
+    baseOid: string;
+    headRefName: string;
+    headOid: string;
+    local: LocalState;
+}
+/** What's in the viewer's pending review: comments only they can see until they submit. */
+export interface PendingReview {
+    /** The review's node id, or `undefined` when there's no pending review. */
+    id: string | undefined;
+    /** New threads. */
+    threads: Thread[];
+    /** Replies to existing threads. */
+    replies: {
+        threadId: string;
+        comment: ThreadComment;
+    }[];
+    /** Comments on blocks GitHub can't anchor, which go on the conversation when submitted. */
+    conversation: Thread[];
+    /** How many comments there are in all. */
+    count: number;
+}
+/** How a review ends: as a comment, an approval, or a request for changes. */
+export type ReviewEvent = "COMMENT" | "APPROVE" | "REQUEST_CHANGES";
+/** How a comment on a block would go, worked out before it's made. */
+export type CommentTarget = 
+/** As a review thread on the block's lines. */
+{
+    kind: "thread";
+}
+/**
+ * In the pending review's body, since GitHub can't anchor it: the file
+ * isn't in the pull request (`"file"`), or the lines are away from its
+ * changes (`"lines"`).
+ */
+ | {
+    kind: "summary";
+    reason: "file" | "lines";
+}
+/** Not until the block's lines are pushed (or fetched): `message` says which. */
+ | {
+    kind: "push-first";
+    message: string;
+};
+/** One pull request's review, for a host and the overlay behind it. */
+export interface ReviewSession {
+    pullRequest: PullRequestInfo;
+    /** The page's threads. Cached until `refresh()` or a change made through the session. */
+    threads(page: PageRef): Promise<PlacedThreads>;
+    /** Every thread on the pull request's files in the content root, located in the working tree. */
+    allThreads(): Promise<LocatedThread[]>;
+    /** The signed-in viewer's login. */
+    viewer(): Promise<string>;
+    /** How a comment on a block would go: as a thread, in the review's summary, or not yet. */
+    commentTarget(anchor: Anchor): Promise<CommentTarget>;
+    /** Comments on a block, in the pending review. */
+    /**
+     * Comments on a block. `quote` is the block's text as the page shows it,
+     * which a comment held in the review's summary quotes; without it, the
+     * comment quotes the block's source.
+     */
+    comment(anchor: Anchor, body: string, page: PageRef, quote?: string): Promise<Thread>;
+    /** Replies to a thread: sent at once (`"now"`), or held in the pending review. */
+    reply(threadId: string, body: string, when: "now" | "withReview"): Promise<ThreadComment>;
+    /** Resolves or reopens a thread, at once. */
+    resolve(threadId: string, resolved: boolean): Promise<void>;
+    pending(): Promise<PendingReview>;
+    /** Submits the pending review, making its comments visible. */
+    submit(event: ReviewEvent, body?: string): Promise<void>;
+    /** Deletes the pending review and everything in it. */
+    discard(): Promise<void>;
+    /** Forgets what's cached, so the next call reads from GitHub again. */
+    refresh(): Promise<void>;
+}
+/** Options for `openReview`. */
+export interface OpenReviewOptions {
+    /** The directory holding the project's `ascribe.toml`. */
+    projectDir: string;
+    /**
+     * The content root's path in the repository, with a trailing `/`. By
+     * default it's worked out from `ascribe.toml`'s `content-root`.
+     */
+    contentPrefix?: string;
+    /** Makes the transport for a host. By default, `ghTransport`. */
+    transport?: (host: string) => GitHubTransport;
+    /**
+     * The least time between two requests that change something, in
+     * milliseconds, to stay under GitHub's secondary rate limit. Default 1000.
+     */
+    mutationInterval?: number;
+}
+/**
+ * Opens a review of the pull request for the project's checkout: the open
+ * pull request whose head is the current branch. Resolves with `undefined`
+ * when there's none, or `HEAD` is detached.
+ */
+export declare function openReview(options: OpenReviewOptions): Promise<ReviewSession | undefined>;
+/** The content root's path in the repository, from the project's `ascribe.toml`. */
+export declare function contentPrefixOf(root: string, projectDir: string): string;
+/**
+ * The open pull request whose head is the checkout's branch, looked for in an
+ * `upstream` remote's repository and then in the one the branch is pushed to.
+ */
+export declare function findPullRequest(checkout: CheckoutInfo, transportFor: (host: string) => GitHubTransport): Promise<PullRequestInfo | undefined>;
+/** What a session needs, for hosts and tests that find the pull request themselves. */
+export interface SessionOptions {
+    root: string;
+    contentPrefix: string;
+    pullRequest: PullRequestInfo;
+    transport: GitHubTransport;
+    mutationInterval: number;
+    /**
+     * How long to wait before reading again when GitHub fails a read with its
+     * generic error, in milliseconds. Default 2000.
+     */
+    retryDelay?: number;
+}
+/** A session for a pull request already found. */
+export declare function createSession(options: SessionOptions): ReviewSession;