@plune-ai/cli 0.16.0 → 0.17.1

package/dist/reporter-core.js

@@ -2,6 +2,7 @@
 import { createHash, randomUUID } from "crypto";
 import { promises as disk } from "fs";
 import { basename as basename2, extname } from "path";
+import { TextDecoder } from "util";
 
 // src/cli/api-url.ts
 var DEFAULT_API_URL = "https://beta-api.plune.ai";
@@ -30,6 +31,8 @@ function loadToken() {
 }
 
 // src/reporter-core/client.ts
+import { createReadStream, openAsBlob } from "fs";
+import { pipeline } from "stream";
 import { request as httpRequest } from "http";
 import { request as httpsRequest } from "https";
 var RETRY_DELAYS_MS = [300, 900];
@@ -63,13 +66,49 @@ function nodeTransport(url, init, idleMs = IDLE_MS) {
     req.end(init.body);
   });
 }
+var PUT_DELAYS_MS = [500, 1500, 4e3];
+var withoutLength = (headers) => Object.fromEntries(Object.entries(headers).filter(([name]) => name.toLowerCase() !== "content-length"));
+function nodePut(url, headers, source, idleMs) {
+  return new Promise((resolve2, reject) => {
+    const target = new URL(url);
+    const send = target.protocol === "https:" ? httpsRequest : httpRequest;
+    const length = "body" in source ? source.body.length : source.size;
+    let answered;
+    const settle = (err) => answered !== void 0 ? resolve2(answered) : reject(err);
+    const req = send(
+      target,
+      { method: "PUT", headers: { ...withoutLength(headers), "content-length": String(length) } },
+      (res) => {
+        const retry = res.headers["retry-after"];
+        answered = { status: res.statusCode ?? 0, retryAfter: Array.isArray(retry) ? retry[0] ?? null : retry ?? null };
+        res.on("error", settle);
+        res.on("close", () => {
+          resolve2(answered);
+          req.destroy();
+        });
+        res.resume();
+      }
+    );
+    req.setTimeout(idleMs, () => req.destroy(Object.assign(new Error("idle"), { code: "ETIMEDOUT" })));
+    req.on("error", settle);
+    if ("body" in source) req.end(source.body);
+    else pipeline(createReadStream(source.path), req, (err) => err ? settle(err) : void 0);
+  });
+}
+var codeOfError = (err) => {
+  const code = err?.code;
+  return typeof code === "string" && /^[A-Z0-9_]{2,40}$/.test(code) ? code : "network";
+};
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 async function detailOf(res) {
   try {
     const body = await res.json();
-    return typeof body.error === "string" ? body.error : "";
+    return {
+      detail: typeof body.error === "string" ? body.error : "",
+      ...typeof body.code === "string" && /^[a-z0-9_]{1,60}$/.test(body.code) ? { code: body.code } : {}
+    };
   } catch {
-    return "";
+    return { detail: "" };
   }
 }
 function retryAfterMs(res) {
@@ -120,10 +159,16 @@ function createClient(opts) {
           return { ok: false, kind: "other", status: res.status, detail: "the answer was not JSON" };
         }
       }
-      const detail = scrub(await detailOf(res));
+      const said = await detailOf(res);
       const kind = classify(res.status);
-      last = { kind, status: res.status, detail };
+      last = { kind, status: res.status, detail: scrub(said.detail), ...said.code !== void 0 ? { code: said.code } : {} };
       if (kind !== "unavailable") break;
+      if (res.status === 429 && retryAfterMs(res) === null) {
+        last.kind = "invalid";
+        last.detail = "quota exceeded (no Retry-After)";
+        if (said.detail) last.detail += ` \u2014 ${said.detail}`;
+        break;
+      }
       if (attempt < RETRY_DELAYS_MS.length) {
         await wait(retryAfterMs(res) ?? RETRY_DELAYS_MS[attempt]);
       }
@@ -133,7 +178,36 @@ function createClient(opts) {
   return {
     post: (path3, body) => send("POST", path3, { body: JSON.stringify(body), type: "application/json" }),
     upload: (path3, bytes, contentType) => send("POST", path3, { body: bytes, type: contentType }),
-    del: (path3) => send("DELETE", path3)
+    del: (path3) => send("DELETE", path3),
+    async put(url, headers, source) {
+      let last = { ok: false, status: null, code: "network" };
+      for (let attempt = 0; attempt <= PUT_DELAYS_MS.length; attempt += 1) {
+        try {
+          let status;
+          let retryAfter;
+          if (opts.fetchImpl === void 0) ({ status, retryAfter } = await nodePut(url, headers, source, IDLE_MS));
+          else {
+            const body = "body" in source ? source.body : await openAsBlob(source.path);
+            const res = await opts.fetchImpl(url, { method: "PUT", headers: withoutLength(headers), body });
+            await res.arrayBuffer().catch(() => void 0);
+            status = res.status;
+            retryAfter = res.headers.get("retry-after");
+          }
+          if (status >= 200 && status <= 299) return { ok: true };
+          last = { ok: false, status, code: `bucket_${status}` };
+          if (status < 500 && status !== 429) return last;
+          const seconds = retryAfter === null ? NaN : Number(retryAfter.trim());
+          if (attempt < PUT_DELAYS_MS.length) {
+            await wait(Number.isFinite(seconds) && seconds >= 0 ? Math.min(seconds, 60) * 1e3 : PUT_DELAYS_MS[attempt]);
+          }
+          continue;
+        } catch (err) {
+          last = { ok: false, status: null, code: codeOfError(err) };
+        }
+        if (attempt < PUT_DELAYS_MS.length) await wait(PUT_DELAYS_MS[attempt]);
+      }
+      return last;
+    }
   };
 }
 
