tracereports 0.4.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracereports",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "TraceReports client for JavaScript/TypeScript: Playwright Test reporter and fixtures, Selenium WebDriver helpers and a client for any runner.",
   "keywords": [
     "testing",

package/src/index.js

@@ -28,7 +28,7 @@ import { Mirror } from "./mirror.js";
 import { Sender } from "./transport.js";
 import { downloadBinary } from "./binary.js";
 
-export const VERSION = "0.4.0";
+export const VERSION = "0.4.1";
 const STATUSES = new Set(["INFO", "PASS", "FAIL", "WARNING", "SKIP"]);
 const truthy = (v) => ["1", "true", "yes"].includes(String(v || "").toLowerCase());
 
@@ -133,12 +133,12 @@ export class TraceReports {
     try {
       this.sender = new Recorder(dir);
     } catch (err) {
-      console.warn(`tracereports: no se pudo grabar en ${dir}: ${err.message}`);
+      console.warn(`tracereports: could not record locally in ${dir}: ${err.message}`);
       return;
     }
     this.offlineDir = dir;
     if (reason) {
-      console.warn(`tracereports: ${reason}; la evidencia se graba en ${dir}`);
+      console.warn(`tracereports: ${reason}; recording the evidence in ${dir}`);
     }
   }
 
@@ -147,7 +147,7 @@ export class TraceReports {
     try {
       this.sender = new Mirror(this.sender, dir, this.baseUrl, runId, payload);
       this.offlineDir = dir;
-    } catch (err) { console.warn(`tracereports: no se pudo iniciar la copia local en ${dir}: ${err.message}`); }
+    } catch (err) { console.warn(`tracereports: could not start local copy in ${dir}: ${err.message}`); }
   }
 
   /** Arma el HTML con el binario instalado o el renderer verificado de la caché. */
@@ -163,7 +163,7 @@ export class TraceReports {
       if (!fs.statSync(index).isFile()) throw Error("renderer did not create index.html");
       this.offlineReport = index;
       if (this.runId > 0) console.warn(`tracereports: server report: ${this.reportUrl}`);
-      console.warn(`tracereports: reporte local: ${this.offlineReport}`);
+      console.warn(`tracereports: local report in ${this.offlineReport}`);
       return this.offlineReport;
     } catch (err) {
       console.warn(`tracereports: local report unavailable (${err.message}); evidence retained in ${this.offlineDir}. ` +
@@ -234,14 +234,14 @@ export class TraceReports {
     let created = res;
     if (!created && this.enabled && ["auto", "both"].includes(this.offlineMode) && !this.recording) {
       // sin servidor, caído o con el token equivocado: se graba en vez de perderlo todo
-      this.goOffline(`no se pudo crear la ejecución en ${this.baseUrl} (servidor caído o token incorrecto)`);
+      this.goOffline(`could not create the run at ${this.baseUrl} (server down or wrong token)`);
       if (this.recording) created = await this.request("POST", "/api/v1/runs", payload);
     }
     if (created?.run_id > 0 && this.offlineMode === "both" && !this.recording) this.goMirror(created.run_id, payload);
     this.runId = created?.run_id ?? null;
     this.runCreated = Boolean(this.runId);
     if (this.enabled && !this.runId) {
-      console.warn(`tracereports: no se pudo crear la ejecución en ${this.baseUrl}; los tests siguen sin reporte.`);
+      console.warn(`tracereports: could not create the run at ${this.baseUrl}; tests will continue without reporting.`);
     }
     return this.runId;
   }
@@ -287,8 +287,8 @@ export class TraceReports {
       return res;
     }
     if (this.runNotClosed) {
-      console.warn(`tracereports: el servidor no confirmó el cierre de la ejecución #${this.runId}: quedó abierta ` +
-        `(ciérrala con PATCH ${this.baseUrl}/api/v1/runs/${this.runId}/finish)`);
+      console.warn(`tracereports: the server did not confirm that run #${this.runId} finished: it stays open ` +
+        `(finish it with PATCH ${this.baseUrl}/api/v1/runs/${this.runId}/finish)`);
     }
     return res;
   }
@@ -411,7 +411,7 @@ export class TraceTest {
       }
     }
     if (body.length > 100 << 20) {
-      console.warn(`tracereports: ${name || kind} pesa más de 100 MB: no se adjunta`);
+      console.warn(`tracereports: ${name || kind} is larger than 100 MB: not attached`);
       return false;
     }
     const boundary = `----tracereports${Math.random().toString(16).slice(2)}`;

