@btravstack/testing 0.13.0 → 0.15.0

package/README.md

@@ -92,6 +92,14 @@ answers the very instances the running graph holds once it is built — after
   provides it where a starter would; `unit` is a module every submitted unit
   forks, with no seed, before its work runs — and what that module needs joins
   `module`'s own, so `start` names it instead of the first `submit()` failing.
+- **`overridden(module, [providers])`** — substitute named providers into your
+  **real** composition root, rather than maintaining a parallel test root
+  beside it. It replaces one **provider**, never a subsystem: the replaced
+  provider's siblings still construct, so swapping a whole adapter stack is
+  still a different module composed in its place. An override for a port the
+  tree stopped providing is a `WiringDefect` ("nothing to override"), which is
+  what keeps a test root from drifting silently away from the real one — the
+  drift that four hand-maintained parallel roots had already produced here.
 - **`createFakeClock(start?)`** — a `Clock` for `StartOptions.clock` whose
   time moves only on `advance(ms)`.
 

package/dist/index.cjs

@@ -21,8 +21,9 @@ let _btravstack_di = require("@btravstack/di");
 * ```
 *
 * The defaults are a test's: `signals: false` always (process-wide handlers
-* would fight across a file), `probes: false`, `preDrainDelayMs: 0` and a silent
-* `onEvent` — each overridable by `defaults` and again per call.
+* would fight across a file), `probes: false`, `preDrainDelayMs: 0`, a
+* `stopTimeoutMs` far out of reach and a silent `onEvent` — each overridable by
+* `defaults` and again per call.
 *
 * Teardown is `stop()`, then `exited` is examined: a **`Defect`** fails the test
 * even when the test never looked at `exited`, while a modeled `Err` passes
@@ -33,6 +34,7 @@ const bootFixture = (defaults = {}) => async ({}, use) => {
 	const boot = ((module, options = {}) => {
 		const app = (0, _btravstack_core.start)(module, {
 			preDrainDelayMs: 0,
+			stopTimeoutMs: 6e5,
 			onEvent: () => {},
 			probes: false,
 			...defaults,

package/dist/index.d.cts

@@ -27,14 +27,15 @@ type BootDefaults = Omit<StartOptions, "signals">;
  * ```
  *
  * The defaults are a test's: `signals: false` always (process-wide handlers
- * would fight across a file), `probes: false`, `preDrainDelayMs: 0` and a silent
- * `onEvent` — each overridable by `defaults` and again per call.
+ * would fight across a file), `probes: false`, `preDrainDelayMs: 0`, a
+ * `stopTimeoutMs` far out of reach and a silent `onEvent` — each overridable by
+ * `defaults` and again per call.
  *
  * Teardown is `stop()`, then `exited` is examined: a **`Defect`** fails the test
  * even when the test never looked at `exited`, while a modeled `Err` passes
  * through, since a startup failure is an outcome a test may be asserting.
  */
