@midleman/playwright-reporter 0.1.0

package/README.md

@@ -0,0 +1,373 @@
+# @midleman/playwright-reporter
+
+A Playwright reporter that writes test results directly to Parquet files on S3 or local filesystem.
+
+## Overview
+
+This reporter collects Playwright test results and writes them as Parquet files to S3 or local filesystem for analysis with DuckDB.
+
+## Installation
+
+### Production (Published Package)
+
+```bash
+npm install @midleman/playwright-reporter
+```
+
+### Local Development (Linked Package)
+
+For iterating on the reporter locally, use npm link:
+
+```bash
+# In e2e-test-insights repo - build and link
+cd packages/playwright-reporter
+npm install
+npm run build
+npm link
+
+# In your test project (e.g., positron) - use the link
+npm link @midleman/playwright-reporter
+```
+
+> **Note:** After making changes to the reporter, run `npm run build` to update the linked package.
+
+## Configuration
+
+### Via Playwright Config
+
+```typescript
+// playwright.config.ts
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+    reporter: [
+        ['html'],
+        [
+            '@midleman/playwright-reporter',
+            {
+                mode: 'dev',      // 'dev', 'prod', or 'disabled'
+                verbose: true,    // Enable debug logging
+            },
+        ],
+    ],
+});
+```
+
+> **Note:** If using from another repository, see [Using from Another Repository](#using-from-another-repository) for setup instructions.
+
+### Reporter Mode
+
+The `mode` option (required) controls where results are sent:
+
+| Mode       | API Endpoint                                    | Use Case                    | CI Required? |
+| ---------- | ----------------------------------------------- | --------------------------- | ------------ |
+| `dev`      | `http://localhost:8000`                         | Local development           | No           |
+| `prod`     | `https://connect.posit.it/e2e-test-insights-api`| CI/Production               | **Yes**      |
+| `disabled` | None                                            | Skip reporting              | No           |
+
+**Important:**
+- `mode: 'prod'` only works in CI environments (GitHub Actions or `CI=true`). If used locally, it will log a warning and disable reporting.
+- `mode: 'dev'` works anywhere and sends to your local API.
+- The reporter sends data to the Plumber API, which then writes to storage (local or S3). Make sure your API is running with matching storage mode:
+  - `mode: 'dev'` → run API with `npm run api` (local) or `npm run api:s3` (S3)
+  - `mode: 'prod'` → uses deployed Posit Connect API (CI only)
+
+### Environment Variables
+
+| Variable              | Description                              | Default                  |
+| --------------------- | ---------------------------------------- | ------------------------ |
+| `E2E_REPORTER_MODE`   | Reporter mode: `dev`, `prod`, `disabled` | (none - required)        |
+| `REPORTER_REPO_NAME`  | Repository name override                 | From `GITHUB_REPOSITORY` |
+| `E2E_REPORTER_VERBOSE`| Enable debug logging (`1` or `0`)        | `0`                      |
+
+## Output Structure
+
+```
+s3://{bucket}/{prefix}/
+└── {repoName}/
+    └── {date}/                    # YYYY-MM-DD partition
+        └── {runId}/
+            ├── run.parquet        # Run metadata (started + completed)
+            ├── results.parquet    # Consolidated test results (written on completion)
+            ├── results-001.parquet # Incremental flush 1 (for live updates)
+            ├── results-002.parquet # Incremental flush 2
+            └── results-XXX.parquet # etc.
+```
+
+**File types:**
+- `results.parquet` - Single file with all deduplicated test results (final state). Best for querying.
+- `results-XXX.parquet` - Incremental files written during the run for live viewing. May contain duplicates from retries.
+
+## Parquet Schemas
+
+### results.parquet
+
+| Column           | Type   | Description                               |
+| ---------------- | ------ | ----------------------------------------- |
+| `type`           | UTF8   | Always `result.created`                   |
+| `repoName`       | UTF8   | Repository name                           |
+| `runId`          | UTF8   | Unique run identifier                     |
+| `specPath`       | UTF8   | Relative path to spec file                |
+| `project`        | UTF8?  | Playwright project name                   |
+| `testName`       | UTF8   | Test title                                |
+| `testId`         | UTF8?  | Test identifier                           |
+| `status`         | UTF8   | `passed`, `failed`, `skipped`, or `flaky` |
+| `durationMs`     | INT64? | Test duration in milliseconds             |
+| `startedAt`      | UTF8?  | ISO timestamp when test started           |
+| `attempt`        | INT32? | Retry attempt number (1-indexed)          |
+| `retries`        | INT32? | Total retries configured                  |
+| `failureMessage` | UTF8?  | Error message if failed                   |
+| `eventId`        | UTF8   | Idempotent event ID for deduplication     |
+| `timestamp`      | UTF8   | ISO timestamp when event was created      |
+| `browser`        | UTF8?  | Browser name (chromium, firefox, etc.)    |
+| `os`             | UTF8?  | Operating system (mac, win, linux)        |
+| `branch`         | UTF8?  | Git branch name                           |
+| `sha`            | UTF8?  | Git commit SHA                            |
+
+### run.parquet
+
+Contains both `run.started` and `run.completed` events:
+
+| Column          | Type   | Description                      |
+| --------------- | ------ | -------------------------------- |
+| `type`          | UTF8   | `run.started` or `run.completed` |
+| `repoName`      | UTF8   | Repository name                  |
+| `runId`         | UTF8   | Unique run identifier            |
+| `startedAt`     | UTF8?  | ISO timestamp (run.started)      |
+| `branch`        | UTF8?  | Git branch name                  |
+| `sha`           | UTF8?  | Git commit SHA                   |
+| `workflowName`  | UTF8?  | GitHub workflow name             |
+| `jobName`       | UTF8?  | GitHub job name                  |
+| `runUrl`        | UTF8?  | GitHub Actions run URL           |
+| `completedAt`   | UTF8?  | ISO timestamp (run.completed)    |
+| `status`        | UTF8?  | Final status (run.completed)     |
+| `durationMs`    | INT64? | Total duration (run.completed)   |
+| `countsPassed`  | INT32? | Passed test count                |
+| `countsFailed`  | INT32? | Failed test count                |
+| `countsSkipped` | INT32? | Skipped test count               |
+| `countsFlaky`   | INT32? | Flaky test count                 |
+
+## Querying with DuckDB
+
+```sql
+-- Query all results from a date range
+SELECT * FROM read_parquet('s3://bucket/test-results/positron/2024-01-*/*/results.parquet');
+
+-- Get failure summary by spec
+SELECT
+  specPath,
+  COUNT(*) as total,
+  SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) as failures
+FROM read_parquet('s3://bucket/test-results/positron/**/results.parquet')
+GROUP BY specPath
+ORDER BY failures DESC;
+
+-- Get run summaries
+SELECT * FROM read_parquet('s3://bucket/test-results/positron/**/run.parquet')
+WHERE type = 'run.completed';
+```
+
+## Usage in Other Repositories
+
+### Production Setup (CI)
+
+For CI/production, install the published package:
+
+```bash
+npm install @midleman/playwright-reporter
+```
+
+Configure Playwright with `mode: 'prod'`:
+
+```typescript
+// playwright.config.ts
+export default defineConfig({
+    reporter: [
+        ['html'],
+        [
+            '@midleman/playwright-reporter',
+            {
+                repoName: 'positron',
+                mode: 'prod',  // Sends to connect.posit.it API (CI only)
+            },
+        ],
+    ],
+});
+```
+
+> **Note:** `mode: 'prod'` requires a CI environment (`GITHUB_ACTIONS=true` or `CI=true`). This prevents local test runs from accidentally sending data to production.
+
+### Local Testing Setup
+
+For testing the reporter locally before publishing:
+
+**1. Link the package** (see [Installation](#local-development-linked-package))
+
+**2. Start the local API** (in e2e-test-insights repo):
+
+```bash
+npm run api        # Local storage
+# OR
+npm run api:s3     # S3 storage (requires aws sso login)
+```
+
+**3. Configure Playwright with `mode: 'dev'`:**
+
+```typescript
+// playwright.config.ts
+export default defineConfig({
+    reporter: [
+        ['html'],
+        [
+            '@midleman/playwright-reporter',
+            {
+                repoName: 'positron',
+                mode: 'dev',     // Sends to localhost:8000
+                verbose: true,   // See debug output
+            },
+        ],
+    ],
+});
+```
+
+**4. Run tests:**
+
+```bash
+npx playwright test
+```
+
+Results are sent to your local API.
+
+## Local Development
+
+```bash
+# 1. Start the API (in e2e-test-insights repo)
+npm run api
+
+# 2. Run tests with reporter in dev mode
+npx playwright test
+
+# 3. View the dashboard
+npm run app
+```
+
+For verbose logging, set `verbose: true` in your playwright config.
+
+## Multi-Worker Support
+
+This reporter is safe for parallel execution:
+
+- Each worker writes to the same `{runId}` directory
+- Idempotent `eventId` enables deduplication at query time
+- DuckDB can query across all files with glob patterns
+
+## GitHub Actions Integration
+
+In CI environments (GitHub Actions or `CI=true`), use `mode: 'prod'` to send results to the deployed API:
+
+```typescript
+[
+    '@midleman/playwright-reporter',
+    {
+        mode: 'prod',  // Sends to connect.posit.it/e2e-test-insights-api (CI only)
+    },
+],
+```
+
+> **Note:** `mode: 'prod'` is designed for CI only. If you accidentally run with `mode: 'prod'` locally, the reporter will log a warning and disable itself to prevent local test runs from polluting production data.
+
+The reporter automatically extracts metadata from GitHub Actions environment:
+
+- Branch name from `GITHUB_REF` or `GITHUB_HEAD_REF`
+- Commit SHA from `GITHUB_SHA`
+- Workflow name from `GITHUB_WORKFLOW`
+- Job name from `GITHUB_JOB`
+- Run URL constructed from GitHub environment variables
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run watch
+
+# Clean
+npm run clean
+```
+
+## Testing
+
+Unit tests use [Vitest](https://vitest.dev/) and cover:
+
+- **reporter.test.ts** - Reporter lifecycle (init, begin, end, test events)
+- **payload.test.ts** - Event payload builders (result.created, run.started, run.completed)
+- **schemas.test.ts** - Zod schema validation
+- **api.test.ts** - API writer with retry logic
+- **utils.test.ts** - Utility functions (ID generation, path handling, browser inference)
+
+```bash
+# Run tests once
+npm test
+
+# Watch mode (re-runs on file changes)
+npm run test:watch
+
+# With coverage report
+npm run test:coverage
+```
+
+### Test Structure
+
+Tests are co-located with source files (`*.test.ts`). The test configuration is in `vitest.config.ts`:
+
+- Environment: Node
+- Globals: enabled (`describe`, `it`, `expect` available without imports)
+- Coverage: v8 provider, excludes test files and index.ts
+
+## Publishing
+
+To publish a new version to npm:
+
+### Prerequisites
+
+- npm account with access to the `@posit-dev` organization
+- Logged in via `npm login`
+
+### Publish Steps
+
+```bash
+cd packages/playwright-reporter
+
+# 1. Ensure tests pass
+npm test
+
+# 2. Build the package
+npm run build
+
+# 3. Preview what will be published
+npm pack --dry-run
+
+# 4. Bump version (choose one)
+npm version patch  # 0.1.0 → 0.1.1 (bug fixes)
+npm version minor  # 0.1.0 → 0.2.0 (new features)
+npm version major  # 0.1.0 → 1.0.0 (breaking changes)
+
+# 5. Publish to npm (scoped packages require --access public)
+npm publish --access public
+
+# 6. Push the version commit and tag
+git push && git push --tags
+```
+
+### Updating in Consumer Repos
+
+After publishing, update the package in repos that use it:
+
+```bash
+npm update @midleman/playwright-reporter
+```

package/dist/buffers.d.ts

@@ -0,0 +1,13 @@
+import { ResultCreatedEvent } from './types';
+export type SpecBuffer = Map<string, ResultCreatedEvent>;
+export type Buffers = Map<string, SpecBuffer>;
+export declare function ensureSpec(buffers: Buffers, spec: string): SpecBuffer;
+export declare function setTest(buffers: Buffers, spec: string, testKey: string, payload: ResultCreatedEvent): void;
+export declare function getSpec(buffers: Buffers, spec: string): SpecBuffer | undefined;
+export declare function deleteTest(buffers: Buffers, spec: string, testKey: string): void;
+export declare function deleteSpec(buffers: Buffers, spec: string): void;
+export declare function specValues(buffers: Buffers, spec: string): ResultCreatedEvent[];
+export declare function specSize(buffers: Buffers, spec: string): number;
+export declare function listSpecs(buffers: Buffers): string[];
+export declare function allValues(buffers: Buffers): ResultCreatedEvent[];
+//# sourceMappingURL=buffers.d.ts.map

package/dist/buffers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffers.d.ts","sourceRoot":"","sources":["../src/buffers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACzD,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE9C,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAOrE;AAED,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,QAI5B;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAKzE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,QAExD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAG/E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAEpD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAQhE"}

package/dist/buffers.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSpec = ensureSpec;
+exports.setTest = setTest;
+exports.getSpec = getSpec;
+exports.deleteTest = deleteTest;
+exports.deleteSpec = deleteSpec;
+exports.specValues = specValues;
+exports.specSize = specSize;
+exports.listSpecs = listSpecs;
+exports.allValues = allValues;
+function ensureSpec(buffers, spec) {
+    let m = buffers.get(spec);
+    if (!m) {
+        m = new Map();
+        buffers.set(spec, m);
+    }
+    return m;
+}
+function setTest(buffers, spec, testKey, payload) {
+    const m = ensureSpec(buffers, spec);
+    m.set(testKey, payload);
+}
+function getSpec(buffers, spec) {
+    return buffers.get(spec);
+}
+function deleteTest(buffers, spec, testKey) {
+    const m = buffers.get(spec);
+    if (!m)
+        return;
+    m.delete(testKey);
+    if (m.size === 0)
+        buffers.delete(spec);
+}
+function deleteSpec(buffers, spec) {
+    buffers.delete(spec);
+}
+function specValues(buffers, spec) {
+    const m = buffers.get(spec);
+    return m ? Array.from(m.values()) : [];
+}
+function specSize(buffers, spec) {
+    const m = buffers.get(spec);
+    return m ? m.size : 0;
+}
+function listSpecs(buffers) {
+    return Array.from(buffers.keys());
+}
+function allValues(buffers) {
+    const results = [];
+    for (const specMap of buffers.values()) {
+        for (const result of specMap.values()) {
+            results.push(result);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=buffers.js.map

package/dist/buffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffers.js","sourceRoot":"","sources":["../src/buffers.ts"],"names":[],"mappings":";;AAKA,gCAOC;AAED,0BAQC;AAED,0BAEC;AAED,gCAKC;AAED,gCAEC;AAED,gCAGC;AAED,4BAGC;AAED,8BAEC;AAED,8BAQC;AAxDD,SAAgB,UAAU,CAAC,OAAgB,EAAE,IAAY;IACvD,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,IAAI,GAAG,EAA8B,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAgB,OAAO,CACrB,OAAgB,EAChB,IAAY,EACZ,OAAe,EACf,OAA2B;IAE3B,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,OAAO,CAAC,OAAgB,EAAE,IAAY;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,UAAU,CAAC,OAAgB,EAAE,IAAY,EAAE,OAAe;IACxE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO;IACf,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,UAAU,CAAC,OAAgB,EAAE,IAAY;IACvD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,SAAgB,UAAU,CAAC,OAAgB,EAAE,IAAY;IACvD,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,QAAQ,CAAC,OAAgB,EAAE,IAAY;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAgB,SAAS,CAAC,OAAgB;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,SAAS,CAAC,OAAgB;IACxC,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/counts.d.ts

@@ -0,0 +1,32 @@
+import { ResultCreatedEvent, ResultStatus } from './types';
+export interface CountsState {
+    countedStatusPerTest: Map<string, ResultStatus>;
+    totalPassed: number;
+    totalFailed: number;
+    totalSkipped: number;
+    totalFlaky: number;
+    buffers: Map<string, Map<string, ResultCreatedEvent>>;
+}
+/**
+ * Update run-level totals for a single test key idempotently.
+ */
+export declare function updateRunTotalsForTest(state: CountsState, testKey: string, now: ResultStatus): void;
+/**
+ * Compute live counts starting from finalized totals and including buffered results.
+ */
+export declare function getLiveCounts(state: CountsState): {
+    passed: number;
+    failed: number;
+    skipped: number;
+    flaky: number;
+};
+/**
+ * Get final counts for run completion.
+ */
+export declare function getFinalCounts(state: CountsState): {
+    passed: number;
+    failed: number;
+    skipped: number;
+    flaky: number;
+};
+//# sourceMappingURL=counts.d.ts.map

package/dist/counts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.d.ts","sourceRoot":"","sources":["../src/counts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,YAAY,QAgBlB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW;;;;;EAiB/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW;;;;;EAOhD"}

package/dist/counts.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateRunTotalsForTest = updateRunTotalsForTest;
+exports.getLiveCounts = getLiveCounts;
+exports.getFinalCounts = getFinalCounts;
+/**
+ * Update run-level totals for a single test key idempotently.
+ */
+function updateRunTotalsForTest(state, testKey, now) {
+    const prev = state.countedStatusPerTest.get(testKey);
+    if (prev !== now) {
+        if (prev === 'flaky')
+            state.totalFlaky = Math.max(0, state.totalFlaky - 1);
+        else if (prev === 'passed')
+            state.totalPassed = Math.max(0, state.totalPassed - 1);
+        else if (prev === 'failed')
+            state.totalFailed = Math.max(0, state.totalFailed - 1);
+        else if (prev === 'skipped')
+            state.totalSkipped = Math.max(0, state.totalSkipped - 1);
+        if (now === 'flaky')
+            state.totalFlaky += 1;
+        else if (now === 'passed')
+            state.totalPassed += 1;
+        else if (now === 'failed')
+            state.totalFailed += 1;
+        else if (now === 'skipped')
+            state.totalSkipped += 1;
+        state.countedStatusPerTest.set(testKey, now);
+    }
+}
+/**
+ * Compute live counts starting from finalized totals and including buffered results.
+ */
+function getLiveCounts(state) {
+    let passed = state.totalPassed;
+    const failed = state.totalFailed;
+    let skipped = state.totalSkipped;
+    let flaky = state.totalFlaky;
+    for (const specMap of state.buffers.values()) {
+        for (const p of specMap.values()) {
+            const s = p.status;
+            if (!s)
+                continue;
+            if (s === 'passed')
+                passed += 1;
+            else if (s === 'flaky')
+                flaky += 1;
+            else if (s === 'skipped')
+                skipped += 1;
+            // do not count interim 'failed' attempts here
+        }
+    }
+    return { passed, failed, skipped, flaky };
+}
+/**
+ * Get final counts for run completion.
+ */
+function getFinalCounts(state) {
+    return {
+        passed: state.totalPassed,
+        failed: state.totalFailed,
+        skipped: state.totalSkipped,
+        flaky: state.totalFlaky,
+    };
+}
+//# sourceMappingURL=counts.js.map

package/dist/counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.js","sourceRoot":"","sources":["../src/counts.ts"],"names":[],"mappings":";;AAcA,wDAmBC;AAKD,sCAiBC;AAKD,wCAOC;AAxDD;;GAEG;AACH,SAAgB,sBAAsB,CACpC,KAAkB,EAClB,OAAe,EACf,GAAiB;IAEjB,MAAM,IAAI,GAAG,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,IAAI,IAAI,KAAK,OAAO;YAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;aACtE,IAAI,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;aAC9E,IAAI,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;aAC9E,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QAEtF,IAAI,GAAG,KAAK,OAAO;YAAE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;aACtC,IAAI,GAAG,KAAK,QAAQ;YAAE,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;aAC7C,IAAI,GAAG,KAAK,QAAQ;YAAE,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;aAC7C,IAAI,GAAG,KAAK,SAAS;YAAE,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAEpD,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAkB;IAC9C,IAAI,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;IACjC,IAAI,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC;IACjC,IAAI,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,CAAC,MAA4B,CAAC;YACzC,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,IAAI,CAAC,KAAK,QAAQ;gBAAE,MAAM,IAAI,CAAC,CAAC;iBAC3B,IAAI,CAAC,KAAK,OAAO;gBAAE,KAAK,IAAI,CAAC,CAAC;iBAC9B,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,CAAC;YACvC,8CAA8C;QAChD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAkB;IAC/C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,WAAW;QACzB,MAAM,EAAE,KAAK,CAAC,WAAW;QACzB,OAAO,EAAE,KAAK,CAAC,YAAY;QAC3B,KAAK,EAAE,KAAK,CAAC,UAAU;KACxB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { default } from './reporter';
+export { default as ParquetReporter } from './reporter';
+export type { ReporterOptions, ReporterMode } from './types';
+export type { ResultStatus, ResultCreatedEvent, RunStartedEvent, RunCompletedEvent, Counts } from './schemas';
+export { SCHEMA_VERSION, ResultStatusSchema, ResultCreatedEventSchema, RunStartedEventSchema, RunCompletedEventSchema, CountsSchema, OutboundEventSchema, } from './schemas';
+export { validateResultEvent, validateRunStartedEvent, validateRunCompletedEvent, safeValidateResultEvent, safeValidateRunStartedEvent, safeValidateRunCompletedEvent, } from './schemas';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AAGxD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAG9G,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeValidateRunCompletedEvent = exports.safeValidateRunStartedEvent = exports.safeValidateResultEvent = exports.validateRunCompletedEvent = exports.validateRunStartedEvent = exports.validateResultEvent = exports.OutboundEventSchema = exports.CountsSchema = exports.RunCompletedEventSchema = exports.RunStartedEventSchema = exports.ResultCreatedEventSchema = exports.ResultStatusSchema = exports.SCHEMA_VERSION = exports.ParquetReporter = exports.default = void 0;
+var reporter_1 = require("./reporter");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(reporter_1).default; } });
+var reporter_2 = require("./reporter");
+Object.defineProperty(exports, "ParquetReporter", { enumerable: true, get: function () { return __importDefault(reporter_2).default; } });
+// Zod schemas (for consumers who want to validate their own payloads)
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "SCHEMA_VERSION", { enumerable: true, get: function () { return schemas_1.SCHEMA_VERSION; } });
+Object.defineProperty(exports, "ResultStatusSchema", { enumerable: true, get: function () { return schemas_1.ResultStatusSchema; } });
+Object.defineProperty(exports, "ResultCreatedEventSchema", { enumerable: true, get: function () { return schemas_1.ResultCreatedEventSchema; } });
+Object.defineProperty(exports, "RunStartedEventSchema", { enumerable: true, get: function () { return schemas_1.RunStartedEventSchema; } });
+Object.defineProperty(exports, "RunCompletedEventSchema", { enumerable: true, get: function () { return schemas_1.RunCompletedEventSchema; } });
+Object.defineProperty(exports, "CountsSchema", { enumerable: true, get: function () { return schemas_1.CountsSchema; } });
+Object.defineProperty(exports, "OutboundEventSchema", { enumerable: true, get: function () { return schemas_1.OutboundEventSchema; } });
+// Validation helpers
+var schemas_2 = require("./schemas");
+Object.defineProperty(exports, "validateResultEvent", { enumerable: true, get: function () { return schemas_2.validateResultEvent; } });
+Object.defineProperty(exports, "validateRunStartedEvent", { enumerable: true, get: function () { return schemas_2.validateRunStartedEvent; } });
+Object.defineProperty(exports, "validateRunCompletedEvent", { enumerable: true, get: function () { return schemas_2.validateRunCompletedEvent; } });
+Object.defineProperty(exports, "safeValidateResultEvent", { enumerable: true, get: function () { return schemas_2.safeValidateResultEvent; } });
+Object.defineProperty(exports, "safeValidateRunStartedEvent", { enumerable: true, get: function () { return schemas_2.safeValidateRunStartedEvent; } });
+Object.defineProperty(exports, "safeValidateRunCompletedEvent", { enumerable: true, get: function () { return schemas_2.safeValidateRunCompletedEvent; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAqC;AAA5B,oHAAA,OAAO,OAAA;AAChB,uCAAwD;AAA/C,4HAAA,OAAO,OAAmB;AAMnC,sEAAsE;AACtE,qCAQmB;AAPjB,yGAAA,cAAc,OAAA;AACd,6GAAA,kBAAkB,OAAA;AAClB,mHAAA,wBAAwB,OAAA;AACxB,gHAAA,qBAAqB,OAAA;AACrB,kHAAA,uBAAuB,OAAA;AACvB,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA;AAGrB,qBAAqB;AACrB,qCAOmB;AANjB,8GAAA,mBAAmB,OAAA;AACnB,kHAAA,uBAAuB,OAAA;AACvB,oHAAA,yBAAyB,OAAA;AACzB,kHAAA,uBAAuB,OAAA;AACvB,sHAAA,2BAA2B,OAAA;AAC3B,wHAAA,6BAA6B,OAAA"}

package/dist/payload.d.ts

@@ -0,0 +1,33 @@
+import type { TestCase, TestResult } from '@playwright/test/reporter';
+import { ResultCreatedEvent, ResultStatus, RunStartedEvent, RunCompletedEvent } from './types';
+export interface RunContext {
+    repoName: string;
+    runId: string;
+    branchName?: string;
+    sha?: string;
+    commitMessage?: string;
+    commitAuthor?: string;
+}
+export declare function buildResultPayload(runCtx: RunContext, spec: string, project: string | undefined, browser: string | undefined, osName: string, test: TestCase, result: TestResult, status: ResultStatus, attempt: number, titlePath?: string[]): ResultCreatedEvent;
+export declare function buildRunStarted(runCtx: RunContext, opts: {
+    startedAt: string;
+    branch?: string;
+    sha?: string;
+    workflowName?: string;
+    jobName?: string;
+    runUrl?: string;
+    commitMessage?: string;
+    commitAuthor?: string;
+}): RunStartedEvent;
+export declare function buildRunCompleted(runCtx: RunContext, opts: {
+    completedAt: string;
+    status: string;
+    durationMs: number;
+    counts: {
+        passed: number;
+        failed: number;
+        skipped: number;
+        flaky: number;
+    };
+}): RunCompletedEvent;
+//# sourceMappingURL=payload.d.ts.map

package/dist/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,EAIlB,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,kBAAkB,CA2CpB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE;IACJ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,eAAe,CAuBjB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E,GACA,iBAAiB,CAmBnB"}