@bitvea/feedback-cli 1.1.0 → 1.2.0

package/dist/dev/server.d.ts

@@ -0,0 +1,35 @@
+/** The only address this receiver ever binds. */
+export declare const DEV_HOST = "127.0.0.1";
+/**
+ * The port the toolbar posts to when nothing says otherwise. Copy of
+ * `DEFAULT_LOOPBACK_PORT` in `packages/toolbar/src/gating.ts`.
+ */
+export declare const DEV_DEFAULT_PORT = 4477;
+export declare const ANNOTATIONS_PATH = "/v1/annotations";
+export interface DevReceiverOptions {
+    /** The repository root; files go under `<root>/.bitvea/feedback`. */
+    root: string;
+    /** The port to listen on. 0 picks a free one, which is what tests use. */
+    port?: number;
+    /** Origins beyond this machine's that may send, already normalised. */
+    allowOrigins?: Iterable<string>;
+    /** The body limit in bytes. Defaults to the contract's. */
+    maxBytes?: number;
+    /** Where one line per event goes. Defaults to silence. */
+    log?: (line: string) => void;
+    /** Where refusals go. Defaults to silence. */
+    warn?: (line: string) => void;
+}
+export interface DevReceiver {
+    /** `http://127.0.0.1:<port>`. */
+    origin: string;
+    /** The collection URL, which is the toolbar's sink URL. */
+    sinkUrl: string;
+    port: number;
+    /** The absolute directory annotations are written to. */
+    dir: string;
+    close(): Promise<void>;
+}
+/** Start the receiver. Resolves once it is listening. */
+export declare function startDevReceiver(options: DevReceiverOptions): Promise<DevReceiver>;
+//# sourceMappingURL=server.d.ts.map

package/dist/dev/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dev/server.ts"],"names":[],"mappings":"AAgDA,iDAAiD;AACjD,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAsED,yDAAyD;AACzD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CA8KtB"}

package/dist/dev/server.js

