@nzila/sdk 0.1.6 → 0.1.9

package/README.md

@@ -25,6 +25,20 @@ Subpaths such as `@nzila/sdk/vitest` need **`moduleResolution`** set to **`bundl
 
 `@nzila/sdk@0.1.4+` also ships root `.d.ts` shims and `typesVersions` for broader editor support.
 
+### Vitest reporter API
+
+`NzilaVitestReporter` implements Vitest’s `Reporter` interface and sends the webhook in **`onTestRunEnd`** (after all modules finish). Optional hooks like `onTestCaseResult` are not required.
+
+### Vitest: tests hang or never start?
+
+Use the **tuple** from `nzilaVitestReporter()` — do **not** put `new NzilaVitestReporter()` in `vitest.config.ts`. Worker pools cannot serialize class instances.
+
+```ts
+reporters: ["default", nzilaVitestReporter({ webhookUrl, apiKey, appName })],
+```
+
+Equivalent: `reporters: ["default", ["@nzila/sdk/vitest", { … }]]`.
+
 ### Reporters not sending?
 
 1. Set **`NZILA_WEBHOOK_URL`**, **`NZILA_API_KEY`**, and **`NZILA_APP_NAME`** (must match the project app name in the dashboard), or pass them in the reporter constructor.
@@ -63,23 +77,34 @@ After you sign in on [nzila-kappa.vercel.app](https://nzila-kappa.vercel.app), t
 **Tests (CI):**
 
 ```ts
+import nzilaConfig from "./nzila.config";
 import { nzilaVitestReporter } from "@nzila/sdk/vitest";
+import { reporterOptionsFromNzilaConfig } from "@nzila/sdk";
 
 export default defineConfig({
   test: {
     reporters: [
       "default",
-      nzilaVitestReporter({
-        webhookUrl: process.env.NZILA_WEBHOOK_URL!,
-        apiKey: process.env.NZILA_API_KEY!,
-        appName: "my-app",
-        mapFeature: (path) => path[0] ?? "general",
-      }),
+      nzilaVitestReporter(reporterOptionsFromNzilaConfig(nzilaConfig)),
     ],
   },
 });
 ```
 
+`nzila.config.ts` (from `npx @nzila/sdk link --api-key … --project-id <uuid> --app-name <app>`):
+
+```ts
+export default {
+  apiKey: "nzl_…",
+  projectId: "00000000-0000-0000-0000-000000000000",
+  appName: "my-app",
+  endpoint: "https://nzila-kappa.vercel.app",
+  framework: "vitest",
+} as const;
+```
+
+Or set env vars: `NZILA_API_KEY`, `NZILA_PROJECT_ID`, `NZILA_APP_NAME`, `NZILA_WEBHOOK_URL`.
+
 **React (runtime):**
 
 ```ts

package/dist/cli/main.js

@@ -16,13 +16,15 @@ async function loadConfig(cwd) {
     const source = await readFile(file, "utf8");
     const match = source.match(/apiKey:\s*["']([^"']+)["']/);
     const projectMatch = source.match(/projectId:\s*["']([^"']+)["']/);
+    const appMatch = source.match(/appName:\s*["']([^"']+)["']/);
     const endpointMatch = source.match(/endpoint:\s*["']([^"']+)["']/);
     const frameworkMatch = source.match(/framework:\s*["']([^"']+)["']/);
-    if (!match?.[1] || !projectMatch?.[1])
+    if (!match?.[1] || !projectMatch?.[1] || !appMatch?.[1])
         return null;
     return {
         apiKey: match[1],
         projectId: projectMatch[1],
+        appName: appMatch[1],
         endpoint: endpointMatch?.[1] ?? defaultEndpoint(),
         framework: frameworkMatch?.[1] ?? "vitest",
     };
@@ -32,6 +34,7 @@ async function writeConfig(cwd, config) {
 export default {
   apiKey: "${config.apiKey}",
   projectId: "${config.projectId}",
+  appName: "${config.appName.replace(/"/g, '\\"')}",
   endpoint: "${config.endpoint.replace(/"/g, '\\"')}",
   framework: "${config.framework}",
 } as const;
