@nzila/sdk 0.1.3 → 0.1.5

package/README.md

@@ -11,6 +11,27 @@ npm install @nzila/sdk
 # Vitest projects also need vitest as a peer
 ```
 
+### TypeScript
+
+Subpaths such as `@nzila/sdk/vitest` need **`moduleResolution`** set to **`bundler`**, **`node16`**, or **`nodenext`** (recommended for Vitest/Vite repos). If you still use legacy `"node"` resolution, upgrade to one of those options in `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+`@nzila/sdk@0.1.4+` also ships root `.d.ts` shims and `typesVersions` for broader editor support.
+
+### 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.
+2. Run with **`NZILA_DEBUG=1`** to see skip/send messages on stderr (reporters are silent by default).
+3. **Vitest 3+** uses `onTestRunEnd` — use `@nzila/sdk@0.1.5+`.
+4. **Jest** with `jest.config.cjs`: use `reporters: [["@nzila/sdk/jest", { … }]]` (CJS entry is included).
+
 ## CLI (onboarding)
 
 `npx @nzila/sdk` opens the [Nzila dashboard](https://nzila-kappa.vercel.app) and prints setup commands. No separate CLI package.

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

@@ -0,0 +1,5 @@
+import type { TestModule } from "vitest/node";
+import type { NzilaClientOptions, NzilaTestCase } from "./types.js";
+/** Collect finished tests from Vitest 3+ `TestModule` reporters API. */
+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

@@ -0,0 +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"}

package/dist/collect-vitest-tests.js

@@ -0,0 +1,53 @@
+function describePathFor(test) {
+    const path = [];
+    let parent = test.parent;
+    while (parent.type === "suite") {
+        path.unshift(parent.name);
+        parent = parent.parent;
+    }
+    return path;
+}
+function mapStatus(state) {
+    if (state === "passed")
+        return "passed";
+    if (state === "failed")
+        return "failed";
+    if (state === "skipped")
+        return "skipped";
+    return "pending";
+}
+/** Collect finished tests from Vitest 3+ `TestModule` reporters API. */
+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();
+            if (result.state === "pending")
+                continue;
+            const describePath = describePathFor(test);
+            const feature = options.mapFeature?.(describePath, test.name) ??
+                describePath[0] ??
+                "general";
+            const errors = result.errors?.map((e) => ({
+                message: e.message ?? String(e),
+                stack: e.stack,
+            })) ?? [];
+            tests.push({
+                appName: options.appName,
+                framework,
+                startedAt: runStartedAt.toISOString(),
+                finishedAt: now,
+                describePath,
+                feature,
+                context: { layer: options.appName },
+                testName: test.name,
+                status: mapStatus(result.state),
+                duration: test.diagnostic()?.duration ?? 0,
+                errors,
+            });
+        }
+    }
+    return tests;
+}

package/dist/deliver.d.ts

