@qualflare/playwright 0.3.0 → 0.4.0

package/README.md

@@ -5,8 +5,9 @@
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
 
 A native Playwright reporter for [Qualflare](https://qualflare.com) — captures test results directly
-from your `playwright test` run: status, real retry counts and flakiness, nested `test.step()` trees,
-screenshots, videos, and author-facing metadata (labels, links, tags, priority, custom attachments).
+from your `playwright test` run: status, per-attempt retry history and flakiness, nested
+`test.step()` trees,
+screenshots, videos, traces, and author-facing metadata (labels, links, tags, priority, custom attachments).
 
 The reporter itself makes **no network calls**. It writes a report directory, and
 [`qualflare-cli`](https://github.com/Qualflare/qualflare-cli) uploads it — which is what lets any
@@ -113,17 +114,31 @@ wrong value cannot fail at test time — the reporter makes no requests — so t
 
 ## Known limitations
 
-- **Traces are not uploaded.** Playwright traces are `application/zip`, which Qualflare's attachment
-  upload endpoint rejects. They are deliberately not attached rather than attached as a link to
-  nothing.
+- **Traces need `--upload-artifacts=trace` at collect time.** The zip is copied into `outputDir`,
+  but `qf collect` uploads no heavy artifact unless asked — pass `--upload-artifacts=trace` (or
+  `video,trace`). Needs `@qualflare/cli` v0.1.20+; older CLIs ignore it.
 - **`pw:api` and `fixture` steps are filtered out by default** (`includeApiSteps`) — a single
   browser test emits hundreds, which buries the steps you actually wrote. A *failed* one is always
   kept.
 - **A stale `outputDir` is refused, not merged** — each report carries a `runId`, and `qf collect`
   errors rather than merging files from two different runs. Needs `@qualflare/cli` v0.1.19+; older
   CLIs merge as before.
-- **`merge-reports` mode is not supported** in v0.1.0 — use the `outputDir` flow above rather than
+- **`merge-reports` mode is not supported** — use the `outputDir` flow above rather than
   Playwright's `blob` reporter.
+- **Playwright-native `tag` needs 1.42+** while the peer floor is 1.40 — on 1.40/1.41 the
+  native tag array is not read; `qualflare.tag()` works throughout.
+- **`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#parameter-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-case-and-per-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

@@ -31,6 +31,7 @@ var import_test = require("@playwright/test");
 // src/shared/constants.ts
 var RESERVED_MESSAGE_MEDIA_TYPE = "application/vnd.qualflare.message+json";
 var MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;
+var MAX_TRACE_UPLOAD_BYTES = 50 * 1024 * 1024;
 
 // src/shared/logger.ts
 var PREFIX = "[qualflare-playwright]";

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/runtime/qualflare-api.ts","../src/shared/constants.ts","../src/shared/logger.ts"],"sourcesContent":["import type { ReporterDescription } from '@playwright/test';\n\nimport type { QualflarePlaywrightOptions } from './config/resolve-config.js';\n\nexport { qualflare } from './runtime/qualflare-api.js';\n\nexport type { QualflarePlaywrightOptions, ResolvedReporterConfig } from './config/resolve-config.js';\n\nexport type {\n  Attachment,\n  Case,\n  CasePriority,\n  CaseStatus,\n  Collect,\n  FrameworkCategory,\n  Label,\n  Link,\n  LinkType,\n  Metadata,\n  NanosecondDuration,\n  Parameter,\n  Platform,\n  Step,\n  Suite,\n} from './shared/types.js';\n\n/**\n * Typed helper for registering the reporter.\n *\n * Playwright types a reporter's options as `any` (`ReporterDescription` ends\n * in `[string, any]`), so writing the tuple by hand gives no autocomplete and\n * silently accepts typos. This returns the same tuple with the options\n * checked:\n *\n * ```ts\n * import { defineConfig } from '@playwright/test';\n * import { qualflareReporter } from '@qualflare/playwright';\n *\n * export default defineConfig({\n *   reporter: [['list'], qualflareReporter({ environment: 'staging' })],\n * });\n * ```\n */\nexport function qualflareReporter(options: QualflarePlaywrightOptions = {}): ReporterDescription {\n  return ['@qualflare/playwright/reporter', options];\n}\n","import { test } from '@playwright/test';\n\nimport { RESERVED_MESSAGE_MEDIA_TYPE } from '../shared/constants.js';\nimport { logger } from '../shared/logger.js';\nimport type { CasePriority, LinkType } from '../shared/types.js';\nimport type { RuntimeMessage } from './message-types.js';\n\n/**\n * Ships one structured message from the test process to the reporter.\n *\n * Playwright runs tests in worker processes and reporters in the main\n * process, with no shared memory — the only user-reachable channel back is\n * `testInfo.attach()`. So every `qualflare.*()` call is serialized and\n * attached under a reserved content type; the reporter recognizes that exact\n * type in `onTestEnd`, replays it as a model mutation, and excludes it from\n * real attachment processing. Same trick `@qualflare/cucumberjs` plays with\n * `World.attach()`, for the same reason.\n *\n * `test.info()` throws when called outside a running test (module scope, a\n * `globalSetup`, a stray import). Warn and drop: a metadata call is never\n * worth failing somebody's suite over.\n */\nfunction send(message: RuntimeMessage): void {\n  try {\n    // The .catch() is not optional. `attach()` returns a promise, and an\n    // unhandled rejection TERMINATES the process by default on Node >= 15 —\n    // a metadata call would take the user's entire test run down with it.\n    // The surrounding try/catch only covers a synchronous throw from\n    // `test.info()` (called outside a running test), not this.\n    void test\n      .info()\n      .attach(`qualflare:${message.type}`, {\n        body: Buffer.from(JSON.stringify(message), 'utf8'),\n        contentType: RESERVED_MESSAGE_MEDIA_TYPE,\n      })\n      .catch((err: unknown) => {\n        logger.warn(`qualflare.${message.type}() could not be recorded: ${(err as Error).message}`);\n      });\n  } catch {\n    logger.warn(`qualflare.${message.type}() was called outside a running test; the call was ignored.`);\n  }\n}\n\n/**\n * Author-facing metadata API. Import it in a spec and annotate tests with\n * business context Playwright itself has no concept of:\n *\n * ```ts\n * import { qualflare } from '@qualflare/playwright';\n *\n * test('checks out', async ({ page }) => {\n *   qualflare.label('epic', 'Billing');\n *   qualflare.link('https://tracker/QF-1', { type: 'issue', name: 'QF-1' });\n *   await qualflare.step('pay', async () => { ... });\n * });\n * ```\n */\nexport const qualflare = {\n  /** Arbitrary name/value metadata (epic, feature, story, owner, severity). */\n  label(name: string, value: string): void {\n    send({ type: 'label', name, value });\n  },\n\n  /** A typed external reference. `type` defaults to `custom`. */\n  link(url: string, opts?: { type?: LinkType; name?: string }): void {\n    send({ type: 'link', url, linkType: opts?.type, name: opts?.name });\n  },\n\n  /** One or more free-text tags. */\n  tag(...tags: string[]): void {\n    send({ type: 'tag', tags });\n  },\n\n  /** Markdown description shown on the case. */\n  description(text: string): void {\n    send({ type: 'description', text });\n  },\n\n  /** Case priority (low | medium | high | critical). */\n  priority(value: CasePriority): void {\n    send({ type: 'priority', value });\n  },\n\n  /** A named input. Inside an open `step()` it attaches to that step;\n   * outside any step it lands in the case's properties. `masked` is a\n   * display hint for the UI only — the server does not redact the value. */\n  parameter(name: string, value?: string, opts?: { masked?: boolean }): void {\n    send({ type: 'parameter', name, value, masked: opts?.masked });\n  },\n\n  /** Attach in-memory content. */\n  attachment(name: string, content: string, opts?: { encoding?: 'utf8' | 'base64'; mimeType?: string }): void {\n    const contentBase64 = opts?.encoding === 'base64' ? content : Buffer.from(content, 'utf8').toString('base64');\n    send({ type: 'attachment', name, contentBase64, mimeType: opts?.mimeType });\n  },\n\n  /** Attach a file from disk. */\n  attachmentFromFile(name: string, path: string, opts?: { mimeType?: string }): void {\n    send({ type: 'attachment_from_file', name, path, mimeType: opts?.mimeType });\n  },\n\n  /**\n   * Records a named step around `fn`.\n   *\n   * Unlike the cucumber-js equivalent, this delegates to Playwright's own\n   * `test.step()` as well, so the step shows up in Playwright's HTML report\n   * and trace viewer in addition to Qualflare — there is no reason to make\n   * users choose, and a step that exists in only one of the two is a\n   * confusing thing to debug against.\n   */\n  async step<T>(name: string, fn: () => T | Promise<T>): Promise<T> {\n    return test.step(name, async () => {\n      send({ type: 'step_start', name, timestamp: Date.now() });\n      try {\n        const result = await fn();\n        send({ type: 'step_stop', status: 'passed', timestamp: Date.now() });\n        return result;\n      } catch (err) {\n        send({\n          type: 'step_stop',\n          status: 'failed',\n          error: err instanceof Error ? err.message : String(err),\n          timestamp: Date.now(),\n        });\n        throw err;\n      }\n    });\n  },\n};\n","/**\n * Shared constants used across the reporter and the author-facing runtime\n * API.\n */\n\n/** Reserved `testInfo.attach()` content type used to smuggle structured\n * `qualflare.*()` calls (label/tag/step/etc.) from test and hook code back to\n * the reporter — the only channel Playwright gives user code back to a\n * running reporter. The reporter recognizes this exact content type and\n * replays the message as a model mutation instead of reporting it as a\n * literal attachment. */\nexport const RESERVED_MESSAGE_MEDIA_TYPE = 'application/vnd.qualflare.message+json';\n\n/** Server-side caps this client should respect defensively (see\n * `api-service/internal/core/domain/launch/launch.go`). */\nexport const MAX_SUITES_PER_LAUNCH = 2000;\nexport const MAX_CASES_PER_SUITE = 5000;\nexport const MAX_STEPS_PER_CASE = 1000;\nexport const MAX_PARAMETERS_PER_STEP = 50;\nexport const MAX_ATTACHMENTS_PER_CASE = 50;\nexport const MAX_LABELS_PER_CASE = 100;\nexport const MAX_LINKS_PER_CASE = 20;\nexport const MAX_TAGS_PER_CASE = 64;\nexport const MAX_TAG_LENGTH = 255;\n\n/** Mirrors `launch.MaxCaseAttempts`. Beyond this the server keeps the first\n * 49 attempts plus the final one and drops the middle, so sending more is\n * wasted payload rather than an error. */\nexport const MAX_ATTEMPTS_PER_CASE = 50;\n\n/** Mirrors the server's per-attempt text bounds (`launch.MaxAttempt*Runes`).\n *\n * Clamped CLIENT-side, not left to the server, because attempts are the only\n * repeated-per-case payload with no size budget of its own. Measured: one\n * retried test with a deep stack and a chatty log serializes to ~630KB\n * unclamped — most of it text the server discards on write — against a 10MB\n * request body limit that, once exceeded, loses the ENTIRE launch. Sending\n * bytes the server will throw away is pure risk. */\nexport const MAX_ATTEMPT_MESSAGE_RUNES = 8192;\nexport const MAX_ATTEMPT_TRACE_RUNES = 32768;\nexport const MAX_ATTEMPT_SNIPPET_RUNES = 4096;\nexport const MAX_ATTEMPT_OUTPUT_RUNES = 16384;\nexport const MAX_ATTEMPT_OUTPUT_LINES = 200;\n\n/** Mirrors `launch.MaxAttachmentUploadFileSize` — the server's hard cap on a\n * single `POST /api/v1/attachments/upload-url` request (video). */\nexport const MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;\n\n/** Client-side SOFT cap on steps recorded per scenario attempt — well under\n * the server's 1000-per-case hard cap (`MAX_STEPS_PER_CASE`). Once hit,\n * further steps within that attempt are dropped (with a one-time warning),\n * not queued and truncated later. */\nexport const MAX_STEPS_PER_TEST_ATTEMPT = 300;\n","/**\n * A minimal logger writing to stderr. Deliberately avoids stdout, since\n * that's typically Playwright's own reporter output stream and shouldn't be\n * polluted with reporter diagnostics.\n */\n\nconst PREFIX = '[qualflare-playwright]';\n\nexport const logger = {\n  debug(...args: unknown[]): void {\n    console.debug(PREFIX, ...args);\n  },\n  info(...args: unknown[]): void {\n    console.log(PREFIX, ...args);\n  },\n  warn(...args: unknown[]): void {\n    console.warn(PREFIX, ...args);\n  },\n  error(...args: unknown[]): void {\n    console.error(PREFIX, ...args);\n  },\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/runtime/qualflare-api.ts","../src/shared/constants.ts","../src/shared/logger.ts"],"sourcesContent":["import type { ReporterDescription } from '@playwright/test';\n\nimport type { QualflarePlaywrightOptions } from './config/resolve-config.js';\n\nexport { qualflare } from './runtime/qualflare-api.js';\n\nexport type { QualflarePlaywrightOptions, ResolvedReporterConfig } from './config/resolve-config.js';\n\nexport type {\n  Attachment,\n  Case,\n  CasePriority,\n  CaseStatus,\n  Collect,\n  FrameworkCategory,\n  Label,\n  Link,\n  LinkType,\n  Metadata,\n  NanosecondDuration,\n  Parameter,\n  Platform,\n  Step,\n  Suite,\n} from './shared/types.js';\n\n/**\n * Typed helper for registering the reporter.\n *\n * Playwright types a reporter's options as `any` (`ReporterDescription` ends\n * in `[string, any]`), so writing the tuple by hand gives no autocomplete and\n * silently accepts typos. This returns the same tuple with the options\n * checked:\n *\n * ```ts\n * import { defineConfig } from '@playwright/test';\n * import { qualflareReporter } from '@qualflare/playwright';\n *\n * export default defineConfig({\n *   reporter: [['list'], qualflareReporter({ environment: 'staging' })],\n * });\n * ```\n */\nexport function qualflareReporter(options: QualflarePlaywrightOptions = {}): ReporterDescription {\n  return ['@qualflare/playwright/reporter', options];\n}\n","import { test } from '@playwright/test';\n\nimport { RESERVED_MESSAGE_MEDIA_TYPE } from '../shared/constants.js';\nimport { logger } from '../shared/logger.js';\nimport type { CasePriority, LinkType } from '../shared/types.js';\nimport type { RuntimeMessage } from './message-types.js';\n\n/**\n * Ships one structured message from the test process to the reporter.\n *\n * Playwright runs tests in worker processes and reporters in the main\n * process, with no shared memory — the only user-reachable channel back is\n * `testInfo.attach()`. So every `qualflare.*()` call is serialized and\n * attached under a reserved content type; the reporter recognizes that exact\n * type in `onTestEnd`, replays it as a model mutation, and excludes it from\n * real attachment processing. Same trick `@qualflare/cucumberjs` plays with\n * `World.attach()`, for the same reason.\n *\n * `test.info()` throws when called outside a running test (module scope, a\n * `globalSetup`, a stray import). Warn and drop: a metadata call is never\n * worth failing somebody's suite over.\n */\nfunction send(message: RuntimeMessage): void {\n  try {\n    // The .catch() is not optional. `attach()` returns a promise, and an\n    // unhandled rejection TERMINATES the process by default on Node >= 15 —\n    // a metadata call would take the user's entire test run down with it.\n    // The surrounding try/catch only covers a synchronous throw from\n    // `test.info()` (called outside a running test), not this.\n    void test\n      .info()\n      .attach(`qualflare:${message.type}`, {\n        body: Buffer.from(JSON.stringify(message), 'utf8'),\n        contentType: RESERVED_MESSAGE_MEDIA_TYPE,\n      })\n      .catch((err: unknown) => {\n        logger.warn(`qualflare.${message.type}() could not be recorded: ${(err as Error).message}`);\n      });\n  } catch {\n    logger.warn(`qualflare.${message.type}() was called outside a running test; the call was ignored.`);\n  }\n}\n\n/**\n * Author-facing metadata API. Import it in a spec and annotate tests with\n * business context Playwright itself has no concept of:\n *\n * ```ts\n * import { qualflare } from '@qualflare/playwright';\n *\n * test('checks out', async ({ page }) => {\n *   qualflare.label('epic', 'Billing');\n *   qualflare.link('https://tracker/QF-1', { type: 'issue', name: 'QF-1' });\n *   await qualflare.step('pay', async () => { ... });\n * });\n * ```\n */\nexport const qualflare = {\n  /** Arbitrary name/value metadata (epic, feature, story, owner, severity). */\n  label(name: string, value: string): void {\n    send({ type: 'label', name, value });\n  },\n\n  /** A typed external reference. `type` defaults to `custom`. */\n  link(url: string, opts?: { type?: LinkType; name?: string }): void {\n    send({ type: 'link', url, linkType: opts?.type, name: opts?.name });\n  },\n\n  /** One or more free-text tags. */\n  tag(...tags: string[]): void {\n    send({ type: 'tag', tags });\n  },\n\n  /** Markdown description shown on the case. */\n  description(text: string): void {\n    send({ type: 'description', text });\n  },\n\n  /** Case priority (low | medium | high | critical). */\n  priority(value: CasePriority): void {\n    send({ type: 'priority', value });\n  },\n\n  /** A named input. Inside an open `step()` it attaches to that step;\n   * outside any step it lands in the case's properties. `masked` is a\n   * display hint for the UI only — the server does not redact the value. */\n  parameter(name: string, value?: string, opts?: { masked?: boolean }): void {\n    send({ type: 'parameter', name, value, masked: opts?.masked });\n  },\n\n  /** Attach in-memory content. */\n  attachment(name: string, content: string, opts?: { encoding?: 'utf8' | 'base64'; mimeType?: string }): void {\n    const contentBase64 = opts?.encoding === 'base64' ? content : Buffer.from(content, 'utf8').toString('base64');\n    send({ type: 'attachment', name, contentBase64, mimeType: opts?.mimeType });\n  },\n\n  /** Attach a file from disk. */\n  attachmentFromFile(name: string, path: string, opts?: { mimeType?: string }): void {\n    send({ type: 'attachment_from_file', name, path, mimeType: opts?.mimeType });\n  },\n\n  /**\n   * Records a named step around `fn`.\n   *\n   * Unlike the cucumber-js equivalent, this delegates to Playwright's own\n   * `test.step()` as well, so the step shows up in Playwright's HTML report\n   * and trace viewer in addition to Qualflare — there is no reason to make\n   * users choose, and a step that exists in only one of the two is a\n   * confusing thing to debug against.\n   */\n  async step<T>(name: string, fn: () => T | Promise<T>): Promise<T> {\n    return test.step(name, async () => {\n      send({ type: 'step_start', name, timestamp: Date.now() });\n      try {\n        const result = await fn();\n        send({ type: 'step_stop', status: 'passed', timestamp: Date.now() });\n        return result;\n      } catch (err) {\n        send({\n          type: 'step_stop',\n          status: 'failed',\n          error: err instanceof Error ? err.message : String(err),\n          timestamp: Date.now(),\n        });\n        throw err;\n      }\n    });\n  },\n};\n","/**\n * Shared constants used across the reporter and the author-facing runtime\n * API.\n */\n\n/** Reserved `testInfo.attach()` content type used to smuggle structured\n * `qualflare.*()` calls (label/tag/step/etc.) from test and hook code back to\n * the reporter — the only channel Playwright gives user code back to a\n * running reporter. The reporter recognizes this exact content type and\n * replays the message as a model mutation instead of reporting it as a\n * literal attachment. */\nexport const RESERVED_MESSAGE_MEDIA_TYPE = 'application/vnd.qualflare.message+json';\n\n/** Server-side caps this client should respect defensively (see\n * `api-service/internal/core/domain/launch/launch.go`). */\nexport const MAX_SUITES_PER_LAUNCH = 2000;\nexport const MAX_CASES_PER_SUITE = 5000;\nexport const MAX_STEPS_PER_CASE = 1000;\nexport const MAX_PARAMETERS_PER_STEP = 50;\nexport const MAX_ATTACHMENTS_PER_CASE = 50;\nexport const MAX_LABELS_PER_CASE = 100;\nexport const MAX_LINKS_PER_CASE = 20;\nexport const MAX_TAGS_PER_CASE = 64;\nexport const MAX_TAG_LENGTH = 255;\n\n/** Mirrors `launch.MaxCaseAttempts`. Beyond this the server keeps the first\n * 49 attempts plus the final one and drops the middle, so sending more is\n * wasted payload rather than an error. */\nexport const MAX_ATTEMPTS_PER_CASE = 50;\n\n/** Mirrors the server's per-attempt text bounds (`launch.MaxAttempt*Runes`).\n *\n * Clamped CLIENT-side, not left to the server, because attempts are the only\n * repeated-per-case payload with no size budget of its own. Measured: one\n * retried test with a deep stack and a chatty log serializes to ~630KB\n * unclamped — most of it text the server discards on write — against a 10MB\n * request body limit that, once exceeded, loses the ENTIRE launch. Sending\n * bytes the server will throw away is pure risk. */\nexport const MAX_ATTEMPT_MESSAGE_RUNES = 8192;\nexport const MAX_ATTEMPT_TRACE_RUNES = 32768;\nexport const MAX_ATTEMPT_SNIPPET_RUNES = 4096;\nexport const MAX_ATTEMPT_OUTPUT_RUNES = 16384;\nexport const MAX_ATTEMPT_OUTPUT_LINES = 200;\n\n/** Mirrors `launch.MaxAttachmentUploadFileSize` — the server's hard cap on a\n * single `POST /api/v1/attachments/upload-url` request (video). */\nexport const MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;\n\n/** Cap on one Playwright trace zip. Matches MAX_VIDEO_UPLOAD_BYTES because both\n * end up at the same server-side limit: the attachment upload endpoint rejects\n * anything past 50MB regardless of kind. Copying a larger trace would only\n * defer the rejection to collect time, after the bytes were already written. */\nexport const MAX_TRACE_UPLOAD_BYTES = 50 * 1024 * 1024;\n\n/** Client-side SOFT cap on steps recorded per scenario attempt — well under\n * the server's 1000-per-case hard cap (`MAX_STEPS_PER_CASE`). Once hit,\n * further steps within that attempt are dropped (with a one-time warning),\n * not queued and truncated later. */\nexport const MAX_STEPS_PER_TEST_ATTEMPT = 300;\n","/**\n * A minimal logger writing to stderr. Deliberately avoids stdout, since\n * that's typically Playwright's own reporter output stream and shouldn't be\n * polluted with reporter diagnostics.\n */\n\nconst PREFIX = '[qualflare-playwright]';\n\nexport const logger = {\n  debug(...args: unknown[]): void {\n    console.debug(PREFIX, ...args);\n  },\n  info(...args: unknown[]): void {\n    console.log(PREFIX, ...args);\n  },\n  warn(...args: unknown[]): void {\n    console.warn(PREFIX, ...args);\n  },\n  error(...args: unknown[]): void {\n    console.error(PREFIX, ...args);\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { ReporterDescription } from '@playwright/test';
-import { L as LinkType, C as CasePriority, Q as QualflarePlaywrightOptions } from './resolve-config-N04M1Avn.cjs';
-export { A as Attachment, a as Case, b as CaseStatus, c as Collect, F as FrameworkCategory, d as Label, e as Link, M as Metadata, N as NanosecondDuration, P as Parameter, f as Platform, R as ResolvedReporterConfig, S as Step, g as Suite } from './resolve-config-N04M1Avn.cjs';
+import { L as LinkType, C as CasePriority, Q as QualflarePlaywrightOptions } from './resolve-config-T2ChZzAm.cjs';
+export { A as Attachment, a as Case, b as CaseStatus, c as Collect, F as FrameworkCategory, d as Label, e as Link, M as Metadata, N as NanosecondDuration, P as Parameter, f as Platform, R as ResolvedReporterConfig, S as Step, g as Suite } from './resolve-config-T2ChZzAm.cjs';
 
 /**
  * Author-facing metadata API. Import it in a spec and annotate tests with

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ReporterDescription } from '@playwright/test';
-import { L as LinkType, C as CasePriority, Q as QualflarePlaywrightOptions } from './resolve-config-N04M1Avn.js';
-export { A as Attachment, a as Case, b as CaseStatus, c as Collect, F as FrameworkCategory, d as Label, e as Link, M as Metadata, N as NanosecondDuration, P as Parameter, f as Platform, R as ResolvedReporterConfig, S as Step, g as Suite } from './resolve-config-N04M1Avn.js';
+import { L as LinkType, C as CasePriority, Q as QualflarePlaywrightOptions } from './resolve-config-T2ChZzAm.js';
+export { A as Attachment, a as Case, b as CaseStatus, c as Collect, F as FrameworkCategory, d as Label, e as Link, M as Metadata, N as NanosecondDuration, P as Parameter, f as Platform, R as ResolvedReporterConfig, S as Step, g as Suite } from './resolve-config-T2ChZzAm.js';
 
 /**
  * Author-facing metadata API. Import it in a spec and annotate tests with

package/dist/index.js

@@ -4,6 +4,7 @@ import { test } from "@playwright/test";
 // src/shared/constants.ts
 var RESERVED_MESSAGE_MEDIA_TYPE = "application/vnd.qualflare.message+json";
 var MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;
+var MAX_TRACE_UPLOAD_BYTES = 50 * 1024 * 1024;
 
 // src/shared/logger.ts
 var PREFIX = "[qualflare-playwright]";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/qualflare-api.ts","../src/shared/constants.ts","../src/shared/logger.ts","../src/index.ts"],"sourcesContent":["import { test } from '@playwright/test';\n\nimport { RESERVED_MESSAGE_MEDIA_TYPE } from '../shared/constants.js';\nimport { logger } from '../shared/logger.js';\nimport type { CasePriority, LinkType } from '../shared/types.js';\nimport type { RuntimeMessage } from './message-types.js';\n\n/**\n * Ships one structured message from the test process to the reporter.\n *\n * Playwright runs tests in worker processes and reporters in the main\n * process, with no shared memory — the only user-reachable channel back is\n * `testInfo.attach()`. So every `qualflare.*()` call is serialized and\n * attached under a reserved content type; the reporter recognizes that exact\n * type in `onTestEnd`, replays it as a model mutation, and excludes it from\n * real attachment processing. Same trick `@qualflare/cucumberjs` plays with\n * `World.attach()`, for the same reason.\n *\n * `test.info()` throws when called outside a running test (module scope, a\n * `globalSetup`, a stray import). Warn and drop: a metadata call is never\n * worth failing somebody's suite over.\n */\nfunction send(message: RuntimeMessage): void {\n  try {\n    // The .catch() is not optional. `attach()` returns a promise, and an\n    // unhandled rejection TERMINATES the process by default on Node >= 15 —\n    // a metadata call would take the user's entire test run down with it.\n    // The surrounding try/catch only covers a synchronous throw from\n    // `test.info()` (called outside a running test), not this.\n    void test\n      .info()\n      .attach(`qualflare:${message.type}`, {\n        body: Buffer.from(JSON.stringify(message), 'utf8'),\n        contentType: RESERVED_MESSAGE_MEDIA_TYPE,\n      })\n      .catch((err: unknown) => {\n        logger.warn(`qualflare.${message.type}() could not be recorded: ${(err as Error).message}`);\n      });\n  } catch {\n    logger.warn(`qualflare.${message.type}() was called outside a running test; the call was ignored.`);\n  }\n}\n\n/**\n * Author-facing metadata API. Import it in a spec and annotate tests with\n * business context Playwright itself has no concept of:\n *\n * ```ts\n * import { qualflare } from '@qualflare/playwright';\n *\n * test('checks out', async ({ page }) => {\n *   qualflare.label('epic', 'Billing');\n *   qualflare.link('https://tracker/QF-1', { type: 'issue', name: 'QF-1' });\n *   await qualflare.step('pay', async () => { ... });\n * });\n * ```\n */\nexport const qualflare = {\n  /** Arbitrary name/value metadata (epic, feature, story, owner, severity). */\n  label(name: string, value: string): void {\n    send({ type: 'label', name, value });\n  },\n\n  /** A typed external reference. `type` defaults to `custom`. */\n  link(url: string, opts?: { type?: LinkType; name?: string }): void {\n    send({ type: 'link', url, linkType: opts?.type, name: opts?.name });\n  },\n\n  /** One or more free-text tags. */\n  tag(...tags: string[]): void {\n    send({ type: 'tag', tags });\n  },\n\n  /** Markdown description shown on the case. */\n  description(text: string): void {\n    send({ type: 'description', text });\n  },\n\n  /** Case priority (low | medium | high | critical). */\n  priority(value: CasePriority): void {\n    send({ type: 'priority', value });\n  },\n\n  /** A named input. Inside an open `step()` it attaches to that step;\n   * outside any step it lands in the case's properties. `masked` is a\n   * display hint for the UI only — the server does not redact the value. */\n  parameter(name: string, value?: string, opts?: { masked?: boolean }): void {\n    send({ type: 'parameter', name, value, masked: opts?.masked });\n  },\n\n  /** Attach in-memory content. */\n  attachment(name: string, content: string, opts?: { encoding?: 'utf8' | 'base64'; mimeType?: string }): void {\n    const contentBase64 = opts?.encoding === 'base64' ? content : Buffer.from(content, 'utf8').toString('base64');\n    send({ type: 'attachment', name, contentBase64, mimeType: opts?.mimeType });\n  },\n\n  /** Attach a file from disk. */\n  attachmentFromFile(name: string, path: string, opts?: { mimeType?: string }): void {\n    send({ type: 'attachment_from_file', name, path, mimeType: opts?.mimeType });\n  },\n\n  /**\n   * Records a named step around `fn`.\n   *\n   * Unlike the cucumber-js equivalent, this delegates to Playwright's own\n   * `test.step()` as well, so the step shows up in Playwright's HTML report\n   * and trace viewer in addition to Qualflare — there is no reason to make\n   * users choose, and a step that exists in only one of the two is a\n   * confusing thing to debug against.\n   */\n  async step<T>(name: string, fn: () => T | Promise<T>): Promise<T> {\n    return test.step(name, async () => {\n      send({ type: 'step_start', name, timestamp: Date.now() });\n      try {\n        const result = await fn();\n        send({ type: 'step_stop', status: 'passed', timestamp: Date.now() });\n        return result;\n      } catch (err) {\n        send({\n          type: 'step_stop',\n          status: 'failed',\n          error: err instanceof Error ? err.message : String(err),\n          timestamp: Date.now(),\n        });\n        throw err;\n      }\n    });\n  },\n};\n","/**\n * Shared constants used across the reporter and the author-facing runtime\n * API.\n */\n\n/** Reserved `testInfo.attach()` content type used to smuggle structured\n * `qualflare.*()` calls (label/tag/step/etc.) from test and hook code back to\n * the reporter — the only channel Playwright gives user code back to a\n * running reporter. The reporter recognizes this exact content type and\n * replays the message as a model mutation instead of reporting it as a\n * literal attachment. */\nexport const RESERVED_MESSAGE_MEDIA_TYPE = 'application/vnd.qualflare.message+json';\n\n/** Server-side caps this client should respect defensively (see\n * `api-service/internal/core/domain/launch/launch.go`). */\nexport const MAX_SUITES_PER_LAUNCH = 2000;\nexport const MAX_CASES_PER_SUITE = 5000;\nexport const MAX_STEPS_PER_CASE = 1000;\nexport const MAX_PARAMETERS_PER_STEP = 50;\nexport const MAX_ATTACHMENTS_PER_CASE = 50;\nexport const MAX_LABELS_PER_CASE = 100;\nexport const MAX_LINKS_PER_CASE = 20;\nexport const MAX_TAGS_PER_CASE = 64;\nexport const MAX_TAG_LENGTH = 255;\n\n/** Mirrors `launch.MaxCaseAttempts`. Beyond this the server keeps the first\n * 49 attempts plus the final one and drops the middle, so sending more is\n * wasted payload rather than an error. */\nexport const MAX_ATTEMPTS_PER_CASE = 50;\n\n/** Mirrors the server's per-attempt text bounds (`launch.MaxAttempt*Runes`).\n *\n * Clamped CLIENT-side, not left to the server, because attempts are the only\n * repeated-per-case payload with no size budget of its own. Measured: one\n * retried test with a deep stack and a chatty log serializes to ~630KB\n * unclamped — most of it text the server discards on write — against a 10MB\n * request body limit that, once exceeded, loses the ENTIRE launch. Sending\n * bytes the server will throw away is pure risk. */\nexport const MAX_ATTEMPT_MESSAGE_RUNES = 8192;\nexport const MAX_ATTEMPT_TRACE_RUNES = 32768;\nexport const MAX_ATTEMPT_SNIPPET_RUNES = 4096;\nexport const MAX_ATTEMPT_OUTPUT_RUNES = 16384;\nexport const MAX_ATTEMPT_OUTPUT_LINES = 200;\n\n/** Mirrors `launch.MaxAttachmentUploadFileSize` — the server's hard cap on a\n * single `POST /api/v1/attachments/upload-url` request (video). */\nexport const MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;\n\n/** Client-side SOFT cap on steps recorded per scenario attempt — well under\n * the server's 1000-per-case hard cap (`MAX_STEPS_PER_CASE`). Once hit,\n * further steps within that attempt are dropped (with a one-time warning),\n * not queued and truncated later. */\nexport const MAX_STEPS_PER_TEST_ATTEMPT = 300;\n","/**\n * A minimal logger writing to stderr. Deliberately avoids stdout, since\n * that's typically Playwright's own reporter output stream and shouldn't be\n * polluted with reporter diagnostics.\n */\n\nconst PREFIX = '[qualflare-playwright]';\n\nexport const logger = {\n  debug(...args: unknown[]): void {\n    console.debug(PREFIX, ...args);\n  },\n  info(...args: unknown[]): void {\n    console.log(PREFIX, ...args);\n  },\n  warn(...args: unknown[]): void {\n    console.warn(PREFIX, ...args);\n  },\n  error(...args: unknown[]): void {\n    console.error(PREFIX, ...args);\n  },\n};\n","import type { ReporterDescription } from '@playwright/test';\n\nimport type { QualflarePlaywrightOptions } from './config/resolve-config.js';\n\nexport { qualflare } from './runtime/qualflare-api.js';\n\nexport type { QualflarePlaywrightOptions, ResolvedReporterConfig } from './config/resolve-config.js';\n\nexport type {\n  Attachment,\n  Case,\n  CasePriority,\n  CaseStatus,\n  Collect,\n  FrameworkCategory,\n  Label,\n  Link,\n  LinkType,\n  Metadata,\n  NanosecondDuration,\n  Parameter,\n  Platform,\n  Step,\n  Suite,\n} from './shared/types.js';\n\n/**\n * Typed helper for registering the reporter.\n *\n * Playwright types a reporter's options as `any` (`ReporterDescription` ends\n * in `[string, any]`), so writing the tuple by hand gives no autocomplete and\n * silently accepts typos. This returns the same tuple with the options\n * checked:\n *\n * ```ts\n * import { defineConfig } from '@playwright/test';\n * import { qualflareReporter } from '@qualflare/playwright';\n *\n * export default defineConfig({\n *   reporter: [['list'], qualflareReporter({ environment: 'staging' })],\n * });\n * ```\n */\nexport function qualflareReporter(options: QualflarePlaywrightOptions = {}): ReporterDescription {\n  return ['@qualflare/playwright/reporter', options];\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime/qualflare-api.ts","../src/shared/constants.ts","../src/shared/logger.ts","../src/index.ts"],"sourcesContent":["import { test } from '@playwright/test';\n\nimport { RESERVED_MESSAGE_MEDIA_TYPE } from '../shared/constants.js';\nimport { logger } from '../shared/logger.js';\nimport type { CasePriority, LinkType } from '../shared/types.js';\nimport type { RuntimeMessage } from './message-types.js';\n\n/**\n * Ships one structured message from the test process to the reporter.\n *\n * Playwright runs tests in worker processes and reporters in the main\n * process, with no shared memory — the only user-reachable channel back is\n * `testInfo.attach()`. So every `qualflare.*()` call is serialized and\n * attached under a reserved content type; the reporter recognizes that exact\n * type in `onTestEnd`, replays it as a model mutation, and excludes it from\n * real attachment processing. Same trick `@qualflare/cucumberjs` plays with\n * `World.attach()`, for the same reason.\n *\n * `test.info()` throws when called outside a running test (module scope, a\n * `globalSetup`, a stray import). Warn and drop: a metadata call is never\n * worth failing somebody's suite over.\n */\nfunction send(message: RuntimeMessage): void {\n  try {\n    // The .catch() is not optional. `attach()` returns a promise, and an\n    // unhandled rejection TERMINATES the process by default on Node >= 15 —\n    // a metadata call would take the user's entire test run down with it.\n    // The surrounding try/catch only covers a synchronous throw from\n    // `test.info()` (called outside a running test), not this.\n    void test\n      .info()\n      .attach(`qualflare:${message.type}`, {\n        body: Buffer.from(JSON.stringify(message), 'utf8'),\n        contentType: RESERVED_MESSAGE_MEDIA_TYPE,\n      })\n      .catch((err: unknown) => {\n        logger.warn(`qualflare.${message.type}() could not be recorded: ${(err as Error).message}`);\n      });\n  } catch {\n    logger.warn(`qualflare.${message.type}() was called outside a running test; the call was ignored.`);\n  }\n}\n\n/**\n * Author-facing metadata API. Import it in a spec and annotate tests with\n * business context Playwright itself has no concept of:\n *\n * ```ts\n * import { qualflare } from '@qualflare/playwright';\n *\n * test('checks out', async ({ page }) => {\n *   qualflare.label('epic', 'Billing');\n *   qualflare.link('https://tracker/QF-1', { type: 'issue', name: 'QF-1' });\n *   await qualflare.step('pay', async () => { ... });\n * });\n * ```\n */\nexport const qualflare = {\n  /** Arbitrary name/value metadata (epic, feature, story, owner, severity). */\n  label(name: string, value: string): void {\n    send({ type: 'label', name, value });\n  },\n\n  /** A typed external reference. `type` defaults to `custom`. */\n  link(url: string, opts?: { type?: LinkType; name?: string }): void {\n    send({ type: 'link', url, linkType: opts?.type, name: opts?.name });\n  },\n\n  /** One or more free-text tags. */\n  tag(...tags: string[]): void {\n    send({ type: 'tag', tags });\n  },\n\n  /** Markdown description shown on the case. */\n  description(text: string): void {\n    send({ type: 'description', text });\n  },\n\n  /** Case priority (low | medium | high | critical). */\n  priority(value: CasePriority): void {\n    send({ type: 'priority', value });\n  },\n\n  /** A named input. Inside an open `step()` it attaches to that step;\n   * outside any step it lands in the case's properties. `masked` is a\n   * display hint for the UI only — the server does not redact the value. */\n  parameter(name: string, value?: string, opts?: { masked?: boolean }): void {\n    send({ type: 'parameter', name, value, masked: opts?.masked });\n  },\n\n  /** Attach in-memory content. */\n  attachment(name: string, content: string, opts?: { encoding?: 'utf8' | 'base64'; mimeType?: string }): void {\n    const contentBase64 = opts?.encoding === 'base64' ? content : Buffer.from(content, 'utf8').toString('base64');\n    send({ type: 'attachment', name, contentBase64, mimeType: opts?.mimeType });\n  },\n\n  /** Attach a file from disk. */\n  attachmentFromFile(name: string, path: string, opts?: { mimeType?: string }): void {\n    send({ type: 'attachment_from_file', name, path, mimeType: opts?.mimeType });\n  },\n\n  /**\n   * Records a named step around `fn`.\n   *\n   * Unlike the cucumber-js equivalent, this delegates to Playwright's own\n   * `test.step()` as well, so the step shows up in Playwright's HTML report\n   * and trace viewer in addition to Qualflare — there is no reason to make\n   * users choose, and a step that exists in only one of the two is a\n   * confusing thing to debug against.\n   */\n  async step<T>(name: string, fn: () => T | Promise<T>): Promise<T> {\n    return test.step(name, async () => {\n      send({ type: 'step_start', name, timestamp: Date.now() });\n      try {\n        const result = await fn();\n        send({ type: 'step_stop', status: 'passed', timestamp: Date.now() });\n        return result;\n      } catch (err) {\n        send({\n          type: 'step_stop',\n          status: 'failed',\n          error: err instanceof Error ? err.message : String(err),\n          timestamp: Date.now(),\n        });\n        throw err;\n      }\n    });\n  },\n};\n","/**\n * Shared constants used across the reporter and the author-facing runtime\n * API.\n */\n\n/** Reserved `testInfo.attach()` content type used to smuggle structured\n * `qualflare.*()` calls (label/tag/step/etc.) from test and hook code back to\n * the reporter — the only channel Playwright gives user code back to a\n * running reporter. The reporter recognizes this exact content type and\n * replays the message as a model mutation instead of reporting it as a\n * literal attachment. */\nexport const RESERVED_MESSAGE_MEDIA_TYPE = 'application/vnd.qualflare.message+json';\n\n/** Server-side caps this client should respect defensively (see\n * `api-service/internal/core/domain/launch/launch.go`). */\nexport const MAX_SUITES_PER_LAUNCH = 2000;\nexport const MAX_CASES_PER_SUITE = 5000;\nexport const MAX_STEPS_PER_CASE = 1000;\nexport const MAX_PARAMETERS_PER_STEP = 50;\nexport const MAX_ATTACHMENTS_PER_CASE = 50;\nexport const MAX_LABELS_PER_CASE = 100;\nexport const MAX_LINKS_PER_CASE = 20;\nexport const MAX_TAGS_PER_CASE = 64;\nexport const MAX_TAG_LENGTH = 255;\n\n/** Mirrors `launch.MaxCaseAttempts`. Beyond this the server keeps the first\n * 49 attempts plus the final one and drops the middle, so sending more is\n * wasted payload rather than an error. */\nexport const MAX_ATTEMPTS_PER_CASE = 50;\n\n/** Mirrors the server's per-attempt text bounds (`launch.MaxAttempt*Runes`).\n *\n * Clamped CLIENT-side, not left to the server, because attempts are the only\n * repeated-per-case payload with no size budget of its own. Measured: one\n * retried test with a deep stack and a chatty log serializes to ~630KB\n * unclamped — most of it text the server discards on write — against a 10MB\n * request body limit that, once exceeded, loses the ENTIRE launch. Sending\n * bytes the server will throw away is pure risk. */\nexport const MAX_ATTEMPT_MESSAGE_RUNES = 8192;\nexport const MAX_ATTEMPT_TRACE_RUNES = 32768;\nexport const MAX_ATTEMPT_SNIPPET_RUNES = 4096;\nexport const MAX_ATTEMPT_OUTPUT_RUNES = 16384;\nexport const MAX_ATTEMPT_OUTPUT_LINES = 200;\n\n/** Mirrors `launch.MaxAttachmentUploadFileSize` — the server's hard cap on a\n * single `POST /api/v1/attachments/upload-url` request (video). */\nexport const MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;\n\n/** Cap on one Playwright trace zip. Matches MAX_VIDEO_UPLOAD_BYTES because both\n * end up at the same server-side limit: the attachment upload endpoint rejects\n * anything past 50MB regardless of kind. Copying a larger trace would only\n * defer the rejection to collect time, after the bytes were already written. */\nexport const MAX_TRACE_UPLOAD_BYTES = 50 * 1024 * 1024;\n\n/** Client-side SOFT cap on steps recorded per scenario attempt — well under\n * the server's 1000-per-case hard cap (`MAX_STEPS_PER_CASE`). Once hit,\n * further steps within that attempt are dropped (with a one-time warning),\n * not queued and truncated later. */\nexport const MAX_STEPS_PER_TEST_ATTEMPT = 300;\n","/**\n * A minimal logger writing to stderr. Deliberately avoids stdout, since\n * that's typically Playwright's own reporter output stream and shouldn't be\n * polluted with reporter diagnostics.\n */\n\nconst PREFIX = '[qualflare-playwright]';\n\nexport const logger = {\n  debug(...args: unknown[]): void {\n    console.debug(PREFIX, ...args);\n  },\n  info(...args: unknown[]): void {\n    console.log(PREFIX, ...args);\n  },\n  warn(...args: unknown[]): void {\n    console.warn(PREFIX, ...args);\n  },\n  error(...args: unknown[]): void {\n    console.error(PREFIX, ...args);\n  },\n};\n","import type { ReporterDescription } from '@playwright/test';\n\nimport type { QualflarePlaywrightOptions } from './config/resolve-config.js';\n\nexport { qualflare } from './runtime/qualflare-api.js';\n\nexport type { QualflarePlaywrightOptions, ResolvedReporterConfig } from './config/resolve-config.js';\n\nexport type {\n  Attachment,\n  Case,\n  CasePriority,\n  CaseStatus,\n  Collect,\n  FrameworkCategory,\n  Label,\n  Link,\n  LinkType,\n  Metadata,\n  NanosecondDuration,\n  Parameter,\n  Platform,\n  Step,\n  Suite,\n} from './shared/types.js';\n\n/**\n * Typed helper for registering the reporter.\n *\n * Playwright types a reporter's options as `any` (`ReporterDescription` ends\n * in `[string, any]`), so writing the tuple by hand gives no autocomplete and\n * silently accepts typos. This returns the same tuple with the options\n * checked:\n *\n * ```ts\n * import { defineConfig } from '@playwright/test';\n * import { qualflareReporter } from '@qualflare/playwright';\n *\n * export default defineConfig({\n *   reporter: [['list'], qualflareReporter({ environment: 'staging' })],\n * });\n * ```\n */\nexport function qualflareReporter(options: QualflarePlaywrightOptions = {}): ReporterDescription {\n  return ['@qualflare/playwright/reporter', options];\n}\n"],"mappings":"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","names":[]}

package/dist/reporter/index.cjs

@@ -58,6 +58,7 @@ var MAX_ATTEMPT_SNIPPET_RUNES = 4096;
 var MAX_ATTEMPT_OUTPUT_RUNES = 16384;
 var MAX_ATTEMPT_OUTPUT_LINES = 200;
 var MAX_VIDEO_UPLOAD_BYTES = 50 * 1024 * 1024;
+var MAX_TRACE_UPLOAD_BYTES = 50 * 1024 * 1024;
 var MAX_STEPS_PER_TEST_ATTEMPT = 300;
 
 // src/config/ci-detect.ts
@@ -285,6 +286,7 @@ function resolveConfig(options, deps = {}) {
     maxAttachmentBytes: options.maxAttachmentBytes ?? envInt("QUALFLARE_MAX_ATTACHMENT_BYTES") ?? 15e5,
     maxTotalAttachmentBytes: options.maxTotalAttachmentBytes ?? envInt("QUALFLARE_MAX_TOTAL_ATTACHMENT_BYTES") ?? 75e4,
     maxVideoBytes: options.maxVideoBytes ?? envInt("QUALFLARE_MAX_VIDEO_BYTES") ?? MAX_VIDEO_UPLOAD_BYTES,
+    maxTraceBytes: options.maxTraceBytes ?? envInt("QUALFLARE_MAX_TRACE_BYTES") ?? MAX_TRACE_UPLOAD_BYTES,
     debug: options.debug ?? envBool("QUALFLARE_DEBUG", "QF_DEBUG") ?? false,
     enabled,
     outputDir,
@@ -321,35 +323,51 @@ var VIDEO_MIME_TYPES_BY_EXTENSION = {
   ".webm": "video/webm",
   ".mov": "video/quicktime"
 };
-function copyVideoAttachment(filePath, outputDir, maxVideoBytes) {
-  const ext = path.extname(filePath).toLowerCase();
-  const mimeType = VIDEO_MIME_TYPES_BY_EXTENSION[ext];
-  if (!mimeType) {
-    logger.warn(`skipping video attachment "${filePath}": unsupported video format.`);
-    return void 0;
-  }
+var TRACE_MIME_TYPE = "application/zip";
+var TRACE_EXTENSION = ".zip";
+function copyArtifact(filePath, outputDir, maxBytes, ext, capName, label) {
   let fileSize;
   try {
     fileSize = fs.statSync(filePath).size;
   } catch (err) {
-    logger.warn(`skipping video attachment "${filePath}": could not stat file: ${err.message}`);
+    logger.warn(`skipping ${label} attachment "${filePath}": could not stat file: ${err.message}`);
     return void 0;
   }
-  if (fileSize > maxVideoBytes) {
+  if (fileSize > maxBytes) {
     logger.warn(
-      `skipping video attachment "${filePath}": ${fileSize} bytes exceeds the configured maxVideoBytes cap of ${maxVideoBytes} bytes.`
+      `skipping ${label} attachment "${filePath}": ${fileSize} bytes exceeds the configured ${capName} cap of ${maxBytes} bytes.`
     );
     return void 0;
   }
-  const localVideoPath = `${(0, import_node_crypto2.randomUUID)()}${ext}`;
+  const localPath = `${(0, import_node_crypto2.randomUUID)()}${ext}`;
   try {
     fs.mkdirSync(outputDir, { recursive: true });
-    fs.copyFileSync(filePath, path.join(outputDir, localVideoPath));
+    fs.copyFileSync(filePath, path.join(outputDir, localPath));
   } catch (err) {
-    logger.warn(`skipping video attachment "${filePath}": could not copy file: ${err.message}`);
+    logger.warn(`skipping ${label} attachment "${filePath}": could not copy file: ${err.message}`);
+    return void 0;
+  }
+  return { localPath, fileSize };
+}
+function copyVideoAttachment(filePath, outputDir, maxVideoBytes) {
+  const ext = path.extname(filePath).toLowerCase();
+  const mimeType = VIDEO_MIME_TYPES_BY_EXTENSION[ext];
+  if (!mimeType) {
+    logger.warn(`skipping video attachment "${filePath}": unsupported video format.`);
     return void 0;
   }
-  return { localVideoPath, fileSize, mimeType };
+  const copied = copyArtifact(filePath, outputDir, maxVideoBytes, ext, "maxVideoBytes", "video");
+  if (!copied) {
+    return void 0;
+  }
+  return { localVideoPath: copied.localPath, fileSize: copied.fileSize, mimeType };
+}
+function copyTraceAttachment(filePath, outputDir, maxTraceBytes) {
+  const copied = copyArtifact(filePath, outputDir, maxTraceBytes, TRACE_EXTENSION, "maxTraceBytes", "trace");
+  if (!copied) {
+    return void 0;
+  }
+  return { localTracePath: copied.localPath, fileSize: copied.fileSize, mimeType: TRACE_MIME_TYPE };
 }
 
 // src/reporter/attachment-reader.ts
@@ -379,6 +397,7 @@ var AttachmentBudget = class {
 };
 var NAME_VIDEO = "video";
 var NAME_TRACE = "trace";
+var TRACE_CONTENT_TYPE = "application/zip";
 function isVideo(a) {
   return a.name === NAME_VIDEO || (a.contentType?.startsWith("video/") ?? false);
 }
@@ -399,7 +418,20 @@ function resolveAttachments(result, config, budget) {
       }
       break;
     }
-    if (a.name === NAME_TRACE || a.contentType === "application/zip") {
+    if (a.name === NAME_TRACE || a.contentType === TRACE_CONTENT_TYPE) {
+      if (!a.path) {
+        logger.warn(`skipping in-memory trace attachment "${a.name}": only file-backed traces are supported.`);
+        continue;
+      }
+      const copied = copyTraceAttachment(a.path, config.outputDir, config.maxTraceBytes);
+      if (copied) {
+        out.push({
+          name: a.name,
+          mimeType: copied.mimeType,
+          localTracePath: copied.localTracePath,
+          fileSize: copied.fileSize
+        });
+      }
       continue;
     }
     if (isVideo(a)) {
@@ -829,7 +861,7 @@ function buildCase(test, config, attachmentsByResult, budget) {
 var os = __toESM(require("os"), 1);
 
 // src/config/version.ts
-var PACKAGE_VERSION = "0.3.0";
+var PACKAGE_VERSION = "0.4.0";
 
 // src/reporter/collect-builder.ts
 function resolveOs(config) {
@@ -1020,7 +1052,8 @@ var QualflareReporter = class {
     return path3.isAbsolute(outputDir) ? outputDir : path3.resolve(this.options.configDir ?? this.rootDir, outputDir);
   }
   /** Drops everything an earlier, now-superseded attempt produced: deletes the
-   * video copied into outputDir and refunds its bytes to the run budget. */
+   * video or trace copied into outputDir and refunds its bytes to the run
+   * budget. */
   discardSupersededAttempt(testId, retry, outputDir) {
     const previous = this.latestAttemptByTest.get(testId);
     if (previous === void 0 || previous >= retry) {
@@ -1028,9 +1061,10 @@ var QualflareReporter = class {
     }
     const key = `${testId}:${previous}`;
     for (const attachment of this.attachmentsByResult.get(key) ?? []) {
-      if (attachment.localVideoPath) {
+      const orphan = attachment.localVideoPath ?? attachment.localTracePath;
+      if (orphan) {
         try {
-          fs3.rmSync(path3.join(this.resolveOutputDir(outputDir), attachment.localVideoPath), { force: true });
+          fs3.rmSync(path3.join(this.resolveOutputDir(outputDir), orphan), { force: true });
         } catch {
         }
       }