@kinora/vitest-reporter 0.2.0 → 0.4.0

package/README.md

@@ -37,6 +37,13 @@ Create an API token in the kinora dashboard (Settings → Workspace). Self-hosti
 
 Only browser tests are uploaded by default: Node unit tests are usually thousands of fast tests with no trace, and would eat your plan's monthly result quota. Upload them too with `include: 'all'`.
 
+## Accessibility
+
+With Storybook's a11y addon, each story's check is uploaded too: the rules broken, their impact
+and the elements they hit, ranked by component on the Components page. Use the addon's `todo`
+mode to keep the impact: in `error` mode, Storybook drops the check when the story fails and
+kinora reads the violations from the failure instead.
+
 ## Documentation
 
 **https://docs.kinora.dev/guides/vitest/**

package/dist/index.d.mts

@@ -1,9 +1,6 @@
 import { AttachmentKind, CiMeta, GitMeta } from "@kinora/core";
 import { Reporter, TestModule, Vitest } from "vitest/node";
-//#region src/convert.d.ts
 type IncludeTests = 'browser' | 'all';
-//#endregion
-//#region src/index.d.ts
 export interface KinoraVitestReporterOptions {
   /** kinora server base URL. Defaults to env KINORA_URL, then the hosted cloud. Set for self-host. */
   url?: string;
@@ -24,14 +21,21 @@ export interface KinoraVitestReporterOptions {
    * plan's monthly result quota with large unit suites.
    */
   include?: IncludeTests;
+  /**
+   * Sharded runs (`--shard`): the uploads of every shard of a CI run are assembled into a single
+   * kinora run. Shards are grouped by this key, defaulting to env KINORA_GROUP_KEY, then the CI run
+   * (GITHUB_RUN_ID / CI_PIPELINE_ID). Set it when a matrix runs the sharded suite once per leg, to
+   * tell the legs apart. `false` uploads each shard as its own run.
+   */
+  groupKey?: string | false;
 }
 export default class KinoraVitestReporter implements Reporter {
   private readonly options;
   private startedAt;
+  private shard;
   constructor(options: KinoraVitestReporterOptions);
   onInit(vitest: Vitest): void;
   onTestRunStart(): void;
   onTestRunEnd(modules: ReadonlyArray<TestModule>): Promise<void>;
 }
-//#endregion
 export {};

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { readFile } from "node:fs/promises";
 import process from "node:process";
-import { A11Y_IMPACTS, DEFAULT_KINORA_URL, DEFAULT_UPLOAD_ATTACHMENTS, IngestError, MAX_A11Y_NODES, MAX_A11Y_VIOLATIONS, STORY_ANNOTATION, createIngestClient, detectCiEnv, isUploadableAttachment, makeTestKey, stripAnsi } from "@kinora/core";
-//#region src/convert.ts
+import { DEFAULT_KINORA_URL, DEFAULT_UPLOAD_ATTACHMENTS, IngestError, MAX_A11Y_NODES, MAX_A11Y_VIOLATIONS, STORY_ANNOTATION, axeViolations, createIngestClient, describeRetry, detectCiEnv, isUploadableAttachment, makeTestKey, resolveShardGroup, stripAnsi } from "@kinora/core";
+// src/convert.ts
 function identity(test) {
 	const file = test.module.relativeModuleId;
 	const suites = [];
@@ -30,23 +30,6 @@ function storyOf(test, titlePath) {
 }
 const MAX_TEXT = 300;
 const truncate = (s) => s.length > MAX_TEXT ? `${s.slice(0, MAX_TEXT)}…` : s;
-const isImpact = (v) => A11Y_IMPACTS.includes(v);
-function selector(target) {
-	if (!Array.isArray(target)) return "";
-	return truncate(target.map((t) => Array.isArray(t) ? t.join(" >>> ") : String(t)).join(" "));
-}
-function violation(v) {
-	if (!v.id) return [];
-	const nodes = v.nodes ?? [];
-	return [{
-		id: v.id,
-		...isImpact(v.impact) && { impact: v.impact },
-		help: truncate(v.help ?? v.id),
-		...v.helpUrl && { helpUrl: v.helpUrl },
-		nodes: nodes.slice(0, MAX_A11Y_NODES).map((n) => selector(n.target)).filter(Boolean),
-		nodeCount: nodes.length
-	}];
-}
 const AXE_FAILURE = /Expected the HTML found at \$\('(.+?)'\) to have no violations:[\s\S]*?Received:\s*"(.+?) \(([\w-]+)\)"[\s\S]*?more information on this issue here:\s*(https:\/\/\S+)/g;
 function a11yFromError(test) {
 	const message = test.result().errors?.find((e) => e.message.includes("toHaveNoViolations"))?.message;
@@ -85,7 +68,7 @@ function a11yOf(test) {
 	}
 	return {
 		status,
-		violations: (result.violations ?? []).slice(0, MAX_A11Y_VIOLATIONS).flatMap(violation)
+		violations: axeViolations(result.violations)
 	};
 }
 function slug(name) {
@@ -180,8 +163,7 @@ function toNormTests(modules, include = "browser") {
 		skippedNodeTests
 	};
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 function countsOf(tests) {
 	const counts = {
 		total: tests.length,
@@ -196,11 +178,17 @@ function countsOf(tests) {
 var KinoraVitestReporter = class {
 	options;
 	startedAt = /* @__PURE__ */ new Date();
+	shard;
 	constructor(options) {
 		this.options = options;
 	}
 	onInit(vitest) {
 		this.startedAt = /* @__PURE__ */ new Date();
+		const shard = vitest.config.shard;
+		this.shard = shard ? {
+			current: shard.index,
+			total: shard.count
+		} : void 0;
 		vitest.config.includeTaskLocation = true;
 		for (const project of vitest.projects) project.config.includeTaskLocation = true;
 	}
@@ -215,9 +203,13 @@ var KinoraVitestReporter = class {
 			return;
 		}
 		const { tests, skippedNodeTests } = toNormTests(modules, this.options.include);
+		const group = this.shard && this.options.groupKey !== false ? resolveShardGroup(process.env, { groupKey: this.options.groupKey }) : void 0;
 		if (!tests.length) {
-			console.warn(skippedNodeTests ? `[kinora] nothing uploaded: no browser tests in this run (${skippedNodeTests} Node tests left out). Set include: 'all' to upload Node tests too.` : "[kinora] nothing uploaded: no tests ran");
-			return;
+			if (!group) {
+				console.warn(skippedNodeTests ? `[kinora] nothing uploaded: no browser tests in this run (${skippedNodeTests} Node tests left out). Set include: 'all' to upload Node tests too.` : "[kinora] nothing uploaded: no tests ran");
+				return;
+			}
+			console.warn("[kinora] no tests to upload in this shard: filling its slot so the run can complete");
 		}
 		const detected = detectCiEnv(process.env);
 		const payload = {
@@ -230,14 +222,19 @@ var KinoraVitestReporter = class {
 				duration: Date.now() - this.startedAt.getTime(),
 				counts: countsOf(tests),
 				git: this.options.git ?? detected.git,
-				ci: this.options.ci ?? detected.ci
+				ci: this.options.ci ?? detected.ci,
+				...this.shard && group && {
+					...group,
+					shard: this.shard
+				}
 			},
 			tests
 		};
 		try {
 			const client = createIngestClient({
 				baseUrl: url,
-				token
+				token,
+				onRetry: (info) => console.warn(`[kinora] ${describeRetry(info)}`)
 			});
 			const res = await client.uploadRun(payload);
 			const kinds = this.options.uploadAttachments ?? DEFAULT_UPLOAD_ATTACHMENTS;
@@ -257,12 +254,11 @@ var KinoraVitestReporter = class {
 					console.warn(`[kinora] ${a.name} upload failed for ${t.testKey}:`, err instanceof Error ? err.message : err);
 				}
 			}
-			console.log(`[kinora] uploaded ${res.tests} tests + ${artifacts} artifacts (run ${res.runId})`);
+			console.log(`[kinora] uploaded ${res.tests} tests + ${artifacts} artifacts (run ${res.runId}${res.shardProgress ? `, ${res.shardProgress.landed} of ${res.shardProgress.total} shards` : ""})`);
 		} catch (err) {
 			if (err instanceof IngestError && err.status === 402) console.warn(`[kinora] ${err.message}`);
 			else console.error("[kinora] upload failed:", err instanceof Error ? err.message : err);
 		}
 	}
 };
-//#endregion
 export { KinoraVitestReporter as default };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kinora/vitest-reporter",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Vitest reporter that uploads browser-mode and Storybook test results to a kinora server",
   "author": "Joris Gallot",
   "license": "MIT",
@@ -34,17 +34,17 @@
     "access": "public"
   },
   "peerDependencies": {
-    "vitest": ">=4.1.11"
+    "vitest": ">=4.1.12"
   },
   "dependencies": {
-    "@kinora/core": "0.9.0"
+    "@kinora/core": "0.14.0"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",
-    "@vitest/coverage-v8": "^5.0.3",
-    "tsdown": "^0.23.1",
+    "@vitest/coverage-v8": "^5.0.5",
+    "tsdown": "^0.23.2",
     "typescript": "~6.0.3",
-    "vitest": "^5.0.3"
+    "vitest": "^5.0.5"
   },
   "scripts": {
     "build": "tsdown",