@@ -7,6 +7,8 @@ export type DeliverOptions = {
     apiKey: string;
     /** Retry count on non-2xx (default 3). */
     maxRetries?: number;
+    /** Log skips/failures to stderr (or `NZILA_DEBUG=1`). */
+    debug?: boolean;
 };
 /**
  * POST a completed test run payload to Nzila.

package/dist/deliver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deliver.d.ts","sourceRoot":"","sources":["../src/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC3B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAOvC"}
+{"version":3,"file":"deliver.d.ts","sourceRoot":"","sources":["../src/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC3B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAQF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAOvC"}

package/dist/deliver.js

@@ -1,4 +1,9 @@
 import { nzilaSafeAsync } from "./silent.js";
+function nzilaLog(message, debug) {
+    if (debug || process.env.NZILA_DEBUG === "1") {
+        console.warn(`[nzila] ${message}`);
+    }
+}
 /**
  * POST a completed test run payload to Nzila.
  * Never throws and never logs — failures are ignored so CI and apps stay unaffected.
@@ -10,10 +15,13 @@ export async function sendNzilaRun(payload, options) {
     await nzilaSafeAsync(async () => {
         const webhookUrl = options?.webhookUrl?.trim();
         const apiKey = options?.apiKey?.trim();
-        if (!webhookUrl || !apiKey)
+        if (!webhookUrl || !apiKey) {
+            nzilaLog("Skipped webhook: set webhookUrl + apiKey (or NZILA_WEBHOOK_URL + NZILA_API_KEY).", options.debug);
             return;
+        }
         const maxRetries = options.maxRetries ?? 3;
         let attempt = 0;
+        let lastStatus;
         while (attempt < maxRetries) {
             attempt += 1;
             try {
@@ -25,7 +33,9 @@ export async function sendNzilaRun(payload, options) {
                     },
                     body: JSON.stringify(payload),
                 });
+                lastStatus = res.status;
                 if (res.ok || res.status === 200 || res.status === 202) {
+                    nzilaLog(`Sent run ${payload.runId} (${payload.tests.length} tests) → ${res.status}`, options.debug);
                     return;
                 }
             }
@@ -34,6 +44,7 @@ export async function sendNzilaRun(payload, options) {
             }
             await new Promise((r) => setTimeout(r, attempt * 1000));
         }
+        nzilaLog(`Webhook failed after ${maxRetries} attempts${lastStatus != null ? ` (last HTTP ${lastStatus})` : ""}.`, options.debug);
     });
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"jest-reporter.d.ts","sourceRoot":"","sources":["../src/jest-reporter.ts"],"names":[],"mappings":"AAEA,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,CAAqB;IAC7C,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;IA8CzD,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;IAmDzD,OAAO,CAAC,SAAS;CAQlB;AAED,4CAA4C;AAC5C,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/jest-reporter.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { sendNzilaRun, resolveLocale } from "./deliver.js";
+import { resolveClientOptions } from "./reporter-options.js";
 /**
  * Jest reporter: aggregates results and POSTs one {@link sendNzilaRun} payload on `onRunComplete`.
  *
@@ -11,8 +12,8 @@ import { sendNzilaRun, resolveLocale } from "./deliver.js";
 export default class NzilaJestReporter {
     constructor(options, _globalConfig) {
         this.sent = false;
-        this.options = options;
-        this.runId = options.runId ?? randomUUID();
+        this.options = resolveClientOptions(options);
+        this.runId = this.options.runId ?? randomUUID();
     }
     onRunComplete(_contexts, results) {
         if (this.sent)
@@ -41,8 +42,12 @@ export default class NzilaJestReporter {
                 });
             }
         }
-        if (!tests.length)
+        if (!tests.length) {
+            if (this.options.debug) {
+                console.warn("[nzila] No Jest test results to send.");
+            }
             return;
+        }
         const locale = resolveLocale(this.options.locale);
         const payload = {
             runId: this.runId,

package/dist/reporter-options.d.ts

@@ -0,0 +1,6 @@
+import type { NzilaClientOptions } from "./types.js";
+/** Merge reporter options with `NZILA_*` environment variables. */
+export declare function resolveClientOptions(options: NzilaClientOptions): NzilaClientOptions & {
+    debug: boolean;
+};
+//# sourceMappingURL=reporter-options.d.ts.map

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

@@ -0,0 +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"}

package/dist/reporter-options.js

@@ -0,0 +1,10 @@
+/** Merge reporter options with `NZILA_*` environment variables. */
+export function resolveClientOptions(options) {
+    return {
+        ...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() || "",
+        debug: options.debug === true || process.env.NZILA_DEBUG === "1",
+    };
+}

package/dist/types.d.ts

@@ -49,5 +49,7 @@ export type NzilaClientOptions = {
      * Default: `describePath[0] ?? "general"`.
      */
     mapFeature?: (describePath: string[], testName: string) => string;
+    /** Log delivery skips/success to stderr (or set `NZILA_DEBUG=1`). */
+    debug?: boolean;
 };
 //# sourceMappingURL=types.d.ts.map

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;CACnE,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,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

@@ -1,37 +1,21 @@
 import type { File } from "@vitest/runner";
+import type { Reporter, TestModule } from "vitest/node";
 import type { NzilaClientOptions } from "./types.js";
-interface VitestReporter {
-    onFinished?: (files?: File[], errors?: unknown[]) => void;
-}
 /**
  * Vitest reporter that POSTs one webhook per finished run via {@link sendNzilaRun}.
- *
- * @example
- * ```ts
- * reporters: [
- *   "default",
- *   new NzilaVitestReporter({
- *     webhookUrl: process.env.NZILA_WEBHOOK_URL!,
- *     apiKey: process.env.NZILA_API_KEY!,
- *     appName: "checkout-api",
- *     mapFeature: (path) => path[0] ?? "general",
- *   }),
- * ],
- * ```
+ * Supports Vitest 3+ (`onTestRunEnd`) and legacy `onFinished` file tasks.
  */
