@qartisan/playwright-loupe 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -4,7 +4,13 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Before 1.0, minor versions may contain breaking changes. The JSON report has its own version (`schemaVersion`), see [`docs/schema/v1.md`](docs/schema/v1.md#versioning-policy).
 
-## [Unreleased]
+## [0.0.2] - 2026-10-15
+
+### Changed
+
+- **Error signatures change: failures are grouped differently from 0.0.1.** Normalization now also replaces e-mail addresses with `<email>` and cuid-like and nanoid-like identifiers (20+ characters mixing letters and digits) with `<id>`, so the same failure for different users or records gets one signature. A signature computed by 0.0.1 for a message containing such values no longer matches. The JSON shape is unchanged: `schemaVersion` stays `1`. See [Error signature](docs/schema/v1.md#error-signature).
+- **New built-in error categories**, evaluated after "Locator not found" and before "Network", "Assertion" and "Timeout": **Rate limited** (`Too Many Requests`, `rate limit`, a 429 in an HTTP context such as `status 429`, `HTTP 429` or `Response status: 429`) and **Server error** (a 500–599 status in the same contexts, or with its reason phrase such as `502 Bad Gateway`). Errors from `failOnStatusCode` and failed `expect(response).toBeOK()` that were "Uncategorized" or "Assertion" now land in these categories. A bare number (`429ms`, `Received: 500`) does not match. See [Error categories](docs/schema/v1.md#error-categories).
+- The package description now lists only what exists today.
 
 ## [0.0.1] - 2026-10-13
 

package/README.md

@@ -1,5 +1,5 @@
 # playwright-loupe
-Loupe — a clear, insightful HTML reporter for Playwright. Project overview, history, flakiness and error categories, using native Playwright APIs only.
+Loupe — an HTML reporter for Playwright: run summary, tests grouped by project and suite, dimensions from tags and annotations, and detailed failures with every attempt, error categories and signatures. Native Playwright APIs only.
 
 > **Status: work in progress — the JSON schema will change before 1.0.**
 

package/dist/core/categories.js

@@ -1,5 +1,13 @@
 const ALL_TARGETS = ['message', 'stack', 'step'];
 export const UNCATEGORIZED_COLOR = '#6b7280';
+/**
+ * An HTTP status in context: `status 429`, `status code: 429`, `"status": 429`,
+ * `statusCode=429`, `HTTP 429`, `HTTP/1.1 429`, `Response status: 429`, or
+ * `← 429`, the response line of Playwright's fetch log.
+ */
+function httpStatus(code) {
+    return new RegExp(`(?:\\b(?:status(?:[ _]?code)?["']?\\s*[:=]?|HTTP(?:/\\d(?:\\.\\d)?)?:?)|\u2190)\\s*${code}(?!\\w|\\.\\d)`, 'i');
+}
 export const BUILT_IN_RULES = [
     {
         // Before "Assertion" and "Timeout": a missing element surfaces as a failed
@@ -9,6 +17,25 @@ export const BUILT_IN_RULES = [
         match: [/element\(s\) not found/i, /resolved to 0 elements/i],
         targets: ['message', 'stack'],
     },
+    {
+        // Before "Network", "Assertion" and "Timeout": the status is the diagnosis,
+        // whether it surfaces through `failOnStatusCode`, `toBeOK()` or a thrown
+        // error. A bare 429 is not enough (`429ms`, `Received: 429`): it needs an
+        // HTTP context.
+        name: 'Rate limited',
+        color: '#c026d3',
+        match: [/\bToo Many Requests\b/i, /\brate[- ]?limit/i, httpStatus('429')],
+        targets: ['message', 'stack'],
+    },
+    {
+        name: 'Server error',
+        color: '#7c2d12',
+        match: [
+            httpStatus('5\\d\\d'),
+            /\b5\d\d (?:Internal Server Error|Not Implemented|Bad Gateway|Service Unavailable|Gateway Time-?out|HTTP Version Not Supported)\b/i,
+        ],
+        targets: ['message', 'stack'],
+    },
     {
         // Before "Timeout" so connection timeouts (ETIMEDOUT) count as network.
         name: 'Network',

package/dist/core/signature.js

@@ -16,13 +16,17 @@ export function stripMergeTagPrefix(text) {
     return text.replace(MERGE_TAG_PREFIX, '');
 }
 /**
- * Ordered replacements. The order matters: URLs before paths (a URL contains
- * slashes), paths before hex and numbers (so a path is replaced as a whole),
- * hex before numbers. See "Error signature" in docs/schema/v1.md.
+ * Ordered replacements. The order matters: URLs before e-mails (a URL may
+ * contain `user@host`) and paths (a URL contains slashes), e-mails and paths
+ * before identifiers, identifiers before durations, hex and numbers (so each
+ * is replaced as a whole), hex before numbers. See "Error signature" in
+ * docs/schema/v1.md.
  */
 const REPLACEMENTS = [
     [/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, '<uuid>'],
     [/\b[a-z][a-z0-9+.-]*:\/\/[^\s'"`<>()[\]{}]*[^\s'"`<>()[\]{}.,;:!?]/gi, '<url>'],
+    // Local part, then a domain with at least one dot and an alphabetic TLD.
+    [/(?<![\w.%+-])[\w.%+-]+@[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)*\.[a-z]{2,}(?![\w-])/gi, '<email>'],
     // ISO 8601 date with optional time and zone.
     [/\b\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}(?::\d{2}(?:[.,]\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?(?![\w:])/g, '<date>'],
     // Time of day.
@@ -32,6 +36,13 @@ const REPLACEMENTS = [
     // Absolute POSIX paths with at least two segments, and Windows drive paths.
     [/(?<![\w.~:/\\-])\/(?:[\w.@+~-]+\/)+[\w.@+~-]+\/?/g, '<path>'],
     [/\b[A-Za-z]:[\\/](?:[^\\/\s'"`:*?<>|]+[\\/])*[^\\/\s'"`:*?<>|]+/g, '<path>'],
+    // nanoid-like: 20+ chars of [A-Za-z0-9_-] with a lowercase letter, an
+    // uppercase letter and a digit. Mixed case keeps kebab-case and snake_case
+    // names out; a digit keeps camelCase words out.
+    [/(?<![\w-])(?=[\w-]*[a-z])(?=[\w-]*[A-Z])(?=[\w-]*\d)[\w-]{20,}(?![\w-])/g, '<id>'],
+    // cuid-like: 20+ lowercase letters and digits, with a digit and a letter
+    // beyond a-f (pure hex strings stay <hex>).
+    [/(?<![0-9A-Za-z])(?=[a-z0-9]*\d)(?=[a-z0-9]*[g-z])[a-z0-9]{20,}(?![0-9A-Za-z])/g, '<id>'],
     [/\b\d+(?:\.\d+)?\s?(?:ms|milliseconds?|s|secs?|seconds?|m|mins?|minutes?|h|hours?)\b/gi, '<duration>'],
     // 8+ hex chars with at least one letter (pure digit runs fall through to <n>).
     [/(?<![0-9A-Za-z])(?=[0-9a-f]*[a-f])[0-9a-f]{8,}(?![0-9A-Za-z])/gi, '<hex>'],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qartisan/playwright-loupe",
-  "version": "0.0.1",
-  "description": "Loupe — a clear, insightful HTML reporter for Playwright: project overview, history, flakiness and error categories, using native Playwright APIs only.",
+  "version": "0.0.2",
+  "description": "Loupe — an HTML reporter for Playwright: run summary, tests grouped by project and suite, dimensions from tags and annotations, and detailed failures with every attempt, error categories and signatures. Native Playwright APIs only.",
   "keywords": [
     "playwright",
     "reporter",