-declare const bootFixture: (defaults?: BootDefaults) => ({}: object, use: (boot: Boot) => Promise<void>) => Promise<void>;
+export declare const bootFixture: (defaults?: BootDefaults) => ({}: object, use: (boot: Boot) => Promise<void>) => Promise<void>;
 //#endregion
 //#region src/fake-clock.d.ts
 type FakeClock = Clock & {
@@ -63,7 +64,7 @@ type FakeClock = Clock & {
  * await clock.advance(20_000); // the drain deadline
  * ```
  */
-declare const createFakeClock: (start?: number) => FakeClock;
+export declare const createFakeClock: (start?: number) => FakeClock;
 //#endregion
 //#region src/overridden.d.ts
 /** One override's error channel, unioned across the tuple by `overridden`. */
@@ -91,7 +92,7 @@ type AnyProviderFor = Provider<never, unknown, unknown>;
  * root to re-export internals to be overridable. They are checked at build
  * instead, by `plan`'s missing-provider defect.
  */
-declare const overridden: <X, E, N, const O extends readonly AnyProviderFor[]>(module: Module<X, E, N>, overrides: O) => Module<X, E | ErrorsOf<O>, N>;
+export declare const overridden: <X, E, N, const O extends readonly AnyProviderFor[]>(module: Module<X, E, N>, overrides: O) => Module<X, E | ErrorsOf<O>, N>;
 //#endregion
 //#region src/tapped.d.ts
 /** The services behind `ports`, in order — what `tapped(...).services()` answers once the graph is built. */
@@ -122,7 +123,7 @@ type ServicesOf<P extends readonly AnyPort[]> = { readonly [K in keyof P]: Servi
 type TapGate<P extends readonly AnyPort[], X> = [Exclude<InstanceType<P[number]>, X>] extends [never] ? unknown : {
   readonly "NOT EXPORTED — tap only what the module exports": Exclude<InstanceType<P[number]>, X>;
 };
-declare const tapped: <X, E, N, const P extends readonly AnyPort[]>(module: Module<X, E, N>, ports: P & TapGate<P, X>) => {
+export declare const tapped: <X, E, N, const P extends readonly AnyPort[]>(module: Module<X, E, N>, ports: P & TapGate<P, X>) => {
   readonly module: Module<X, E, N>;
   readonly services: () => ServicesOf<P>;
 };
@@ -141,7 +142,7 @@ type TestRuntimeInfo = {
   readonly name: string;
 };
 /** The in-memory runtime's port: what `TestRuntime.module` provides, and what a test composition exports. */
-declare class TestRuntimePort extends RuntimePort<Runtime<never, TestRuntimeInfo>> {}
+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
@@ -191,6 +192,6 @@ type TestRuntime<Unit extends AnyUnitModule | undefined = undefined> = Runtime<n
   /** The `RuntimeHost` the kernel last called `start` with. **Throws** if the runtime was never started — the same misuse guard as `serving()`. */
   readonly host: () => RuntimeHost<never>;
 };
-declare const testRuntime: <Unit extends AnyUnitModule | undefined = undefined>(name?: string, options?: TestRuntimeOptions<Unit>) => TestRuntime<Unit>;
+export declare const testRuntime: <Unit extends AnyUnitModule | undefined = undefined>(name?: string, options?: TestRuntimeOptions<Unit>) => TestRuntime<Unit>;
 //#endregion
-export { type Boot, type BootDefaults, type FakeClock, type ServicesOf, type SubmittedUnit, type TestRuntime, type TestRuntimeInfo, type TestRuntimeOptions, TestRuntimePort, bootFixture, createFakeClock, overridden, tapped, testRuntime };
+export type { Boot, BootDefaults, FakeClock, ServicesOf, SubmittedUnit, TestRuntime, TestRuntimeInfo, TestRuntimeOptions };

package/dist/index.d.mts

@@ -27,14 +27,15 @@ type BootDefaults = Omit<StartOptions, "signals">;
  * ```
  *
  * The defaults are a test's: `signals: false` always (process-wide handlers
- * would fight across a file), `probes: false`, `preDrainDelayMs: 0` and a silent
- * `onEvent` — each overridable by `defaults` and again per call.
+ * would fight across a file), `probes: false`, `preDrainDelayMs: 0`, a
+ * `stopTimeoutMs` far out of reach and a silent `onEvent` — each overridable by
+ * `defaults` and again per call.
  *
  * Teardown is `stop()`, then `exited` is examined: a **`Defect`** fails the test
  * even when the test never looked at `exited`, while a modeled `Err` passes
  * through, since a startup failure is an outcome a test may be asserting.
  */