-export default class NzilaVitestReporter implements VitestReporter {
+export default class NzilaVitestReporter implements Reporter {
     private readonly options;
     private startedAt;
     private sent;
     private readonly runId;
-    private tests;
-    /**
-     * @param options - Webhook URL, API key, and project `appName` (required).
-     */
     constructor(options: NzilaClientOptions);
+    onTestRunEnd(testModules: ReadonlyArray<TestModule>): void;
+    /** @deprecated Vitest 2 — still invoked in some setups */
     onFinished(files?: File[], _errors?: unknown[]): void;
+    private sendPayload;
     private walkTasks;
     private mapStatus;
 }
-export {};
 //# 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;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAmD,MAAM,YAAY,CAAC;AAEtG,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,cAAc;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,KAAK,CAAuB;IAEpC;;OAEG;gBACS,OAAO,EAAE,kBAAkB;IAKvC,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IA2B9C,OAAO,CAAC,SAAS;IAuCjB,OAAO,CAAC,SAAS;CAMlB"}
+{"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,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKxD,OAAO,KAAK,EAAE,kBAAkB,EAAmD,MAAM,YAAY,CAAC;AAEtG;;;GAGG;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,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC;IAKnD,0DAA0D;IAC1D,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;YAQhC,WAAW;IA2BzB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,SAAS;CAMlB"}

package/dist/vitest-reporter.js

@@ -1,42 +1,41 @@
 import { randomUUID } from "node:crypto";
+import { collectTestsFromVitestModules } from "./collect-vitest-tests.js";
 import { sendNzilaRun, resolveLocale } from "./deliver.js";
+import { resolveClientOptions } from "./reporter-options.js";
 /**
  * Vitest reporter that POSTs one webhook per finished run via {@link sendNzilaRun}.
- *
- * @example
- * ```ts
- * reporters: [
- *   "default",
- *   new NzilaVitestReporter({
- *     webhookUrl: process.env.NZILA_WEBHOOK_URL!,
- *     apiKey: process.env.NZILA_API_KEY!,
- *     appName: "checkout-api",
- *     mapFeature: (path) => path[0] ?? "general",
- *   }),
- * ],
- * ```
+ * Supports Vitest 3+ (`onTestRunEnd`) and legacy `onFinished` file tasks.
  */
 export default class NzilaVitestReporter {
-    /**
-     * @param options - Webhook URL, API key, and project `appName` (required).
-     */
     constructor(options) {
         this.startedAt = new Date();
         this.sent = false;
-        this.tests = [];
-        this.options = options;
-        this.runId = options.runId ?? randomUUID();
+        this.options = resolveClientOptions(options);
+        this.runId = this.options.runId ?? randomUUID();
     }
+    onTestRunEnd(testModules) {
+        const tests = collectTestsFromVitestModules(testModules, this.options, this.startedAt);
+        void this.sendPayload(tests);
+    }
+    /** @deprecated Vitest 2 — still invoked in some setups */
     onFinished(files, _errors) {
+        const tests = [];
+        for (const file of files ?? []) {
+            this.walkTasks(file.tasks, file.name.split("/").slice(0, -1), tests);
+        }
+        void this.sendPayload(tests);
+    }
+    async sendPayload(tests) {
+        if (!tests.length) {
+            if (this.options.debug) {
+                console.warn("[nzila] No finished tests to send (check that tests ran).");
+            }
+            return;
+        }
         if (this.sent)
             return;
         this.sent = true;
         const finishedAt = new Date();
-        for (const file of files ?? []) {
-            this.walkTasks(file.tasks, file.name.split("/").slice(0, -1));
-        }
-        if (!this.tests.length)
-            return;
         const framework = this.options.framework ?? "vitest";
         const locale = resolveLocale(this.options.locale);
         const payload = {
@@ -45,22 +44,24 @@ export default class NzilaVitestReporter {
             framework,
             startedAt: this.startedAt.toISOString(),
             finishedAt: finishedAt.toISOString(),
-            tests: this.tests,
+            tests,
             ...(locale ? { locale } : {}),
         };
-        void sendNzilaRun(payload, this.options);
+        await sendNzilaRun(payload, this.options);
     }
-    walkTasks(tasks, describePath) {
+    walkTasks(tasks, describePath, out) {
         const framework = this.options.framework ?? "vitest";
         const now = new Date().toISOString();
         for (const task of tasks) {
             if (task.type === "suite") {
-                this.walkTasks(task.tasks, [...describePath, task.name]);
+                this.walkTasks(task.tasks, [...describePath, task.name], out);
                 continue;
             }
             if (task.type !== "test")
                 continue;
             const result = task?.result;
+            if (!result?.state || result.state === "skip")
+                continue;
             const errors = result?.errors?.map((e) => ({
                 message: e?.message ?? String(e),
                 stack: e?.stack,
@@ -68,7 +69,7 @@ export default class NzilaVitestReporter {
             const feature = this.options.mapFeature?.(describePath, task.name) ??
                 describePath[0] ??
                 "general";
-            this.tests.push({
+            out.push({
                 appName: this.options.appName,
                 framework,
                 startedAt: this.startedAt.toISOString(),

package/jest.cjs

@@ -0,0 +1,29 @@
+/**
+ * Jest loads reporters via `require()` — this CJS entry delegates to the ESM implementation.
+ */
+let reporterModulePromise;
+
+function loadReporter() {
+  if (!reporterModulePromise) {
+    reporterModulePromise = import("./dist/jest-reporter.js");
+  }
+  return reporterModulePromise;
+}
+
+class NzilaJestReporter {
+  constructor(options, globalConfig) {
+    this._options = options;
+    this._globalConfig = globalConfig;
+    this._delegate = null;
+  }
+
+  async onRunComplete(contexts, results) {
+    if (!this._delegate) {
+      const mod = await loadReporter();
+      this._delegate = new mod.default(this._options, this._globalConfig);
+    }
+    return this._delegate.onRunComplete(contexts, results);
+  }
+}
+
+module.exports = NzilaJestReporter;

package/jest.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./dist/jest-reporter.js";
+export * from "./dist/jest-reporter.js";

package/mocha.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./dist/mocha-reporter.js";
+export * from "./dist/mocha-reporter.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nzila/sdk",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Send test runs to Nzila, trace live feature errors, and onboard via npx @nzila/sdk.",
   "type": "module",
   "license": "MIT",
@@ -14,9 +14,24 @@
   },
   "files": [
     "dist",
+    "vitest.d.ts",
+    "jest.d.ts",
+    "jest.cjs",
+    "mocha.d.ts",
+    "runtime.d.ts",
+    "react.d.ts",
     "README.md",
     "examples"
   ],
+  "typesVersions": {
+    "*": {
+      "vitest": ["./dist/vitest-reporter.d.ts"],
+      "jest": ["./dist/jest-reporter.d.ts"],
+      "mocha": ["./dist/mocha-reporter.d.ts"],
+      "runtime": ["./dist/runtime/index.d.ts"],
+      "react": ["./dist/react/index.d.ts"]
+    }
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
@@ -28,24 +43,30 @@
       "import": "./dist/index.js"
     },
     "./vitest": {
-      "types": "./dist/vitest-reporter.d.ts",
-      "import": "./dist/vitest-reporter.js"
+      "types": "./vitest.d.ts",
+      "import": "./dist/vitest-reporter.js",
+      "default": "./dist/vitest-reporter.js"
     },
     "./jest": {
-      "types": "./dist/jest-reporter.d.ts",
-      "import": "./dist/jest-reporter.js"
+      "types": "./jest.d.ts",
+      "import": "./dist/jest-reporter.js",
+      "require": "./jest.cjs",
+      "default": "./dist/jest-reporter.js"
     },
     "./mocha": {
-      "types": "./dist/mocha-reporter.d.ts",
-      "import": "./dist/mocha-reporter.js"
+      "types": "./mocha.d.ts",
+      "import": "./dist/mocha-reporter.js",
+      "default": "./dist/mocha-reporter.js"
     },
     "./runtime": {
-      "types": "./dist/runtime/index.d.ts",
-      "import": "./dist/runtime/index.js"
+      "types": "./runtime.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
     },
     "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js"
+      "types": "./react.d.ts",
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
     }
   },
   "scripts": {

package/react.d.ts

@@ -0,0 +1 @@
+export * from "./dist/react/index.js";

package/runtime.d.ts

@@ -0,0 +1 @@
+export * from "./dist/runtime/index.js";

package/vitest.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./dist/vitest-reporter.js";
+export * from "./dist/vitest-reporter.js";