@tracelane/report 0.1.0-alpha.12 → 0.1.0-alpha.14

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { buildReport } from './build-report.js';
 export type { BuildReportOptions } from './build-report.js';
 export type { ReportMeta, ReportStatus, Viewport } from './types.js';
+export { reportFileName, slugify, specSlug, writeReport } from './report-writer.js';
+export type { WriteReportInput } from './report-writer.js';
 export { decodeEventsBlob, encodeEventsBlob } from './embed.js';
 export { extractConsole, extractNetwork, CONSOLE_PLUGIN, NETWORK_EVENT_TAG, NETWORK_CONSOLE_PREFIX, } from './panels.js';
 export type { ConsoleEntry, NetworkEntry } from './panels.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIrE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,6 +1,9 @@
 // Public API surface for @tracelane/report.
 // The report builder: events + metadata -> self-contained offline HTML string.
 export { buildReport } from './build-report.js';
+// Disk writer: build the HTML and write it under outDir with a parallel-safe,
+// adapter-namespaced filename. Shared by the WDIO and Playwright adapters.
+export { reportFileName, slugify, specSlug, writeReport } from './report-writer.js';
 // Events blob round-trip (Task 2.9) — useful for re-reading a report's events.
 export { decodeEventsBlob, encodeEventsBlob } from './embed.js';
 // Console + network panel extraction (Task 2.10).

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,kDAAkD;AAClD,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,sCAAsC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,8EAA8E;AAC9E,2EAA2E;AAC3E,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGpF,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,kDAAkD;AAClD,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,sCAAsC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/report-writer.d.ts

@@ -0,0 +1,38 @@
+import type { eventWithTime } from '@cubenest/rrweb-core';
+import type { ReportMeta } from './types.js';
+/** Inputs for {@link writeReport}. */
+export interface WriteReportInput {
+    /** Output directory (created if missing). */
+    outDir: string;
+    /** Worker/project id (e.g. WDIO `0-0` or a Playwright project name); namespaces the filename for parallel safety. */
+    cid?: string | undefined;
+    /** Captured rrweb event stream. */
+    events: eventWithTime[];
+    /** Report metadata (spec, title, status, error, browser, ...). */
+    meta: ReportMeta;
+    /** Render the report's "Generated by tracelane" footer. Default true. */
+    footer?: boolean | undefined;
+}
+/**
+ * Turn an arbitrary spec path / test title into a filesystem-safe slug:
+ * lowercase, non-alphanumerics collapsed to single dashes, trimmed, capped.
+ */
+export declare function slugify(input: string): string;
+/**
+ * Build a unique-ish report filename: `<spec>--<title>--<cid>-<ts>.html`. The
+ * timestamp + cid keep retries and parallel workers from overwriting each other.
+ */
+export declare function reportFileName(meta: ReportMeta, cid?: string): string;
+/**
+ * Slug for the spec segment: take the file's basename (so an absolute path like
+ * `/repo/test/login.spec.ts` doesn't bloat the filename), then strip the common
+ * test-file suffixes (`.spec.ts`, `.test.mts`, `.e2e.js`, …) so it slugifies to
+ * a clean `login`, not `login-spec`.
+ */
+export declare function specSlug(spec: string): string;
+/**
+ * Build the report HTML and write it under `outDir`, namespaced by `cid`.
+ * Returns the absolute-or-relative path written (as `join` produced it).
+ */
+export declare function writeReport(input: WriteReportInput): string;
+//# sourceMappingURL=report-writer.d.ts.map

package/dist/report-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-writer.d.ts","sourceRoot":"","sources":["../src/report-writer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,qHAAqH;IACrH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,mCAAmC;IACnC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,kEAAkE;IAClE,IAAI,EAAE,UAAU,CAAC;IACjB,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAS3D"}

package/dist/report-writer.js

@@ -0,0 +1,58 @@
+// Write a self-contained HTML report to disk (ADR-0005 / ADR-0006).
+//
+// Given the captured event stream + metadata, call buildReport to produce the
+// offline HTML string, then write it under `outDir`. Files are namespaced by
+// `cid` (the adapter's worker/project id — e.g. the WDIO capability id or the
+// Playwright project name) so parallel workers never collide (ADR-0006 action
+// item #6). Lives in @tracelane/report so every adapter (WDIO, Playwright)
+// shares one write path.
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildReport } from './build-report.js';
+/**
+ * Turn an arbitrary spec path / test title into a filesystem-safe slug:
+ * lowercase, non-alphanumerics collapsed to single dashes, trimmed, capped.
+ */
+export function slugify(input) {
+    const slug = input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    // Cap length so deeply-nested titles don't blow past filesystem name limits.
+    return (slug || 'report').slice(0, 120);
+}
+/**
+ * Build a unique-ish report filename: `<spec>--<title>--<cid>-<ts>.html`. The
+ * timestamp + cid keep retries and parallel workers from overwriting each other.
+ */
+export function reportFileName(meta, cid) {
+    const specPart = meta.spec ? specSlug(meta.spec) : 'spec';
+    const titlePart = slugify(meta.title);
+    const cidPart = cid ? `${slugify(cid)}-` : '';
+    return `${specPart}--${titlePart}--${cidPart}${Date.now()}.html`;
+}
+/**
+ * Slug for the spec segment: take the file's basename (so an absolute path like
+ * `/repo/test/login.spec.ts` doesn't bloat the filename), then strip the common
+ * test-file suffixes (`.spec.ts`, `.test.mts`, `.e2e.js`, …) so it slugifies to
+ * a clean `login`, not `login-spec`.
+ */
+export function specSlug(spec) {
+    const base = spec.replace(/^.*[/\\]/, '');
+    return slugify(base.replace(/(\.(spec|test|e2e|cy))?\.[cm]?[jt]sx?$/, ''));
+}
+/**
+ * Build the report HTML and write it under `outDir`, namespaced by `cid`.
+ * Returns the absolute-or-relative path written (as `join` produced it).
+ */
+export function writeReport(input) {
+    const { outDir, cid, events, meta, footer } = input;
+    const html = buildReport(events, meta, footer === false ? { footer: false } : {});
+    if (!existsSync(outDir)) {
+        mkdirSync(outDir, { recursive: true });
+    }
+    const filePath = join(outDir, reportFileName(meta, cid));
+    writeFileSync(filePath, html);
+    return filePath;
+}
+//# sourceMappingURL=report-writer.js.map

package/dist/report-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-writer.js","sourceRoot":"","sources":["../src/report-writer.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,yBAAyB;AAEzB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiBhD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,6EAA6E;IAC7E,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,GAAY;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,OAAO,GAAG,QAAQ,KAAK,SAAS,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACpD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracelane/report",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.14",
   "description": "Self-contained, offline HTML report builder for tracelane. Embeds the rrweb player and a gzipped event blob into a single .html file.",
   "keywords": [
     "tracelane",
@@ -35,7 +35,7 @@
     "fflate": "^0.8.2",
     "rrweb-player": "1.0.0-alpha.4",
     "@cubenest/rrweb-core": "0.1.0-alpha.5",
-    "@tracelane/core": "0.1.0-alpha.10"
+    "@tracelane/core": "0.1.0-alpha.12"
   },
   "devDependencies": {
     "jsdom": "^25.0.1"