@@ -65,17 +68,45 @@ function detectFramework(cwd) {
         return "playwright";
     return "vitest";
 }
-function printEnvSnippet(endpoint) {
-    const paths = platformPaths(endpoint);
+function printEnvSnippet(config) {
+    const paths = platformPaths(config.endpoint);
     console.log("");
-    console.log("Add to your project .env.local:");
+    console.log("Optional .env.local (or use nzila.config.ts only):");
     console.log(`NZILA_WEBHOOK_URL=${paths.webhook}`);
     console.log(`NZILA_SIGNALS_URL=${paths.signals}`);
-    console.log("NZILA_API_KEY=<from dashboard → API Keys>");
+    console.log(`NZILA_API_KEY=${config.apiKey}`);
+    console.log(`NZILA_PROJECT_ID=${config.projectId}`);
+    console.log(`NZILA_APP_NAME=${config.appName}`);
     console.log("");
-    console.log(`SDK already installed via ${PKG}; add Vitest reporter from docs.`);
+    printReporterSnippet(config);
     console.log(`Docs: ${paths.docs}`);
 }
+function printReporterSnippet(config) {
+    const paths = platformPaths(config.endpoint);
+    if (config.framework === "vitest") {
+        console.log("vitest.config.ts:");
+        console.log(`  import nzilaConfig from "./${CONFIG_FILE.replace(".ts", "")}";`);
+        console.log(`  import { nzilaVitestReporter } from "${PKG}/vitest";`);
+        console.log(`  import { reporterOptionsFromNzilaConfig } from "${PKG}";`);
+        console.log("  reporters: [");
+        console.log('    "default",');
+        console.log("    nzilaVitestReporter(reporterOptionsFromNzilaConfig(nzilaConfig)),");
+        console.log("  ],");
+    }
+    else if (config.framework === "jest") {
+        console.log("jest.config:");
+        console.log(`  reporters: ["default", ["${PKG}/jest", {`);
+        console.log(`    webhookUrl: "${paths.webhook}",`);
+        console.log(`    apiKey: nzilaConfig.apiKey,`);
+        console.log(`    projectId: "${config.projectId}",`);
+        console.log(`    appName: "${config.appName}",`);
+        console.log("  }]],");
+    }
+    else {
+        console.log(`Wire ${PKG} reporter for ${config.framework} — see docs.`);
+    }
+    console.log("");
+}
 async function tryOpen(url, quiet = false) {
     try {
         await openBrowser(url);
@@ -104,9 +135,15 @@ async function cmdInit(flags) {
     console.log("Quick start:");
     console.log(`  1. npx ${PKG} login     → sign in (opens browser)`);
     console.log("  2. Create a project + API key in the dashboard");
-    console.log(`  3. npx ${PKG} link --api-key nzl_… --project-id <uuid>`);
+    console.log(`  3. npx ${PKG} link --api-key nzl_… --project-id <uuid> --app-name <app>`);
     console.log("  4. Wire @nzila/sdk/vitest and run tests");
-    printEnvSnippet(base);
+    printEnvSnippet({
+        apiKey: "<api-key>",
+        projectId: "<project-uuid>",
+        appName: "<app-name>",
+        endpoint: base,
+        framework,
+    });
     if (flags.open !== false) {
         await tryOpen(paths.register, true);
     }
@@ -119,22 +156,24 @@ async function cmdLogin(flags) {
     console.log(`  ${platformPaths(base).keys}`);
     console.log("");
     console.log("Then link this repo:");
-    console.log(`  npx ${PKG} link --api-key <key> --project-id <uuid>`);
+    console.log(`  npx ${PKG} link --api-key <key> --project-id <uuid> --app-name <app>`);
     await tryOpen(loginUrl);
 }
 async function cmdLink(flags) {
     const apiKey = String(flags["api-key"] ?? flags.apiKey ?? "");
     const projectId = String(flags["project-id"] ?? flags.projectId ?? "");
+    const appName = String(flags["app-name"] ?? flags.appName ?? "");
     const endpoint = String(flags.endpoint ?? defaultEndpoint()).replace(/\/$/, "");
-    if (!apiKey || !projectId) {
-        console.error(`Usage: npx ${PKG} link --api-key <token> --project-id <uuid> [--endpoint <url>]`);
+    if (!apiKey || !projectId || !appName) {
+        console.error(`Usage: npx ${PKG} link --api-key <token> --project-id <uuid> --app-name <name> [--endpoint <url>]`);
         process.exit(1);
     }
     const cwd = process.cwd();
     const framework = detectFramework(cwd);
-    await writeConfig(cwd, { apiKey, projectId, endpoint, framework });
+    const config = { apiKey, projectId, appName, endpoint, framework };
+    await writeConfig(cwd, config);
     console.log(`Wrote ${CONFIG_FILE} (endpoint: ${endpoint})`);
-    printEnvSnippet(endpoint);
+    printEnvSnippet(config);
 }
 async function cmdDoctor() {
     const cwd = process.cwd();
@@ -146,6 +185,7 @@ async function cmdDoctor() {
     const paths = platformPaths(config.endpoint);
     console.log("Config OK:", {
         projectId: config.projectId,
+        appName: config.appName,
         endpoint: config.endpoint,
         framework: config.framework,
     });
@@ -159,13 +199,13 @@ Commands:
   open       Open the dashboard in your browser (default)
   init       Detect framework + show setup steps
   login      Open sign-in and linking instructions
-  link       Write nzila.config.ts (--api-key, --project-id)
+  link       Write nzila.config.ts (--api-key, --project-id, --app-name)
   doctor     Validate nzila.config.ts
 
 Examples:
   npx ${PKG}
   npx ${PKG} login
-  npx ${PKG} link --api-key nzl_… --project-id <uuid>
+  npx ${PKG} link --api-key nzl_… --project-id <uuid> --app-name <app>
 
 Docs: ${paths.docs}
 `);

package/dist/collect-vitest-tests.d.ts

@@ -1,5 +1,5 @@
 import type { TestModule } from "vitest/node";
 import type { NzilaClientOptions, NzilaTestCase } from "./types.js";
-/** Collect finished tests from Vitest 3+ `TestModule` reporters API. */
+/** Collect finished tests from Vitest `onTestRunEnd` modules. */
 export declare function collectTestsFromVitestModules(modules: ReadonlyArray<TestModule>, options: NzilaClientOptions, runStartedAt: Date): NzilaTestCase[];
 //# sourceMappingURL=collect-vitest-tests.d.ts.map

package/dist/collect-vitest-tests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect-vitest-tests.d.ts","sourceRoot":"","sources":["../src/collect-vitest-tests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,UAAU,EAAa,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAmBrF,wEAAwE;AACxE,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,IAAI,GACjB,aAAa,EAAE,CAuCjB"}
+{"version":3,"file":"collect-vitest-tests.d.ts","sourceRoot":"","sources":["../src/collect-vitest-tests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AA6BrF,iEAAiE;AACjE,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,IAAI,GACjB,aAAa,EAAE,CA0CjB"}

package/dist/collect-vitest-tests.js

@@ -1,7 +1,12 @@
+import { nzilaTestContext } from "./reporter-options.js";
 function describePathFor(test) {
     const path = [];
     let parent = test.parent;
-    while (parent.type === "suite") {
+    const seen = new Set();
+    while (parent?.type === "suite") {
+        if (seen.has(parent))
+            break;
+        seen.add(parent);
         path.unshift(parent.name);
         parent = parent.parent;
     }
@@ -16,18 +21,22 @@ function mapStatus(state) {
         return "skipped";
     return "pending";
 }
-/** Collect finished tests from Vitest 3+ `TestModule` reporters API. */
+/** Collect finished tests from Vitest `onTestRunEnd` modules. */
 export function collectTestsFromVitestModules(modules, options, runStartedAt) {
     const framework = options.framework ?? "vitest";
     const tests = [];
     const now = new Date().toISOString();
     for (const mod of modules) {
-        for (const test of mod.children.allTests()) {
-            const result = test.result();
+        const allTests = mod.children?.allTests?.();
+        if (!allTests)
+            continue;
+        for (const test of allTests) {
+            const node = test;
+            const result = node.result();
             if (result.state === "pending")
                 continue;
-            const describePath = describePathFor(test);
-            const feature = options.mapFeature?.(describePath, test.name) ??
+            const describePath = describePathFor(node);
+            const feature = options.mapFeature?.(describePath, node.name) ??
                 describePath[0] ??
                 "general";
             const errors = result.errors?.map((e) => ({
@@ -41,10 +50,10 @@ export function collectTestsFromVitestModules(modules, options, runStartedAt) {
                 finishedAt: now,
                 describePath,
                 feature,
-                context: { layer: options.appName },
-                testName: test.name,
+                context: nzilaTestContext(options),
+                testName: node.name,
                 status: mapStatus(result.state),
-                duration: test.diagnostic()?.duration ?? 0,
+                duration: node.diagnostic()?.duration ?? 0,
                 errors,
             });
         }

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  */
 export { NZILA_TEST_FRAMEWORKS, type NzilaTestFramework, type NzilaTestStatus, type NzilaLocale, type NzilaTestCase, type NzilaRunPayload, type NzilaClientOptions, } from "./types.js";
 export { sendNzilaRun, resolveLocale, type DeliverOptions } from "./deliver.js";
+export { type NzilaConfig, webhookUrlFromEndpoint, reporterOptionsFromNzilaConfig, } from "./nzila-config.js";
 export { initNzilaRuntime, isNzilaRuntimeReady, traceNzilaFeature, createFeatureHandle, reportFeatureError, captureFeatureError, extractErrorFields, type NzilaFeatureHandle, type NzilaRuntimeConfig, type NzilaRuntimeSignal, } from "./runtime/index.js";
 export { default as NzilaVitestReporter } from "./vitest-reporter.js";
 export { default as NzilaJestReporter } from "./jest-reporter.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,KAAK,WAAW,EAChB,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@
  */
 export { NZILA_TEST_FRAMEWORKS, } from "./types.js";
 export { sendNzilaRun, resolveLocale } from "./deliver.js";
+export { webhookUrlFromEndpoint, reporterOptionsFromNzilaConfig, } from "./nzila-config.js";
 export { initNzilaRuntime, isNzilaRuntimeReady, traceNzilaFeature, createFeatureHandle, reportFeatureError, captureFeatureError, extractErrorFields, } from "./runtime/index.js";
 export { default as NzilaVitestReporter } from "./vitest-reporter.js";
 export { default as NzilaJestReporter } from "./jest-reporter.js";

package/dist/jest-reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jest-reporter.d.ts","sourceRoot":"","sources":["../src/jest-reporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAEpB,KAAK,aAAa,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpD,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,WAAW,EAAE,cAAc,EAAE,CAAC;KAC/B,EAAE,CAAC;CACL,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,kBAAkB,EAAE,aAAa,CAAC,EAAE,OAAO;IAKhE,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc;IAmDzD,OAAO,CAAC,SAAS;CAQlB;AAED,4CAA4C;AAC5C,YAAY,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"jest-reporter.d.ts","sourceRoot":"","sources":["../src/jest-reporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAEpB,KAAK,aAAa,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpD,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,WAAW,EAAE,cAAc,EAAE,CAAC;KAC/B,EAAE,CAAC;CACL,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,kBAAkB,EAAE,aAAa,CAAC,EAAE,OAAO;IAKhE,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc;IAoDzD,OAAO,CAAC,SAAS;CAQlB;AAED,4CAA4C;AAC5C,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/jest-reporter.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { sendNzilaRun, resolveLocale } from "./deliver.js";
-import { resolveClientOptions } from "./reporter-options.js";
+import { nzilaTestContext, resolveClientOptions } from "./reporter-options.js";
 /**
  * Jest reporter: aggregates results and POSTs one {@link sendNzilaRun} payload on `onRunComplete`.
  *
@@ -35,6 +35,7 @@ export default class NzilaJestReporter {
                     finishedAt: new Date(file.perfStats.end).toISOString(),
                     describePath,
                     feature: describePath[0],
+                    context: nzilaTestContext(this.options),
                     testName: test.title,
                     status: this.mapStatus(test.status),
                     duration: test.duration ?? 0,

package/dist/nzila-config.d.ts

@@ -0,0 +1,28 @@
+import type { NzilaClientOptions, NzilaTestFramework } from "./types.js";
+/** Shape of `nzila.config.ts` written by `npx @nzila/sdk link`. */
+export type NzilaConfig = {
+    apiKey: string;
+    /** Dashboard project UUID (API Keys → copy project ID). */
+    projectId: string;
+    /** Must match the project App name in Nzila (webhook payload). */
+    appName: string;
+    /** Platform base URL, e.g. https://nzila-kappa.vercel.app */
+    endpoint: string;
+    framework?: NzilaTestFramework;
+    locale?: NzilaClientOptions["locale"];
+};
+export declare function webhookUrlFromEndpoint(endpoint: string): string;
+/**
+ * Build Vitest/Jest reporter options from `nzila.config.ts` (or the same fields inline).
+ *
+ * @example
+ * ```ts
+ * import nzilaConfig from "./nzila.config";
+ * import { nzilaVitestReporter } from "@nzila/sdk/vitest";
+ * import { reporterOptionsFromNzilaConfig } from "@nzila/sdk";
+ *
+ * reporters: ["default", nzilaVitestReporter(reporterOptionsFromNzilaConfig(nzilaConfig))],
+ * ```
+ */
+export declare function reporterOptionsFromNzilaConfig(config: NzilaConfig): NzilaClientOptions;
+//# sourceMappingURL=nzila-config.d.ts.map

package/dist/nzila-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nzila-config.d.ts","sourceRoot":"","sources":["../src/nzila-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,WAAW,GAClB,kBAAkB,CASpB"}

package/dist/nzila-config.js

@@ -0,0 +1,26 @@
+export function webhookUrlFromEndpoint(endpoint) {
+    const base = endpoint.trim().replace(/\/$/, "");
+    return `${base}/api/webhooks/tests`;
+}
+/**
+ * Build Vitest/Jest reporter options from `nzila.config.ts` (or the same fields inline).
+ *
+ * @example
+ * ```ts
+ * import nzilaConfig from "./nzila.config";
+ * import { nzilaVitestReporter } from "@nzila/sdk/vitest";
+ * import { reporterOptionsFromNzilaConfig } from "@nzila/sdk";
+ *
+ * reporters: ["default", nzilaVitestReporter(reporterOptionsFromNzilaConfig(nzilaConfig))],
+ * ```
+ */
+export function reporterOptionsFromNzilaConfig(config) {
+    return {
+        apiKey: config.apiKey,
+        projectId: config.projectId,
+        appName: config.appName,
+        webhookUrl: webhookUrlFromEndpoint(config.endpoint),
+        framework: config.framework,
+        locale: config.locale,
+    };
+}

package/dist/reporter-options.d.ts

@@ -1,4 +1,5 @@
 import type { NzilaClientOptions } from "./types.js";
+export declare function nzilaTestContext(options: Pick<NzilaClientOptions, "appName" | "projectId">): Record<string, unknown>;
 /** Merge reporter options with `NZILA_*` environment variables. */
 export declare function resolveClientOptions(options: NzilaClientOptions): NzilaClientOptions & {
     debug: boolean;

package/dist/reporter-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter-options.d.ts","sourceRoot":"","sources":["../src/reporter-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,mEAAmE;AACnE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAQzC"}
+{"version":3,"file":"reporter-options.d.ts","sourceRoot":"","sources":["../src/reporter-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,WAAW,CAAC,GACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAUzC"}

package/dist/reporter-options.js

@@ -1,3 +1,9 @@
+export function nzilaTestContext(options) {
+    return {
+        layer: options.appName,
+        ...(options.projectId ? { projectId: options.projectId } : {}),
+    };
+}
 /** Merge reporter options with `NZILA_*` environment variables. */
 export function resolveClientOptions(options) {
     return {
@@ -5,6 +11,7 @@ export function resolveClientOptions(options) {
         webhookUrl: options.webhookUrl?.trim() || process.env.NZILA_WEBHOOK_URL?.trim() || "",
         apiKey: options.apiKey?.trim() || process.env.NZILA_API_KEY?.trim() || "",
         appName: options.appName?.trim() || process.env.NZILA_APP_NAME?.trim() || "",
+        projectId: options.projectId?.trim() || process.env.NZILA_PROJECT_ID?.trim() || undefined,
         debug: options.debug === true || process.env.NZILA_DEBUG === "1",
     };
 }

package/dist/types.d.ts

@@ -39,6 +39,8 @@ export type NzilaClientOptions = {
     webhookUrl: string;
     apiKey: string;
     appName: string;
+    /** Dashboard project UUID — use in `nzila.config.ts` and `NZILA_PROJECT_ID` (metadata on payloads). */
+    projectId?: string;
     framework?: NzilaTestFramework;
     /** Defaults to a random UUID per reporter instance. */
     runId?: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,yGAUxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG;IAC5B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAClE,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,yGAUxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG;IAC5B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAClE,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/vitest-reporter.d.ts

@@ -2,25 +2,37 @@ import type { File } from "@vitest/runner";
 import type { Reporter, SerializedError, TestModule, TestRunEndReason } from "vitest/node";
 import type { NzilaClientOptions } from "./types.js";
 /**
- * Vitest reporter that POSTs one webhook per finished run via {@link sendNzilaRun}.
- * Supports Vitest 3+ (`onTestRunEnd`) and legacy `onFinished` file tasks.
+ * Vitest {@link Reporter} that POSTs one webhook per run on {@link onTestRunEnd}.
+ *
+ * @see https://vitest.dev/guide/advanced/reporters
  */
-export default class NzilaVitestReporter {
+export default class NzilaVitestReporter implements Reporter {
     private readonly options;
     private startedAt;
     private sent;
     private readonly runId;
     constructor(options: NzilaClientOptions);
-    onTestRunEnd(testModules: ReadonlyArray<TestModule>, _unhandledErrors?: ReadonlyArray<SerializedError>, _reason?: TestRunEndReason): void;
-    /** @deprecated Vitest 2 — still invoked in some setups */
-    onFinished(files: File[], _errors: unknown[], _coverage?: unknown): void;
+    onTestRunStart(): void;
+    onTestRunEnd(testModules: ReadonlyArray<TestModule>, _unhandledErrors: ReadonlyArray<SerializedError>, _reason: TestRunEndReason): Promise<void>;
+    /**
+     * Vitest 2.x only — not part of the current `Reporter` interface.
+     * @deprecated Use Vitest 3+ `onTestRunEnd` instead.
+     */
+    onFinished(files: File[], _errors: unknown[], _coverage?: unknown): Promise<void>;
     private sendPayload;
     private walkTasks;
     private mapStatus;
 }
+/** Vitest `reporters` entry — load by package name (works with `pool: forks` / `threads`). */
+export declare const NZILA_VITEST_REPORTER: "@nzila/sdk/vitest";
+export type NzilaVitestReporterEntry = [
+    typeof NZILA_VITEST_REPORTER,
+    NzilaClientOptions
+];
 /**
- * Returns a reporter instance typed for your project's Vitest config (`reporters` array).
- * Prefer this over `new NzilaVitestReporter()` when TypeScript reports a Reporter mismatch.
+ * Returns `['@nzila/sdk/vitest', options]` for `defineConfig({ test: { reporters } })`.
+ * Do **not** use `new NzilaVitestReporter()` in config — worker pools cannot serialize instances.
  */
-export declare function nzilaVitestReporter(options: NzilaClientOptions): Reporter;
+export declare function nzilaVitestReporter(options: NzilaClientOptions): NzilaVitestReporterEntry;
+export type { Reporter as VitestReporter } from "vitest/node";
 //# sourceMappingURL=vitest-reporter.d.ts.map

package/dist/vitest-reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-reporter.d.ts","sourceRoot":"","sources":["../src/vitest-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAQ,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,UAAU,EACV,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,kBAAkB,EAAmD,MAAM,YAAY,CAAC;AAEtG;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,YAAY,CACV,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,EACtC,gBAAgB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,EACjD,OAAO,CAAC,EAAE,gBAAgB;IAM5B,0DAA0D;IAC1D,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,OAAO;YAQnD,WAAW;IA2BzB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,SAAS;CAMlB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,CAEzE"}
+{"version":3,"file":"vitest-reporter.d.ts","sourceRoot":"","sources":["../src/vitest-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAQ,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,UAAU,EACV,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,kBAAkB,EAAmD,MAAM,YAAY,CAAC;AAEtG;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,QAAQ;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,cAAc;IAKR,YAAY,CAChB,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,EACtC,gBAAgB,EAAE,aAAa,CAAC,eAAe,CAAC,EAChD,OAAO,EAAE,gBAAgB;IAM3B;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,OAAO;YAQzD,WAAW;IA2BzB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,SAAS;CAMlB;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,EAAG,mBAA4B,CAAC;AAElE,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,qBAAqB;IAC5B,kBAAkB;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,GAC1B,wBAAwB,CAE1B;AAED,YAAY,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/vitest-reporter.js

@@ -1,10 +1,11 @@
 import { randomUUID } from "node:crypto";
 import { collectTestsFromVitestModules } from "./collect-vitest-tests.js";
 import { sendNzilaRun, resolveLocale } from "./deliver.js";
-import { resolveClientOptions } from "./reporter-options.js";
+import { nzilaTestContext, resolveClientOptions } from "./reporter-options.js";
 /**
- * Vitest reporter that POSTs one webhook per finished run via {@link sendNzilaRun}.
- * Supports Vitest 3+ (`onTestRunEnd`) and legacy `onFinished` file tasks.
+ * Vitest {@link Reporter} that POSTs one webhook per run on {@link onTestRunEnd}.
+ *
+ * @see https://vitest.dev/guide/advanced/reporters
  */
 export default class NzilaVitestReporter {
     constructor(options) {
@@ -13,17 +14,24 @@ export default class NzilaVitestReporter {
         this.options = resolveClientOptions(options);
         this.runId = this.options.runId ?? randomUUID();
     }
-    onTestRunEnd(testModules, _unhandledErrors, _reason) {
+    onTestRunStart() {
+        this.startedAt = new Date();
+        this.sent = false;
+    }
+    async onTestRunEnd(testModules, _unhandledErrors, _reason) {
         const tests = collectTestsFromVitestModules(testModules, this.options, this.startedAt);
-        void this.sendPayload(tests);
+        await this.sendPayload(tests);
     }
-    /** @deprecated Vitest 2 — still invoked in some setups */
-    onFinished(files, _errors, _coverage) {
+    /**
+     * Vitest 2.x only — not part of the current `Reporter` interface.
+     * @deprecated Use Vitest 3+ `onTestRunEnd` instead.
+     */
+    async onFinished(files, _errors, _coverage) {
         const tests = [];
         for (const file of files ?? []) {
             this.walkTasks(file.tasks, file.name.split("/").slice(0, -1), tests);
         }
-        void this.sendPayload(tests);
+        await this.sendPayload(tests);
     }
     async sendPayload(tests) {
         if (!tests.length) {
@@ -76,7 +84,7 @@ export default class NzilaVitestReporter {
                 finishedAt: now,
                 describePath,
                 feature,
-                context: { layer: this.options.appName },
+                context: nzilaTestContext(this.options),
                 testName: task.name,
                 status: this.mapStatus(result?.state),
                 duration: result?.duration ?? 0,
@@ -94,10 +102,12 @@ export default class NzilaVitestReporter {
         return "pending";
     }
 }
+/** Vitest `reporters` entry — load by package name (works with `pool: forks` / `threads`). */
+export const NZILA_VITEST_REPORTER = "@nzila/sdk/vitest";
 /**
- * Returns a reporter instance typed for your project's Vitest config (`reporters` array).
- * Prefer this over `new NzilaVitestReporter()` when TypeScript reports a Reporter mismatch.
+ * Returns `['@nzila/sdk/vitest', options]` for `defineConfig({ test: { reporters } })`.
+ * Do **not** use `new NzilaVitestReporter()` in config — worker pools cannot serialize instances.
  */
 export function nzilaVitestReporter(options) {
-    return new NzilaVitestReporter(options);
+    return [NZILA_VITEST_REPORTER, options];
 }

package/examples/nzila.config.example.ts

@@ -0,0 +1,8 @@
+/** Example — copy to your app as `nzila.config.ts` */
+export default {
+  apiKey: process.env.NZILA_API_KEY ?? "nzl_your_key_here",
+  projectId: process.env.NZILA_PROJECT_ID ?? "00000000-0000-0000-0000-000000000000",
+  appName: process.env.NZILA_APP_NAME ?? "your-app-name",
+  endpoint: process.env.NZILA_APP_URL ?? "https://nzila-kappa.vercel.app",
+  framework: "vitest" as const,
+} as const;

package/examples/vitest.config.example.ts

@@ -3,13 +3,13 @@
  * Nzila repo uses examples/vitest.config.ts (and backend/frontend-specific configs).
  */
 import { defineConfig } from "vitest/config";
-import NzilaVitestReporter from "@nzila/sdk/vitest";
+import { nzilaVitestReporter } from "@nzila/sdk/vitest";
 
 export default defineConfig({
   test: {
     reporters: [
       "default",
-      new NzilaVitestReporter({
+      nzilaVitestReporter({
         webhookUrl: process.env.NZILA_WEBHOOK_URL ?? "http://localhost:3000/api/webhooks/tests",
         apiKey: process.env.NZILA_API_KEY!,
         appName: process.env.NZILA_APP_NAME ?? "my-app",

package/nzila.config.example.ts

@@ -0,0 +1,11 @@
+/**
+ * Copy to your repo root as `nzila.config.ts` (or run `npx @nzila/sdk link`).
+ * Values come from the dashboard: API Keys → generate key + copy project ID.
+ */
+export default {
+  apiKey: process.env.NZILA_API_KEY ?? "nzl_your_key_here",
+  projectId: process.env.NZILA_PROJECT_ID ?? "00000000-0000-0000-0000-000000000000",
+  appName: process.env.NZILA_APP_NAME ?? "your-app-name",
+  endpoint: process.env.NZILA_APP_URL ?? "https://nzila-kappa.vercel.app",
+  framework: "vitest" as const,
+} as const;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nzila/sdk",
-  "version": "0.1.6",
+  "version": "0.1.9",
   "description": "Send test runs to Nzila, trace live feature errors, and onboard via npx @nzila/sdk.",
   "type": "module",
   "license": "MIT",
@@ -15,6 +15,7 @@
   "files": [
     "dist",
     "vitest.d.ts",
+    "nzila.config.example.ts",
     "jest.d.ts",
     "jest.cjs",
     "mocha.d.ts",

package/vitest.d.ts

@@ -1,15 +1,19 @@
 import type { NzilaClientOptions } from "./dist/types.js";
 
-/** @see {@link nzilaVitestReporter} for use in `defineConfig({ test: { reporters } })`. */
+export const NZILA_VITEST_REPORTER: "@nzila/sdk/vitest";
+
+export type NzilaVitestReporterEntry = [typeof NZILA_VITEST_REPORTER, NzilaClientOptions];
+
+/** Use in `reporters: ["default", nzilaVitestReporter({ ... })]` — not `new NzilaVitestReporter()`. */
+export function nzilaVitestReporter(
+  options: NzilaClientOptions,
+): NzilaVitestReporterEntry;
+
+/** @see nzilaVitestReporter — default export is the reporter class (loaded by Vitest from the tuple). */
 declare class NzilaVitestReporter {
   constructor(options: NzilaClientOptions);
 }
 
 export default NzilaVitestReporter;
 
-/** Vitest-config-safe factory (avoids duplicate `Reporter` types across packages). */
-export function nzilaVitestReporter(
-  options: NzilaClientOptions,
-): import("vitest/node").Reporter;
-
 export * from "./dist/vitest-reporter.js";