@btravstack/testing 0.16.0 → 0.17.0

package/README.md

@@ -126,8 +126,7 @@ pair, a `node:http` listener answering its public key as a JWKS, and a
 `sign(claims?, options?)` closing over the private key — a real fetch against
 a real JWKS document, for a test that wants the verifying library's own
 behaviour rather than a double's. `sign`'s `expiresIn: false` mints a token
-with no `exp` claim; `localIssuer`'s `algorithm` picks the asymmetric algorithm
-(default `"RS256"`). The subpath needs Node ≥22.12 under CommonJS — `jose` is
+with no `exp` claim, and the key is RS256. The subpath needs Node ≥22.12 under CommonJS — `jose` is
 ESM-only, so the CJS build's `require("jose")` depends on `require(esm)`;
 ESM consumers, and anyone who never imports the subpath, are unaffected.
 

package/dist/index.cjs

@@ -161,21 +161,11 @@ const testRuntime = (name = "test", options = {}) => {
 	let accepting = false;
 	let serving;
 	let submitted = 0;
-	let onStarted;
-	const started = new Promise((resolve) => {
-		onStarted = resolve;
-	});
-	const make = () => ({
-		info: { name },
-		drain: (signal) => {
-			accepting = false;
-			return (0, unthrown.OkAsync)();
-		},
-		stop: () => {
-			accepting = false;
-			return (0, unthrown.OkAsync)();
-		}
-	});
+	const started = Promise.withResolvers();
+	const stopAccepting = () => {
+		accepting = false;
+		return (0, unthrown.OkAsync)();
+	};
 	const runtime = {
 		name,
 		module: (0, _btravstack_di.Module)("TestRuntime")({
@@ -189,12 +179,16 @@ const testRuntime = (name = "test", options = {}) => {
 		start: (h) => {
 			host = h;
 			accepting = true;
-			serving = make();
-			onStarted();
+			serving = {
+				info: { name },
+				drain: stopAccepting,
+				stop: stopAccepting
+			};
+			started.resolve();
 			return (0, unthrown.OkAsync)(serving);
 		},
 		started: () => serving !== void 0,
-		untilStarted: () => (0, unthrown.fromSafePromise)(started),
+		untilStarted: () => (0, unthrown.fromSafePromise)(started.promise),
 		accepting: () => accepting,
 		serving: () => {
 			if (serving === void 0) throw new Error("[test-runtime] not started");
@@ -207,10 +201,7 @@ const testRuntime = (name = "test", options = {}) => {
 		submit: () => {
 			if (host === void 0 || !accepting) throw new Error("[test-runtime] not accepting work");
 			submitted += 1;
-			let settle;
-			const held = new Promise((resolve) => {
-				settle = resolve;
-			});
+			const held = Promise.withResolvers();
 			const forwarded = new AbortController();
 			const unit = options.unit;
 			const result = host.run({
@@ -219,10 +210,10 @@ const testRuntime = (name = "test", options = {}) => {
 			}, (unitHost, signal) => {
 				if (signal.aborted) forwarded.abort(signal.reason);
 				else signal.addEventListener("abort", () => forwarded.abort(signal.reason), { once: true });
-				return unit === void 0 ? held : unitHost.fork(unit, []).flatMap(() => (0, unthrown.fromSafePromise)(held).flatMap((r) => r));
+				return unit === void 0 ? held.promise : unitHost.fork(unit, []).flatMap(() => (0, unthrown.fromSafePromise)(held.promise).flatMap((r) => r));
 			});
 			return {
-				settle,
+				settle: held.resolve,
 				result,
 				signal: forwarded.signal
 			};

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { Clock, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, RuntimePort, Serving, StartGate, StartOptions } from "@btravstack/core";
-import { AnyPort, Module, Provider, Scope, ServiceOf } from "@btravstack/di";
+import { AnyUnitModule, Clock, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, RuntimePort, Serving, StartGate, StartOptions, UnitNeedsOf } from "@btravstack/core";
+import { AnyPort, Module, Provider, ServiceOf } from "@btravstack/di";
 import { AsyncResult, Result } from "unthrown";
 //#region src/boot-fixture.d.ts
 /**
@@ -143,21 +143,6 @@ type TestRuntimeInfo = {
 };
 /** The in-memory runtime's port: what `TestRuntime.module` provides, and what a test composition exports. */
 export declare class TestRuntimePort extends RuntimePort<Runtime<never, TestRuntimeInfo>> {}
-/**
- * A module `options.unit` may bind, as the upper bound `testRuntime`
- * constrains its own `Unit` type parameter to. `Module`'s `_exports` channel is
- * contravariant, so `Exports = never` — never `unknown` — is what makes a REAL
- * module's own (necessarily narrower) export type assignable to this bound.
- * `@btravstack/http-server`'s `AnyUnitModule` carries the same bound for the
- * same reason.
- */
-type AnyUnitModule = Module<never, never, unknown>;
-/**
- * The needs a bound `unit` module still owes, or `never` when none is bound.
- * `Scope` is excluded, since nothing can ever provide it — the same exemption
- * `NeedsGate` itself carries.
- */
-type UnitNeedsOf<Unit> = Unit extends Module<never, never, infer N> ? Exclude<N, Scope> : never;
 type TestRuntimeOptions<Unit extends AnyUnitModule | undefined = undefined> = {
   /** A module every submitted unit forks, with no seed, before its work runs. */
   readonly unit?: Unit;

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { Clock, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, RuntimePort, Serving, StartGate, StartOptions } from "@btravstack/core";
+import { AnyUnitModule, Clock, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, RuntimePort, Serving, StartGate, StartOptions, UnitNeedsOf } from "@btravstack/core";
 import { AsyncResult, Result } from "unthrown";
-import { AnyPort, Module, Provider, Scope, ServiceOf } from "@btravstack/di";
+import { AnyPort, Module, Provider, ServiceOf } from "@btravstack/di";
 //#region src/boot-fixture.d.ts
 /**
  * `start`, as a test hands it out: the same signature and the same phantom
@@ -143,21 +143,6 @@ type TestRuntimeInfo = {
 };
 /** The in-memory runtime's port: what `TestRuntime.module` provides, and what a test composition exports. */
 export declare class TestRuntimePort extends RuntimePort<Runtime<never, TestRuntimeInfo>> {}
-/**
- * A module `options.unit` may bind, as the upper bound `testRuntime`
- * constrains its own `Unit` type parameter to. `Module`'s `_exports` channel is
- * contravariant, so `Exports = never` — never `unknown` — is what makes a REAL
- * module's own (necessarily narrower) export type assignable to this bound.
- * `@btravstack/http-server`'s `AnyUnitModule` carries the same bound for the
- * same reason.
- */
-type AnyUnitModule = Module<never, never, unknown>;
-/**
- * The needs a bound `unit` module still owes, or `never` when none is bound.
- * `Scope` is excluded, since nothing can ever provide it — the same exemption
- * `NeedsGate` itself carries.
- */
-type UnitNeedsOf<Unit> = Unit extends Module<never, never, infer N> ? Exclude<N, Scope> : never;
 type TestRuntimeOptions<Unit extends AnyUnitModule | undefined = undefined> = {
   /** A module every submitted unit forks, with no seed, before its work runs. */
   readonly unit?: Unit;

package/dist/index.mjs

@@ -160,21 +160,11 @@ const testRuntime = (name = "test", options = {}) => {
 	let accepting = false;
 	let serving;
 	let submitted = 0;
-	let onStarted;
-	const started = new Promise((resolve) => {
-		onStarted = resolve;
-	});
-	const make = () => ({
-		info: { name },
-		drain: (signal) => {
-			accepting = false;
-			return OkAsync();
-		},
-		stop: () => {
-			accepting = false;
-			return OkAsync();
-		}
-	});
+	const started = Promise.withResolvers();
+	const stopAccepting = () => {
+		accepting = false;
+		return OkAsync();
+	};
 	const runtime = {
 		name,
 		module: Module("TestRuntime")({
@@ -188,12 +178,16 @@ const testRuntime = (name = "test", options = {}) => {
 		start: (h) => {
 			host = h;
 			accepting = true;
-			serving = make();
-			onStarted();
+			serving = {
+				info: { name },
+				drain: stopAccepting,
+				stop: stopAccepting
+			};
+			started.resolve();
 			return OkAsync(serving);
 		},
 		started: () => serving !== void 0,
-		untilStarted: () => fromSafePromise(started),
+		untilStarted: () => fromSafePromise(started.promise),
 		accepting: () => accepting,
 		serving: () => {
 			if (serving === void 0) throw new Error("[test-runtime] not started");
@@ -206,10 +200,7 @@ const testRuntime = (name = "test", options = {}) => {
 		submit: () => {
 			if (host === void 0 || !accepting) throw new Error("[test-runtime] not accepting work");
 			submitted += 1;
-			let settle;
-			const held = new Promise((resolve) => {
-				settle = resolve;
-			});
+			const held = Promise.withResolvers();
 			const forwarded = new AbortController();
 			const unit = options.unit;
 			const result = host.run({
@@ -218,10 +209,10 @@ const testRuntime = (name = "test", options = {}) => {
 			}, (unitHost, signal) => {
 				if (signal.aborted) forwarded.abort(signal.reason);
 				else signal.addEventListener("abort", () => forwarded.abort(signal.reason), { once: true });
-				return unit === void 0 ? held : unitHost.fork(unit, []).flatMap(() => fromSafePromise(held).flatMap((r) => r));
+				return unit === void 0 ? held.promise : unitHost.fork(unit, []).flatMap(() => fromSafePromise(held.promise).flatMap((r) => r));
 			});
 			return {
-				settle,
+				settle: held.resolve,
 				result,
 				signal: forwarded.signal
 			};

package/dist/jwt.cjs

@@ -4,6 +4,7 @@ let node_http = require("node:http");
 let jose = require("jose");
 //#region src/jwt.ts
 const KID = "k1";
+const ALG = "RS256";
 /**
 * A real JWKS endpoint and a matching signer, for a test that wants a genuine
 * fetch and a genuine verify rather than a double for either.
@@ -12,38 +13,35 @@ const KID = "k1";
 * listener answering the JWKS on any path, and `sign` closing over the
 * private key. `close()` stops the listener; nothing else needs tearing down.
 */
-const localIssuer = (options) => {
-	const algorithm = options.algorithm ?? "RS256";
-	return (0, unthrown.fromSafePromise)((async () => {
-		const { publicKey, privateKey } = await (0, jose.generateKeyPair)(algorithm, { extractable: true });
-		const jwk = {
-			...await (0, jose.exportJWK)(publicKey),
-			kid: KID,
-			alg: algorithm,
-			use: "sig"
-		};
-		const server = (0, node_http.createServer)((_request, response) => {
-			response.setHeader("content-type", "application/json");
-			response.end(JSON.stringify({ keys: [jwk] }));
-		});
-		await new Promise((done) => server.listen(0, "127.0.0.1", done));
-		const { port } = server.address();
-		return {
-			jwks: `http://127.0.0.1:${port}/jwks.json`,
-			jwk,
-			issuer: options.issuer,
-			audience: options.audience,
-			sign: (claims = {}, signOptions = {}) => (0, unthrown.fromSafePromise)((async () => {
-				const token = new jose.SignJWT(claims).setProtectedHeader({
-					alg: algorithm,
-					kid: KID
-				}).setIssuer(signOptions.issuer ?? options.issuer).setAudience(signOptions.audience ?? options.audience).setIssuedAt();
-				if (signOptions.expiresIn !== false) token.setExpirationTime(signOptions.expiresIn ?? "5m");
-				return token.sign(privateKey);
-			})()),
-			close: () => (0, unthrown.fromSafePromise)(new Promise((done) => server.close(() => done())))
-		};
-	})());
-};
+const localIssuer = (options) => (0, unthrown.fromSafePromise)((async () => {
+	const { publicKey, privateKey } = await (0, jose.generateKeyPair)(ALG, { extractable: true });
+	const jwk = {
+		...await (0, jose.exportJWK)(publicKey),
+		kid: KID,
+		alg: ALG,
+		use: "sig"
+	};
+	const server = (0, node_http.createServer)((_request, response) => {
+		response.setHeader("content-type", "application/json");
+		response.end(JSON.stringify({ keys: [jwk] }));
+	});
+	await new Promise((done) => server.listen(0, "127.0.0.1", done));
+	const { port } = server.address();
+	return {
+		jwks: `http://127.0.0.1:${port}/jwks.json`,
+		jwk,
+		issuer: options.issuer,
+		audience: options.audience,
+		sign: (claims = {}, signOptions = {}) => (0, unthrown.fromSafePromise)((async () => {
+			const token = new jose.SignJWT(claims).setProtectedHeader({
+				alg: ALG,
+				kid: KID
+			}).setIssuer(signOptions.issuer ?? options.issuer).setAudience(signOptions.audience ?? options.audience).setIssuedAt();
+			if (signOptions.expiresIn !== false) token.setExpirationTime(signOptions.expiresIn ?? "5m");
+			return token.sign(privateKey);
+		})()),
+		close: () => (0, unthrown.fromSafePromise)(new Promise((done) => server.close(() => done())))
+	};
+})());
 //#endregion
 exports.localIssuer = localIssuer;

package/dist/jwt.d.cts

@@ -4,8 +4,6 @@ import { JWK, JWTPayload } from "jose";
 export type LocalIssuerOptions = {
   readonly issuer: string;
   readonly audience: string;
-  /** Asymmetric only, the same list `jwtAuthenticator` accepts; default `"RS256"`. */
-  readonly algorithm?: "RS256" | "RS384" | "RS512" | "ES256" | "ES384";
 };
 export type SignOptions = {
   readonly issuer?: string;

package/dist/jwt.d.mts

@@ -4,8 +4,6 @@ import { JWK, JWTPayload } from "jose";
 export type LocalIssuerOptions = {
   readonly issuer: string;
   readonly audience: string;
-  /** Asymmetric only, the same list `jwtAuthenticator` accepts; default `"RS256"`. */
-  readonly algorithm?: "RS256" | "RS384" | "RS512" | "ES256" | "ES384";
 };
 export type SignOptions = {
   readonly issuer?: string;

package/dist/jwt.mjs

@@ -3,6 +3,7 @@ import { createServer } from "node:http";
 import { SignJWT, exportJWK, generateKeyPair } from "jose";
 //#region src/jwt.ts
 const KID = "k1";
+const ALG = "RS256";
 /**
 * A real JWKS endpoint and a matching signer, for a test that wants a genuine
 * fetch and a genuine verify rather than a double for either.
@@ -11,38 +12,35 @@ const KID = "k1";
 * listener answering the JWKS on any path, and `sign` closing over the
 * private key. `close()` stops the listener; nothing else needs tearing down.
 */
-const localIssuer = (options) => {
-	const algorithm = options.algorithm ?? "RS256";
-	return fromSafePromise((async () => {
-		const { publicKey, privateKey } = await generateKeyPair(algorithm, { extractable: true });
-		const jwk = {
-			...await exportJWK(publicKey),
-			kid: KID,
-			alg: algorithm,
-			use: "sig"
-		};
-		const server = createServer((_request, response) => {
-			response.setHeader("content-type", "application/json");
-			response.end(JSON.stringify({ keys: [jwk] }));
-		});
-		await new Promise((done) => server.listen(0, "127.0.0.1", done));
-		const { port } = server.address();
-		return {
-			jwks: `http://127.0.0.1:${port}/jwks.json`,
-			jwk,
-			issuer: options.issuer,
-			audience: options.audience,
-			sign: (claims = {}, signOptions = {}) => fromSafePromise((async () => {
-				const token = new SignJWT(claims).setProtectedHeader({
-					alg: algorithm,
-					kid: KID
-				}).setIssuer(signOptions.issuer ?? options.issuer).setAudience(signOptions.audience ?? options.audience).setIssuedAt();
-				if (signOptions.expiresIn !== false) token.setExpirationTime(signOptions.expiresIn ?? "5m");
-				return token.sign(privateKey);
-			})()),
-			close: () => fromSafePromise(new Promise((done) => server.close(() => done())))
-		};
-	})());
-};
+const localIssuer = (options) => fromSafePromise((async () => {
+	const { publicKey, privateKey } = await generateKeyPair(ALG, { extractable: true });
+	const jwk = {
+		...await exportJWK(publicKey),
+		kid: KID,
+		alg: ALG,
+		use: "sig"
+	};
+	const server = createServer((_request, response) => {
+		response.setHeader("content-type", "application/json");
+		response.end(JSON.stringify({ keys: [jwk] }));
+	});
+	await new Promise((done) => server.listen(0, "127.0.0.1", done));
+	const { port } = server.address();
+	return {
+		jwks: `http://127.0.0.1:${port}/jwks.json`,
+		jwk,
+		issuer: options.issuer,
+		audience: options.audience,
+		sign: (claims = {}, signOptions = {}) => fromSafePromise((async () => {
+			const token = new SignJWT(claims).setProtectedHeader({
+				alg: ALG,
+				kid: KID
+			}).setIssuer(signOptions.issuer ?? options.issuer).setAudience(signOptions.audience ?? options.audience).setIssuedAt();
+			if (signOptions.expiresIn !== false) token.setExpirationTime(signOptions.expiresIn ?? "5m");
+			return token.sign(privateKey);
+		})()),
+		close: () => fromSafePromise(new Promise((done) => server.close(() => done())))
+	};
+})());
 //#endregion
 export { localIssuer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/testing",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Test the applications @btravstack/core boots: an in-memory runtime, a fake clock, a boot fixture that stops what it started, and a tap into a running graph",
   "keywords": [
     "dependency-injection",
@@ -54,23 +54,23 @@
     }
   },
   "devDependencies": {
-    "@btravstack/config": "0.16.0",
-    "@btravstack/core": "0.16.0",
-    "@btravstack/di": "0.16.0",
+    "@btravstack/config": "0.17.0",
+    "@btravstack/core": "0.17.0",
+    "@btravstack/di": "0.17.0",
     "@btravstack/tsconfig": "0.4.0",
-    "@types/node": "26.4.1",
-    "@unthrown/vitest": "5.8.0",
-    "@vitest/coverage-v8": "4.1.11",
+    "@types/node": "26.6.4",
+    "@unthrown/vitest": "5.12.0",
+    "@vitest/coverage-v8": "5.0.3",
     "jose": "6.2.12",
     "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "unthrown": "5.8.0",
-    "vitest": "4.1.11"
+    "unthrown": "5.12.0",
+    "vitest": "5.0.3"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.16.0",
-    "@btravstack/core": "^0.16.0",
-    "@btravstack/di": "^0.16.0",
+    "@btravstack/config": "^0.17.0",
+    "@btravstack/core": "^0.17.0",
+    "@btravstack/di": "^0.17.0",
     "jose": "^6",
     "unthrown": "^5.0.0"
   },