@btravstack/testing 0.18.0 → 0.20.0

package/README.md

@@ -100,6 +100,9 @@ answers the very instances the running graph holds once it is built — after
   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.
+  `overridden(module, [providers], { unit: { user: [providers] } })` reaches
+  inside a unit module the root binds, by kind, with the same drift gate at
+  boot.
 - **`createFakeClock(start?)`** — a `Clock` for `StartOptions.clock` whose
   time moves only on `advance(ms)`.
 

package/dist/index.cjs

@@ -114,6 +114,14 @@ const createFakeClock = (start = 0) => {
 * tree no longer provides is a `WiringDefect` ("nothing to override"), which is
 * what turns fixture drift into a loud failure.
 *
+* `options.unit` reaches inside the unit modules the root binds, keyed by the
+* kind the root binds them under (`{ user: [...] }`, `{ message: [...] }`):
+* a unit module is forked per unit, after the root is built, so a root-level
+* override cannot see its providers. The kernel applies these at boot, and a
+* kind the runtime binds no module for, a port that kind's module does not
+* provide, or two overrides for one port in one kind is a defect there — the
+* same drift gate, at the same moment.
+*
 * It replaces ONE provider, never a subsystem: the replaced provider's siblings
 * still construct, so swapping a whole adapter stack remains a different module
 * composed in its place.
@@ -123,9 +131,12 @@ const createFakeClock = (start = 0) => {
 * root to re-export internals to be overridable. They are checked at build
 * instead, by `plan`'s missing-provider defect.
 */
-const overridden = (module, overrides) => (0, _btravstack_di.Module)("Overridden")({
+const overridden = (module, overrides, options = {}) => (0, _btravstack_di.Module)("Overridden")({
 	imports: [module],
-	provides: overrides.map((override) => (0, _btravstack_di.overrideProvider)(override)),
+	provides: [...overrides.map((override) => (0, _btravstack_di.overrideProvider)(override)), _btravstack_di.Provider.member(_btravstack_core.UnitOverrides)({
+		inject: {},
+		value: Object.fromEntries(Object.entries(options.unit ?? {}).map(([kind, providers]) => [kind, providers.map((provider) => (0, _btravstack_di.overrideProvider)(provider))]))
+	})],
 	exports: [module]
 });
 //#endregion
@@ -176,6 +187,7 @@ const testRuntime = (name = "test", options = {}) => {
 			exports: [TestRuntimePort]
 		}),
 		resolves: [],
+		units: { test: options.unit },
 		start: (h) => {
 			host = h;
 			accepting = true;

package/dist/index.d.cts

@@ -68,9 +68,11 @@ export declare const createFakeClock: (start?: number) => FakeClock;
 //#endregion
 //#region src/overridden.d.ts
 /** One override's error channel, unioned across the tuple by `overridden`. */
-type ErrorsOf<O extends readonly AnyProviderFor[]> = O[number] extends Provider<never, infer E, unknown> ? E : never;
+type ErrorsOf<O extends readonly AnyProviderFor[]> = O[number] extends (infer P) ? P extends Provider<never, infer E, unknown> ? E : never : never;
 /** The widest provider `overridden` accepts — variance makes every real one assignable. */
 type AnyProviderFor = Provider<never, unknown, unknown>;
+/** A unit module's provider: a fork's error channel is `never`, so its overrides' must be too. */
+type UnitProviderFor = Provider<never, never, unknown>;
 /**
  * The real composition root, with named providers substituted — the testing half
  * of "swapping an adapter is composing a different module", for the seam
@@ -83,6 +85,14 @@ type AnyProviderFor = Provider<never, unknown, unknown>;
  * tree no longer provides is a `WiringDefect` ("nothing to override"), which is
  * what turns fixture drift into a loud failure.
  *
+ * `options.unit` reaches inside the unit modules the root binds, keyed by the
+ * kind the root binds them under (`{ user: [...] }`, `{ message: [...] }`):
+ * a unit module is forked per unit, after the root is built, so a root-level
+ * override cannot see its providers. The kernel applies these at boot, and a
+ * kind the runtime binds no module for, a port that kind's module does not
+ * provide, or two overrides for one port in one kind is a defect there — the
+ * same drift gate, at the same moment.
+ *
  * It replaces ONE provider, never a subsystem: the replaced provider's siblings
  * still construct, so swapping a whole adapter stack remains a different module
  * composed in its place.
@@ -92,7 +102,9 @@ 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.
  */
-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>;
+export declare const overridden: <X, E, N, const O extends readonly AnyProviderFor[]>(module: Module<X, E, N>, overrides: O, options?: {
+  readonly unit?: Readonly<Record<string, readonly UnitProviderFor[]>>;
+}) => 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. */

package/dist/index.d.mts

@@ -68,9 +68,11 @@ export declare const createFakeClock: (start?: number) => FakeClock;
 //#endregion
 //#region src/overridden.d.ts
 /** One override's error channel, unioned across the tuple by `overridden`. */
-type ErrorsOf<O extends readonly AnyProviderFor[]> = O[number] extends Provider<never, infer E, unknown> ? E : never;
+type ErrorsOf<O extends readonly AnyProviderFor[]> = O[number] extends (infer P) ? P extends Provider<never, infer E, unknown> ? E : never : never;
 /** The widest provider `overridden` accepts — variance makes every real one assignable. */
 type AnyProviderFor = Provider<never, unknown, unknown>;
+/** A unit module's provider: a fork's error channel is `never`, so its overrides' must be too. */
+type UnitProviderFor = Provider<never, never, unknown>;
 /**
  * The real composition root, with named providers substituted — the testing half
  * of "swapping an adapter is composing a different module", for the seam
@@ -83,6 +85,14 @@ type AnyProviderFor = Provider<never, unknown, unknown>;
  * tree no longer provides is a `WiringDefect` ("nothing to override"), which is
  * what turns fixture drift into a loud failure.
  *
+ * `options.unit` reaches inside the unit modules the root binds, keyed by the
+ * kind the root binds them under (`{ user: [...] }`, `{ message: [...] }`):
+ * a unit module is forked per unit, after the root is built, so a root-level
+ * override cannot see its providers. The kernel applies these at boot, and a
+ * kind the runtime binds no module for, a port that kind's module does not
+ * provide, or two overrides for one port in one kind is a defect there — the
+ * same drift gate, at the same moment.
+ *
  * It replaces ONE provider, never a subsystem: the replaced provider's siblings
  * still construct, so swapping a whole adapter stack remains a different module
  * composed in its place.
@@ -92,7 +102,9 @@ 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.
  */
-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>;
+export declare const overridden: <X, E, N, const O extends readonly AnyProviderFor[]>(module: Module<X, E, N>, overrides: O, options?: {
+  readonly unit?: Readonly<Record<string, readonly UnitProviderFor[]>>;
+}) => 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. */

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { RuntimePort, start } from "@btravstack/core";
+import { RuntimePort, UnitOverrides, start } from "@btravstack/core";
 import { setTimeout } from "node:timers/promises";
 import { OkAsync, fromSafePromise } from "unthrown";
 import { Module, Port, Provider, overrideProvider } from "@btravstack/di";
@@ -113,6 +113,14 @@ const createFakeClock = (start = 0) => {
 * tree no longer provides is a `WiringDefect` ("nothing to override"), which is
 * what turns fixture drift into a loud failure.
 *
+* `options.unit` reaches inside the unit modules the root binds, keyed by the
+* kind the root binds them under (`{ user: [...] }`, `{ message: [...] }`):
+* a unit module is forked per unit, after the root is built, so a root-level
+* override cannot see its providers. The kernel applies these at boot, and a
+* kind the runtime binds no module for, a port that kind's module does not
+* provide, or two overrides for one port in one kind is a defect there — the
+* same drift gate, at the same moment.
+*
 * It replaces ONE provider, never a subsystem: the replaced provider's siblings
 * still construct, so swapping a whole adapter stack remains a different module
 * composed in its place.
@@ -122,9 +130,12 @@ const createFakeClock = (start = 0) => {
 * root to re-export internals to be overridable. They are checked at build
 * instead, by `plan`'s missing-provider defect.
 */
-const overridden = (module, overrides) => Module("Overridden")({
+const overridden = (module, overrides, options = {}) => Module("Overridden")({
 	imports: [module],
-	provides: overrides.map((override) => overrideProvider(override)),
+	provides: [...overrides.map((override) => overrideProvider(override)), Provider.member(UnitOverrides)({
+		inject: {},
+		value: Object.fromEntries(Object.entries(options.unit ?? {}).map(([kind, providers]) => [kind, providers.map((provider) => overrideProvider(provider))]))
+	})],
 	exports: [module]
 });
 //#endregion
@@ -175,6 +186,7 @@ const testRuntime = (name = "test", options = {}) => {
 			exports: [TestRuntimePort]
 		}),
 		resolves: [],
+		units: { test: options.unit },
 		start: (h) => {
 			host = h;
 			accepting = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/testing",
-  "version": "0.18.0",
+  "version": "0.20.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,9 +54,9 @@
     }
   },
   "devDependencies": {
-    "@btravstack/config": "0.18.0",
-    "@btravstack/core": "0.18.0",
-    "@btravstack/di": "0.18.0",
+    "@btravstack/config": "0.20.0",
+    "@btravstack/core": "0.20.0",
+    "@btravstack/di": "0.20.0",
     "@btravstack/tsconfig": "0.4.0",
     "@types/node": "26.6.4",
     "@unthrown/vitest": "5.12.0",
@@ -68,9 +68,9 @@
     "vitest": "5.0.3"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.18.0",
-    "@btravstack/core": "^0.18.0",
-    "@btravstack/di": "^0.18.0",
+    "@btravstack/config": "^0.20.0",
+    "@btravstack/core": "^0.20.0",
+    "@btravstack/di": "^0.20.0",
     "jose": "^6",
     "unthrown": "^5.0.0"
   },