-declare const bootFixture: (defaults?: BootDefaults) => ({}: object, use: (boot: Boot) => Promise<void>) => Promise<void>;
+export declare const bootFixture: (defaults?: BootDefaults) => ({}: object, use: (boot: Boot) => Promise<void>) => Promise<void>;
 //#endregion
 //#region src/fake-clock.d.ts
 type FakeClock = Clock & {
@@ -63,7 +64,7 @@ type FakeClock = Clock & {
  * await clock.advance(20_000); // the drain deadline
  * ```
  */
-declare const createFakeClock: (start?: number) => FakeClock;
+export declare const createFakeClock: (start?: number) => FakeClock;
 //#endregion
 //#region src/overridden.d.ts
 /** One override's error channel, unioned across the tuple by `overridden`. */
@@ -91,7 +92,7 @@ type AnyProviderFor = Provider<never, unknown, unknown>;
  * root to re-export internals to be overridable. They are checked at build
  * instead, by `plan`'s missing-provider defect.
  */
-declare const overridden: <X, E, N, const O extends readonly AnyProviderFor[]>(module: Module<X, E, N>, overrides: O) => Module<X, E | ErrorsOf<O>, N>;
+export declare const overridden: <X, E, N, const O extends readonly AnyProviderFor[]>(module: Module<X, E, N>, overrides: O) => Module<X, E | ErrorsOf<O>, N>;
 //#endregion
 //#region src/tapped.d.ts
 /** The services behind `ports`, in order — what `tapped(...).services()` answers once the graph is built. */
@@ -122,7 +123,7 @@ type ServicesOf<P extends readonly AnyPort[]> = { readonly [K in keyof P]: Servi
 type TapGate<P extends readonly AnyPort[], X> = [Exclude<InstanceType<P[number]>, X>] extends [never] ? unknown : {
   readonly "NOT EXPORTED — tap only what the module exports": Exclude<InstanceType<P[number]>, X>;
 };
-declare const tapped: <X, E, N, const P extends readonly AnyPort[]>(module: Module<X, E, N>, ports: P & TapGate<P, X>) => {
+export declare const tapped: <X, E, N, const P extends readonly AnyPort[]>(module: Module<X, E, N>, ports: P & TapGate<P, X>) => {
   readonly module: Module<X, E, N>;
   readonly services: () => ServicesOf<P>;
 };
@@ -141,7 +142,7 @@ type TestRuntimeInfo = {
   readonly name: string;
 };
 /** The in-memory runtime's port: what `TestRuntime.module` provides, and what a test composition exports. */
-declare class TestRuntimePort extends RuntimePort<Runtime<never, TestRuntimeInfo>> {}
+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
@@ -191,6 +192,6 @@ type TestRuntime<Unit extends AnyUnitModule | undefined = undefined> = Runtime<n
   /** The `RuntimeHost` the kernel last called `start` with. **Throws** if the runtime was never started — the same misuse guard as `serving()`. */
   readonly host: () => RuntimeHost<never>;
 };
-declare const testRuntime: <Unit extends AnyUnitModule | undefined = undefined>(name?: string, options?: TestRuntimeOptions<Unit>) => TestRuntime<Unit>;
+export declare const testRuntime: <Unit extends AnyUnitModule | undefined = undefined>(name?: string, options?: TestRuntimeOptions<Unit>) => TestRuntime<Unit>;
 //#endregion
-export { type Boot, type BootDefaults, type FakeClock, type ServicesOf, type SubmittedUnit, type TestRuntime, type TestRuntimeInfo, type TestRuntimeOptions, TestRuntimePort, bootFixture, createFakeClock, overridden, tapped, testRuntime };
+export type { Boot, BootDefaults, FakeClock, ServicesOf, SubmittedUnit, TestRuntime, TestRuntimeInfo, TestRuntimeOptions };

package/dist/index.mjs

@@ -20,8 +20,9 @@ import { Module, Port, Provider, overrideProvider } from "@btravstack/di";
 * ```
 *
 * The defaults are a test's: `signals: false` always (process-wide handlers
-* would fight across a file), `probes: false`, `preDrainDelayMs: 0` and a silent
-* `onEvent` — each overridable by `defaults` and again per call.
+* would fight across a file), `probes: false`, `preDrainDelayMs: 0`, a
+* `stopTimeoutMs` far out of reach and a silent `onEvent` — each overridable by
+* `defaults` and again per call.
 *
 * Teardown is `stop()`, then `exited` is examined: a **`Defect`** fails the test
 * even when the test never looked at `exited`, while a modeled `Err` passes
