@naturalcycles/dev-lib 20.60.0 → 20.61.0

package/dist/testing/testOffline.js

@@ -1,3 +1,4 @@
+import path from 'node:path';
 import { AppError } from '@naturalcycles/js-lib/error/error.util.js';
 import { red } from '@naturalcycles/nodejs-lib/colors';
 import { createMitm } from '../vendor/mitm.js';
@@ -18,7 +19,8 @@ export function testOffline(opt) {
     mitm.on('connect', (socket, socketOptions) => {
         const { host } = socketOptions;
         if (!LOCAL_HOSTS.has(host)) {
-            process.stderr.write(red(`Network request forbidden by testOffline: ${host}\n`));
+            const testInfo = getCurrentTestInfo(host);
+            process.stderr.write(red(`Network request forbidden by testOffline: ${testInfo}\n`));
             opt?.onForbiddenRequest?.(host);
             throw new AppError(`Network request forbidden by testOffline: ${host}`, {
                 backendResponseStatusCode: 410,
@@ -34,3 +36,39 @@ export function testOnline() {
     mitm?.disable();
     mitm = undefined;
 }
+/**
+ * Returns the test name and test file that triggered the request (as tracked by vitest),
+ * formatted as `test: <name>, file: <path>` to append to the alert, so the culprit is easy to find.
+ * Returns an empty string when nothing is known (e.g. vitest is not installed or not running,
+ * or the request was made outside of any test).
+ *
+ * Reads vitest's worker state from the global vitest stores it in (the same source that
+ * `expect.getState()` uses for `testPath` and `currentTestName`), instead of importing `vitest`:
+ * - it has to be synchronous (see the `connect` listener), and `vitest` can only be imported asynchronously
+ * - `vitest` may not be installed in the consuming project
+ */
+function getCurrentTestInfo(host) {
+    const tokens = [host];
+    const state = globalThis['__vitest_worker__'];
+    if (state) {
+        if (state.filepath) {
+            tokens.push(`file: ${path.relative(process.cwd(), state.filepath)}`);
+        }
+        if (state.current?.type === 'test') {
+            tokens.push(`test: ${getFullTestName(state.current)}`);
+        }
+    }
+    return tokens.filter(Boolean).join('\n');
+}
+/**
+ * Test name prefixed with the names of its parent suites (same as `expect.getState().currentTestName`),
+ * e.g. `describe name > nested describe name > test name`.
+ */
+function getFullTestName(test) {
+    const names = [];
+    // Walk up the chain of parent suites; it ends with `undefined` (or with the file itself, which is excluded)
+    for (let task = test; task && task !== test.file; task = task.suite) {
+        names.push(task.name);
+    }
+    return names.reverse().join(' > ');
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/dev-lib",
   "type": "module",
-  "version": "20.60.0",
+  "version": "20.61.0",
   "dependencies": {
     "prompts": "^2",
     "@naturalcycles/js-lib": "^15",