@@ -0,0 +1,270 @@
+// The `dev` receiver: the loopback sink the toolbar's local mode POSTs to.
+//
+// Three routes and nothing else:
+//
+//   POST /v1/annotations           store one annotation (the toolbar's send)
+//   GET  /v1/annotations?url=<p>   list what is stored, for one page or all
+//   GET  /v1/annotations/<id>.png  one stored screenshot
+//
+// plus `GET /v1/health`, which answers `{"v":1}` so a script can wait for the
+// port without guessing.
+//
+// What it promises, stated because "local" is a promise rather than a
+// description of where the server happens to run:
+//
+//   - It binds 127.0.0.1 and never anything wider. A receiver on 0.0.0.0 is a
+//     feedback endpoint for everybody on the same coffee-shop network.
+//   - It sends nothing anywhere. No telemetry, no update check, no request of
+//     its own at all: the only sockets it touches are the ones it accepts.
+//   - It answers only pages on this machine and origins the developer named,
+//     and addressed by a loopback name (see ./origins.ts for why both).
+//   - It never reads more body than `LOCAL_ANNOTATION_MAX_BYTES`, and it
+//     refuses a POST that is not `application/json`, which is what forces a
+//     browser to ask permission (a CORS preflight) before it can send one.
+//   - No cookie is read, none is set, and `Access-Control-Allow-Credentials`
+//     is never sent: the toolbar sends with `credentials: "omit"` and this
+//     receiver would not know what to do with an identity anyway.
+import { createServer, } from "node:http";
+import { LOCAL_ANNOTATION_MAX_BYTES, LOCAL_ANNOTATION_VERSION, replaceControlCharacters, validateAnnotation, } from "./contract.js";
+import { isAllowedOrigin, isLoopbackHostHeader } from "./origins.js";
+import { AnnotationExistsError, AnnotationFileError, createAnnotationStore, } from "./store.js";
+/** The only address this receiver ever binds. */
+export const DEV_HOST = "127.0.0.1";
+/**
+ * The port the toolbar posts to when nothing says otherwise. Copy of
+ * `DEFAULT_LOOPBACK_PORT` in `packages/toolbar/src/gating.ts`.
+ */
+export const DEV_DEFAULT_PORT = 4477;
+export const ANNOTATIONS_PATH = "/v1/annotations";
+const PNG_PATH = /^\/v1\/annotations\/([A-Za-z0-9_-]{1,64})\.png$/;
+class HttpRefusal extends Error {
+    status;
+    code;
+    issues;
+    constructor(status, code, issues) {
+        super(code);
+        this.status = status;
+        this.code = code;
+        this.issues = issues;
+    }
+}
+function sendJson(res, status, body) {
+    const bytes = Buffer.from(JSON.stringify(body));
+    res.writeHead(status, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": bytes.length,
+        "cache-control": "no-store",
+        "x-content-type-options": "nosniff",
+    });
+    res.end(bytes);
+}
+/**
+ * The body, as text, or a refusal once it passes `maxBytes`.
+ *
+ * `Content-Length` is checked first so an honest oversized request is refused
+ * without reading it; the running count is what holds a chunked one to the
+ * same line.
+ */
+function readBody(req, maxBytes) {
+    const declared = Number(req.headers["content-length"] ?? Number.NaN);
+    if (Number.isFinite(declared) && declared > maxBytes) {
+        return Promise.reject(new HttpRefusal(413, "payload_too_large"));
+    }
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let refused = false;
+        req.on("data", (chunk) => {
+            if (refused)
+                return;
+            size += chunk.length;
+            if (size > maxBytes) {
+                refused = true;
+                chunks.length = 0;
+                reject(new HttpRefusal(413, "payload_too_large"));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => {
+            if (!refused)
+                resolve(Buffer.concat(chunks).toString("utf8"));
+        });
+        req.on("error", (err) => {
+            if (!refused)
+                reject(err);
+        });
+    });
+}
+function preview(text) {
+    // Control characters out before anything else: this line goes to the
+    // developer's terminal, and an ESC in somebody's text is an escape sequence
+    // there. `text` is the one field the contract lets keep them, because it is
+    // prose and may legitimately hold line breaks and tabs.
+    const line = replaceControlCharacters(text, " ")
+        .trim()
+        .replace(/\s+/g, " ");
+    return line.length > 60 ? `${line.slice(0, 59)}...` : line;
+}
+/** Start the receiver. Resolves once it is listening. */
+export async function startDevReceiver(options) {
+    const store = createAnnotationStore(options.root);
+    const allow = new Set(options.allowOrigins ?? []);
+    const maxBytes = options.maxBytes ?? LOCAL_ANNOTATION_MAX_BYTES;
+    const log = options.log ?? (() => { });
+    const warn = options.warn ?? (() => { });
+    // One line per refused origin rather than one per request: a page that
+    // retries would otherwise bury the terminal.
+    const warnedOrigins = new Set();
+    const handle = async (req, res) => {
+        if (!isLoopbackHostHeader(req.headers.host)) {
+            throw new HttpRefusal(421, "host_not_loopback");
+        }
+        const origin = req.headers.origin;
+        if (origin !== undefined) {
+            if (!isAllowedOrigin(origin, allow)) {
+                if (!warnedOrigins.has(origin)) {
+                    warnedOrigins.add(origin);
+                    warn(`refused a request from ${origin}: not this machine and not named ` +
+                        "with --allow-origin.");
+                }
+                throw new HttpRefusal(403, "origin_not_allowed");
+            }
+            // Set before anything else can answer, so a 413 or a 400 reaches the
+            // page as a status it can read rather than as an opaque network error.
+            res.setHeader("access-control-allow-origin", origin);
+            res.setHeader("vary", "Origin");
+        }
+        const url = new URL(req.url ?? "/", "http://127.0.0.1");
+        const method = req.method ?? "GET";
+        if (method === "OPTIONS") {
+            if (origin === undefined)
+                throw new HttpRefusal(400, "not_a_preflight");
+            res.setHeader("access-control-allow-methods", "GET, POST");
+            res.setHeader("access-control-allow-headers", "content-type");
+            res.setHeader("access-control-max-age", "600");
+            // Chrome's Private Network Access asks this of a loopback target; the
+            // origin has already been checked, so the answer can be yes.
+            if (req.headers["access-control-request-private-network"] === "true") {
+                res.setHeader("access-control-allow-private-network", "true");
+            }
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (url.pathname === "/v1/health") {
+            if (method !== "GET")
+                throw new HttpRefusal(405, "method_not_allowed");
+            sendJson(res, 200, { v: LOCAL_ANNOTATION_VERSION });
+            return;
+        }
+        if (url.pathname === ANNOTATIONS_PATH) {
+            if (method === "POST") {
+                const type = req.headers["content-type"] ?? "";
+                if (!/^application\/json\s*(;|$)/i.test(type)) {
+                    throw new HttpRefusal(415, "content_type_not_json");
+                }
+                const text = await readBody(req, maxBytes);
+                let body;
+                try {
+                    body = JSON.parse(text);
+                }
+                catch {
+                    throw new HttpRefusal(400, "invalid_json");
+                }
+                const issues = validateAnnotation(body);
+                if (issues.length > 0) {
+                    throw new HttpRefusal(400, "validation_failed", issues);
+                }
+                const annotation = body;
+                let saved;
+                try {
+                    saved = store.save(annotation);
+                }
+                catch (err) {
+                    if (err instanceof AnnotationFileError) {
+                        throw new HttpRefusal(400, "validation_failed", [err.message]);
+                    }
+                    if (err instanceof AnnotationExistsError) {
+                        throw new HttpRefusal(409, "annotation_exists");
+                    }
+                    throw err;
+                }
+                log(`+ ${annotation.kind} "${preview(annotation.text)}" on ${annotation.url}` +
+                    ` -> ${saved.jsonPath}`);
+                sendJson(res, 201, { v: LOCAL_ANNOTATION_VERSION, id: annotation.id });
+                return;
+            }
+            if (method === "GET") {
+                const page = url.searchParams.get("url");
+                const annotations = store
+                    .list()
+                    .filter((a) => page === null || a.url === page)
+                    .map((a) => ({
+                    ...a,
+                    screenshot: a.screenshot === null ? null : `${ANNOTATIONS_PATH}/${a.id}.png`,
+                }));
+                sendJson(res, 200, { v: LOCAL_ANNOTATION_VERSION, annotations });
+                return;
+            }
+            throw new HttpRefusal(405, "method_not_allowed");
+        }
+        const png = PNG_PATH.exec(url.pathname);
+        if (png?.[1]) {
+            if (method !== "GET")
+                throw new HttpRefusal(405, "method_not_allowed");
+            const bytes = store.png(png[1]);
+            if (bytes === null)
+                throw new HttpRefusal(404, "not_found");
+            res.writeHead(200, {
+                "content-type": "image/png",
+                "content-length": bytes.length,
+                "cache-control": "no-store",
+                "x-content-type-options": "nosniff",
+            });
+            res.end(bytes);
+            return;
+        }
+        throw new HttpRefusal(404, "not_found");
+    };
+    const server = createServer((req, res) => {
+        handle(req, res).catch((err) => {
+            if (res.headersSent) {
+                res.destroy();
+                return;
+            }
+            if (err instanceof HttpRefusal) {
+                if (err.status === 413) {
+                    // The rest of an oversized body is not worth reading; close the
+                    // connection once the answer is out rather than drain it.
+                    res.setHeader("connection", "close");
+                    res.on("finish", () => req.destroy());
+                }
+                sendJson(res, err.status, err.issues ? { error: err.code, issues: err.issues } : { error: err.code });
+                return;
+            }
+            warn(`internal error: ${err instanceof Error ? err.message : String(err)}`);
+            sendJson(res, 500, { error: "internal_error" });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(options.port ?? DEV_DEFAULT_PORT, DEV_HOST, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    const { port } = server.address();
+    const origin = `http://${DEV_HOST}:${port}`;
+    return {
+        origin,
+        sinkUrl: `${origin}${ANNOTATIONS_PATH}`,
+        port,
+        dir: store.dir,
+        close: () => new Promise((resolve, reject) => {
+            server.close((err) => (err ? reject(err) : resolve()));
+            server.closeAllConnections();
+        }),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/dev/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dev/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,iCAAiC;AACjC,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,yDAAyD;AACzD,EAAE;AACF,8EAA8E;AAC9E,yBAAyB;AACzB,EAAE;AACF,sEAAsE;AACtE,kDAAkD;AAClD,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAC9E,2EAA2E;AAC3E,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,kEAAkE;AAClE,OAAO,EACL,YAAY,GAIb,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,GAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAElD,MAAM,QAAQ,GAAG,iDAAiD,CAAC;AA4BnE,MAAM,WAAY,SAAQ,KAAK;IAElB;IACA;IACA;IAHX,YACW,MAAc,EACd,IAAY,EACZ,MAAiB;QAE1B,KAAK,CAAC,IAAI,CAAC,CAAC;QAJH,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAW;IAG5B,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,IAAa;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,iCAAiC;QACjD,gBAAgB,EAAE,KAAK,CAAC,MAAM;QAC9B,eAAe,EAAE,UAAU;QAC3B,wBAAwB,EAAE,SAAS;KACpC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAAoB,EAAE,QAAgB;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,QAAQ,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC/B,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;YACrB,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClB,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC,OAAO;gBAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACtB,IAAI,CAAC,OAAO;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,qEAAqE;IACrE,4EAA4E;IAC5E,4EAA4E;IAC5E,wDAAwD;IACxD,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC;SAC7C,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA2B;IAE3B,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,0BAA0B,CAAC;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,uEAAuE;IACvE,6CAA6C;IAC7C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,MAAM,MAAM,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;QACjE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/B,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC1B,IAAI,CACF,0BAA0B,MAAM,mCAAmC;wBACjE,sBAAsB,CACzB,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;YACnD,CAAC;YACD,qEAAqE;YACrE,uEAAuE;YACvE,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;YACrD,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;QAEnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YACxE,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,WAAW,CAAC,CAAC;YAC3D,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,cAAc,CAAC,CAAC;YAC9D,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAC/C,sEAAsE;YACtE,6DAA6D;YAC7D,IAAI,GAAG,CAAC,OAAO,CAAC,wCAAwC,CAAC,KAAK,MAAM,EAAE,CAAC;gBACrE,GAAG,CAAC,SAAS,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAC;YAChE,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAClC,IAAI,MAAM,KAAK,KAAK;gBAAE,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;YACvE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,wBAAwB,EAAE,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACtC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBAC/C,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9C,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC3C,IAAI,IAAa,CAAC;gBAClB,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;gBAC7C,CAAC;gBACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM,UAAU,GAAG,IAAuB,CAAC;gBAC3C,IAAI,KAAK,CAAC;gBACV,IAAI,CAAC;oBACH,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;wBACvC,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,mBAAmB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;oBACjE,CAAC;oBACD,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;wBACzC,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;oBAClD,CAAC;oBACD,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,GAAG,CACD,KAAK,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,UAAU,CAAC,GAAG,EAAE;oBACvE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAC1B,CAAC;gBACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,wBAAwB,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;YACD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACzC,MAAM,WAAW,GAAG,KAAK;qBACtB,IAAI,EAAE;qBACN,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;qBAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACX,GAAG,CAAC;oBACJ,UAAU,EACR,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,gBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM;iBACnE,CAAC,CAAC,CAAC;gBACN,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,wBAAwB,EAAE,WAAW,EAAE,CAAC,CAAC;gBACjE,OAAO;YACT,CAAC;YACD,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,IAAI,MAAM,KAAK,KAAK;gBAAE,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC5D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;gBACjB,cAAc,EAAE,WAAW;gBAC3B,gBAAgB,EAAE,KAAK,CAAC,MAAM;gBAC9B,eAAe,EAAE,UAAU;gBAC3B,wBAAwB,EAAE,SAAS;aACpC,CAAC,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,MAAM,GAAW,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;gBAC/B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACvB,gEAAgE;oBAChE,0DAA0D;oBAC1D,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACrC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxC,CAAC;gBACD,QAAQ,CACN,GAAG,EACH,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAC3E,CAAC;gBACF,OAAO;YACT,CAAC;YACD,IAAI,CAAC,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5E,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,gBAAgB,EAAE,QAAQ,EAAE,GAAG,EAAE;YAC7D,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,EAAiB,CAAC;IACjD,MAAM,MAAM,GAAG,UAAU,QAAQ,IAAI,IAAI,EAAE,CAAC;IAC5C,OAAO;QACL,MAAM;QACN,OAAO,EAAE,GAAG,MAAM,GAAG,gBAAgB,EAAE;QACvC,IAAI;QACJ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC/B,CAAC,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/dev/store.d.ts

@@ -0,0 +1,43 @@
+import { type LocalAnnotation } from "./contract.js";
+/** Where the files go, under the repository root. */
+export declare const FEEDBACK_DIR: string;
+export declare const INBOX_FILE = "inbox.md";
+export declare class AnnotationFileError extends Error {
+}
+/**
+ * An id that is already on disk.
+ *
+ * An annotation is written ONCE. The toolbar mints a fresh id for every send,
+ * its retry after a 413 included, so nothing it does ever re-sends one; and a
+ * receiver that replaced by id would let any other page on this machine's
+ * loopback overwrite a colleague's annotation, or delete its screenshot by
+ * re-sending the id without one.
+ */
+export declare class AnnotationExistsError extends Error {
+}
+export interface AnnotationStore {
+    /** The absolute directory the files are in. */
+    dir: string;
+    /** Store one validated annotation. Re-sending an id replaces it. */
+    save(annotation: LocalAnnotation): {
+        jsonPath: string;
+        pngPath: string | null;
+    };
+    /**
+     * Every stored annotation, oldest first, with `screenshot` set to the PNG's
+     * file name (or null). A file that no longer validates is skipped rather
+     * than failing the list, because a person may have edited it by hand.
+     */
+    list(): LocalAnnotation[];
+    /** The bytes of `<id>.png`, or null when there is none. */
+    png(id: string): Buffer | null;
+}
+export declare function createAnnotationStore(root: string): AnnotationStore;
+/**
+ * The inbox: every annotation, newest first, as a person or an agent reads it.
+ *
+ * Exported for the tests. Deterministic in its input, so regenerating it after
+ * a write that changed nothing produces the same bytes.
+ */
+export declare function renderInbox(annotations: LocalAnnotation[]): string;
+//# sourceMappingURL=store.d.ts.map

package/dist/dev/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/dev/store.ts"],"names":[],"mappings":"AA0BA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAEpB,qDAAqD;AACrD,eAAO,MAAM,YAAY,QAA8B,CAAC;AAExD,eAAO,MAAM,UAAU,aAAa,CAAC;AAarC,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;CAAG;AASnD,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAChF;;;;OAIG;IACH,IAAI,IAAI,eAAe,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAwEnE;AAoDD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,CA2ClE"}

package/dist/dev/store.js

@@ -0,0 +1,215 @@
+// The files: `.bitvea/feedback/<id>.json`, a sibling `<id>.png`, and a
+// regenerated `inbox.md`.
+//
+// THE FILES ARE THE CONTRACT, and the HTTP receiver is only the way a browser
+// reaches them. Every coding agent can already read a file, so "read
+// `.bitvea/feedback/inbox.md`" is a complete integration with no MCP server,
+// no port and no configuration - which is why the files are shaped for a
+// reader rather than for this process. The JSON is the annotation exactly as
+// the toolbar sent it, with the screenshot swapped for the sibling file's
+// name; the inbox is the same facts, newest first, as prose.
+//
+// Nothing is ever read back from `inbox.md`. It is rewritten from the JSON
+// files after every write, so a hand edit to it is overwritten and a hand edit
+// to a JSON file is what the next inbox says.
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { ANNOTATION_ID_PATTERN, decodePngDataUrl, replaceControlCharacters, validateAnnotation, } from "./contract.js";
+/** Where the files go, under the repository root. */
+export const FEEDBACK_DIR = join(".bitvea", "feedback");
+export const INBOX_FILE = "inbox.md";
+/**
+ * Written once, the first time the directory is created, and never again.
+ *
+ * `*` ignores the directory's whole contents, itself included, so a screenshot
+ * of somebody's staging data cannot end up in a commit by default - a leak
+ * that would outlive the annotation. It is only ever created, never
+ * overwritten: a developer who deletes it to commit their annotations has
+ * made a decision this process must not undo.
+ */
+const GITIGNORE = "# Written by `npx @bitvea/feedback-toolbar dev`.\n*\n";
+export class AnnotationFileError extends Error {
+}
+/**
+ * An id that is already on disk.
+ *
+ * An annotation is written ONCE. The toolbar mints a fresh id for every send,
+ * its retry after a 413 included, so nothing it does ever re-sends one; and a
+ * receiver that replaced by id would let any other page on this machine's
+ * loopback overwrite a colleague's annotation, or delete its screenshot by
+ * re-sending the id without one.
+ */
+export class AnnotationExistsError extends Error {
+}
+/** Write through a temp file and a rename, so a reader never sees half. */
+function writeAtomically(path, contents) {
+    const temp = `${path}.${randomUUID()}.tmp`;
+    writeFileSync(temp, contents);
+    renameSync(temp, path);
+}
+export function createAnnotationStore(root) {
+    const dir = join(root, FEEDBACK_DIR);
+    const ensureDir = () => {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const gitignore = join(dir, ".gitignore");
+        if (!existsSync(gitignore))
+            writeFileSync(gitignore, GITIGNORE, "utf8");
+    };
+    const list = () => {
+        if (!existsSync(dir))
+            return [];
+        const rows = [];
+        for (const name of readdirSync(dir)) {
+            if (!name.endsWith(".json"))
+                continue;
+            const id = name.slice(0, -".json".length);
+            if (!ANNOTATION_ID_PATTERN.test(id))
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(readFileSync(join(dir, name), "utf8"));
+            }
+            catch {
+                continue;
+            }
+            const row = storedAnnotation(parsed, id);
+            if (row)
+                rows.push(row);
+        }
+        return rows.sort((a, b) => a.timestamp.localeCompare(b.timestamp) || a.id.localeCompare(b.id));
+    };
+    const writeInbox = () => {
+        writeAtomically(join(dir, INBOX_FILE), renderInbox(list()));
+    };
+    return {
+        dir,
+        save(annotation) {
+            ensureDir();
+            const jsonPath = join(dir, `${annotation.id}.json`);
+            if (existsSync(jsonPath)) {
+                throw new AnnotationExistsError(`${annotation.id} is already stored`);
+            }
+            const pngPath = join(dir, `${annotation.id}.png`);
+            let screenshot = null;
+            if (annotation.screenshot !== null) {
+                const bytes = decodePngDataUrl(annotation.screenshot);
+                if (bytes === null) {
+                    throw new AnnotationFileError("screenshot: the data URL is not a PNG");
+                }
+                writeAtomically(pngPath, bytes);
+                screenshot = `${annotation.id}.png`;
+            }
+            else {
+                // A picture with no JSON beside it is left over from a write that
+                // died between the two files; it describes nothing this annotation
+                // says it has.
+                rmSync(pngPath, { force: true });
+            }
+            writeAtomically(jsonPath, `${JSON.stringify({ ...annotation, screenshot }, null, 2)}\n`);
+            writeInbox();
+            return { jsonPath, pngPath: screenshot === null ? null : pngPath };
+        },
+        list,
+        png(id) {
+            if (!ANNOTATION_ID_PATTERN.test(id))
+                return null;
+            const path = join(dir, `${id}.png`);
+            return existsSync(path) ? readFileSync(path) : null;
+        },
+    };
+}
+/**
+ * A stored JSON file as an annotation, or null when it is not one.
+ *
+ * On disk `screenshot` is the sibling file's name; the rest is the incoming
+ * contract, so it is checked by the same validator with the picture set aside.
+ */
+function storedAnnotation(value, id) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return null;
+    }
+    const record = value;
+    if (record["id"] !== id)
+        return null;
+    const screenshot = record["screenshot"];
+    if (screenshot !== null && screenshot !== `${id}.png`)
+        return null;
+    if (validateAnnotation({ ...record, screenshot: null }).length > 0) {
+        return null;
+    }
+    return record;
+}
+/** A code span that survives whatever backticks the value itself holds. */
+function code(value) {
+    const longest = Math.max(0, ...(value.match(/`+/g) ?? []).map((m) => m.length));
+    const fence = "`".repeat(longest + 1);
+    const pad = value.startsWith("`") || value.endsWith("`") ? " " : "";
+    return `${fence}${pad}${value}${pad}${fence}`;
+}
+/**
+ * Every line ending CommonMark recognises, a lone `\r` included. Splitting on
+ * `\r?\n` alone left a bare carriage return inside a quoted line, where a
+ * markdown reader ends the line and the `>` with it - so the text of an
+ * annotation could step out of its quote and write the inbox's own structure.
+ */
+const LINE_ENDING = /\r\n|\r|\n/;
+/** The control characters left once the text is split into lines, tab kept. */
+function withoutControl(line) {
+    return replaceControlCharacters(line, "", "\t");
+}
+/** The first line of the text, short enough for a heading. */
+function headline(text) {
+    const first = withoutControl(text.trim().split(LINE_ENDING, 1)[0] ?? "");
+    const short = first.length > 80 ? `${first.slice(0, 79)}...` : first;
+    // A heading is one line of prose; markup characters at its start would make
+    // it something else.
+    return short.replace(/^[#>*\-+\d.\s]+/, "") || "(no text)";
+}
+/**
+ * The inbox: every annotation, newest first, as a person or an agent reads it.
+ *
+ * Exported for the tests. Deterministic in its input, so regenerating it after
+ * a write that changed nothing produces the same bytes.
+ */
+export function renderInbox(annotations) {
+    const newestFirst = [...annotations].reverse();
+    const lines = [
+        "# BitVea feedback inbox",
+        "",
+        "Written by `npx @bitvea/feedback-toolbar dev` from the JSON files in this directory.",
+        "It is regenerated after every annotation, so edits made here are overwritten.",
+        "Each entry names its JSON file, which holds the same facts in full.",
+        "",
+        newestFirst.length === 1
+            ? "1 annotation, newest first."
+            : `${newestFirst.length} annotations, newest first.`,
+    ];
+    newestFirst.forEach((a, index) => {
+        lines.push("", `## ${index + 1}. ${headline(a.text)}`, "");
+        for (const raw of a.text.trim().split(LINE_ENDING)) {
+            const line = withoutControl(raw);
+            lines.push(line.length > 0 ? `> ${line}` : ">");
+        }
+        lines.push("");
+        lines.push(`- Page: ${a.url}`);
+        lines.push(a.selector === null
+            ? "- Element: none, this is a note about the whole page"
+            : `- Element: ${code(a.selector)}`);
+        if (a.component) {
+            const chain = a.component.owners.length > 1
+                ? ` (rendered by ${a.component.owners.slice(1).map(code).join(" < ")})`
+                : "";
+            lines.push(`- Component: ${code(a.component.name)}${chain}`);
+        }
+        lines.push(`- Filed: ${a.timestamp}`);
+        lines.push(`- Viewport: ${a.viewport.width} x ${a.viewport.height} at ${a.viewport.devicePixelRatio}x`);
+        if (a.screenshot !== null) {
+            lines.push(`- Screenshot: [${a.screenshot}](${a.screenshot})`);
+        }
+        lines.push(`- File: [${a.id}.json](${a.id}.json)`);
+    });
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=store.js.map

package/dist/dev/store.js.map

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

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AA4CA,MAAM,WAAW,UAAU;IACzB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAoQD,wBAAsB,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAoBjB"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AA8CA,MAAM,WAAW,UAAU;IACzB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAgRD,wBAAsB,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}