@@ -32,6 +33,7 @@ const bootFixture = (defaults = {}) => async ({}, use) => {
 	const boot = ((module, options = {}) => {
 		const app = start(module, {
 			preDrainDelayMs: 0,
+			stopTimeoutMs: 6e5,
 			onEvent: () => {},
 			probes: false,
 			...defaults,

package/dist/jwt.d.cts

@@ -1,19 +1,19 @@
 import { AsyncResult } from "unthrown";
 import { JWK, JWTPayload } from "jose";
 //#region src/jwt.d.ts
-type LocalIssuerOptions = {
+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";
 };
-type SignOptions = {
+export type SignOptions = {
   readonly issuer?: string;
   readonly audience?: string;
   /** `"5m"` by default; `false` mints a token with no `exp` at all. */
   readonly expiresIn?: string | false;
 };
-type LocalIssuer = {
+export type LocalIssuer = {
   /** `http://127.0.0.1:<port>/jwks.json` — served on ANY path, so a caller need not match it exactly. */
   readonly jwks: string;
   /** The public key as served, with `kid`/`alg`/`use` already set. */
@@ -31,6 +31,5 @@ type LocalIssuer = {
  * listener answering the JWKS on any path, and `sign` closing over the
  * private key. `close()` stops the listener; nothing else needs tearing down.
  */
-declare const localIssuer: (options: LocalIssuerOptions) => AsyncResult<LocalIssuer, never>;
-//#endregion
-export { LocalIssuer, LocalIssuerOptions, SignOptions, localIssuer };
+export declare const localIssuer: (options: LocalIssuerOptions) => AsyncResult<LocalIssuer, never>;
+//#endregion

package/dist/jwt.d.mts

@@ -1,19 +1,19 @@
 import { AsyncResult } from "unthrown";
 import { JWK, JWTPayload } from "jose";
 //#region src/jwt.d.ts
-type LocalIssuerOptions = {
+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";
 };
-type SignOptions = {
+export type SignOptions = {
   readonly issuer?: string;
   readonly audience?: string;
   /** `"5m"` by default; `false` mints a token with no `exp` at all. */
   readonly expiresIn?: string | false;
 };
-type LocalIssuer = {
+export type LocalIssuer = {
   /** `http://127.0.0.1:<port>/jwks.json` — served on ANY path, so a caller need not match it exactly. */
   readonly jwks: string;
   /** The public key as served, with `kid`/`alg`/`use` already set. */
@@ -31,6 +31,5 @@ type LocalIssuer = {
  * listener answering the JWKS on any path, and `sign` closing over the
  * private key. `close()` stops the listener; nothing else needs tearing down.
  */
-declare const localIssuer: (options: LocalIssuerOptions) => AsyncResult<LocalIssuer, never>;
-//#endregion
-export { LocalIssuer, LocalIssuerOptions, SignOptions, localIssuer };
+export declare const localIssuer: (options: LocalIssuerOptions) => AsyncResult<LocalIssuer, never>;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/testing",
-  "version": "0.13.0",
+  "version": "0.15.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,25 +54,25 @@
     }
   },
   "devDependencies": {
+    "@btravstack/config": "0.15.0",
+    "@btravstack/core": "0.15.0",
+    "@btravstack/di": "0.15.0",
     "@btravstack/tsconfig": "0.4.0",
-    "@types/node": "26.4.0",
-    "@unthrown/vitest": "5.7.0",
+    "@types/node": "26.4.1",
+    "@unthrown/vitest": "5.8.0",
     "@vitest/coverage-v8": "4.1.11",
-    "jose": "6.2.10",
-    "tsdown": "0.22.14",
+    "jose": "6.2.12",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "unthrown": "5.7.0",
-    "vitest": "4.1.11",
-    "@btravstack/config": "0.13.0",
-    "@btravstack/core": "0.13.0",
-    "@btravstack/di": "0.13.0"
+    "unthrown": "5.8.0",
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
+    "@btravstack/config": "^0.15.0",
+    "@btravstack/core": "^0.15.0",
+    "@btravstack/di": "^0.15.0",
     "jose": "^6",
-    "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.13.0",
-    "@btravstack/core": "^0.13.0",
-    "@btravstack/di": "^0.13.0"
+    "unthrown": "^5.0.0"
   },
   "peerDependenciesMeta": {
     "jose": {
@@ -86,7 +86,6 @@
     "build": "tsdown src/index.ts src/jwt.ts --format cjs,esm --dts --clean",
     "dev": "tsdown src/index.ts src/jwt.ts --format cjs,esm --dts --watch",
     "test": "vitest run --coverage",
-    "test:types": "tsc --noEmit -p tsconfig.test-d.json",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test-d.json"
   }
 }