package/src/mask.js

@@ -90,7 +90,7 @@ export async function seleniumScreenshot(driver) {
         await driver.executeScript(COVER_JS, selector, MASK_COLOR, OVERLAY_ATTR);
         covered = true;
       } catch (err) {
-        console.warn(`tracereports: no se pudo tapar ${JSON.stringify(selector)} antes de la captura: ${err?.message ?? err}`);
+        console.warn(`tracereports: could not cover ${JSON.stringify(selector)} before the screenshot: ${err?.message ?? err}`);
         return null;
       }
     }

package/src/mirror.js

@@ -20,12 +20,12 @@ export class Mirror {
     fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
     this.locked(() => {
       const marker = path.join(directory, MARKER);
-      if (fs.existsSync(marker) && JSON.parse(fs.readFileSync(marker)).raw_removed) throw new Error("la carpeta solo contiene el reporte; usa otra carpeta");
+      if (fs.existsSync(marker) && JSON.parse(fs.readFileSync(marker)).raw_removed) throw new Error("the folder only contains the report; use another folder");
       this.recorder = new Recorder(directory);
       this.status = `status-${process.pid}-${this.recorder.tag}.json`;
       this.write(this.status, { complete: false, reason: "active" });
       const m = JSON.parse(fs.readFileSync(marker));
-      if (m.mirror && m.mirror.server !== server) throw new Error("la carpeta pertenece a otro servidor");
+      if (m.mirror && m.mirror.server !== server) throw new Error("the folder belongs to another server");
       m.mirror ||= { server, runs: [], complete: false };
       m.mirror.complete = false;
       this.write(MARKER, m);
@@ -39,10 +39,10 @@ export class Mirror {
       } else {
         try {
           local = Number(fs.readFileSync(mapping, "utf8"));
-          if (!Number.isSafeInteger(local) || local >= 0) throw new Error("id local inválido");
+          if (!Number.isSafeInteger(local) || local >= 0) throw new Error("invalid local id");
         } catch (err) {
           this.failed = true;
-          console.warn(`tracereports: falta el id local de la ejecución #${runId}: ${err.message}`);
+          console.warn(`tracereports: missing local id for run #${runId}: ${err.message}`);
         }
       }
       if (local) this.runs.set(runId, local);
@@ -57,7 +57,7 @@ export class Mirror {
         if (n >= 50) {
           let stale = false;
           try { stale = Date.now() - fs.statSync(lock).mtimeMs > STALE_LOCK_MS; } catch { /* ya no existe */ }
-          if (!stale) throw new Error(`${lock} lo tiene otro proceso (bórralo si ninguna ejecución usa esta carpeta)`);
+          if (!stale) throw new Error(`${lock} is held by another process (delete it if no run uses this folder)`);
           try { fs.rmdirSync(lock); } catch { /* otro proceso lo retiró antes */ }
           n = 0; // huérfano: se retira y se vuelve a intentar
         }
@@ -83,7 +83,7 @@ export class Mirror {
 
   diskError(err) {
     this.failed = true;
-    if (!this.disabled) console.warn(`tracereports: se detuvo la copia local en ${this.directory}: ${err.message}`);
+    if (!this.disabled) console.warn(`tracereports: stopped local copy in ${this.directory}: ${err.message}`);
     this.disabled = true;
   }
 

package/src/reporter.js

@@ -181,18 +181,18 @@ export default class TraceReportsReporter {
     const problems = this.cr.deliveryProblems() + (this.cr.recording && this.cr.runId < 0 && ["auto", "both"].includes(this.cr.offlineMode) ? 1 : 0);
     if (this.cr.recording && this.cr.runId > 0) {
       console.log(`TraceReports: ${this.cr.reportUrl}`);
-      console.log(`TraceReports copia local: ${this.cr.offlineReport || `tracereports report ${this.cr.offlineDir}`}`);
+      console.log(`TraceReports local copy: ${this.cr.offlineReport || `tracereports report ${this.cr.offlineDir}`}`);
     } else if (this.cr.recording) {
-      console.log(`TraceReports (sin servidor): evidencia en ${this.cr.offlineDir}; reporte: ` +
-        (this.cr.reportUrl || `\`tracereports report ${this.cr.offlineDir} -o reporte\``) +
-        `; para subirla: \`tracereports push ${this.cr.offlineDir}\``);
+      console.log(`TraceReports (no server): evidence in ${this.cr.offlineDir}; report: ` +
+        (this.cr.reportUrl || `\`tracereports report ${this.cr.offlineDir} -o report\``) +
+        `; to upload it: \`tracereports push ${this.cr.offlineDir}\``);
     } else if (this.cr.runId) console.log(`TraceReports: ${this.cr.reportUrl}`);
     if (problems && (!this.cr.recording || this.cr.runId > 0)) {
       const d = this.cr.delivery;
-      console.warn(`TraceReports: atención: ${problems - d.runNotClosed} eventos de evidencia no llegaron al servidor ` +
-        `(enviados ${d.sent}, rechazados ${d.rejected}, descartados ${d.dropped}, perdidos ${d.lost})` +
-        (d.runNotClosed ? "; el servidor no confirmó el cierre de la ejecución: quedó abierta" : "") +
-        (this.strict ? " — TRACEREPORTS_STRICT: la corrida falla" : ""));
+      console.warn(`TraceReports: warning: ${problems - d.runNotClosed} evidence events did not reach the server ` +
+        `(sent ${d.sent}, rejected ${d.rejected}, dropped ${d.dropped}, lost ${d.lost})` +
+        (d.runNotClosed ? "; the server did not confirm that the run finished: it stays open" : "") +
+        (this.strict ? " - TRACEREPORTS_STRICT: the run fails" : ""));
     }
     if (this.strict && (problems || (this.cr.enabled && !this.cr.runId)) && result.status === "passed") {
       return { status: "failed" };

package/src/transport.js

@@ -60,11 +60,11 @@ export class Sender {
         return { kind: "ok", data: text ? JSON.parse(text) : {} };
       }
       if (RETRYABLE.has(res.status)) return { kind: "retry" };
-      const hint = res.status === 401 ? " (configura el token: new TraceReports({ token }), la variable TRACEREPORTS_TOKEN o TRACEREPORTS_TOKEN en el .env del proyecto)" : "";
+      const hint = res.status === 401 ? " (set the token: new TraceReports({ token }), the TRACEREPORTS_TOKEN variable or TRACEREPORTS_TOKEN in the project .env)" : "";
       console.warn(`tracereports: ${item.method} ${item.path} -> HTTP ${res.status} ${text.slice(0, 300)}${hint}`);
       return { kind: "reject" };
     } catch (err) {
-      if (!this.serverDown()) console.warn(`tracereports: ${item.method} ${item.path} falló: ${err.cause?.code || err.message}`);
+      if (!this.serverDown()) console.warn(`tracereports: ${item.method} ${item.path} failed: ${err.cause?.code || err.message}`);
       this.downUntil = Date.now() + limits.circuitMs;
       return { kind: "retry" };
     }
@@ -92,7 +92,7 @@ export class Sender {
     const size = body?.length ?? 0;
     if (this.pending + 1 > this.maxItems || this.bytes + size > this.maxBytes) {
       if (this.stats.dropped++ === 0) {
-        console.warn(`tracereports: la cola de envío está llena (${this.maxItems} eventos); se descartan los eventos nuevos`);
+        console.warn(`tracereports: the send queue is full (${this.maxItems} events); new events are dropped`);
       }
       return false;
     }
@@ -178,7 +178,7 @@ export class Sender {
     }
     this.notify();
     if (items.length) {
-      console.warn(`tracereports: ${items.length} eventos de evidencia no se pudieron enviar y se perdieron`);
+      console.warn(`tracereports: ${items.length} evidence events could not be sent and were lost`);
     }
     return items.length;
   }