@@ -222,6 +296,138 @@ function ciCommit(reported, env = process.env) {
   };
 }
 
+// src/reporter-core/failure-detail.ts
+import { existsSync as existsSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join2, posix, resolve } from "path";
+import { stripVTControlCharacters } from "util";
+function failureOf(attempt, home = homedir2()) {
+  const error = chosen(attempt);
+  const line = error === void 0 ? void 0 : firstLine(machineless(error.text, attempt.repoRoot, home));
+  const headline = line !== void 0 && jsonBytes(line) <= HEADLINE_LIMIT ? line : void 0;
+  const steps = chainOf(attempt.steps);
+  const location = error === void 0 ? void 0 : fromRoot(placeOf(error, attempt.testFile), attempt.repoRoot);
+  const artifacts = attempt.attachments.filter((a) => a.path !== void 0 && !a.name.startsWith("_") && a.contentType !== METADATA_TYPE).map(({ name, contentType }) => ({ name: fileNameOf(name), ...contentType ? { contentType } : {} })).filter((a) => a.name !== "");
+  const ciUrl = webLink(attempt.buildHref);
+  const failure = {
+    ...headline !== void 0 ? { headline } : {},
+    ...steps.length > 0 ? { steps } : {},
+    ...location !== void 0 ? { location } : {},
+    ...artifacts.length > 0 ? { artifacts } : {},
+    ...ciUrl !== void 0 ? { ciUrl } : {}
+  };
+  return Object.keys(failure).length === 0 ? void 0 : failure;
+}
+function repoRootOf(dir, stopAt) {
+  for (let here = resolve(dir); ; here = dirname2(here)) {
+    if (existsSync2(join2(here, ".git"))) return here;
+    if (here === stopAt || dirname2(here) === here) return void 0;
+  }
+}
+function errorContextOf(attempt, home = homedir2()) {
+  const text = attempt.errors.map((e) => e.text).filter((t) => t !== "").join("\n\n");
+  return cut(machineless(text, attempt.repoRoot, home));
+}
+var printable = (text) => text.replace(/[\u0000-\u001f\u007f-\u009f]/g, "?");
+var mediaTypeOf = (contentType) => contentType?.split(";")[0]?.trim().toLowerCase() || void 0;
+var TEXT_TYPES = /* @__PURE__ */ new Set(["application/json", "text/plain"]);
+var isTextType = (contentType) => TEXT_TYPES.has(mediaTypeOf(contentType) ?? "");
+function filesOf(attempt) {
+  return attempt.attachments.filter((a) => a.path !== void 0 || a.body !== void 0 && isTextType(a.contentType));
+}
+function machineless(raw, repoRoot, home) {
+  let text = stripVTControlCharacters(raw).replaceAll("\x1B", "");
+  const root = repoRoot === void 0 ? void 0 : pathIn(repoRoot);
+  if (root !== void 0) text = text.replace(new RegExp(`${PATH_START}${root.source}[\\\\/]+`, root.flags), "");
+  const own = pathIn(home);
+  if (own !== void 0) text = text.replace(new RegExp(`${PATH_START}${own.source}(?![\\w.-])`, own.flags), "~");
+  if (repoRoot === void 0) text = text.replace(ANY_HOME, "~");
+  return text;
+}
+var PATH_START = "(?<![\\w.~%/\\\\-])";
+var TEXT_LIMIT = 524288;
+var HEADLINE_LIMIT = 8 * 1024;
+var jsonBytes = (text) => Buffer.byteLength(JSON.stringify(text)) - 2;
+var ANY_HOME = /(?<=^|[\s'"`(=,[])(?:(?:file|webpack|webpack-internal):(?:\\*\/){2,3})?(?:\\*\/home\\*\/|\\*\/Users\\*\/|[A-Za-z]:[\\/]+Users[\\/]+)[^\\/\s'"`:*?<>|]+/g;
+function pathIn(path3) {
+  const parts = path3.split(/[\\/]+/);
+  while (parts.length > 1 && parts.at(-1) === "") parts.pop();
+  if (!parts.some((part) => part !== "" && !/^[A-Za-z]:$/.test(part))) return void 0;
+  const joined = parts.map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[\\\\/]+");
+  const escaped = /^\/(?!\/)/.test(path3) ? joined.replace("[\\\\/]+", "\\\\*\\/") : joined;
+  const url = "(?:(?:file|webpack|webpack-internal):(?:\\\\*\\/){2,3})?";
+  return new RegExp(`${url}${escaped}`, /^[A-Za-z]:$/.test(parts[0]) ? "gi" : "g");
+}
+var fileNameOf = (name) => /^(?:file:\/\/|[\\/]|~[\\/]|[A-Za-z]:[\\/])/.test(name) ? name.split(/[\\/]/).pop() ?? "" : name;
+function cut(text) {
+  if (jsonBytes(text) <= TEXT_LIMIT) return text;
+  const lines = text.split("\n");
+  const size = lines.map((line) => jsonBytes(line) + 2);
+  const budget = TEXT_LIMIT - jsonBytes(omitted(lines.length));
+  let used = 0;
+  let head = 0;
+  let tail = lines.length;
+  while (head < tail && used + size[head] <= budget / 2) used += size[head++];
+  while (tail > head && used + size[tail - 1] <= budget) used += size[--tail];
+  return [...lines.slice(0, head), omitted(tail - head), ...lines.slice(tail)].join("\n");
+}
+var omitted = (lines) => `\u2026[omitted ${lines} lines]\u2026`;
+var METADATA_TYPE = "application/plune.metadata+json";
+var REPO_RELATIVE = /^(?![A-Za-z][A-Za-z0-9+.-]*:)(?![\\/~])(?!(?:.*[\\/])?\.\.(?:[\\/]|$)).+$/;
+var FRAME = /^\s+at (?:.*? \()?(.+?):(\d+):(\d+)\)?$/;
+var FRAME_MAX = 8192;
+var firstLine = (text) => stripVTControlCharacters(text).split("\n").map((line) => line.trim()).find((line) => line !== "");
+function chosen({ status, errors }) {
+  if (status === "timedOut") {
+    const timeout = errors.findIndex((e) => firstLine(e.text)?.startsWith("Test timeout of ") === true);
+    if (timeout !== -1 && timeout + 1 < errors.length) return errors[timeout + 1];
+  }
+  return errors[0];
+}
+function chainOf(steps) {
+  const chain = [];
+  for (let failed = steps.find((s) => s.failed); failed !== void 0; failed = failed.steps.find((s) => s.failed)) {
+    chain.push(failed.title);
+  }
+  return chain;
+}
+function placeOf(error, testFile) {
+  const own = normal(testFile);
+  let first;
+  for (const line of stripVTControlCharacters(error.text).split("\n")) {
+    if (line.length > FRAME_MAX) continue;
+    const frame = FRAME.exec(line);
+    if (frame === null) continue;
+    const place = { file: fileOf(frame[1]), line: Number(frame[2]), column: Number(frame[3]) };
+    if (normal(place.file) === own) return place;
+    if (first === void 0 && !normal(place.file).includes("/node_modules/")) first = place;
+  }
+  return error.location ?? first;
+}
+function fileOf(raw) {
+  if (!raw.startsWith("file://")) return raw;
+  let path3 = raw.slice("file://".length);
+  try {
+    path3 = decodeURIComponent(path3);
+  } catch {
+  }
+  return /^\/[A-Za-z]:\//.test(path3) ? path3.slice(1) : path3;
+}
+var normal = (path3) => posix.normalize(path3.replace(/\\/g, "/")).replace(/^([a-z]):/, (_, drive) => `${drive.toUpperCase()}:`);
+function fromRoot(place, root) {
+  if (place === void 0 || root === void 0 || !Number.isInteger(place.line) || place.line < 1) return void 0;
+  const base = normal(root).replace(/\/+$/, "");
+  const file = normal(place.file);
+  if (!file.startsWith(`${base}/`)) return void 0;
+  const relative = file.slice(base.length + 1);
+  if (!REPO_RELATIVE.test(relative)) return void 0;
+  const column = place.column !== void 0 && Number.isInteger(place.column) && place.column >= 1 ? place.column : void 0;
+  return column === void 0 ? { file: relative, line: place.line } : { file: relative, line: place.line, column };
+}
+function webLink(href) {
+  return href !== void 0 && /^https?:\/\//i.test(href) && URL.canParse(href) ? href : void 0;
+}
+
 // src/reporter-core/fallback.ts
 import * as fs from "fs";
 import * as path2 from "path";
@@ -252,17 +458,21 @@ var COUNTED = ["accepted", "duplicate", "conflict", "rejected"];
 var SCREENSHOT_TYPES = /* @__PURE__ */ new Set(["image/png", "image/jpeg", "image/webp"]);
 var SCREENSHOT_BYTES = 2 * 1024 * 1024;
 var SCREENSHOTS_PER_RESULT = 20;
+var TEXT_BYTES = 512 * 1024;
+var TEXTS_PER_RESULT = 10;
+var UTF8 = new TextDecoder("utf-8", { fatal: true });
 var TYPE_BY_EXTENSION = {
   ".png": "image/png",
   ".jpg": "image/jpeg",
   ".jpeg": "image/jpeg",
   ".webp": "image/webp"
 };
+var METADATA_TYPE2 = "application/plune.metadata+json";
 var UPLOADS_AT_ONCE = 4;
 var NAME_MAX = 200;
 function nameOf(file) {
-  const own = file.name.split(/[\\/]/).pop()?.trim() || basename2(file.path);
-  const fileExt = extname(file.path);
+  const own = file.name.split(/[\\/]/).pop()?.trim() || (file.path === void 0 ? "" : basename2(file.path));
+  const fileExt = file.path === void 0 ? "" : extname(file.path);
   const ownExt = extname(own);
   const typed = ownExt !== "" && (ownExt.toLowerCase() === fileExt.toLowerCase() || TYPE_BY_EXTENSION[ownExt.toLowerCase()] !== void 0);
   const ext = typed ? ownExt : fileExt;
@@ -278,8 +488,57 @@ var SKIPPED = {
   type: "Plune takes PNG, JPEG and WebP",
   limit: `a result holds at most ${SCREENSHOTS_PER_RESULT}`,
   missing: "the file cannot be read on this machine",
-  size: "Plune takes a file of at most 2 MB"
+  size: "Plune takes a file of at most 2 MB",
+  textLimit: `a result holds at most ${TEXTS_PER_RESULT} text files`,
+  textSize: "Plune takes a text file of at most 512 KiB",
+  empty: "the file is empty",
+  binary: "the file holds a NUL byte, and Plune takes UTF-8 text without one",
+  encoding: "Plune takes UTF-8 text only",
+  noStorage: "no storage bucket is connected to this project"
+};
+var BUCKET_FOUND = "plune: storage bucket found for this project \u2014 screenshots, text, trace and video go straight to it over short-lived links.";
+var KINDS = {
+  screenshot: { label: "screenshot", bytes: SCREENSHOT_BYTES, room: SCREENSHOTS_PER_RESULT, limit: "limit", size: "size" },
+  text: { label: "text file", bytes: TEXT_BYTES, room: TEXTS_PER_RESULT, limit: "textLimit", size: "textSize" },
+  // Only the label is used: a file of this kind has no home in the database, so no ceiling of its own is known here.
+  file: { label: "file", bytes: 0, room: 0, limit: "limit", size: "size" }
 };
+function kindOf(type) {
+  if (type.startsWith("image/")) return "screenshot";
+  return TEXT_TYPES.has(type) ? "text" : "file";
+}
+var codeOf = (out) => out.code ?? (out.status === null ? "network" : `http_${out.status}`);
+function linkOf(item) {
+  const link = item;
+  if (typeof link?.id !== "string" || typeof link.url !== "string") return void 0;
+  const headers = typeof link.headers === "object" && link.headers !== null ? link.headers : {};
+  return { id: link.id, url: link.url, headers };
+}
+function textTypeOf(contentType, type) {
+  const charset = /;\s*charset\s*=\s*"?([^\s";]+)"?/i.exec(contentType)?.[1];
+  return charset?.toLowerCase() === "utf-8" ? `${type}; charset=utf-8` : type;
+}
+function textRefusal(bytes) {
+  if (bytes.length > TEXT_BYTES) return "textSize";
+  if (bytes.length === 0) return "empty";
+  if (bytes.includes(0)) return "binary";
+  try {
+    UTF8.decode(bytes);
+  } catch {
+    return "encoding";
+  }
+  return void 0;
+}
+function onDisk(result) {
+  if (!("files" in result) || result.files === void 0) return result;
+  const { files, ...rest } = result;
+  const kept = files.filter((f) => f.path !== void 0).map(({ body: _body, ...file }) => file);
+  return kept.length === 0 ? rest : { ...rest, files: kept };
+}
+function tally(counts, noun) {
+  if (counts.uploaded + counts.skipped + counts.failed === 0) return void 0;
+  return `${counts.uploaded} ${noun}(s) uploaded` + (counts.skipped > 0 ? `, ${counts.skipped} skipped` : "") + (counts.failed > 0 ? `, ${counts.failed} failed to upload` : "");
+}
 function boundKey(key) {
   if (key.value.length <= KEY_MAX) return key;
   const digest = createHash("sha256").update(key.value).digest("hex").slice(0, 16);
@@ -355,7 +614,9 @@ async function startRun(passed, declared) {
     created: 0,
     unoffered: 0,
     deferred: 0,
-    screenshots: { uploaded: 0, skipped: 0, failed: 0 }
+    screenshots: { uploaded: 0, skipped: 0, failed: 0 },
+    textFiles: { uploaded: 0, skipped: 0, failed: 0 },
+    otherFiles: { uploaded: 0, skipped: 0, failed: 0 }
   };
   const resolved = /* @__PURE__ */ new Map();
   let buffer = [];
@@ -366,6 +627,13 @@ async function startRun(passed, declared) {
   let done = false;
   const shortened = /* @__PURE__ */ new Set();
   const skipsSaid = /* @__PURE__ */ new Set();
+  const countsOf = (kind) => kind === "text" ? stats.textFiles : kind === "file" ? stats.otherFiles : stats.screenshots;
+  let bucketSeen = false;
+  let noStorage = 0;
+  let uploadsMissing = false;
+  const failedSaid = /* @__PURE__ */ new Set();
+  const codesSaid = /* @__PURE__ */ new Set();
+  const rooms = /* @__PURE__ */ new Map();
   function bound(keys) {
     return keys.map((key) => {
       const fit = boundKey(key);
@@ -373,7 +641,7 @@ async function startRun(passed, declared) {
         shortened.add(key.value);
         if (shortened.size === 1) {
           log(
-            `plune: a test name longer than ${KEY_MAX} characters was shortened to fit its key \u2014 "${key.value.slice(0, 80)}\u2026". Give the test a shorter name; until then this is its identity.`
+            `plune: a test name longer than ${KEY_MAX} characters was shortened to fit its key \u2014 ${JSON.stringify(printable(key.value.slice(0, 80)))}\u2026 Give the test a shorter name; until then this is its identity.`
           );
         }
       }
@@ -393,7 +661,7 @@ async function startRun(passed, declared) {
       externalKey,
       session: sessionMarker,
       ...cfg.meta !== void 0 ? { meta: cfg.meta } : {},
-      results
+      results: results.map(onDisk)
     });
     stats.deferred += results.length;
   }
@@ -501,57 +769,173 @@ async function startRun(passed, declared) {
       stats.created += out.body.results.filter((r) => r?.outcome === "created").length;
     }
   }
-  function skip(name, why) {
-    stats.screenshots.skipped += 1;
-    if (skipsSaid.has(why)) return;
-    skipsSaid.add(why);
-    log(`plune: screenshot "${name}" not uploaded \u2014 ${SKIPPED[why]}.`);
+  function skip(kind, name, why) {
+    countsOf(kind).skipped += 1;
+    if (why === "noStorage") noStorage += 1;
+    const said = why === "noStorage" ? why : `${kind}/${why}`;
+    if (skipsSaid.has(said)) return;
+    skipsSaid.add(said);
+    if (why === "noStorage") log(`plune: "${name}" not stored \u2014 ${SKIPPED[why]}.`);
+    else log(`plune: ${KINDS[kind].label} "${name}" not uploaded \u2014 ${SKIPPED[why]}.`);
   }
-  async function uploadOne(shot) {
+  function ask(job, size) {
+    return client.post(`/v1/results/${encodeURIComponent(job.id)}/files/uploads`, {
+      files: [{ name: job.name, contentType: job.type, size }]
+    });
+  }
+  function failed(job, why) {
+    countsOf(job.kind).failed += 1;
+    if (!failedSaid.has(job.kind)) {
+      failedSaid.add(job.kind);
+      log(`plune: could not upload a ${KINDS[job.kind].label} (${why}) \u2014 its result is reported without it.`);
+    }
+  }
+  function failedToBucket(job, code) {
+    countsOf(job.kind).failed += 1;
+    if (codesSaid.has(code)) return;
+    codesSaid.add(code);
+    log(`plune: "${job.name}" not uploaded to your bucket (${code}) \u2014 its result is reported without it.`);
+  }
+  function refusedHere(job, size) {
+    if (job.kind === "screenshot") {
+      if (!SCREENSHOT_TYPES.has(job.type)) return "type";
+      if (size > SCREENSHOT_BYTES) return "size";
+    }
+    if (job.kind === "text" && size > TEXT_BYTES) return "textSize";
+    return void 0;
+  }
+  async function uploadDirect(job, size) {
+    const { kind } = job;
+    if (kind === "file") return skip(kind, job.name, "noStorage");
+    const { bytes: ceiling, size: tooBig } = KINDS[kind];
+    if (size > ceiling) return skip(kind, job.name, tooBig);
     let bytes;
-    try {
-      if ((await disk.stat(shot.path)).size > SCREENSHOT_BYTES) return skip(shot.name, "size");
-      bytes = await disk.readFile(shot.path);
-    } catch {
-      return skip(shot.name, "missing");
+    if (job.body !== void 0) bytes = job.body;
+    else {
+      try {
+        bytes = await disk.readFile(job.path);
+      } catch {
+        return skip(kind, job.name, "missing");
+      }
     }
+    const refusal = kind === "text" ? textRefusal(bytes) : void 0;
+    if (refusal !== void 0) return skip(kind, job.name, refusal);
     const out = await client.upload(
-      `/v1/results/${encodeURIComponent(shot.id)}/files?name=${encodeURIComponent(shot.name)}`,
+      `/v1/results/${encodeURIComponent(job.id)}/files?name=${encodeURIComponent(job.name)}`,
       bytes,
-      shot.type
+      job.type
     );
-    if (out.ok) {
-      stats.screenshots.uploaded += 1;
-      return;
+    if (out.ok) countsOf(kind).uploaded += 1;
+    else failed(job, out.detail || out.kind);
+  }
+  async function uploadToBucket(job, size, first) {
+    const source = job.body !== void 0 ? { body: job.body } : { path: job.path, size };
+    let link = first;
+    for (let renewed = false; ; ) {
+      const put = await client.put(link.url, link.headers, source);
+      if (put.ok) break;
+      if (put.status !== 403 || renewed) return failedToBucket(job, put.code);
+      renewed = true;
+      const again = await ask(job, size);
+      if (!again.ok) return failedToBucket(job, codeOf(again));
+      const fresh = linkOf(again.body?.files?.[0]);
+      if (fresh === void 0) return failedToBucket(job, "bad_answer");
+      link = fresh;
     }
-    stats.screenshots.failed += 1;
-    if (stats.screenshots.failed === 1) {
-      log(`plune: could not upload a screenshot (${out.detail || out.kind}) \u2014 its result is reported without it.`);
+    const done2 = await client.post(`/v1/files/${encodeURIComponent(link.id)}/complete`, {});
+    if (!done2.ok) return failedToBucket(job, codeOf(done2));
+    countsOf(job.kind).uploaded += 1;
+  }
+  let free = UPLOADS_AT_ONCE;
+  const waiting = [];
+  async function gated(work) {
+    if (free === 0) await new Promise((resolve2) => waiting.push(resolve2));
+    else free -= 1;
+    try {
+      return await work();
+    } finally {
+      const next = waiting.shift();
+      if (next !== void 0) next();
+      else free += 1;
     }
   }
+  async function plan(job) {
+    const { kind } = job;
+    let size;
+    if (job.body !== void 0) size = job.body.length;
+    else if (job.path === void 0) return void skip(kind, job.name, "missing");
+    else {
+      try {
+        size = (await disk.stat(job.path)).size;
+      } catch {
+        return void skip(kind, job.name, "missing");
+      }
+    }
+    if (size === 0) return void skip(kind, job.name, "empty");
+    const direct = () => {
+      if (kind === "file") return void skip(kind, job.name, "noStorage");
+      const roomKey = `${job.id}/${kind}`;
+      const left = rooms.get(roomKey) ?? KINDS[kind].room;
+      if (left === 0) return void skip(kind, job.name, KINDS[kind].limit);
+      rooms.set(roomKey, left - 1);
+      return () => uploadDirect(job, size);
+    };
+    if (uploadsMissing) return direct();
+    const out = await gated(() => ask(job, size));
+    if (!out.ok) {
+      if (out.status === 404 && out.detail === "" && out.code === void 0) {
+        uploadsMissing = true;
+        return direct();
+      }
+      if (out.code !== void 0) failedToBucket(job, out.code);
+      else failed(job, out.detail || out.kind);
+      return void 0;
+    }
+    const item = out.body?.files?.[0];
+    if (item?.skipped === "no_storage") return void skip(kind, job.name, refusedHere(job, size) ?? "noStorage");
+    if (item?.direct === true) return direct();
+    const link = linkOf(item);
+    if (link === void 0) return void failed(job, "bad_answer");
+    if (!bucketSeen) {
+      bucketSeen = true;
+      log(BUCKET_FOUND);
+    }
+    return () => uploadToBucket(job, size, link);
+  }
   async function upload(items, filesByKey) {
     if (filesByKey.size === 0 || !Array.isArray(items)) return;
-    const shots = [];
+    const jobs = [];
     for (const item of items) {
       if (item?.status !== "accepted" || typeof item.id !== "string" || typeof item.resultKey !== "string") continue;
-      let room = SCREENSHOTS_PER_RESULT;
       for (const file of filesByKey.get(item.resultKey) ?? []) {
-        const type = file.contentType?.split(";")[0]?.trim().toLowerCase() || TYPE_BY_EXTENSION[extname(file.path).toLowerCase()];
-        if (!type?.startsWith("image/")) continue;
+        const type = mediaTypeOf(file.contentType) ?? (file.path === void 0 ? void 0 : TYPE_BY_EXTENSION[extname(file.path).toLowerCase()]);
+        if (type === void 0 || type === METADATA_TYPE2) continue;
+        const kind = kindOf(type);
+        if (kind !== "text" && file.path === void 0) continue;
         const name = nameOf(file);
-        if (file.name.startsWith("_")) skip(name, "hidden");
-        else if (!SCREENSHOT_TYPES.has(type)) skip(name, "type");
-        else if (room === 0) skip(name, "limit");
+        if (file.name.startsWith("_")) skip(kind, name, "hidden");
         else {
-          room -= 1;
-          shots.push({ id: item.id, name, type, path: file.path });
+          jobs.push({
+            id: item.id,
+            kind,
+            name,
+            type: kind === "text" ? textTypeOf(file.contentType ?? "", type) : type,
+            ...file.body !== void 0 ? { body: file.body } : {},
+            ...file.path !== void 0 ? { path: file.path } : {}
+          });
         }
       }
     }
-    let next = 0;
+    const byResult = /* @__PURE__ */ new Map();
+    for (const job of jobs) byResult.set(job.id, [...byResult.get(job.id) ?? [], job]);
     await Promise.all(
-      Array.from({ length: Math.min(UPLOADS_AT_ONCE, shots.length) }, async () => {
-        while (next < shots.length) await uploadOne(shots[next++]);
+      [...byResult.values()].map(async (group) => {
+        const work = [];
+        for (const job of group) {
+          const act = await plan(job);
+          if (act !== void 0) work.push(gated(act));
+        }
+        await Promise.all(work);
       })
     );
   }
@@ -629,11 +1013,20 @@ async function startRun(passed, declared) {
     if (stats.unresolved > 0) parts.push(`${stats.unresolved} with no matching test case`);
     if (stats.offered > 0) parts.push(`${stats.offered} offered for review`);
     if (stats.created > 0) parts.push(`${stats.created} added as cases (trusted source)`);
-    const shots = stats.screenshots;
-    if (shots.uploaded + shots.skipped + shots.failed > 0) {
+    const kinds = [stats.screenshots, stats.textFiles, stats.otherFiles];
+    const sum = (what) => kinds.reduce((n, counts) => n + counts[what], 0);
+    if (bucketSeen) {
+      const other = sum("skipped") - noStorage;
       parts.push(
-        `${shots.uploaded} screenshot(s) uploaded` + (shots.skipped > 0 ? `, ${shots.skipped} skipped` : "") + (shots.failed > 0 ? `, ${shots.failed} failed to upload` : "")
+        `${sum("uploaded")} file(s) uploaded to your bucket` + (noStorage > 0 ? `, ${noStorage} skipped (no bucket connected)` : "") + (other > 0 ? `, ${other} skipped` : "") + (sum("failed") > 0 ? `, ${sum("failed")} failed to upload` : "")
       );
+    } else {
+      for (const said of [tally(stats.screenshots, "screenshot"), tally(stats.textFiles, "text file")]) {
+        if (said !== void 0) parts.push(said);
+      }
+      const other = stats.otherFiles;
+      if (other.skipped > 0) parts.push(`${other.skipped} file(s) not stored (no bucket connected)`);
+      if (other.failed > 0) parts.push(`${other.failed} file(s) failed to upload`);
     }
     if (stats.deferred > 0) parts.push(`${stats.deferred} not delivered \u2014 written to ${fallbackPath}`);
     if (shortened.size > 0) parts.push(`${shortened.size} test name(s) shortened to fit a key`);
@@ -700,134 +1093,6 @@ function resultKey(testId, retry) {
   const plain = `${testId}#${retry}`;
   return plain.length <= RESULT_KEY_MAX ? plain : `${sha256(testId).slice(0, HASH_CHARS)}#${retry}`;
 }
-
-// src/reporter-core/failure-detail.ts
-import { existsSync as existsSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { dirname as dirname3, join as join3, posix, resolve } from "path";
-import { stripVTControlCharacters } from "util";
-function failureOf(attempt, home = homedir2()) {
-  const error = chosen(attempt);
-  const line = error === void 0 ? void 0 : firstLine(machineless(error.text, attempt.repoRoot, home));
-  const headline = line !== void 0 && jsonBytes(line) <= HEADLINE_LIMIT ? line : void 0;
-  const steps = chainOf(attempt.steps);
-  const location = error === void 0 ? void 0 : fromRoot(placeOf(error, attempt.testFile), attempt.repoRoot);
-  const artifacts = attempt.attachments.filter((a) => a.path !== void 0 && !a.name.startsWith("_") && a.contentType !== METADATA_TYPE).map(({ name, contentType }) => ({ name: fileNameOf(name), ...contentType ? { contentType } : {} })).filter((a) => a.name !== "");
-  const ciUrl = webLink(attempt.buildHref);
-  const failure = {
-    ...headline !== void 0 ? { headline } : {},
-    ...steps.length > 0 ? { steps } : {},
-    ...location !== void 0 ? { location } : {},
-    ...artifacts.length > 0 ? { artifacts } : {},
-    ...ciUrl !== void 0 ? { ciUrl } : {}
-  };
-  return Object.keys(failure).length === 0 ? void 0 : failure;
-}
-function repoRootOf(dir, stopAt) {
-  for (let here = resolve(dir); ; here = dirname3(here)) {
-    if (existsSync2(join3(here, ".git"))) return here;
-    if (here === stopAt || dirname3(here) === here) return void 0;
-  }
-}
-function errorContextOf(attempt, home = homedir2()) {
-  const text = attempt.errors.map((e) => e.text).filter((t) => t !== "").join("\n\n");
-  return cut(machineless(text, attempt.repoRoot, home));
-}
-function filesOf(attempt) {
-  return attempt.attachments.filter((a) => a.path !== void 0);
-}
-function machineless(raw, repoRoot, home) {
-  let text = stripVTControlCharacters(raw).replaceAll("\x1B", "");
-  const root = repoRoot === void 0 ? void 0 : pathIn(repoRoot);
-  if (root !== void 0) text = text.replace(new RegExp(`${PATH_START}${root.source}[\\\\/]+`, root.flags), "");
-  const own = pathIn(home);
-  if (own !== void 0) text = text.replace(new RegExp(`${PATH_START}${own.source}(?![\\w.-])`, own.flags), "~");
-  if (repoRoot === void 0) text = text.replace(ANY_HOME, "~");
-  return text;
-}
-var PATH_START = "(?<![\\w.~%/\\\\-])";
-var TEXT_LIMIT = 524288;
-var HEADLINE_LIMIT = 8 * 1024;
-var jsonBytes = (text) => Buffer.byteLength(JSON.stringify(text)) - 2;
-var ANY_HOME = /(?<=^|[\s'"`(=,[])(?:(?:file|webpack|webpack-internal):(?:\\*\/){2,3})?(?:\\*\/home\\*\/|\\*\/Users\\*\/|[A-Za-z]:[\\/]+Users[\\/]+)[^\\/\s'"`:*?<>|]+/g;
-function pathIn(path3) {
-  const parts = path3.split(/[\\/]+/);
-  while (parts.length > 1 && parts.at(-1) === "") parts.pop();
-  if (!parts.some((part) => part !== "" && !/^[A-Za-z]:$/.test(part))) return void 0;
-  const joined = parts.map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[\\\\/]+");
-  const escaped = /^\/(?!\/)/.test(path3) ? joined.replace("[\\\\/]+", "\\\\*\\/") : joined;
-  const url = "(?:(?:file|webpack|webpack-internal):(?:\\\\*\\/){2,3})?";
-  return new RegExp(`${url}${escaped}`, /^[A-Za-z]:$/.test(parts[0]) ? "gi" : "g");
-}
-var fileNameOf = (name) => /^(?:file:\/\/|[\\/]|~[\\/]|[A-Za-z]:[\\/])/.test(name) ? name.split(/[\\/]/).pop() ?? "" : name;
-function cut(text) {
-  if (jsonBytes(text) <= TEXT_LIMIT) return text;
-  const lines = text.split("\n");
-  const size = lines.map((line) => jsonBytes(line) + 2);
-  const budget = TEXT_LIMIT - jsonBytes(omitted(lines.length));
-  let used = 0;
-  let head = 0;
-  let tail = lines.length;
-  while (head < tail && used + size[head] <= budget / 2) used += size[head++];
-  while (tail > head && used + size[tail - 1] <= budget) used += size[--tail];
-  return [...lines.slice(0, head), omitted(tail - head), ...lines.slice(tail)].join("\n");
-}
-var omitted = (lines) => `\u2026[omitted ${lines} lines]\u2026`;
-var METADATA_TYPE = "application/plune.metadata+json";
-var REPO_RELATIVE = /^(?![A-Za-z][A-Za-z0-9+.-]*:)(?![\\/~])(?!(?:.*[\\/])?\.\.(?:[\\/]|$)).+$/;
-var FRAME = /^\s+at (?:.*? \()?(.+?):(\d+):(\d+)\)?$/;
-var FRAME_MAX = 8192;
-var firstLine = (text) => stripVTControlCharacters(text).split("\n").map((line) => line.trim()).find((line) => line !== "");
-function chosen({ status, errors }) {
-  if (status === "timedOut") {
-    const timeout = errors.findIndex((e) => firstLine(e.text)?.startsWith("Test timeout of ") === true);
-    if (timeout !== -1 && timeout + 1 < errors.length) return errors[timeout + 1];
-  }
-  return errors[0];
-}
-function chainOf(steps) {
-  const chain = [];
-  for (let failed = steps.find((s) => s.failed); failed !== void 0; failed = failed.steps.find((s) => s.failed)) {
-    chain.push(failed.title);
-  }
-  return chain;
-}
-function placeOf(error, testFile) {
-  const own = normal(testFile);
-  let first;
-  for (const line of stripVTControlCharacters(error.text).split("\n")) {
-    if (line.length > FRAME_MAX) continue;
-    const frame = FRAME.exec(line);
-    if (frame === null) continue;
-    const place = { file: fileOf(frame[1]), line: Number(frame[2]), column: Number(frame[3]) };
-    if (normal(place.file) === own) return place;
-    if (first === void 0 && !normal(place.file).includes("/node_modules/")) first = place;
-  }
-  return error.location ?? first;
-}
-function fileOf(raw) {
-  if (!raw.startsWith("file://")) return raw;
-  let path3 = raw.slice("file://".length);
-  try {
-    path3 = decodeURIComponent(path3);
-  } catch {
-  }
-  return /^\/[A-Za-z]:\//.test(path3) ? path3.slice(1) : path3;
-}
-var normal = (path3) => posix.normalize(path3.replace(/\\/g, "/")).replace(/^([a-z]):/, (_, drive) => `${drive.toUpperCase()}:`);
-function fromRoot(place, root) {
-  if (place === void 0 || root === void 0 || !Number.isInteger(place.line) || place.line < 1) return void 0;
-  const base = normal(root).replace(/\/+$/, "");
-  const file = normal(place.file);
-  if (!file.startsWith(`${base}/`)) return void 0;
-  const relative = file.slice(base.length + 1);
-  if (!REPO_RELATIVE.test(relative)) return void 0;
-  const column = place.column !== void 0 && Number.isInteger(place.column) && place.column >= 1 ? place.column : void 0;
-  return column === void 0 ? { file: relative, line: place.line } : { file: relative, line: place.line, column };
-}
-function webLink(href) {
-  return href !== void 0 && /^https?:\/\//i.test(href) && URL.canParse(href) ? href : void 0;
-}
 export {
   DEFAULT_FALLBACK_PATH,
   RESULT_KEY_MAX,