@nonameolsson/nightjar 0.0.0-stage → 0.2.0

package/dist/azure-devops/fake-azure-devops.js

@@ -0,0 +1,728 @@
+const TOKEN = 'Bearer fake-azure-devops';
+const API = '7.1';
+const COMMENTS_API = '7.1-preview.4';
+const STATE = /System\.State/i;
+const CHILD = 'System.LinkTypes.Hierarchy-Forward';
+const PARENT = 'System.LinkTypes.Hierarchy-Reverse';
+const SUCCESSOR = 'System.LinkTypes.Dependency-Forward';
+const PREDECESSOR = 'System.LinkTypes.Dependency-Reverse';
+const json = (status, body) => ({
+    status,
+    text: body === undefined ? '' : JSON.stringify(body)
+});
+const refusal = (status, message) => json(status, { message, typeKey: 'Fault' });
+// What Azure DevOps keeps of Markdown: a bare < or > becomes its entity.
+const storedMarkdown = (text) => text.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+const fault = (message) => new Error(`the fake Azure DevOps: ${message}`);
+const guid = (n) => `00000000-0000-0000-0000-${String(n).padStart(12, '0')}`;
+export class FakeAzureDevOps {
+    organization;
+    project;
+    person;
+    items = new Map();
+    people = new Map();
+    discussion = new Map();
+    clock = Date.UTC(2026, 9, 30, 9, 0);
+    // every call it answered, in order
+    asked = [];
+    faults = [];
+    repositories = new Map();
+    pulls = [];
+    // the artifact links on each work item, such as one to a pull request
+    artifacts = new Map();
+    constructor(organization, project, 
+    // the sign-in name the token is for
+    person) {
+        this.organization = organization;
+        this.project = project;
+        this.person = person;
+        this.join(person, { contributor: true });
+    }
+    // Adds a person to the organization; a Contributor is in the project's Contributors group by way of its team.
+    join(uniqueName, { contributor }) {
+        const known = this.people.get(uniqueName.toLowerCase());
+        const id = known?.id ?? guid(this.people.size + 1);
+        this.people.set(uniqueName.toLowerCase(), { id, uniqueName, contributor });
+    }
+    // Makes a work item and gives back its id.
+    workItem(item) {
+        const id = this.items.size + 1;
+        const fields = {
+            'System.Id': id,
+            'System.TeamProject': this.project,
+            'System.WorkItemType': item.type,
+            'System.Title': item.title,
+            'System.State': item.state ?? 'New',
+            'System.CreatedDate': this.tick()
+        };
+        if (item.description !== undefined) {
+            fields['System.Description'] = item.html
+                ? item.description
+                : storedMarkdown(item.description);
+        }
+        if (item.assignedTo !== undefined)
+            fields['System.AssignedTo'] = this.identity(item.assignedTo);
+        if (item.tags !== undefined && item.tags.length > 0)
+            fields['System.Tags'] = item.tags.join('; ');
+        if (item.closed === true)
+            fields['Microsoft.VSTS.Common.ClosedDate'] = this.tick();
+        if (item.rank !== undefined)
+            fields[item.rank.field] = item.rank.value;
+        this.items.set(id, { id, rev: 1, fields, markdown: item.html !== true, links: [] });
+        return id;
+    }
+    // Links `child` under `parent`, last among its children.
+    addChild(parent, child) {
+        this.link(parent, CHILD, child);
+        this.link(child, PARENT, parent);
+    }
+    // Links `successor` after `predecessor`: the predecessor blocks it.
+    precede(predecessor, successor) {
+        this.link(predecessor, SUCCESSOR, successor);
+        this.link(successor, PREDECESSOR, predecessor);
+    }
+    say(id, author, text, { html = false } = {}) {
+        this.get(id);
+        const list = this.discussion.get(id) ?? [];
+        list.push({
+            id: list.length + 1,
+            text: html ? text : storedMarkdown(text),
+            markdown: !html,
+            author: this.who(author),
+            createdDate: this.tick()
+        });
+        this.discussion.set(id, list);
+    }
+    // The tags on a work item, as Azure DevOps lists them.
+    tagsOf(id) {
+        return tagList(this.get(id).fields['System.Tags']);
+    }
+    // Makes a Git repo in the project, on Azure Repos.
+    repository(name) {
+        const id = guid(5000 + this.repositories.size + 1);
+        this.repositories.set(name.toLowerCase(), { id, name });
+    }
+    // A pull request as the fake keeps it.
+    pullRequestAt(id) {
+        const found = this.pulls.find((p) => p.pullRequestId === id);
+        if (found === undefined)
+            throw fault(`no pull request ${String(id)}`);
+        return found;
+    }
+    // The work items linked to a pull request, by id.
+    linkedWorkItems(pullId) {
+        const link = this.artifactOf(this.pullRequestAt(pullId));
+        return [...this.artifacts.entries()]
+            .filter(([, links]) => links.some((l) => l.toLowerCase() === link.toLowerCase()))
+            .map(([id]) => id)
+            .sort((a, b) => a - b);
+    }
+    // The next call whose address `match` finds answers `status` and changes nothing.
+    failNext(match, status) {
+        this.faults.push({ match, status });
+    }
+    // A sign-in whose token this fake takes.
+    signIn() {
+        return {
+            authorization: () => Promise.resolve(TOKEN),
+            via: () => Promise.resolve('the fake sign-in'),
+            refresh: () => Promise.resolve()
+        };
+    }
+    request = (url, call) => {
+        const body = call.body === undefined ? undefined : JSON.parse(call.body);
+        if (STATE.test(url) || STATE.test(call.body ?? '')) {
+            throw fault(`Nightjar never reads or sets a work item's state (docs/adr/0002): ${url}`);
+        }
+        this.asked.push({ method: call.method, url, body });
+        if (call.headers.Authorization !== TOKEN)
+            return Promise.resolve(json(401));
+        const scripted = this.faults.find((f) => f.match.test(url));
+        if (scripted !== undefined) {
+            this.faults.splice(this.faults.indexOf(scripted), 1);
+            return Promise.resolve(refusal(scripted.status, 'the fake Azure DevOps: a scripted fault'));
+        }
+        return Promise.resolve(this.answer(new URL(url), call, body));
+    };
+    answer(url, call, body) {
+        const org = `/${encodeURIComponent(this.organization)}`;
+        const project = `${org}/${encodeURIComponent(this.project)}`;
+        const path = url.pathname;
+        const route = `${call.method} ${url.host}`;
+        if (route === 'GET vssps.dev.azure.com' && path === `${org}/_apis/identities`) {
+            return this.identities(url.searchParams);
+        }
+        if (url.host !== 'dev.azure.com')
+            throw fault(`no host ${url.host}`);
+        if (call.method === 'GET' && path === `${org}/_apis/connectionData`) {
+            const me = this.who(this.person);
+            return json(200, {
+                authenticatedUser: {
+                    id: me.id,
+                    providerDisplayName: me.uniqueName,
+                    properties: { Account: { $type: 'System.String', $value: me.uniqueName } }
+                }
+            });
+        }
+        if (call.method === 'POST' && path === `${project}/_apis/wit/wiql`) {
+            this.query(url, { 'api-version': API });
+            return this.wiql(body);
+        }
+        if (call.method === 'GET' && path === `${org}/_apis/wit/workitems`) {
+            return this.batch(url.searchParams);
+        }
+        const made = new RegExp(`^${project}/_apis/wit/workitems/(?:\\$|%24)(.+)$`).exec(path);
+        if (call.method === 'POST' && made) {
+            this.query(url, { 'api-version': API });
+            if (call.headers['Content-Type'] !== 'application/json-patch+json') {
+                throw fault('a work item is made with application/json-patch+json');
+            }
+            return this.create(decodeURIComponent(made[1] ?? ''), body);
+        }
+        const one = new RegExp(`^${project}/_apis/wit/workitems/(\\d+)$`).exec(path);
+        if (call.method === 'PATCH' && one) {
+            this.query(url, { 'api-version': API });
+            if (call.headers['Content-Type'] !== 'application/json-patch+json') {
+                throw fault('a work item is patched with application/json-patch+json');
+            }
+            return this.patch(Number(one[1]), body);
+        }
+        const thread = new RegExp(`^${project}/_apis/wit/workItems/(\\d+)/comments$`).exec(path);
+        if (thread) {
+            const id = Number(thread[1]);
+            if (!this.items.has(id))
+                return refusal(404, `TF401232: Work item ${String(id)} does not exist.`);
+            if (call.method === 'GET')
+                return this.comments(id, url.searchParams);
+            if (call.method === 'POST')
+                return this.addComment(id, url.searchParams, body);
+        }
+        const repos = this.reposAnswer(url, call, body, project);
+        if (repos !== null)
+            return repos;
+        const linking = new RegExp(`^${org}/_apis/wit/workitems/(\\d+)$`, 'i').exec(path);
+        if (call.method === 'PATCH' && linking) {
+            this.query(url, { 'api-version': API });
+            if (call.headers['Content-Type'] !== 'application/json-patch+json') {
+                throw fault('a work item is patched with application/json-patch+json');
+            }
+            return this.linkArtifact(Number(linking[1]), body);
+        }
+        throw fault(`no route answers ${call.method} ${url.href}`);
+    }
+    // Azure Repos: a repo, its pull requests, their threads and linked work items. Null for another route.
+    reposAnswer(url, call, body, project) {
+        const shape = new RegExp(`^${project}/_apis/git/repositories/([^/]+)(?:/(pullrequests)(?:/(\\d+)(?:/(workitems|threads))?)?)?$`, 'i').exec(url.pathname);
+        if (!shape)
+            return null;
+        this.query(url, { 'api-version': API }, [
+            'searchCriteria.sourceRefName',
+            'searchCriteria.status'
+        ]);
+        const repo = this.repositories.get(decodeURIComponent(shape[1] ?? '').toLowerCase());
+        if (repo === undefined) {
+            return refusal(404, `TF401019: The Git repository with name or identifier ${shape[1] ?? ''} does not exist.`);
+        }
+        const [, , pulls, idText, part] = shape;
+        if (pulls === undefined) {
+            if (call.method !== 'GET')
+                throw fault(`${call.method} on a repo`);
+            return json(200, this.renderRepository(repo));
+        }
+        if (idText === undefined) {
+            if (call.method === 'GET')
+                return this.listPulls(repo, url.searchParams);
+            if (call.method === 'POST')
+                return this.createPull(repo, body);
+            throw fault(`${call.method} on the pull requests`);
+        }
+        const pull = this.pulls.find((p) => p.pullRequestId === Number(idText) && p.repository === repo.id);
+        if (pull === undefined) {
+            return refusal(404, `TF401180: The requested pull request was not found.`);
+        }
+        if (part === undefined) {
+            if (call.method === 'GET')
+                return json(200, this.renderPull(pull));
+            if (call.method === 'PATCH')
+                return this.updatePull(pull, body);
+        }
+        else if (part.toLowerCase() === 'workitems' && call.method === 'GET') {
+            const value = this.linkedWorkItems(pull.pullRequestId).map((id) => ({
+                id: String(id),
+                url: this.itemUrl(id)
+            }));
+            return json(200, { count: value.length, value });
+        }
+        else if (part.toLowerCase() === 'threads' && call.method === 'POST') {
+            const content = body?.comments?.[0]
+                ?.content;
+            if (typeof content !== 'string')
+                throw fault('a thread carries { comments: [{ content }] }');
+            this.replacePull({ ...pull, comments: [...pull.comments, content] });
+            return json(200, { id: pull.comments.length + 1, comments: [{ id: 1, content }] });
+        }
+        throw fault(`no route answers ${call.method} ${url.href}`);
+    }
+    listPulls(repo, search) {
+        const source = search.get('searchCriteria.sourceRefName');
+        const status = search.get('searchCriteria.status') ?? 'active';
+        if (status !== 'active')
+            throw fault(`searchCriteria.status=${status}`);
+        const value = this.pulls
+            .filter((p) => p.repository === repo.id && (source === null || p.sourceRefName === source))
+            .map((p) => this.renderPull(p));
+        return json(200, { count: value.length, value });
+    }
+    createPull(repo, body) {
+        const got = (body ?? {});
+        const { sourceRefName, targetRefName, title, description, isDraft } = got;
+        for (const name of Object.keys(got)) {
+            if (!['sourceRefName', 'targetRefName', 'title', 'description', 'isDraft'].includes(name))
+                throw fault(`a new pull request Nightjar may not send with ${name}`);
+        }
+        if (typeof sourceRefName !== 'string' || typeof targetRefName !== 'string')
+            throw fault('a pull request names its sourceRefName and targetRefName');
+        if (typeof title !== 'string' || typeof description !== 'string')
+            throw fault('a pull request carries a title and a description');
+        if (description.length > DESCRIPTION_LIMIT) {
+            return refusal(400, 'The pull request description is too long; it must be 4000 characters or less.');
+        }
+        if (this.pulls.some((p) => p.repository === repo.id &&
+            p.sourceRefName === sourceRefName &&
+            p.targetRefName === targetRefName)) {
+            return refusal(409, 'TF401179: An active pull request for the source and target branch already exists.');
+        }
+        const made = {
+            pullRequestId: 100 + this.pulls.length + 1,
+            repository: repo.id,
+            sourceRefName,
+            targetRefName,
+            title,
+            description,
+            isDraft: isDraft === true,
+            status: 'active',
+            comments: []
+        };
+        this.pulls.push(made);
+        return json(201, this.renderPull(made));
+    }
+    // Only the title and description are Nightjar's to change: a pull request is never completed, abandoned or published.
+    updatePull(pull, body) {
+        const got = (body ?? {});
+        for (const name of Object.keys(got)) {
+            if (!['title', 'description'].includes(name))
+                throw fault(`a pull request update Nightjar may not send: ${name}`);
+        }
+        const { description, title } = got;
+        if (typeof description === 'string' && description.length > DESCRIPTION_LIMIT) {
+            return refusal(400, 'The pull request description is too long; it must be 4000 characters or less.');
+        }
+        const changed = {
+            ...pull,
+            ...(typeof description === 'string' ? { description } : {}),
+            ...(typeof title === 'string' ? { title } : {})
+        };
+        this.replacePull(changed);
+        return json(200, this.renderPull(changed));
+    }
+    // Only a link to a pull request is Nightjar's to add this way: any other patch is a fault.
+    linkArtifact(id, body) {
+        const item = this.items.get(id);
+        if (item === undefined)
+            return refusal(404, `TF401232: Work item ${String(id)} does not exist.`);
+        if (!Array.isArray(body))
+            throw fault('a patch is a list of operations');
+        const links = [...(this.artifacts.get(id) ?? [])];
+        for (const op of body) {
+            const value = op.value;
+            const url = value?.url;
+            if (op.op !== 'add' ||
+                op.path !== '/relations/-' ||
+                value?.rel !== 'ArtifactLink' ||
+                typeof url !== 'string' ||
+                !url.startsWith('vstfs:///Git/PullRequestId/')) {
+                throw fault(`a patch Nightjar may not send: ${JSON.stringify(op)}`);
+            }
+            if (links.some((l) => l.toLowerCase() === url.toLowerCase())) {
+                return refusal(400, `TF201036: You cannot add a link of this type: the link already exists.`);
+            }
+            links.push(url);
+        }
+        this.artifacts.set(id, links);
+        const changed = { ...item, rev: item.rev + 1 };
+        this.items.set(id, changed);
+        return json(200, this.render(changed, undefined, false));
+    }
+    replacePull(pull) {
+        const at = this.pulls.findIndex((p) => p.pullRequestId === pull.pullRequestId);
+        this.pulls[at] = pull;
+    }
+    artifactOf(pull) {
+        return `vstfs:///Git/PullRequestId/${PROJECT_ID}%2F${pull.repository}%2F${String(pull.pullRequestId)}`;
+    }
+    renderRepository(repo) {
+        const web = `https://dev.azure.com/${encodeURIComponent(this.organization)}/${encodeURIComponent(this.project)}/_git/${encodeURIComponent(repo.name)}`;
+        return {
+            id: repo.id,
+            name: repo.name,
+            project: { id: PROJECT_ID, name: this.project },
+            remoteUrl: web,
+            webUrl: web
+        };
+    }
+    renderPull(pull) {
+        const repo = [...this.repositories.values()].find((r) => r.id === pull.repository);
+        if (repo === undefined)
+            throw fault('a pull request without its repo');
+        return {
+            pullRequestId: pull.pullRequestId,
+            repository: this.renderRepository(repo),
+            status: pull.status,
+            title: pull.title,
+            description: pull.description,
+            sourceRefName: pull.sourceRefName,
+            targetRefName: pull.targetRefName,
+            isDraft: pull.isDraft,
+            artifactId: this.artifactOf(pull),
+            url: `https://dev.azure.com/${encodeURIComponent(this.organization)}/_apis/git/repositories/${repo.id}/pullRequests/${String(pull.pullRequestId)}`
+        };
+    }
+    // The query a call carries must be exactly `wanted`, besides the `optional` names.
+    query(url, wanted, optional = []) {
+        for (const [name, value] of Object.entries(wanted)) {
+            if (url.searchParams.get(name) !== value)
+                throw fault(`${url.href} needs ${name}=${value}`);
+        }
+        for (const name of url.searchParams.keys()) {
+            if (!(name in wanted) && !optional.includes(name))
+                throw fault(`${url.href} takes no ${name}`);
+        }
+    }
+    // The clauses Nightjar writes, joined by AND; any other WIQL is a fault, not an empty answer.
+    wiql(body) {
+        const query = body?.query;
+        if (typeof query !== 'string')
+            throw fault('a WIQL call carries { query }');
+        const shape = /^SELECT \[System\.Id\] FROM WorkItems WHERE (.+) ORDER BY \[System\.Id\]$/s.exec(query.trim());
+        if (!shape)
+            throw fault(`WIQL of a shape not known: ${query}`);
+        const clause = /\s*(?:AND\s+)?\[([\w.]+)\]\s+(=|CONTAINS)\s+('(?:[^']|'')*'|@project|@Me)\s*/y;
+        const tests = [];
+        const where = shape[1] ?? '';
+        while (clause.lastIndex < where.length) {
+            const at = clause.lastIndex;
+            const found = clause.exec(where);
+            if (!found)
+                throw fault(`WIQL clause not known at "${where.slice(at)}"`);
+            tests.push(this.clause(found[1] ?? '', found[2] ?? '', found[3] ?? ''));
+        }
+        const ids = [...this.items.values()].filter((i) => tests.every((t) => t(i))).map((i) => i.id);
+        return json(200, {
+            queryType: 'flat',
+            workItems: ids.sort((a, b) => a - b).map((id) => ({ id, url: this.itemUrl(id) }))
+        });
+    }
+    clause(field, op, raw) {
+        if (raw === '@project') {
+            if (field !== 'System.TeamProject' || op !== '=')
+                throw fault(`@project with ${field}`);
+            return () => true;
+        }
+        if (raw === '@Me') {
+            if (field !== 'System.AssignedTo' || op !== '=')
+                throw fault(`@Me with ${field}`);
+            return this.clause(field, op, `'${this.person.replace(/'/g, "''")}'`);
+        }
+        const value = raw.slice(1, -1).replace(/''/g, "'").toLowerCase();
+        const text = (item) => {
+            const got = item.fields[field];
+            const shown = typeof got === 'object' && got !== null ? got.uniqueName : got;
+            return typeof shown === 'string' ? shown.toLowerCase() : '';
+        };
+        if (op === 'CONTAINS' && field === 'System.Tags') {
+            return (item) => tagList(item.fields['System.Tags']).some((t) => t.toLowerCase() === value);
+        }
+        if (op === '=' && ['System.WorkItemType', 'System.AssignedTo'].includes(field)) {
+            return (item) => text(item) === value;
+        }
+        throw fault(`WIQL clause not known: [${field}] ${op} ${raw}`);
+    }
+    // Azure DevOps refuses $expand beside a field list; errorPolicy=omit puts a null for an id it cannot show.
+    batch(search) {
+        const url = new URL(`https://dev.azure.com/?${search.toString()}`);
+        this.query(url, { 'api-version': API }, ['ids', '$expand', 'fields', 'errorPolicy']);
+        const expand = search.get('$expand');
+        const fields = search.get('fields')?.split(',');
+        if (expand !== null && fields !== undefined) {
+            return refusal(400, 'VS403062: The expand parameter can not be used with the fields parameter.');
+        }
+        if (expand !== null && expand !== 'relations')
+            throw fault(`$expand=${expand}`);
+        const omit = search.get('errorPolicy');
+        if (omit !== null && omit !== 'omit')
+            throw fault(`errorPolicy=${omit}`);
+        const ids = (search.get('ids') ?? '')
+            .split(',')
+            .filter((s) => s !== '')
+            .map(Number);
+        if (ids.length === 0 || ids.length > 200)
+            throw fault(`ids takes 1 to 200 ids, not ${String(ids.length)}`);
+        const value = [];
+        for (const id of ids) {
+            const item = this.items.get(id);
+            if (item === undefined && omit === null) {
+                return refusal(404, `TF401232: Work item ${String(id)} does not exist, or you do not have permissions to read it.`);
+            }
+            value.push(item === undefined ? null : this.render(item, fields, expand !== null));
+        }
+        return json(200, { count: value.length, value });
+    }
+    // Only the tags are Nightjar's to write: any other patch is a fault.
+    patch(id, body) {
+        const item = this.items.get(id);
+        if (item === undefined)
+            return refusal(404, `TF401232: Work item ${String(id)} does not exist.`);
+        if (!Array.isArray(body))
+            throw fault('a patch is a list of operations');
+        const fields = { ...item.fields };
+        for (const op of body) {
+            const dependency = op.op === 'add' && op.path === '/relations/-' ? relation(op.value) : null;
+            if (dependency?.rel === PREDECESSOR) {
+                const blocker = this.items.get(dependency.id);
+                if (blocker === undefined) {
+                    return refusal(404, `TF401232: Work item ${String(dependency.id)} does not exist.`);
+                }
+                this.precede(blocker.id, id);
+                continue;
+            }
+            if ((op.op === 'add' || op.op === 'replace') && op.path === '/fields/System.Tags') {
+                const tags = [];
+                for (const tag of tagList(op.value)) {
+                    if (!tags.some((t) => t.toLowerCase() === tag.toLowerCase()))
+                        tags.push(tag);
+                }
+                if (tags.length === 0)
+                    delete fields['System.Tags'];
+                else
+                    fields['System.Tags'] = tags.join('; ');
+            }
+            else {
+                throw fault(`a patch Nightjar may not send: ${JSON.stringify(op)}`);
+            }
+        }
+        const changed = { ...this.get(id), rev: item.rev + 1, fields };
+        this.items.set(id, changed);
+        return json(200, this.render(changed, undefined, false));
+    }
+    // A work item made with fields and a parent link, as Nightjar makes a Feature or Ticket; any other field is a fault.
+    create(type, body) {
+        if (!Array.isArray(body))
+            throw fault('a work item is made from a list of operations');
+        let title;
+        let description;
+        let markdown = false;
+        let parent;
+        for (const op of body) {
+            if (op.op !== 'add')
+                throw fault(`a work item is made with add, not ${JSON.stringify(op)}`);
+            const value = op.value;
+            if (op.path === '/fields/System.Title' && typeof value === 'string')
+                title = value;
+            else if (op.path === '/fields/System.Description' && typeof value === 'string') {
+                description = value;
+            }
+            else if (op.path === '/multilineFieldsFormat/System.Description') {
+                markdown = typeof value === 'string' && value.toLowerCase() === 'markdown';
+            }
+            else if (op.path === '/relations/-' && relation(value)?.rel === PARENT) {
+                parent = relation(value)?.id;
+                if (parent === undefined || !this.items.has(parent)) {
+                    return refusal(404, `TF401232: Work item ${String(parent)} does not exist.`);
+                }
+            }
+            else
+                throw fault(`a field Nightjar may not make: ${JSON.stringify(op)}`);
+        }
+        if (title === undefined || title.trim() === '') {
+            return refusal(400, 'TF401320: Rule Error for field Title. Error code: Required.');
+        }
+        const id = this.workItem({
+            type,
+            title,
+            ...(description === undefined ? {} : { description, html: !markdown })
+        });
+        if (parent !== undefined)
+            this.addChild(parent, id);
+        return json(200, this.render(this.get(id), undefined, true));
+    }
+    // Azure DevOps answers newest first unless asked otherwise, a page at a time.
+    comments(id, search) {
+        const url = new URL(`https://dev.azure.com/?${search.toString()}`);
+        this.query(url, { 'api-version': COMMENTS_API }, ['$top', 'order', 'continuationToken']);
+        const all = [...(this.discussion.get(id) ?? [])];
+        if (search.get('order') !== 'asc')
+            all.reverse();
+        const top = Number(search.get('$top') ?? '200');
+        const from = Number(search.get('continuationToken') ?? '0');
+        const page = all.slice(from, from + top);
+        return json(200, {
+            totalCount: all.length,
+            count: page.length,
+            comments: page.map((c) => this.renderComment(id, c)),
+            ...(from + top < all.length ? { continuationToken: String(from + top) } : {})
+        });
+    }
+    addComment(id, search, body) {
+        const url = new URL(`https://dev.azure.com/?${search.toString()}`);
+        this.query(url, { 'api-version': COMMENTS_API }, ['format']);
+        const text = body?.text;
+        if (typeof text !== 'string')
+            throw fault('a comment carries { text }');
+        const html = search.get('format') !== 'markdown';
+        this.say(id, this.person, text, { html });
+        const list = this.discussion.get(id) ?? [];
+        const made = list[list.length - 1];
+        if (made === undefined)
+            throw fault('the comment was not kept');
+        return json(200, this.renderComment(id, made));
+    }
+    // Two reads of the identity host: the project's Contributors group by name, and a person by id with every group above them.
+    identities(search) {
+        const url = new URL(`https://vssps.dev.azure.com/?${search.toString()}`);
+        const contributors = `[${this.project}]\\Contributors`;
+        if (search.has('searchFilter')) {
+            this.query(url, {
+                'api-version': API,
+                searchFilter: 'General',
+                filterValue: contributors,
+                queryMembership: 'None'
+            });
+            return json(200, {
+                count: 1,
+                value: [
+                    {
+                        id: guid(9001),
+                        descriptor: CONTRIBUTORS,
+                        providerDisplayName: contributors,
+                        isContainer: true
+                    }
+                ]
+            });
+        }
+        this.query(url, { 'api-version': API, identityIds: search.get('identityIds') ?? '' }, [
+            'queryMembership'
+        ]);
+        const ids = (search.get('identityIds') ?? '').split(',');
+        const expanded = search.get('queryMembership') === 'ExpandedUp';
+        const value = ids.map((id) => {
+            const person = [...this.people.values()].find((p) => p.id === id);
+            if (person === undefined)
+                return null;
+            // a person reaches Contributors through their team's group, so only an expanded read shows it
+            const groups = person.contributor ? [TEAM, ...(expanded ? [CONTRIBUTORS] : [])] : [READERS];
+            return {
+                id: person.id,
+                descriptor: `Microsoft.IdentityModel.Claims.ClaimsIdentity;contoso\\${person.uniqueName}`,
+                providerDisplayName: person.uniqueName,
+                isContainer: false,
+                memberOf: groups
+            };
+        });
+        return json(200, { count: value.length, value });
+    }
+    render(item, fields, relations) {
+        const shown = fields
+            ? Object.fromEntries(Object.entries(item.fields).filter(([name]) => fields.includes(name)))
+            : item.fields;
+        return {
+            id: item.id,
+            rev: item.rev,
+            fields: shown,
+            ...(item.markdown && 'System.Description' in shown
+                ? { multilineFieldsFormat: { 'System.Description': 'markdown' } }
+                : {}),
+            ...(relations && item.links.length > 0
+                ? {
+                    relations: item.links.map((l) => ({
+                        rel: l.rel,
+                        url: this.itemUrl(l.id),
+                        attributes: { isLocked: false, name: l.rel === CHILD ? 'Child' : 'Other' }
+                    }))
+                }
+                : {}),
+            url: this.itemUrl(item.id)
+        };
+    }
+    renderComment(workItemId, c) {
+        const by = {
+            id: c.author.id,
+            displayName: c.author.uniqueName,
+            uniqueName: c.author.uniqueName
+        };
+        return {
+            workItemId,
+            id: c.id,
+            version: 1,
+            text: c.text,
+            format: c.markdown ? 'markdown' : 'html',
+            createdBy: by,
+            createdDate: c.createdDate,
+            modifiedBy: by,
+            modifiedDate: c.createdDate,
+            isDeleted: false
+        };
+    }
+    identity(uniqueName) {
+        const p = this.who(uniqueName);
+        return { displayName: p.uniqueName, uniqueName: p.uniqueName, id: p.id };
+    }
+    // A person the organization knows; one it does not yet is added without Contributors.
+    who(uniqueName) {
+        const found = this.people.get(uniqueName.toLowerCase());
+        if (found)
+            return found;
+        this.join(uniqueName, { contributor: false });
+        return this.who(uniqueName);
+    }
+    link(from, rel, to) {
+        const item = this.get(from);
+        this.get(to);
+        this.items.set(from, { ...item, links: [...item.links, { rel, id: to }] });
+    }
+    itemUrl(id) {
+        return `https://dev.azure.com/${encodeURIComponent(this.organization)}/_apis/wit/workItems/${String(id)}`;
+    }
+    get(id) {
+        const item = this.items.get(id);
+        if (item === undefined)
+            throw fault(`no work item ${String(id)}`);
+        return item;
+    }
+    tick() {
+        this.clock += 60_000;
+        return new Date(this.clock).toISOString();
+    }
+}
+const CONTRIBUTORS = 'Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1-contributors';
+const TEAM = 'Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2-team';
+const READERS = 'Microsoft.TeamFoundation.Identity;S-1-9-1551374245-3-readers';
+const PROJECT_ID = guid(4000);
+// the most characters Azure Repos keeps in a pull request's description
+const DESCRIPTION_LIMIT = 4000;
+function tagList(value) {
+    if (typeof value !== 'string')
+        return [];
+    return value
+        .split(';')
+        .map((t) => t.trim())
+        .filter((t) => t !== '');
+}
+// The link a patch adds: its type and the id its address names.
+function relation(value) {
+    const link = value;
+    if (typeof link?.rel !== 'string' || typeof link.url !== 'string')
+        return null;
+    const id = /\/workItems\/(\d+)$/i.exec(link.url)?.[1];
+    return id === undefined ? null : { rel: link.rel, id: Number(id) };
+}
+//# sourceMappingURL=fake-azure-devops.js.map