@qualflare/cypress 0.3.0 → 0.5.0

package/README.md

@@ -5,7 +5,7 @@
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
 
 A native Cypress reporter for [Qualflare](https://qualflare.com) — captures test results directly
-from your Cypress run: suite/test status, real retry counts, screenshots, step-by-step command
+from your Cypress run: suite/test status, per-attempt retry history, screenshots, step-by-step command
 traces, and author-facing metadata (labels, links, tags, custom attachments) — and writes them into
 a report directory that [`qualflare-cli`](https://github.com/Qualflare/qualflare-cli) uploads. No
 post-hoc file parsing, no intermediate report format to hand-roll, no network access needed from
@@ -120,6 +120,23 @@ wrong value cannot fail at run time — this package makes no network calls —
   CLIs merge as before.
 - **Command-log step nesting is two levels only** (Cypress's own API limit) — `qualflare.step()`
   supports arbitrary nesting depth.
+- **An all-passing spec's video is not captured by default.** Cypress records one video per spec,
+  and it is only copied when a case in that spec failed. Set `videoOnFailureOnly: false` to keep a
+  green spec's video too; uploading it is separately opt-in via the CLI's `--upload-artifacts`.
+- **Step timing is an approximation** — command-log steps are timed from log events, not from
+  instrumented start/stop boundaries. `qualflare.step()` timing is exact.
+- **`parameter()` outside a step is not masked** — `masked` is a display hint for the UI; the
+  server never redacts the value, so never put a real secret in one. See
+  [`docs/LIMITATIONS.md`](./docs/LIMITATIONS.md#qualflareparameter-outside-a-step-has-no-masking).
+- **Attachment caps are two budgets, not one pool** — `maxAttachmentBytes` bounds a single
+  attachment and `maxTotalAttachmentBytes` the whole run; anything over either is dropped
+  outright rather than truncated. Raising them is the easiest way to push a request past
+  `/collect`'s body limit. See
+  [`docs/LIMITATIONS.md`](./docs/LIMITATIONS.md#per-caseper-attachment-caps-are-independent-not-pooled).
+- **Retries carry per-attempt errors, but everything else is the final attempt** — `Case.attempts`
+  records each attempt's status, duration and error; steps, labels, links, tags, priority,
+  properties and attachments come from the last attempt only, so an abandoned attempt's step trace
+  is discarded rather than replayed alongside the final one.
 
 Full details in [`docs/LIMITATIONS.md`](./docs/LIMITATIONS.md).
 

package/dist/index.cjs

@@ -45,6 +45,8 @@ var MAX_LABELS_PER_CASE = 100;
 var MAX_LINKS_PER_CASE = 20;
 var MAX_TAGS_PER_CASE = 64;
 var MAX_TAG_LENGTH = 255;
+var MAX_ATTEMPTS_PER_CASE = 50;
+var MAX_ATTEMPT_MESSAGE_RUNES = 8192;
 var MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;
 var MAX_STEPS_PER_TEST_ATTEMPT = 300;
 
@@ -298,6 +300,18 @@ function registerCommandLogListener(buffer) {
   });
 }
 
+// src/shared/text.ts
+function truncateRunes(value, maxRunes) {
+  if (value.length <= maxRunes) {
+    return value;
+  }
+  const runes = Array.from(value);
+  if (runes.length <= maxRunes) {
+    return value;
+  }
+  return runes.slice(0, maxRunes).join("");
+}
+
 // src/browser/case-builder.ts
 function combineSteps(autoSteps, manualSteps) {
   const auto = autoSteps ?? [];
@@ -314,6 +328,26 @@ function combineSteps(autoSteps, manualSteps) {
   });
   return [...auto, ...offsetManual];
 }
+function buildAttempts(attempts) {
+  if (attempts.length < 2) {
+    return void 0;
+  }
+  let kept = attempts;
+  if (attempts.length > MAX_ATTEMPTS_PER_CASE) {
+    kept = [...attempts.slice(0, MAX_ATTEMPTS_PER_CASE - 1), attempts[attempts.length - 1]];
+  }
+  return kept.map((a, i) => {
+    const attempt = {
+      attempt: i + 1,
+      status: a.status,
+      duration: msToNs(a.duration)
+    };
+    if (a.error) {
+      attempt.message = truncateRunes(a.error, MAX_ATTEMPT_MESSAGE_RUNES);
+    }
+    return attempt;
+  });
+}
 function collapseAttempts(attempts) {
   if (attempts.length === 0) {
     throw new Error("collapseAttempts: at least one attempt is required");
@@ -322,11 +356,13 @@ function collapseAttempts(attempts) {
   const retryCount = attempts.length - 1;
   const isFlaky = retryCount > 0 && final.status === "passed" && attempts.some((a) => a.status !== "passed");
   const duration = attempts.reduce((sum, a) => sum + a.duration, 0);
+  const attemptHistory = buildAttempts(attempts);
   return {
     status: final.status,
     duration,
     retryCount,
     isFlaky,
+    ...attemptHistory ? { attempts: attemptHistory } : {},
     error: final.status === "passed" ? void 0 : final.error,
     steps: combineSteps(final.steps, final.manualSteps),
     labels: final.labels,
@@ -353,6 +389,8 @@ function flushCase(test, attempts) {
     duration: msToNs(collapsed.duration),
     retryCount: collapsed.retryCount,
     isFlaky: collapsed.isFlaky,
+    // Already nanoseconds — collapseAttempts converts, unlike `duration` above.
+    attempts: collapsed.attempts,
     error: collapsed.error,
     steps: collapsed.steps,
     // qualflare.* author-facing metadata API calls (labels/links/tags/