@logtape/testing-node 2.3.0-dev.0 → 2.3.0-dev.840

package/README.md

@@ -38,11 +38,11 @@ import { test } from "@logtape/testing-node/autoload";
 import { getLogger } from "@logtape/logtape";
 
 test("case", async () => {
-  getLogger(["my-lib"]).debug("Fixture state: {state}.", {
+  getLogger(["my-lib"]).info("Fixture state: {state}.", {
     state: "ready",
   });
 
-  // Logs emitted here are printed only if this callback fails.
+  // The info log is printed only if this callback fails.
 });
 ~~~~
 
@@ -52,6 +52,10 @@ when LogTape has not been configured yet.  If your suite already configures
 LogTape, that configuration must include `contextLocalStorage`; otherwise, use
 `@logtape/testing-node` and manage setup explicitly.
 
+Set `LOGTAPE_TEST_MODE` to `on-failure`, `always`, or `never`, and
+`LOGTAPE_TEST_LOWEST_LEVEL` to a LogTape level such as `debug` or `info` to
+configure the default reporter used by the autoload `test` and `it` exports.
+
 Use `createTest()` when a suite needs custom reporter options:
 
 ~~~~ typescript

package/dist/autoload.cjs

@@ -24,8 +24,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 //#endregion
 const node_async_hooks = __toESM(require("node:async_hooks"));
 const __logtape_logtape = __toESM(require("@logtape/logtape"));
-const node_test = __toESM(require("node:test"));
 const __logtape_testing_reporter = __toESM(require("@logtape/testing/reporter"));
+const node_test = __toESM(require("node:test"));
 
 //#region src/mod.ts
 /**
@@ -60,52 +60,51 @@ function createIt(options = {}) {
 *
 * @since 2.3.0
 */
-const test = createTest();
+const test$1 = createTest();
 /**
 * A `node:test` `it()` alias that reports LogTape records from failed test
 * callbacks using the default reporter options.
 *
 * @since 2.3.0
 */
-const it = createIt();
+const it$1 = createIt();
 /**
 * Shorthand for marking a test as `only`.
 *
 * @since 2.3.0
 */
-const only = test.only;
+const only$1 = test$1.only;
 /**
 * Shorthand for skipping a test.
 *
 * @since 2.3.0
 */
-const skip = test.skip;
+const skip$1 = test$1.skip;
 /**
 * Shorthand for marking a test as TODO.
 *
 * @since 2.3.0
 */
-const todo = test.todo;
+const todo$1 = test$1.todo;
 /**
 * Shorthand for expecting a test to fail when supported by the active Node.js
 * runtime.
 *
 * @since 2.3.0
 */
-const expectFailure = test.expectFailure;
+const expectFailure$1 = test$1.expectFailure;
 /**
 * Node.js' test assertion tracker when supported by the active runtime.
 *
 * @since 2.3.0
 */
-const assert = test.assert;
+const assert = test$1.assert;
 /**
 * Node.js' snapshot helper when supported by the active runtime.
 *
 * @since 2.3.0
 */
-const snapshot = test.snapshot;
-var src_default = test;
+const snapshot = test$1.snapshot;
 function createNodeTestFunction(baseTest, options, includeExtendedProperties = true) {
 	const register = (...args) => Reflect.apply(baseTest, void 0, wrapCallbackArgument(args, options));
 	const baseExpectFailure = baseTest.expectFailure;
@@ -142,27 +141,48 @@ function wrapNodeCallback(wrap, callback) {
 	if (callback.length >= 2) return function(context, done) {
 		const runCallback = (...args) => Reflect.apply(callback, this, args);
 		wrap(() => new Promise((resolve, reject) => {
+			let callbackReturned = false;
+			let doneCalled = false;
+			let pendingDone = false;
+			let pendingDoneError;
 			let settled = false;
-			const wrappedDone = (error) => {
+			const settle = (error) => {
 				if (settled) return;
 				settled = true;
 				if (error == null) resolve();
 				else reject(error);
 			};
+			const wrappedDone = (error) => {
+				if (doneCalled) return;
+				doneCalled = true;
+				if (!callbackReturned) {
+					pendingDone = true;
+					pendingDoneError = error;
+					return;
+				}
+				settle(error);
+			};
 			try {
-				runCallback(context, wrappedDone);
+				const result = runCallback(context, wrappedDone);
+				callbackReturned = true;
+				if (isPromiseLike(result)) {
+					reject(new TypeError("Callback-style node:test functions must not return a Promise."));
+					return;
+				}
+				if (pendingDone) settle(pendingDoneError);
 			} catch (error) {
+				callbackReturned = true;
 				reject(error);
 			}
 		}))().then(() => done(), (error) => done(error));
 	};
-	if (callback.length === 0) return function() {
-		return wrap(() => Reflect.apply(callback, this, []))();
-	};
 	return function(context) {
 		return wrap(() => Reflect.apply(callback, this, [context]))();
 	};
 }
+function isPromiseLike(value) {
+	return typeof value === "object" && value != null && "then" in value && typeof value.then === "function";
+}
 
 //#endregion
 //#region src/autoload.ts
@@ -176,7 +196,21 @@ if (config == null) (0, __logtape_logtape.configureSync)({
 	}]
 });
 else if (config.contextLocalStorage == null) throw new __logtape_logtape.ConfigError("@logtape/testing-node/autoload requires the existing LogTape configuration to provide contextLocalStorage.");
-var autoload_default = src_default;
+const reporterOptions = (0, __logtape_testing_reporter.getFailureLogReporterOptionsFromEnv)({ getEnv });
+const test = createTest(reporterOptions);
+const it = createIt(reporterOptions);
+const only = test.only;
+const skip = test.skip;
+const todo = test.todo;
+const expectFailure = test.expectFailure;
+function getEnv(name) {
+	try {
+		return process.env[name];
+	} catch {
+		return void 0;
+	}
+}
+var autoload_default = test;
 
 //#endregion
 Object.defineProperty(exports, 'after', {
@@ -236,5 +270,5 @@ Object.defineProperty(exports, 'suite', {
     return node_test.suite;
   }
 });
-exports.test = src_default;
+exports.test = test;
 exports.todo = todo;

package/dist/autoload.d.cts

@@ -75,39 +75,7 @@ declare function createIt(options?: FailureLogReporterOptions$1): NodeTestFuncti
  *
  * @since 2.3.0
  */
-declare const test: NodeTestFunction;
-/**
- * A `node:test` `it()` alias that reports LogTape records from failed test
- * callbacks using the default reporter options.
- *
- * @since 2.3.0
- */
-declare const it: NodeTestFunction;
-/**
- * Shorthand for marking a test as `only`.
- *
- * @since 2.3.0
- */
-declare const only: NodeTestFunction;
-/**
- * Shorthand for skipping a test.
- *
- * @since 2.3.0
- */
-declare const skip: NodeTestFunction;
-/**
- * Shorthand for marking a test as TODO.
- *
- * @since 2.3.0
- */
-declare const todo: NodeTestFunction;
-/**
- * Shorthand for expecting a test to fail when supported by the active Node.js
- * runtime.
- *
- * @since 2.3.0
- */
-declare const expectFailure: NodeTestFunction | undefined;
+
 /**
  * Node.js' test assertion tracker when supported by the active runtime.
  *
@@ -121,5 +89,13 @@ declare const assert: unknown;
  */
 declare const snapshot: unknown;
 //#endregion
+//#region src/autoload.d.ts
+declare const test: NodeTestFunction;
+declare const it: NodeTestFunction;
+declare const only: NodeTestFunction["only"];
+declare const skip: NodeTestFunction["skip"];
+declare const todo: NodeTestFunction["todo"];
+declare const expectFailure: NodeTestFunction["expectFailure"];
+//#endregion
 export { FailureLogReportMode, FailureLogReporterOptions, NodeTestCallback, NodeTestFunction, NodeTestOptions, TestContext, after, afterEach, assert, before, beforeEach, createIt, createTest, test as default, test, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, todo };
 //# sourceMappingURL=autoload.d.cts.map

package/dist/autoload.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"autoload.d.cts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAgCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}
+{"version":3,"file":"autoload.d.cts","names":[],"sources":["../src/mod.ts","../src/autoload.ts"],"sourcesContent":[],"mappings":";;;;;AAmCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAyDN,SAAgE,IAAA,CAAA,EAtG3D,gBAsG2D;AAO7E;KA1GK,gBAAA;;;AC/Ca;AAyBwC;AACJ;AAC1B;AACA;AACA;;;;;iBDyCZ,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;;;;;;;cAyDU;;;;;;cAOA;;;cChIP,MAAM;cACN,IAAI;AD3BV,cC4BM,ID5BW,EC4BL,gBD5BoB,CAAA,MAAA,CAAA;cC6B1B,ID7B0B,EC6BpB,gBD7BoB,CAAA,MAAA,CAAA;cC8B1B,IDzBA,ECyBM,gBDzBN,CAAA,MAAA,CAAA;cC0BA,aDvBA,ECuBe,gBDvBf,CAAA,eAAA,CAAA"}

package/dist/autoload.d.ts

@@ -1,5 +1,5 @@
-import { TestContext, after, afterEach, before, beforeEach, describe, mock, run, suite } from "node:test";
 import { FailureLogReportMode, FailureLogReporterOptions, FailureLogReporterOptions as FailureLogReporterOptions$1 } from "@logtape/testing/reporter";
+import { TestContext, after, afterEach, before, beforeEach, describe, mock, run, suite } from "node:test";
 
 //#region src/mod.d.ts
 
@@ -75,39 +75,7 @@ declare function createIt(options?: FailureLogReporterOptions$1): NodeTestFuncti
  *
  * @since 2.3.0
  */
-declare const test: NodeTestFunction;
-/**
- * A `node:test` `it()` alias that reports LogTape records from failed test
- * callbacks using the default reporter options.
- *
- * @since 2.3.0
- */
-declare const it: NodeTestFunction;
-/**
- * Shorthand for marking a test as `only`.
- *
- * @since 2.3.0
- */
-declare const only: NodeTestFunction;
-/**
- * Shorthand for skipping a test.
- *
- * @since 2.3.0
- */
-declare const skip: NodeTestFunction;
-/**
- * Shorthand for marking a test as TODO.
- *
- * @since 2.3.0
- */
-declare const todo: NodeTestFunction;
-/**
- * Shorthand for expecting a test to fail when supported by the active Node.js
- * runtime.
- *
- * @since 2.3.0
- */
-declare const expectFailure: NodeTestFunction | undefined;
+
 /**
  * Node.js' test assertion tracker when supported by the active runtime.
  *
@@ -121,5 +89,13 @@ declare const assert: unknown;
  */
 declare const snapshot: unknown;
 //#endregion
+//#region src/autoload.d.ts
+declare const test: NodeTestFunction;
+declare const it: NodeTestFunction;
+declare const only: NodeTestFunction["only"];
+declare const skip: NodeTestFunction["skip"];
+declare const todo: NodeTestFunction["todo"];
+declare const expectFailure: NodeTestFunction["expectFailure"];
+//#endregion
 export { FailureLogReportMode, FailureLogReporterOptions, NodeTestCallback, NodeTestFunction, NodeTestOptions, TestContext, after, afterEach, assert, before, beforeEach, createIt, createTest, test as default, test, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, todo };
 //# sourceMappingURL=autoload.d.ts.map

package/dist/autoload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoload.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAgCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}
+{"version":3,"file":"autoload.d.ts","names":[],"sources":["../src/mod.ts","../src/autoload.ts"],"sourcesContent":[],"mappings":";;;;;AAmCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAyDN,SAAgE,IAAA,CAAA,EAtG3D,gBAsG2D;AAO7E;KA1GK,gBAAA;;;AC/Ca;AAyBwC;AACJ;AAC1B;AACA;AACA;;;;;iBDyCZ,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;;;;;;;cAyDU;;;;;;cAOA;;;cChIP,MAAM;cACN,IAAI;AD3BV,cC4BM,ID5BW,EC4BL,gBD5BoB,CAAA,MAAA,CAAA;cC6B1B,ID7B0B,EC6BpB,gBD7BoB,CAAA,MAAA,CAAA;cC8B1B,IDzBA,ECyBM,gBDzBN,CAAA,MAAA,CAAA;cC0BA,aDvBA,ECuBe,gBDvBf,CAAA,eAAA,CAAA"}

package/dist/autoload.js

@@ -1,7 +1,7 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import { ConfigError, configureSync, getConfig } from "@logtape/logtape";
+import { createFailureLogReporter, getFailureLogReporterOptionsFromEnv } from "@logtape/testing/reporter";
 import nodeTest, { after, afterEach, before, beforeEach, describe, it as it$1, mock, run, suite } from "node:test";
-import { createFailureLogReporter } from "@logtape/testing/reporter";
 
 //#region src/mod.ts
 /**
@@ -36,52 +36,51 @@ function createIt(options = {}) {
 *
 * @since 2.3.0
 */
-const test = createTest();
+const test$1 = createTest();
 /**
 * A `node:test` `it()` alias that reports LogTape records from failed test
 * callbacks using the default reporter options.
 *
 * @since 2.3.0
 */
-const it = createIt();
+const it$2 = createIt();
 /**
 * Shorthand for marking a test as `only`.
 *
 * @since 2.3.0
 */
-const only = test.only;
+const only$1 = test$1.only;
 /**
 * Shorthand for skipping a test.
 *
 * @since 2.3.0
 */
-const skip = test.skip;
+const skip$1 = test$1.skip;
 /**
 * Shorthand for marking a test as TODO.
 *
 * @since 2.3.0
 */
-const todo = test.todo;
+const todo$1 = test$1.todo;
 /**
 * Shorthand for expecting a test to fail when supported by the active Node.js
 * runtime.
 *
 * @since 2.3.0
 */
-const expectFailure = test.expectFailure;
+const expectFailure$1 = test$1.expectFailure;
 /**
 * Node.js' test assertion tracker when supported by the active runtime.
 *
 * @since 2.3.0
 */
-const assert = test.assert;
+const assert = test$1.assert;
 /**
 * Node.js' snapshot helper when supported by the active runtime.
 *
 * @since 2.3.0
 */
-const snapshot = test.snapshot;
-var src_default = test;
+const snapshot = test$1.snapshot;
 function createNodeTestFunction(baseTest, options, includeExtendedProperties = true) {
 	const register = (...args) => Reflect.apply(baseTest, void 0, wrapCallbackArgument(args, options));
 	const baseExpectFailure = baseTest.expectFailure;
@@ -118,27 +117,48 @@ function wrapNodeCallback(wrap, callback) {
 	if (callback.length >= 2) return function(context, done) {
 		const runCallback = (...args) => Reflect.apply(callback, this, args);
 		wrap(() => new Promise((resolve, reject) => {
+			let callbackReturned = false;
+			let doneCalled = false;
+			let pendingDone = false;
+			let pendingDoneError;
 			let settled = false;
-			const wrappedDone = (error) => {
+			const settle = (error) => {
 				if (settled) return;
 				settled = true;
 				if (error == null) resolve();
 				else reject(error);
 			};
+			const wrappedDone = (error) => {
+				if (doneCalled) return;
+				doneCalled = true;
+				if (!callbackReturned) {
+					pendingDone = true;
+					pendingDoneError = error;
+					return;
+				}
+				settle(error);
+			};
 			try {
-				runCallback(context, wrappedDone);
+				const result = runCallback(context, wrappedDone);
+				callbackReturned = true;
+				if (isPromiseLike(result)) {
+					reject(new TypeError("Callback-style node:test functions must not return a Promise."));
+					return;
+				}
+				if (pendingDone) settle(pendingDoneError);
 			} catch (error) {
+				callbackReturned = true;
 				reject(error);
 			}
 		}))().then(() => done(), (error) => done(error));
 	};
-	if (callback.length === 0) return function() {
-		return wrap(() => Reflect.apply(callback, this, []))();
-	};
 	return function(context) {
 		return wrap(() => Reflect.apply(callback, this, [context]))();
 	};
 }
+function isPromiseLike(value) {
+	return typeof value === "object" && value != null && "then" in value && typeof value.then === "function";
+}
 
 //#endregion
 //#region src/autoload.ts
@@ -152,8 +172,22 @@ if (config == null) configureSync({
 	}]
 });
 else if (config.contextLocalStorage == null) throw new ConfigError("@logtape/testing-node/autoload requires the existing LogTape configuration to provide contextLocalStorage.");
-var autoload_default = src_default;
+const reporterOptions = getFailureLogReporterOptionsFromEnv({ getEnv });
+const test = createTest(reporterOptions);
+const it = createIt(reporterOptions);
+const only = test.only;
+const skip = test.skip;
+const todo = test.todo;
+const expectFailure = test.expectFailure;
+function getEnv(name) {
+	try {
+		return process.env[name];
+	} catch {
+		return void 0;
+	}
+}
+var autoload_default = test;
 
 //#endregion
-export { after, afterEach, assert, before, beforeEach, createIt, createTest, autoload_default as default, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, src_default as test, todo };
+export { after, afterEach, assert, before, beforeEach, createIt, createTest, autoload_default as default, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, test, todo };
 //# sourceMappingURL=autoload.js.map

package/dist/autoload.js.map

@@ -1 +1 @@
-{"version":3,"file":"autoload.js","names":["options: FailureLogReporterOptions","nodeIt","test: NodeTestFunction","it: NodeTestFunction","only: NodeTestFunction","skip: NodeTestFunction","todo: NodeTestFunction","expectFailure: NodeTestFunction | undefined","assert: unknown","snapshot: unknown","baseTest: BaseNodeTestFunction","args: readonly unknown[]","wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"]","callback: AnyFunction","context: TestContext","done: NodeDoneCallback","wrappedDone: NodeDoneCallback","error?: unknown","error: unknown","test"],"sources":["../src/mod.ts","../src/autoload.ts"],"sourcesContent":["import nodeTest, { it as nodeIt } from \"node:test\";\nimport type { TestContext } from \"node:test\";\n\nimport {\n  createFailureLogReporter,\n  type FailureLogReporterOptions,\n} from \"@logtape/testing/reporter\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n} from \"@logtape/testing/reporter\";\nexport {\n  after,\n  afterEach,\n  before,\n  beforeEach,\n  describe,\n  mock,\n  run,\n  suite,\n} from \"node:test\";\n\n/**\n * Options accepted by Node.js `test()` and `it()` functions.\n *\n * The shape intentionally mirrors Node's documented option bag while allowing\n * newer Node.js options to pass through even when a runtime's bundled TypeScript\n * declarations lag behind the current documentation.\n *\n * @since 2.3.0\n */\nexport interface NodeTestOptions {\n  readonly concurrency?: number | boolean;\n  readonly expectFailure?:\n    | boolean\n    | string\n    | RegExp\n    | ((error: unknown) => boolean)\n    | object\n    | Error;\n  readonly only?: boolean;\n  readonly signal?: AbortSignal;\n  readonly skip?: boolean | string;\n  readonly tags?: readonly string[];\n  readonly todo?: boolean | string;\n  readonly timeout?: number;\n  readonly plan?: number;\n}\n\n/**\n * A callback passed to Node.js `test()` or `it()`.\n *\n * @since 2.3.0\n */\nexport type NodeTestCallback = (\n  context: TestContext,\n  done?: NodeDoneCallback,\n) => unknown;\n\n/**\n * A Node.js `test()`-compatible function.\n *\n * @since 2.3.0\n */\nexport interface NodeTestFunction {\n  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<\n    void\n  >;\n  (name?: string, fn?: NodeTestCallback): Promise<void>;\n  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;\n  (fn?: NodeTestCallback): Promise<void>;\n  readonly only: NodeTestFunction;\n  readonly skip: NodeTestFunction;\n  readonly todo: NodeTestFunction;\n  readonly expectFailure?: NodeTestFunction;\n  readonly it?: NodeTestFunction;\n  readonly test?: NodeTestFunction;\n}\n\ntype NodeDoneCallback = (error?: unknown) => void;\ntype AnyFunction = (...args: never[]) => unknown;\ntype BaseNodeTestFunction = AnyFunction & {\n  readonly only: AnyFunction;\n  readonly skip: AnyFunction;\n  readonly todo: AnyFunction;\n  readonly expectFailure?: AnyFunction;\n  readonly it?: AnyFunction;\n  readonly test?: AnyFunction;\n};\n\n/**\n * Creates a `node:test` test function that reports LogTape records from failed\n * test callbacks.\n *\n * The returned function preserves Node.js test options and shorthand helpers\n * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback\n * arguments are adapted; options are passed through to `node:test`.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible test function.\n * @since 2.3.0\n */\nexport function createTest(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeTest as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * Creates an `it()` alias that reports LogTape records from failed test\n * callbacks.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible `it()` function.\n * @since 2.3.0\n */\nexport function createIt(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeIt as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * A `node:test` test function that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const test: NodeTestFunction = createTest();\n\n/**\n * A `node:test` `it()` alias that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const it: NodeTestFunction = createIt();\n\n/**\n * Shorthand for marking a test as `only`.\n *\n * @since 2.3.0\n */\nexport const only: NodeTestFunction = test.only;\n\n/**\n * Shorthand for skipping a test.\n *\n * @since 2.3.0\n */\nexport const skip: NodeTestFunction = test.skip;\n\n/**\n * Shorthand for marking a test as TODO.\n *\n * @since 2.3.0\n */\nexport const todo: NodeTestFunction = test.todo;\n\n/**\n * Shorthand for expecting a test to fail when supported by the active Node.js\n * runtime.\n *\n * @since 2.3.0\n */\nexport const expectFailure: NodeTestFunction | undefined = test.expectFailure;\n\n/**\n * Node.js' test assertion tracker when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const assert: unknown = (test as { readonly assert?: unknown }).assert;\n\n/**\n * Node.js' snapshot helper when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const snapshot: unknown = (test as { readonly snapshot?: unknown })\n  .snapshot;\n\nexport default test;\n\nfunction createNodeTestFunction(\n  baseTest: BaseNodeTestFunction,\n  options: FailureLogReporterOptions,\n  includeExtendedProperties = true,\n): NodeTestFunction {\n  const register = ((...args: unknown[]) =>\n    Reflect.apply(\n      baseTest,\n      undefined,\n      wrapCallbackArgument(args, options),\n    )) as NodeTestFunction;\n\n  const baseExpectFailure = baseTest.expectFailure;\n  const wrapped = Object.assign(register, baseTest, {\n    only: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.only,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"only\"],\n    skip: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.skip,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"skip\"],\n    todo: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.todo,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"todo\"],\n    expectFailure: typeof baseExpectFailure === \"function\"\n      ? ((...args: unknown[]) =>\n        Reflect.apply(\n          baseExpectFailure,\n          undefined,\n          wrapCallbackArgument(args, options),\n        )) as NodeTestFunction[\"expectFailure\"]\n      : undefined,\n  });\n\n  if (includeExtendedProperties) {\n    if (typeof baseTest.it === \"function\") {\n      Object.defineProperty(wrapped, \"it\", {\n        configurable: true,\n        enumerable: true,\n        value: createNodeTestFunction(\n          baseTest.it as BaseNodeTestFunction,\n          options,\n          false,\n        ),\n        writable: true,\n      });\n    }\n    if (typeof baseTest.test === \"function\") {\n      Object.defineProperty(wrapped, \"test\", {\n        configurable: true,\n        enumerable: true,\n        value: wrapped,\n        writable: true,\n      });\n    }\n  }\n\n  return wrapped;\n}\n\nfunction wrapCallbackArgument(\n  args: readonly unknown[],\n  options: FailureLogReporterOptions,\n): unknown[] {\n  const callback = args.at(-1);\n  if (typeof callback !== \"function\") return [...args];\n\n  const reporter = createFailureLogReporter(options);\n  const wrapped = wrapNodeCallback(\n    reporter.wrap.bind(reporter),\n    callback as unknown as AnyFunction,\n  );\n  return [...args.slice(0, -1), wrapped];\n}\n\nfunction wrapNodeCallback(\n  wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"],\n  callback: AnyFunction,\n): AnyFunction {\n  if (callback.length >= 2) {\n    return function (\n      this: unknown,\n      context: TestContext,\n      done: NodeDoneCallback,\n    ): void {\n      const runCallback = (...args: readonly unknown[]): unknown =>\n        Reflect.apply(callback, this, args);\n      void wrap(() =>\n        new Promise<void>((resolve, reject) => {\n          let settled = false;\n          const wrappedDone: NodeDoneCallback = ((error?: unknown) => {\n            if (settled) return;\n            settled = true;\n            if (error == null) resolve();\n            else reject(error);\n          }) as NodeDoneCallback;\n\n          try {\n            runCallback(context, wrappedDone);\n          } catch (error) {\n            reject(error);\n          }\n        })\n      )().then(\n        () => done(),\n        (error: unknown) => done(error),\n      );\n    };\n  }\n\n  if (callback.length === 0) {\n    return function (this: unknown): Promise<unknown> {\n      return wrap(() => Reflect.apply(callback, this, []))();\n    };\n  }\n\n  return function (this: unknown, context: TestContext): Promise<unknown> {\n    return wrap(() => Reflect.apply(callback, this, [context]))();\n  };\n}\n\nexport type { TestContext };\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport {\n  ConfigError,\n  configureSync,\n  type ContextLocalStorage,\n  getConfig,\n} from \"@logtape/logtape\";\n\nimport {\n  after,\n  afterEach,\n  assert,\n  before,\n  beforeEach,\n  createIt,\n  createTest,\n  default as test,\n  describe,\n  expectFailure,\n  it,\n  mock,\n  only,\n  run,\n  skip,\n  snapshot,\n  suite,\n  todo,\n} from \"./mod.ts\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n  NodeTestCallback,\n  NodeTestFunction,\n  NodeTestOptions,\n  TestContext,\n} from \"./mod.ts\";\n\nconst config = getConfig();\n\nif (config == null) {\n  configureSync({\n    contextLocalStorage: new AsyncLocalStorage() as ContextLocalStorage<\n      Record<string, unknown>\n    >,\n    sinks: {},\n    loggers: [\n      { category: [\"logtape\", \"meta\"], sinks: [] },\n    ],\n  });\n} else if (config.contextLocalStorage == null) {\n  throw new ConfigError(\n    \"@logtape/testing-node/autoload requires the existing LogTape \" +\n      \"configuration to provide contextLocalStorage.\",\n  );\n}\n\nexport {\n  after,\n  afterEach,\n  assert,\n  before,\n  beforeEach,\n  createIt,\n  createTest,\n  describe,\n  expectFailure,\n  it,\n  mock,\n  only,\n  run,\n  skip,\n  snapshot,\n  suite,\n  test,\n  todo,\n};\nexport default test;\n"],"mappings":"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"}
+{"version":3,"file":"autoload.js","names":["options: FailureLogReporterOptions","nodeIt","test: NodeTestFunction","it: NodeTestFunction","only: NodeTestFunction","test","skip: NodeTestFunction","todo: NodeTestFunction","expectFailure: NodeTestFunction | undefined","assert: unknown","snapshot: unknown","baseTest: BaseNodeTestFunction","register: NodeTestFunction","args: readonly unknown[]","wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"]","callback: AnyFunction","context: TestContext","done: NodeDoneCallback","pendingDoneError: unknown","error?: unknown","wrappedDone: NodeDoneCallback","error: unknown","value: unknown","reporterOptions: FailureLogReporterOptions","test: NodeTestFunction","it: NodeTestFunction","only: NodeTestFunction[\"only\"]","skip: NodeTestFunction[\"skip\"]","todo: NodeTestFunction[\"todo\"]","expectFailure: NodeTestFunction[\"expectFailure\"]","name: string"],"sources":["../src/mod.ts","../src/autoload.ts"],"sourcesContent":["// deno-coverage-ignore-file -- This package targets node:test.  Deno's\n// node:test shim rejects the nested registrations needed by the integration\n// tests, so coverage for this module comes from the Node.js and Bun jobs.\nimport nodeTest, { it as nodeIt } from \"node:test\";\nimport type { TestContext } from \"node:test\";\n\nimport {\n  createFailureLogReporter,\n  type FailureLogReporterOptions,\n} from \"@logtape/testing/reporter\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n} from \"@logtape/testing/reporter\";\nexport {\n  after,\n  afterEach,\n  before,\n  beforeEach,\n  describe,\n  mock,\n  run,\n  suite,\n} from \"node:test\";\n\n/**\n * Options accepted by Node.js `test()` and `it()` functions.\n *\n * The shape intentionally mirrors Node's documented option bag while allowing\n * newer Node.js options to pass through even when a runtime's bundled TypeScript\n * declarations lag behind the current documentation.\n *\n * @since 2.3.0\n */\nexport interface NodeTestOptions {\n  readonly concurrency?: number | boolean;\n  readonly expectFailure?:\n    | boolean\n    | string\n    | RegExp\n    | ((error: unknown) => boolean)\n    | object\n    | Error;\n  readonly only?: boolean;\n  readonly signal?: AbortSignal;\n  readonly skip?: boolean | string;\n  readonly tags?: readonly string[];\n  readonly todo?: boolean | string;\n  readonly timeout?: number;\n  readonly plan?: number;\n}\n\n/**\n * A callback passed to Node.js `test()` or `it()`.\n *\n * @since 2.3.0\n */\nexport type NodeTestCallback = (\n  context: TestContext,\n  done?: NodeDoneCallback,\n) => unknown;\n\n/**\n * A Node.js `test()`-compatible function.\n *\n * @since 2.3.0\n */\nexport interface NodeTestFunction {\n  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<\n    void\n  >;\n  (name?: string, fn?: NodeTestCallback): Promise<void>;\n  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;\n  (fn?: NodeTestCallback): Promise<void>;\n  readonly only: NodeTestFunction;\n  readonly skip: NodeTestFunction;\n  readonly todo: NodeTestFunction;\n  readonly expectFailure?: NodeTestFunction;\n  readonly it?: NodeTestFunction;\n  readonly test?: NodeTestFunction;\n}\n\ntype NodeDoneCallback = (error?: unknown) => void;\ntype AnyFunction = (...args: never[]) => unknown;\ntype BaseNodeTestFunction = AnyFunction & {\n  readonly only: AnyFunction;\n  readonly skip: AnyFunction;\n  readonly todo: AnyFunction;\n  readonly expectFailure?: AnyFunction;\n  readonly it?: AnyFunction;\n  readonly test?: AnyFunction;\n};\n\n/**\n * Creates a `node:test` test function that reports LogTape records from failed\n * test callbacks.\n *\n * The returned function preserves Node.js test options and shorthand helpers\n * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback\n * arguments are adapted; options are passed through to `node:test`.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible test function.\n * @since 2.3.0\n */\nexport function createTest(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeTest as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * Creates an `it()` alias that reports LogTape records from failed test\n * callbacks.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible `it()` function.\n * @since 2.3.0\n */\nexport function createIt(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeIt as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * A `node:test` test function that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const test: NodeTestFunction = createTest();\n\n/**\n * A `node:test` `it()` alias that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const it: NodeTestFunction = createIt();\n\n/**\n * Shorthand for marking a test as `only`.\n *\n * @since 2.3.0\n */\nexport const only: NodeTestFunction = test.only;\n\n/**\n * Shorthand for skipping a test.\n *\n * @since 2.3.0\n */\nexport const skip: NodeTestFunction = test.skip;\n\n/**\n * Shorthand for marking a test as TODO.\n *\n * @since 2.3.0\n */\nexport const todo: NodeTestFunction = test.todo;\n\n/**\n * Shorthand for expecting a test to fail when supported by the active Node.js\n * runtime.\n *\n * @since 2.3.0\n */\nexport const expectFailure: NodeTestFunction | undefined = test.expectFailure;\n\n/**\n * Node.js' test assertion tracker when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const assert: unknown = (test as { readonly assert?: unknown }).assert;\n\n/**\n * Node.js' snapshot helper when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const snapshot: unknown = (test as { readonly snapshot?: unknown })\n  .snapshot;\n\nexport default test;\n\nfunction createNodeTestFunction(\n  baseTest: BaseNodeTestFunction,\n  options: FailureLogReporterOptions,\n  includeExtendedProperties = true,\n): NodeTestFunction {\n  const register: NodeTestFunction = ((...args: unknown[]) =>\n    Reflect.apply(\n      baseTest,\n      undefined,\n      wrapCallbackArgument(args, options),\n    )) as NodeTestFunction;\n\n  const baseExpectFailure = baseTest.expectFailure;\n  const wrapped = Object.assign(register, baseTest, {\n    only: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.only,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"only\"],\n    skip: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.skip,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"skip\"],\n    todo: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.todo,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"todo\"],\n    expectFailure: typeof baseExpectFailure === \"function\"\n      ? ((...args: unknown[]) =>\n        Reflect.apply(\n          baseExpectFailure,\n          undefined,\n          wrapCallbackArgument(args, options),\n        )) as NodeTestFunction[\"expectFailure\"]\n      : undefined,\n  });\n\n  if (includeExtendedProperties) {\n    if (typeof baseTest.it === \"function\") {\n      Object.defineProperty(wrapped, \"it\", {\n        configurable: true,\n        enumerable: true,\n        value: createNodeTestFunction(\n          baseTest.it as BaseNodeTestFunction,\n          options,\n          false,\n        ),\n        writable: true,\n      });\n    }\n    if (typeof baseTest.test === \"function\") {\n      Object.defineProperty(wrapped, \"test\", {\n        configurable: true,\n        enumerable: true,\n        value: wrapped,\n        writable: true,\n      });\n    }\n  }\n\n  return wrapped;\n}\n\nfunction wrapCallbackArgument(\n  args: readonly unknown[],\n  options: FailureLogReporterOptions,\n): unknown[] {\n  const callback = args.at(-1);\n  if (typeof callback !== \"function\") return [...args];\n\n  const reporter = createFailureLogReporter(options);\n  const wrapped = wrapNodeCallback(\n    reporter.wrap.bind(reporter),\n    callback as unknown as AnyFunction,\n  );\n  return [...args.slice(0, -1), wrapped];\n}\n\nfunction wrapNodeCallback(\n  wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"],\n  callback: AnyFunction,\n): AnyFunction {\n  if (callback.length >= 2) {\n    return function (\n      this: unknown,\n      context: TestContext,\n      done: NodeDoneCallback,\n    ): void {\n      const runCallback = (...args: readonly unknown[]): unknown =>\n        Reflect.apply(callback, this, args);\n      void wrap(() =>\n        new Promise<void>((resolve, reject) => {\n          let callbackReturned = false;\n          let doneCalled = false;\n          let pendingDone = false;\n          let pendingDoneError: unknown;\n          let settled = false;\n          const settle = (error?: unknown): void => {\n            if (settled) return;\n            settled = true;\n            if (error == null) resolve();\n            else reject(error);\n          };\n          const wrappedDone: NodeDoneCallback = ((error?: unknown) => {\n            if (doneCalled) return;\n            doneCalled = true;\n            if (!callbackReturned) {\n              pendingDone = true;\n              pendingDoneError = error;\n              return;\n            }\n            settle(error);\n          }) as NodeDoneCallback;\n\n          try {\n            const result = runCallback(context, wrappedDone);\n            callbackReturned = true;\n            if (isPromiseLike(result)) {\n              reject(\n                new TypeError(\n                  \"Callback-style node:test functions must not return a Promise.\",\n                ),\n              );\n              return;\n            }\n            if (pendingDone) settle(pendingDoneError);\n          } catch (error) {\n            callbackReturned = true;\n            reject(error);\n          }\n        })\n      )().then(\n        () => done(),\n        (error: unknown) => done(error),\n      );\n    };\n  }\n\n  return function (this: unknown, context: TestContext): unknown {\n    return wrap(() => Reflect.apply(callback, this, [context]))();\n  };\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return typeof value === \"object\" && value != null &&\n    \"then\" in value &&\n    typeof value.then === \"function\";\n}\n\nexport type { TestContext };\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport {\n  ConfigError,\n  configureSync,\n  type ContextLocalStorage,\n  getConfig,\n} from \"@logtape/logtape\";\nimport {\n  type FailureLogReporterOptions,\n  getFailureLogReporterOptionsFromEnv,\n} from \"@logtape/testing/reporter\";\n\nimport {\n  after,\n  afterEach,\n  assert,\n  before,\n  beforeEach,\n  createIt,\n  createTest,\n  describe,\n  mock,\n  type NodeTestFunction,\n  run,\n  snapshot,\n  suite,\n} from \"./mod.ts\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n  NodeTestCallback,\n  NodeTestFunction,\n  NodeTestOptions,\n  TestContext,\n} from \"./mod.ts\";\n\nconst config = getConfig();\n\nif (config == null) {\n  configureSync({\n    contextLocalStorage: new AsyncLocalStorage() as ContextLocalStorage<\n      Record<string, unknown>\n    >,\n    sinks: {},\n    loggers: [\n      { category: [\"logtape\", \"meta\"], sinks: [] },\n    ],\n  });\n} else if (config.contextLocalStorage == null) {\n  throw new ConfigError(\n    \"@logtape/testing-node/autoload requires the existing LogTape \" +\n      \"configuration to provide contextLocalStorage.\",\n  );\n}\n\nconst reporterOptions: FailureLogReporterOptions =\n  getFailureLogReporterOptionsFromEnv({\n    getEnv,\n  });\nconst test: NodeTestFunction = createTest(reporterOptions);\nconst it: NodeTestFunction = createIt(reporterOptions);\nconst only: NodeTestFunction[\"only\"] = test.only;\nconst skip: NodeTestFunction[\"skip\"] = test.skip;\nconst todo: NodeTestFunction[\"todo\"] = test.todo;\nconst expectFailure: NodeTestFunction[\"expectFailure\"] = test.expectFailure;\n\nfunction getEnv(name: string): string | undefined {\n  try {\n    return process.env[name];\n  } catch {\n    return undefined;\n  }\n}\n\nexport {\n  after,\n  afterEach,\n  assert,\n  before,\n  beforeEach,\n  createIt,\n  createTest,\n  describe,\n  expectFailure,\n  it,\n  mock,\n  only,\n  run,\n  skip,\n  snapshot,\n  suite,\n  test,\n  todo,\n};\nexport default test;\n"],"mappings":"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"}

package/dist/mod.cjs

@@ -118,27 +118,48 @@ function wrapNodeCallback(wrap, callback) {
 	if (callback.length >= 2) return function(context, done) {
 		const runCallback = (...args) => Reflect.apply(callback, this, args);
 		wrap(() => new Promise((resolve, reject) => {
+			let callbackReturned = false;
+			let doneCalled = false;
+			let pendingDone = false;
+			let pendingDoneError;
 			let settled = false;
-			const wrappedDone = (error) => {
+			const settle = (error) => {
 				if (settled) return;
 				settled = true;
 				if (error == null) resolve();
 				else reject(error);
 			};
+			const wrappedDone = (error) => {
+				if (doneCalled) return;
+				doneCalled = true;
+				if (!callbackReturned) {
+					pendingDone = true;
+					pendingDoneError = error;
+					return;
+				}
+				settle(error);
+			};
 			try {
-				runCallback(context, wrappedDone);
+				const result = runCallback(context, wrappedDone);
+				callbackReturned = true;
+				if (isPromiseLike(result)) {
+					reject(new TypeError("Callback-style node:test functions must not return a Promise."));
+					return;
+				}
+				if (pendingDone) settle(pendingDoneError);
 			} catch (error) {
+				callbackReturned = true;
 				reject(error);
 			}
 		}))().then(() => done(), (error) => done(error));
 	};
-	if (callback.length === 0) return function() {
-		return wrap(() => Reflect.apply(callback, this, []))();
-	};
 	return function(context) {
 		return wrap(() => Reflect.apply(callback, this, [context]))();
 	};
 }
+function isPromiseLike(value) {
+	return typeof value === "object" && value != null && "then" in value && typeof value.then === "function";
+}
 
 //#endregion
 Object.defineProperty(exports, 'after', {

package/dist/mod.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.cts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAgCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}
+{"version":3,"file":"mod.d.cts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAmCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}

package/dist/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAgCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAmCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}

package/dist/mod.js

@@ -116,27 +116,48 @@ function wrapNodeCallback(wrap, callback) {
 	if (callback.length >= 2) return function(context, done) {
 		const runCallback = (...args) => Reflect.apply(callback, this, args);
 		wrap(() => new Promise((resolve, reject) => {
+			let callbackReturned = false;
+			let doneCalled = false;
+			let pendingDone = false;
+			let pendingDoneError;
 			let settled = false;
-			const wrappedDone = (error) => {
+			const settle = (error) => {
 				if (settled) return;
 				settled = true;
 				if (error == null) resolve();
 				else reject(error);
 			};
+			const wrappedDone = (error) => {
+				if (doneCalled) return;
+				doneCalled = true;
+				if (!callbackReturned) {
+					pendingDone = true;
+					pendingDoneError = error;
+					return;
+				}
+				settle(error);
+			};
 			try {
-				runCallback(context, wrappedDone);
+				const result = runCallback(context, wrappedDone);
+				callbackReturned = true;
+				if (isPromiseLike(result)) {
+					reject(new TypeError("Callback-style node:test functions must not return a Promise."));
+					return;
+				}
+				if (pendingDone) settle(pendingDoneError);
 			} catch (error) {
+				callbackReturned = true;
 				reject(error);
 			}
 		}))().then(() => done(), (error) => done(error));
 	};
-	if (callback.length === 0) return function() {
-		return wrap(() => Reflect.apply(callback, this, []))();
-	};
 	return function(context) {
 		return wrap(() => Reflect.apply(callback, this, [context]))();
 	};
 }
+function isPromiseLike(value) {
+	return typeof value === "object" && value != null && "then" in value && typeof value.then === "function";
+}
 
 //#endregion
 export { after, afterEach, assert, before, beforeEach, createIt, createTest, src_default as default, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, test, todo };

package/dist/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":["options: FailureLogReporterOptions","nodeIt","test: NodeTestFunction","it: NodeTestFunction","only: NodeTestFunction","skip: NodeTestFunction","todo: NodeTestFunction","expectFailure: NodeTestFunction | undefined","assert: unknown","snapshot: unknown","baseTest: BaseNodeTestFunction","args: readonly unknown[]","wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"]","callback: AnyFunction","context: TestContext","done: NodeDoneCallback","wrappedDone: NodeDoneCallback","error?: unknown","error: unknown"],"sources":["../src/mod.ts"],"sourcesContent":["import nodeTest, { it as nodeIt } from \"node:test\";\nimport type { TestContext } from \"node:test\";\n\nimport {\n  createFailureLogReporter,\n  type FailureLogReporterOptions,\n} from \"@logtape/testing/reporter\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n} from \"@logtape/testing/reporter\";\nexport {\n  after,\n  afterEach,\n  before,\n  beforeEach,\n  describe,\n  mock,\n  run,\n  suite,\n} from \"node:test\";\n\n/**\n * Options accepted by Node.js `test()` and `it()` functions.\n *\n * The shape intentionally mirrors Node's documented option bag while allowing\n * newer Node.js options to pass through even when a runtime's bundled TypeScript\n * declarations lag behind the current documentation.\n *\n * @since 2.3.0\n */\nexport interface NodeTestOptions {\n  readonly concurrency?: number | boolean;\n  readonly expectFailure?:\n    | boolean\n    | string\n    | RegExp\n    | ((error: unknown) => boolean)\n    | object\n    | Error;\n  readonly only?: boolean;\n  readonly signal?: AbortSignal;\n  readonly skip?: boolean | string;\n  readonly tags?: readonly string[];\n  readonly todo?: boolean | string;\n  readonly timeout?: number;\n  readonly plan?: number;\n}\n\n/**\n * A callback passed to Node.js `test()` or `it()`.\n *\n * @since 2.3.0\n */\nexport type NodeTestCallback = (\n  context: TestContext,\n  done?: NodeDoneCallback,\n) => unknown;\n\n/**\n * A Node.js `test()`-compatible function.\n *\n * @since 2.3.0\n */\nexport interface NodeTestFunction {\n  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<\n    void\n  >;\n  (name?: string, fn?: NodeTestCallback): Promise<void>;\n  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;\n  (fn?: NodeTestCallback): Promise<void>;\n  readonly only: NodeTestFunction;\n  readonly skip: NodeTestFunction;\n  readonly todo: NodeTestFunction;\n  readonly expectFailure?: NodeTestFunction;\n  readonly it?: NodeTestFunction;\n  readonly test?: NodeTestFunction;\n}\n\ntype NodeDoneCallback = (error?: unknown) => void;\ntype AnyFunction = (...args: never[]) => unknown;\ntype BaseNodeTestFunction = AnyFunction & {\n  readonly only: AnyFunction;\n  readonly skip: AnyFunction;\n  readonly todo: AnyFunction;\n  readonly expectFailure?: AnyFunction;\n  readonly it?: AnyFunction;\n  readonly test?: AnyFunction;\n};\n\n/**\n * Creates a `node:test` test function that reports LogTape records from failed\n * test callbacks.\n *\n * The returned function preserves Node.js test options and shorthand helpers\n * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback\n * arguments are adapted; options are passed through to `node:test`.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible test function.\n * @since 2.3.0\n */\nexport function createTest(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeTest as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * Creates an `it()` alias that reports LogTape records from failed test\n * callbacks.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible `it()` function.\n * @since 2.3.0\n */\nexport function createIt(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeIt as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * A `node:test` test function that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const test: NodeTestFunction = createTest();\n\n/**\n * A `node:test` `it()` alias that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const it: NodeTestFunction = createIt();\n\n/**\n * Shorthand for marking a test as `only`.\n *\n * @since 2.3.0\n */\nexport const only: NodeTestFunction = test.only;\n\n/**\n * Shorthand for skipping a test.\n *\n * @since 2.3.0\n */\nexport const skip: NodeTestFunction = test.skip;\n\n/**\n * Shorthand for marking a test as TODO.\n *\n * @since 2.3.0\n */\nexport const todo: NodeTestFunction = test.todo;\n\n/**\n * Shorthand for expecting a test to fail when supported by the active Node.js\n * runtime.\n *\n * @since 2.3.0\n */\nexport const expectFailure: NodeTestFunction | undefined = test.expectFailure;\n\n/**\n * Node.js' test assertion tracker when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const assert: unknown = (test as { readonly assert?: unknown }).assert;\n\n/**\n * Node.js' snapshot helper when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const snapshot: unknown = (test as { readonly snapshot?: unknown })\n  .snapshot;\n\nexport default test;\n\nfunction createNodeTestFunction(\n  baseTest: BaseNodeTestFunction,\n  options: FailureLogReporterOptions,\n  includeExtendedProperties = true,\n): NodeTestFunction {\n  const register = ((...args: unknown[]) =>\n    Reflect.apply(\n      baseTest,\n      undefined,\n      wrapCallbackArgument(args, options),\n    )) as NodeTestFunction;\n\n  const baseExpectFailure = baseTest.expectFailure;\n  const wrapped = Object.assign(register, baseTest, {\n    only: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.only,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"only\"],\n    skip: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.skip,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"skip\"],\n    todo: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.todo,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"todo\"],\n    expectFailure: typeof baseExpectFailure === \"function\"\n      ? ((...args: unknown[]) =>\n        Reflect.apply(\n          baseExpectFailure,\n          undefined,\n          wrapCallbackArgument(args, options),\n        )) as NodeTestFunction[\"expectFailure\"]\n      : undefined,\n  });\n\n  if (includeExtendedProperties) {\n    if (typeof baseTest.it === \"function\") {\n      Object.defineProperty(wrapped, \"it\", {\n        configurable: true,\n        enumerable: true,\n        value: createNodeTestFunction(\n          baseTest.it as BaseNodeTestFunction,\n          options,\n          false,\n        ),\n        writable: true,\n      });\n    }\n    if (typeof baseTest.test === \"function\") {\n      Object.defineProperty(wrapped, \"test\", {\n        configurable: true,\n        enumerable: true,\n        value: wrapped,\n        writable: true,\n      });\n    }\n  }\n\n  return wrapped;\n}\n\nfunction wrapCallbackArgument(\n  args: readonly unknown[],\n  options: FailureLogReporterOptions,\n): unknown[] {\n  const callback = args.at(-1);\n  if (typeof callback !== \"function\") return [...args];\n\n  const reporter = createFailureLogReporter(options);\n  const wrapped = wrapNodeCallback(\n    reporter.wrap.bind(reporter),\n    callback as unknown as AnyFunction,\n  );\n  return [...args.slice(0, -1), wrapped];\n}\n\nfunction wrapNodeCallback(\n  wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"],\n  callback: AnyFunction,\n): AnyFunction {\n  if (callback.length >= 2) {\n    return function (\n      this: unknown,\n      context: TestContext,\n      done: NodeDoneCallback,\n    ): void {\n      const runCallback = (...args: readonly unknown[]): unknown =>\n        Reflect.apply(callback, this, args);\n      void wrap(() =>\n        new Promise<void>((resolve, reject) => {\n          let settled = false;\n          const wrappedDone: NodeDoneCallback = ((error?: unknown) => {\n            if (settled) return;\n            settled = true;\n            if (error == null) resolve();\n            else reject(error);\n          }) as NodeDoneCallback;\n\n          try {\n            runCallback(context, wrappedDone);\n          } catch (error) {\n            reject(error);\n          }\n        })\n      )().then(\n        () => done(),\n        (error: unknown) => done(error),\n      );\n    };\n  }\n\n  if (callback.length === 0) {\n    return function (this: unknown): Promise<unknown> {\n      return wrap(() => Reflect.apply(callback, this, []))();\n    };\n  }\n\n  return function (this: unknown, context: TestContext): Promise<unknown> {\n    return wrap(() => Reflect.apply(callback, this, [context]))();\n  };\n}\n\nexport type { TestContext };\n"],"mappings":";;;;;;;;;;;;;;;;AAuGA,SAAgB,WACdA,UAAqC,CAAE,GACrB;AAClB,QAAO,uBACL,UACA,QACD;AACF;;;;;;;;;AAUD,SAAgB,SACdA,UAAqC,CAAE,GACrB;AAClB,QAAO,uBACLC,MACA,QACD;AACF;;;;;;;AAQD,MAAaC,OAAyB,YAAY;;;;;;;AAQlD,MAAaC,KAAuB,UAAU;;;;;;AAO9C,MAAaC,OAAyB,KAAK;;;;;;AAO3C,MAAaC,OAAyB,KAAK;;;;;;AAO3C,MAAaC,OAAyB,KAAK;;;;;;;AAQ3C,MAAaC,gBAA8C,KAAK;;;;;;AAOhE,MAAaC,SAAmB,KAAuC;;;;;;AAOvE,MAAaC,WAAqB,KAC/B;AAEH,kBAAe;AAEf,SAAS,uBACPC,UACAV,SACA,4BAA4B,MACV;CAClB,MAAM,WAAY,CAAC,GAAG,SACpB,QAAQ,MACN,kBAEA,qBAAqB,MAAM,QAAQ,CACpC;CAEH,MAAM,oBAAoB,SAAS;CACnC,MAAM,UAAU,OAAO,OAAO,UAAU,UAAU;EAChD,MAAO,CAAC,GAAG,SACT,QAAQ,MACN,SAAS,cAET,qBAAqB,MAAM,QAAQ,CACpC;EACH,MAAO,CAAC,GAAG,SACT,QAAQ,MACN,SAAS,cAET,qBAAqB,MAAM,QAAQ,CACpC;EACH,MAAO,CAAC,GAAG,SACT,QAAQ,MACN,SAAS,cAET,qBAAqB,MAAM,QAAQ,CACpC;EACH,sBAAsB,sBAAsB,aACvC,CAAC,GAAG,SACL,QAAQ,MACN,2BAEA,qBAAqB,MAAM,QAAQ,CACpC;CAEN,EAAC;AAEF,KAAI,2BAA2B;AAC7B,aAAW,SAAS,OAAO,WACzB,QAAO,eAAe,SAAS,MAAM;GACnC,cAAc;GACd,YAAY;GACZ,OAAO,uBACL,SAAS,IACT,SACA,MACD;GACD,UAAU;EACX,EAAC;AAEJ,aAAW,SAAS,SAAS,WAC3B,QAAO,eAAe,SAAS,QAAQ;GACrC,cAAc;GACd,YAAY;GACZ,OAAO;GACP,UAAU;EACX,EAAC;CAEL;AAED,QAAO;AACR;AAED,SAAS,qBACPW,MACAX,SACW;CACX,MAAM,WAAW,KAAK,GAAG,GAAG;AAC5B,YAAW,aAAa,WAAY,QAAO,CAAC,GAAG,IAAK;CAEpD,MAAM,WAAW,yBAAyB,QAAQ;CAClD,MAAM,UAAU,iBACd,SAAS,KAAK,KAAK,SAAS,EAC5B,SACD;AACD,QAAO,CAAC,GAAG,KAAK,MAAM,GAAG,GAAG,EAAE,OAAQ;AACvC;AAED,SAAS,iBACPY,MACAC,UACa;AACb,KAAI,SAAS,UAAU,EACrB,QAAO,SAELC,SACAC,MACM;EACN,MAAM,cAAc,CAAC,GAAG,SACtB,QAAQ,MAAM,UAAU,MAAM,KAAK;AACrC,EAAK,KAAK,MACR,IAAI,QAAc,CAAC,SAAS,WAAW;GACrC,IAAI,UAAU;GACd,MAAMC,cAAiC,CAACC,UAAoB;AAC1D,QAAI,QAAS;AACb,cAAU;AACV,QAAI,SAAS,KAAM,UAAS;QACvB,QAAO,MAAM;GACnB;AAED,OAAI;AACF,gBAAY,SAAS,YAAY;GAClC,SAAQ,OAAO;AACd,WAAO,MAAM;GACd;EACF,GACF,EAAE,CAAC,KACF,MAAM,MAAM,EACZ,CAACC,UAAmB,KAAK,MAAM,CAChC;CACF;AAGH,KAAI,SAAS,WAAW,EACtB,QAAO,WAA2C;AAChD,SAAO,KAAK,MAAM,QAAQ,MAAM,UAAU,MAAM,CAAE,EAAC,CAAC,EAAE;CACvD;AAGH,QAAO,SAAyBJ,SAAwC;AACtE,SAAO,KAAK,MAAM,QAAQ,MAAM,UAAU,MAAM,CAAC,OAAQ,EAAC,CAAC,EAAE;CAC9D;AACF"}
+{"version":3,"file":"mod.js","names":["options: FailureLogReporterOptions","nodeIt","test: NodeTestFunction","it: NodeTestFunction","only: NodeTestFunction","skip: NodeTestFunction","todo: NodeTestFunction","expectFailure: NodeTestFunction | undefined","assert: unknown","snapshot: unknown","baseTest: BaseNodeTestFunction","register: NodeTestFunction","args: readonly unknown[]","wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"]","callback: AnyFunction","context: TestContext","done: NodeDoneCallback","pendingDoneError: unknown","error?: unknown","wrappedDone: NodeDoneCallback","error: unknown","value: unknown"],"sources":["../src/mod.ts"],"sourcesContent":["// deno-coverage-ignore-file -- This package targets node:test.  Deno's\n// node:test shim rejects the nested registrations needed by the integration\n// tests, so coverage for this module comes from the Node.js and Bun jobs.\nimport nodeTest, { it as nodeIt } from \"node:test\";\nimport type { TestContext } from \"node:test\";\n\nimport {\n  createFailureLogReporter,\n  type FailureLogReporterOptions,\n} from \"@logtape/testing/reporter\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n} from \"@logtape/testing/reporter\";\nexport {\n  after,\n  afterEach,\n  before,\n  beforeEach,\n  describe,\n  mock,\n  run,\n  suite,\n} from \"node:test\";\n\n/**\n * Options accepted by Node.js `test()` and `it()` functions.\n *\n * The shape intentionally mirrors Node's documented option bag while allowing\n * newer Node.js options to pass through even when a runtime's bundled TypeScript\n * declarations lag behind the current documentation.\n *\n * @since 2.3.0\n */\nexport interface NodeTestOptions {\n  readonly concurrency?: number | boolean;\n  readonly expectFailure?:\n    | boolean\n    | string\n    | RegExp\n    | ((error: unknown) => boolean)\n    | object\n    | Error;\n  readonly only?: boolean;\n  readonly signal?: AbortSignal;\n  readonly skip?: boolean | string;\n  readonly tags?: readonly string[];\n  readonly todo?: boolean | string;\n  readonly timeout?: number;\n  readonly plan?: number;\n}\n\n/**\n * A callback passed to Node.js `test()` or `it()`.\n *\n * @since 2.3.0\n */\nexport type NodeTestCallback = (\n  context: TestContext,\n  done?: NodeDoneCallback,\n) => unknown;\n\n/**\n * A Node.js `test()`-compatible function.\n *\n * @since 2.3.0\n */\nexport interface NodeTestFunction {\n  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<\n    void\n  >;\n  (name?: string, fn?: NodeTestCallback): Promise<void>;\n  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;\n  (fn?: NodeTestCallback): Promise<void>;\n  readonly only: NodeTestFunction;\n  readonly skip: NodeTestFunction;\n  readonly todo: NodeTestFunction;\n  readonly expectFailure?: NodeTestFunction;\n  readonly it?: NodeTestFunction;\n  readonly test?: NodeTestFunction;\n}\n\ntype NodeDoneCallback = (error?: unknown) => void;\ntype AnyFunction = (...args: never[]) => unknown;\ntype BaseNodeTestFunction = AnyFunction & {\n  readonly only: AnyFunction;\n  readonly skip: AnyFunction;\n  readonly todo: AnyFunction;\n  readonly expectFailure?: AnyFunction;\n  readonly it?: AnyFunction;\n  readonly test?: AnyFunction;\n};\n\n/**\n * Creates a `node:test` test function that reports LogTape records from failed\n * test callbacks.\n *\n * The returned function preserves Node.js test options and shorthand helpers\n * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback\n * arguments are adapted; options are passed through to `node:test`.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible test function.\n * @since 2.3.0\n */\nexport function createTest(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeTest as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * Creates an `it()` alias that reports LogTape records from failed test\n * callbacks.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible `it()` function.\n * @since 2.3.0\n */\nexport function createIt(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeIt as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * A `node:test` test function that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const test: NodeTestFunction = createTest();\n\n/**\n * A `node:test` `it()` alias that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const it: NodeTestFunction = createIt();\n\n/**\n * Shorthand for marking a test as `only`.\n *\n * @since 2.3.0\n */\nexport const only: NodeTestFunction = test.only;\n\n/**\n * Shorthand for skipping a test.\n *\n * @since 2.3.0\n */\nexport const skip: NodeTestFunction = test.skip;\n\n/**\n * Shorthand for marking a test as TODO.\n *\n * @since 2.3.0\n */\nexport const todo: NodeTestFunction = test.todo;\n\n/**\n * Shorthand for expecting a test to fail when supported by the active Node.js\n * runtime.\n *\n * @since 2.3.0\n */\nexport const expectFailure: NodeTestFunction | undefined = test.expectFailure;\n\n/**\n * Node.js' test assertion tracker when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const assert: unknown = (test as { readonly assert?: unknown }).assert;\n\n/**\n * Node.js' snapshot helper when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const snapshot: unknown = (test as { readonly snapshot?: unknown })\n  .snapshot;\n\nexport default test;\n\nfunction createNodeTestFunction(\n  baseTest: BaseNodeTestFunction,\n  options: FailureLogReporterOptions,\n  includeExtendedProperties = true,\n): NodeTestFunction {\n  const register: NodeTestFunction = ((...args: unknown[]) =>\n    Reflect.apply(\n      baseTest,\n      undefined,\n      wrapCallbackArgument(args, options),\n    )) as NodeTestFunction;\n\n  const baseExpectFailure = baseTest.expectFailure;\n  const wrapped = Object.assign(register, baseTest, {\n    only: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.only,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"only\"],\n    skip: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.skip,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"skip\"],\n    todo: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.todo,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"todo\"],\n    expectFailure: typeof baseExpectFailure === \"function\"\n      ? ((...args: unknown[]) =>\n        Reflect.apply(\n          baseExpectFailure,\n          undefined,\n          wrapCallbackArgument(args, options),\n        )) as NodeTestFunction[\"expectFailure\"]\n      : undefined,\n  });\n\n  if (includeExtendedProperties) {\n    if (typeof baseTest.it === \"function\") {\n      Object.defineProperty(wrapped, \"it\", {\n        configurable: true,\n        enumerable: true,\n        value: createNodeTestFunction(\n          baseTest.it as BaseNodeTestFunction,\n          options,\n          false,\n        ),\n        writable: true,\n      });\n    }\n    if (typeof baseTest.test === \"function\") {\n      Object.defineProperty(wrapped, \"test\", {\n        configurable: true,\n        enumerable: true,\n        value: wrapped,\n        writable: true,\n      });\n    }\n  }\n\n  return wrapped;\n}\n\nfunction wrapCallbackArgument(\n  args: readonly unknown[],\n  options: FailureLogReporterOptions,\n): unknown[] {\n  const callback = args.at(-1);\n  if (typeof callback !== \"function\") return [...args];\n\n  const reporter = createFailureLogReporter(options);\n  const wrapped = wrapNodeCallback(\n    reporter.wrap.bind(reporter),\n    callback as unknown as AnyFunction,\n  );\n  return [...args.slice(0, -1), wrapped];\n}\n\nfunction wrapNodeCallback(\n  wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"],\n  callback: AnyFunction,\n): AnyFunction {\n  if (callback.length >= 2) {\n    return function (\n      this: unknown,\n      context: TestContext,\n      done: NodeDoneCallback,\n    ): void {\n      const runCallback = (...args: readonly unknown[]): unknown =>\n        Reflect.apply(callback, this, args);\n      void wrap(() =>\n        new Promise<void>((resolve, reject) => {\n          let callbackReturned = false;\n          let doneCalled = false;\n          let pendingDone = false;\n          let pendingDoneError: unknown;\n          let settled = false;\n          const settle = (error?: unknown): void => {\n            if (settled) return;\n            settled = true;\n            if (error == null) resolve();\n            else reject(error);\n          };\n          const wrappedDone: NodeDoneCallback = ((error?: unknown) => {\n            if (doneCalled) return;\n            doneCalled = true;\n            if (!callbackReturned) {\n              pendingDone = true;\n              pendingDoneError = error;\n              return;\n            }\n            settle(error);\n          }) as NodeDoneCallback;\n\n          try {\n            const result = runCallback(context, wrappedDone);\n            callbackReturned = true;\n            if (isPromiseLike(result)) {\n              reject(\n                new TypeError(\n                  \"Callback-style node:test functions must not return a Promise.\",\n                ),\n              );\n              return;\n            }\n            if (pendingDone) settle(pendingDoneError);\n          } catch (error) {\n            callbackReturned = true;\n            reject(error);\n          }\n        })\n      )().then(\n        () => done(),\n        (error: unknown) => done(error),\n      );\n    };\n  }\n\n  return function (this: unknown, context: TestContext): unknown {\n    return wrap(() => Reflect.apply(callback, this, [context]))();\n  };\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return typeof value === \"object\" && value != null &&\n    \"then\" in value &&\n    typeof value.then === \"function\";\n}\n\nexport type { TestContext };\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logtape/testing-node",
-  "version": "2.3.0-dev.0",
+  "version": "2.3.0-dev.840+34e837bf",
   "description": "Node.js test runner integration for LogTape failure log reporting",
   "keywords": [
     "logging",
@@ -60,15 +60,15 @@
     "dist/"
   ],
   "dependencies": {
-    "@logtape/testing": "^2.3.0"
+    "@logtape/testing": "^2.3.0-dev.840+34e837bf"
   },
   "peerDependencies": {
-    "@logtape/logtape": "^2.3.0"
+    "@logtape/logtape": "^2.3.0-dev.840+34e837bf"
   },
   "devDependencies": {
     "tsdown": "^0.12.7",
     "typescript": "^5.8.3",
-    "@logtape/logtape": "^2.3.0"
+    "@logtape/logtape": "^2.3.0-dev.840+34e837bf"
   },
   "scripts": {
     "build": "tsdown",