better-effect 0.11.0 → 0.13.0

package/dist/standard-services.mjs

@@ -1,3 +1,4 @@
-import { t as CurrentAbortSignal } from "./signal-B97cs85Z.mjs";
-import { _ as ConfigSourceError, a as CurrentRequest, c as LoggerLive, d as Random, f as RandomLive, g as ConfigLive, h as Config, i as ClockTestLayer, l as LoggerTest, m as RandomSeededLayer, n as ClockLive, o as CurrentRequestLayer, p as RandomSeeded, r as ClockTest, s as Logger, t as Clock, u as LoggerTestLayer, v as ConfigValidationError } from "./standard-services-BFBq-4lo.mjs";
-export { Clock, ClockLive, ClockTest, ClockTestLayer, Config, ConfigLive, ConfigSourceError, ConfigValidationError, CurrentAbortSignal, CurrentRequest, CurrentRequestLayer, Logger, LoggerLive, LoggerTest, LoggerTestLayer, Random, RandomLive, RandomSeeded, RandomSeededLayer };
+import { t as CurrentAbortSignal } from "./signal-nfgFyNCk.mjs";
+import { n as CurrentRequestLayer, t as CurrentRequest } from "./current-request-DDKNyymv.mjs";
+import { S as ConfigValidationError, _ as IdGeneratorTestLayer, a as Logger, b as ConfigLive, c as LoggerTestLayer, d as RandomSeeded, f as RandomSeededLayer, g as IdGeneratorTest, h as IdGeneratorLive, i as ClockTestLayer, l as Random, m as IdGeneratorExhaustedError, n as ClockLive, o as LoggerLive, p as IdGenerator, r as ClockTest, s as LoggerTest, t as Clock, u as RandomLive, v as IdGeneratorUnavailableError, x as ConfigSourceError, y as Config } from "./standard-services-vnGIafkS.mjs";
+export { Clock, ClockLive, ClockTest, ClockTestLayer, Config, ConfigLive, ConfigSourceError, ConfigValidationError, CurrentAbortSignal, CurrentRequest, CurrentRequestLayer, IdGenerator, IdGeneratorExhaustedError, IdGeneratorLive, IdGeneratorTest, IdGeneratorTestLayer, IdGeneratorUnavailableError, Logger, LoggerLive, LoggerTest, LoggerTestLayer, Random, RandomLive, RandomSeeded, RandomSeededLayer };

package/dist/testing.d.mts

@@ -1,7 +1,9 @@
-import { M as AnyService, c as RuntimeContextStorage } from "./index-heuaRmXR.mjs";
-import { A as OverrideLayerResult, C as CompleteExecutionLayer, D as LayerInputState, E as LayerInput, F as ValidateOverrides, I as ValidateOverridesWitness, M as RequiredEnvironment, N as ValidateLayerInput, R as MissingDependencies, S as CompleteExecution, _ as MapLayerBackend, c as RuntimeObserver, d as RuntimeServiceResolveEvent, i as RuntimeRunOptions, j as ProvidedEnvironment, l as RuntimeResourceReleaseEvent, n as RuntimeDisposeOptions, o as RuntimeExecutionEndEvent, r as RuntimeOptions, s as RuntimeExecutionStartEvent, u as RuntimeServiceAcquireEvent, v as LayerBackend } from "./index-rQhZk3Nt.mjs";
-import { f as Runtime } from "./index-C7Qild0_.mjs";
-import { f as LoggerTest, g as RandomSeeded, r as ClockTest } from "./index-DStz0JMN.mjs";
+import { M as AnyService, c as RuntimeContextStorage } from "./index-AiKM71-u.mjs";
+import { C as OverrideLayerResult, E as ValidateLayerInput, O as ValidateOverrides, T as RequiredEnvironment, b as LayerInputState, d as LayerBackend, g as CompleteExecutionLayer, h as CompleteExecution, i as RuntimeRunOptions, j as MissingDependencies, k as ValidateOverridesWitness, n as RuntimeDisposeOptions, r as RuntimeOptions, w as ProvidedEnvironment, y as LayerInput } from "./outcome-DI8LPIQ4.mjs";
+import { a as RuntimeObserver, c as RuntimeServiceResolveEvent, i as RuntimeExecutionStartEvent, n as RuntimeExecutionEndEvent, o as RuntimeResourceReleaseEvent, s as RuntimeServiceAcquireEvent } from "./observer-9nhbL7Pr.mjs";
+import { t as MapLayerBackend } from "./index-DAKn0qHk.mjs";
+import { l as Runtime } from "./index-BodMy6rO.mjs";
+import { f as LoggerTest, g as RandomSeeded, i as ClockTest, x as IdGeneratorTest } from "./index-cXgyMa0v.mjs";
 //#region src/testing/contracts.d.ts
 /** One runner-neutral conformance scenario. */
 interface ContractScenario {
@@ -95,6 +97,59 @@ declare class RecordedRuntimeObserver implements RuntimeObserver {
   private record;
 }
 //#endregion
+//#region src/testing/runtime-graph-observer.d.ts
+/** One logical Service node in a Runtime graph snapshot. */
+type RuntimeGraphNode = {
+  readonly tag: string;
+  readonly resolutions: number;
+  readonly acquisitions: number;
+  readonly failures: number;
+};
+/** One observed parent-to-child Service edge in a Runtime graph snapshot. */
+type RuntimeGraphEdge = {
+  readonly from: string;
+  readonly to: string;
+  readonly resolutions: number;
+};
+/** Detached, sorted and immutable Runtime graph data. */
+type RuntimeGraphSnapshot = {
+  readonly nodes: readonly RuntimeGraphNode[];
+  readonly edges: readonly RuntimeGraphEdge[];
+};
+/** Options for a diagnostic Runtime graph observer. */
+type RuntimeGraphObserverOptions = {
+  /** Count failed resolution and acquisition events in each node's failures field. */
+  readonly includeFailures?: boolean;
+  /** Add this label as a synthetic root in Mermaid output for top-level resolutions. */
+  readonly rootLabel?: string;
+};
+/**
+ * Observe the public Runtime resolution and acquisition events as a diagnostic graph.
+ *
+ * The graph is deliberately an observation of paths emitted by Runtime. It does
+ * not inspect Layer provenance, retain Service instances, or plan dependencies.
+ */
+declare class RuntimeGraphObserver implements RuntimeObserver {
+  private readonly includeFailures;
+  private readonly rootLabel;
+  private readonly nodes;
+  private readonly edges;
+  private readonly rootEdges;
+  private constructor();
+  /** Create an empty Runtime graph observer. */
+  static make(options?: RuntimeGraphObserverOptions): RuntimeGraphObserver;
+  readonly onServiceResolve: (event: RuntimeServiceResolveEvent) => void;
+  readonly onServiceAcquire: (event: RuntimeServiceAcquireEvent) => void;
+  /** Return a fresh, deeply detached and sorted graph snapshot. */
+  toJSON(): RuntimeGraphSnapshot;
+  /** Render the current graph as deterministic Mermaid flowchart source. */
+  toMermaid(): string;
+  /** Discard all observed graph data while keeping this observer reusable. */
+  clear(): void;
+  private ensureNode;
+  private ensurePath;
+}
+//#endregion
 //#region src/testing/test-runtime.d.ts
 declare const TestRuntimeOptionsOverridesTypeId: unique symbol;
 type ValidatedTestServiceOption<Base extends LayerInput, Overrides extends readonly LayerInput[], Replacement extends LayerInput, Value> = Value & ValidateOverridesWitness<Base, readonly [...Overrides, Replacement]>;
@@ -110,6 +165,8 @@ type TestRuntimeOptions<Base extends LayerInput = LayerInput, Overrides extends
   readonly logger?: ValidatedTestServiceOption<Base, Overrides, LoggerTestLayer, LoggerTest>;
   /** Seeded Random provider to install for this TestRuntime. */
   readonly random?: ValidatedTestServiceOption<Base, Overrides, RandomSeededLayer, RandomSeeded>;
+  /** Deterministic IdGenerator provider to install for this TestRuntime. */
+  readonly idGenerator?: ValidatedTestServiceOption<Base, Overrides, IdGeneratorTestLayer, IdGeneratorTest>;
   /** Additional best-effort observers after the default recorder. */
   readonly observers?: readonly RuntimeObserver[];
 } & {
@@ -118,20 +175,22 @@ type TestRuntimeOptions<Base extends LayerInput = LayerInput, Overrides extends
 type ClockTestLayer = ReturnType<typeof ClockTest.layer>;
 type LoggerTestLayer = ReturnType<typeof LoggerTest.layer>;
 type RandomSeededLayer = ReturnType<typeof RandomSeeded.layer>;
+type IdGeneratorTestLayer = ReturnType<typeof IdGeneratorTest.layer>;
 type TestRuntimeOptionsInput = Omit<RuntimeOptions, 'backend' | 'observers'> & {
   readonly overrides?: readonly LayerInput[];
   readonly backend?: LayerBackend;
   readonly clock?: ClockTest;
   readonly logger?: LoggerTest;
   readonly random?: RandomSeeded;
+  readonly idGenerator?: IdGeneratorTest;
   readonly observers?: readonly RuntimeObserver[];
 };
 type ExplicitOverrides<Options extends TestRuntimeOptionsInput> = typeof TestRuntimeOptionsOverridesTypeId extends keyof Options ? Exclude<Options[typeof TestRuntimeOptionsOverridesTypeId], undefined> extends (infer Overrides extends readonly LayerInput[]) ? Overrides : readonly [] : Exclude<Options['overrides'], undefined> extends (infer Overrides extends readonly LayerInput[]) ? Overrides : readonly [];
 type HasDefinedOption<Options, Key extends PropertyKey> = true extends (Options extends unknown ? Key extends keyof Options ? {} extends Pick<Options, Key> ? false : undefined extends Options[Key] ? false : true : false : never) ? true : false;
 type HasPotentialOption<Options, Key extends PropertyKey> = true extends (Options extends unknown ? Key extends keyof Options ? [Exclude<Options[Key], undefined>] extends [never] ? false : true : false : never) ? true : false;
 type HasGuaranteedOption<Options, Key extends PropertyKey> = [Options] extends [never] ? false : false extends (Options extends unknown ? HasDefinedOption<Options, Key> : never) ? false : true;
-type TestRuntimeOptionLayers<Options extends TestRuntimeOptionsInput> = [...ExplicitOverrides<Options>, ...(HasGuaranteedOption<Options, 'clock'> extends true ? [ClockTestLayer] : []), ...(HasGuaranteedOption<Options, 'logger'> extends true ? [LoggerTestLayer] : []), ...(HasGuaranteedOption<Options, 'random'> extends true ? [RandomSeededLayer] : [])];
-type TestRuntimeValidationLayers<Options extends TestRuntimeOptionsInput> = [...ExplicitOverrides<Options>, ...(HasPotentialOption<Options, 'clock'> extends true ? [ClockTestLayer] : []), ...(HasPotentialOption<Options, 'logger'> extends true ? [LoggerTestLayer] : []), ...(HasPotentialOption<Options, 'random'> extends true ? [RandomSeededLayer] : [])];
+type TestRuntimeOptionLayers<Options extends TestRuntimeOptionsInput> = [...ExplicitOverrides<Options>, ...(HasGuaranteedOption<Options, 'clock'> extends true ? [ClockTestLayer] : []), ...(HasGuaranteedOption<Options, 'logger'> extends true ? [LoggerTestLayer] : []), ...(HasGuaranteedOption<Options, 'random'> extends true ? [RandomSeededLayer] : []), ...(HasGuaranteedOption<Options, 'idGenerator'> extends true ? [IdGeneratorTestLayer] : [])];
+type TestRuntimeValidationLayers<Options extends TestRuntimeOptionsInput> = [...ExplicitOverrides<Options>, ...(HasPotentialOption<Options, 'clock'> extends true ? [ClockTestLayer] : []), ...(HasPotentialOption<Options, 'logger'> extends true ? [LoggerTestLayer] : []), ...(HasPotentialOption<Options, 'random'> extends true ? [RandomSeededLayer] : []), ...(HasPotentialOption<Options, 'idGenerator'> extends true ? [IdGeneratorTestLayer] : [])];
 type TestRuntimeLayer<Base extends LayerInput, Options extends TestRuntimeOptionsInput> = OverrideLayerResult<Base, TestRuntimeOptionLayers<Options>>;
 type TestRuntimeOptionsValidation<Base extends LayerInput, Options extends TestRuntimeOptionsInput> = (Options extends {
   readonly overrides?: infer Overrides extends readonly LayerInput[];
@@ -162,6 +221,7 @@ declare class TestRuntime<Provided extends AnyService = any, Options extends obj
   readonly clock: ConfiguredService<Options, 'clock', ClockTest>;
   readonly logger: ConfiguredService<Options, 'logger', LoggerTest>;
   readonly random: ConfiguredService<Options, 'random', RandomSeeded>;
+  readonly idGenerator: ConfiguredService<Options, 'idGenerator', IdGeneratorTest>;
   private disposalPromise;
   private constructor();
   /** Create a TestRuntime with a fresh backend and default lifecycle recorder. */
@@ -194,5 +254,5 @@ declare namespace TestRuntime {
   type DisposeOptions = RuntimeDisposeOptions;
 }
 //#endregion
-export { ClockTest, ConformanceError, type ContextConcurrency, type ContractScenario, type LayerBackendAcquisitionFailure, type LayerBackendContractOptions, LoggerTest, MapLayerBackend as MemoryLayerBackend, RandomSeeded, RecordedRuntimeObserver, type RecordedRuntimeObserverSnapshot, type RuntimeContextStorageContractOptions, RuntimeObserver, type RuntimeObserverEvent, TestRuntime, TestRuntimeObserverError, type TestRuntimeOptions, layerBackendContract, runtimeContextStorageContract };
+export { ClockTest, ConformanceError, type ContextConcurrency, type ContractScenario, IdGeneratorTest, type LayerBackendAcquisitionFailure, type LayerBackendContractOptions, LoggerTest, MapLayerBackend as MemoryLayerBackend, RandomSeeded, RecordedRuntimeObserver, type RecordedRuntimeObserverSnapshot, type RuntimeContextStorageContractOptions, type RuntimeGraphEdge, type RuntimeGraphNode, RuntimeGraphObserver, type RuntimeGraphObserverOptions, type RuntimeGraphSnapshot, RuntimeObserver, type RuntimeObserverEvent, TestRuntime, TestRuntimeObserverError, type TestRuntimeOptions, layerBackendContract, runtimeContextStorageContract };
 //# sourceMappingURL=testing.d.mts.map

package/dist/testing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.mts","names":[],"sources":["../src/testing/contracts.ts","../src/testing/recorded-runtime-observer.ts","../src/testing/test-runtime.ts"],"mappings":"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"}
+{"version":3,"file":"testing.d.mts","names":[],"sources":["../src/testing/contracts.ts","../src/testing/recorded-runtime-observer.ts","../src/testing/runtime-graph-observer.ts","../src/testing/test-runtime.ts"],"mappings":"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"}

package/dist/testing.mjs

@@ -1,10 +1,11 @@
-import { a as ServiceTagCollisionError, c as ServiceNotFoundError, n as LayerDisposeError, t as DuplicateServiceError } from "./errors-Dnjhzbt0.mjs";
-import { g as RuntimeContextOverlapError, h as RuntimeContextNotConfiguredError } from "./context-BUEf1qjL.mjs";
+import { i as LayerDisposeError, r as DuplicateServiceError, s as ServiceTagCollisionError, u as ServiceNotFoundError } from "./registration-drnZk0SY.mjs";
+import { g as RuntimeContextOverlapError, h as RuntimeContextNotConfiguredError } from "./context-BphfFUMO.mjs";
 import { t as isPromiseLike } from "./runtime-CDcCF5cb.mjs";
-import { c as ScopeClosedError, d as ServiceRuntime, r as Layer, s as ScopeCloseError, u as Service } from "./signal-B97cs85Z.mjs";
-import { r as ScopeRuntime, t as Scope } from "./scope-GGnmTQck.mjs";
-import { i as MapLayerBackend, n as RuntimeObserver, r as classifyRuntimeOutcome, t as Runtime } from "./runtime-DnMn0X0X.mjs";
-import { d as Random, l as LoggerTest, p as RandomSeeded, r as ClockTest, s as Logger, t as Clock } from "./standard-services-BFBq-4lo.mjs";
+import { a as ScopeClosedError, i as ScopeCloseError } from "./disposable-CP-Q2H3l.mjs";
+import { n as Service, r as ServiceRuntime, t as Layer } from "./layer-D16GKxuX.mjs";
+import { i as Scope, o as ScopeRuntime } from "./program-metadata-BxjGkT17.mjs";
+import { i as MapLayerBackend, n as RuntimeObserver, r as classifyRuntimeOutcome, t as Runtime } from "./runtime-C_55ofnL.mjs";
+import { a as Logger, d as RandomSeeded, g as IdGeneratorTest, l as Random, p as IdGenerator, r as ClockTest, s as LoggerTest, t as Clock } from "./standard-services-vnGIafkS.mjs";
 //#region src/testing/contracts.ts
 /** Thrown by a conformance scenario when an adapter violates its contract. */
 var ConformanceError = class extends Error {
@@ -809,6 +810,185 @@ var RecordedRuntimeObserver = class RecordedRuntimeObserver {
 	}
 };
 //#endregion
+//#region src/testing/runtime-graph-observer.ts
+const compareStrings = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+const compareEdges = (left, right) => compareStrings(left.from, right.from) || compareStrings(left.to, right.to);
+const freezeNode = (node) => Object.freeze({ ...node });
+const freezeEdge = (edge) => Object.freeze({ ...edge });
+const serviceTags = (path, targetTag) => {
+	const tags = path.map((service) => service.serviceTag);
+	if (tags[tags.length - 1] !== targetTag) tags.push(targetTag);
+	return tags;
+};
+const mermaidLabelPunctuation = /* @__PURE__ */ new Set([
+	"&",
+	"\"",
+	"'",
+	"\\",
+	"[",
+	"]",
+	"(",
+	")",
+	"{",
+	"}",
+	"|",
+	"#",
+	";",
+	":",
+	"<",
+	">",
+	"=",
+	"`",
+	"*",
+	"_",
+	"~",
+	"!",
+	"^",
+	"$"
+]);
+const isMermaidLabelControl = (character, codePoint) => codePoint <= 31 || codePoint >= 127 && codePoint <= 159 || codePoint >= 55296 && codePoint <= 57343 || /\s/u.test(character) && character !== " " || /\p{Cf}/u.test(character);
+/**
+* Escape Mermaid syntax while keeping the decoded label readable.
+*
+* Mermaid's documented `#number;` form is a syntax-level escape. Encoding the
+* entity introducers themselves prevents label text from creating a second
+* entity, while encoding Markdown and HTML punctuation keeps it out of the
+* renderer's interpretation paths.
+*/
+const escapeMermaidLabel = (label) => {
+	let escaped = "";
+	for (const character of label) {
+		const codePoint = character.codePointAt(0);
+		if (codePoint === void 0) continue;
+		if (isMermaidLabelControl(character, codePoint) || mermaidLabelPunctuation.has(character)) escaped += `#${codePoint};`;
+		else escaped += character;
+	}
+	return escaped;
+};
+/** Encode a string as a Mermaid-safe, injective and registration-order-independent ID. */
+const mermaidId = (prefix, value) => {
+	const codeUnits = [];
+	for (let index = 0; index < value.length; index += 1) codeUnits.push(value.charCodeAt(index).toString(16).padStart(4, "0"));
+	return `${prefix}${codeUnits.join("_") || "empty"}`;
+};
+/**
+* Observe the public Runtime resolution and acquisition events as a diagnostic graph.
+*
+* The graph is deliberately an observation of paths emitted by Runtime. It does
+* not inspect Layer provenance, retain Service instances, or plan dependencies.
+*/
+var RuntimeGraphObserver = class RuntimeGraphObserver {
+	includeFailures;
+	rootLabel;
+	nodes = /* @__PURE__ */ new Map();
+	edges = /* @__PURE__ */ new Map();
+	rootEdges = /* @__PURE__ */ new Map();
+	constructor(includeFailures, rootLabel) {
+		this.includeFailures = includeFailures;
+		this.rootLabel = rootLabel;
+	}
+	/** Create an empty Runtime graph observer. */
+	static make(options = {}) {
+		if (typeof options !== "object" || options === null) throw new TypeError("RuntimeGraphObserver options must be an object");
+		if (options.includeFailures !== void 0 && typeof options.includeFailures !== "boolean") throw new TypeError("RuntimeGraphObserver includeFailures must be a boolean");
+		if (options.rootLabel !== void 0 && typeof options.rootLabel !== "string") throw new TypeError("RuntimeGraphObserver rootLabel must be a string");
+		return new RuntimeGraphObserver(options.includeFailures ?? true, options.rootLabel);
+	}
+	onServiceResolve = (event) => {
+		const targetTag = event.service.serviceTag;
+		const path = serviceTags(event.resolutionPath, targetTag);
+		const node = this.ensureNode(targetTag);
+		this.ensurePath(path);
+		node.resolutions += 1;
+		if (event.outcome.status === "failure" && this.includeFailures) node.failures += 1;
+		const parentTag = path[path.length - 2];
+		if (parentTag === void 0) {
+			if (this.rootLabel !== void 0) this.rootEdges.set(targetTag, (this.rootEdges.get(targetTag) ?? 0) + 1);
+			return;
+		}
+		const targets = this.edges.get(parentTag) ?? /* @__PURE__ */ new Map();
+		const edge = targets.get(targetTag) ?? (() => {
+			const created = {
+				from: parentTag,
+				to: targetTag,
+				resolutions: 0
+			};
+			targets.set(targetTag, created);
+			return created;
+		})();
+		edge.resolutions += 1;
+		this.edges.set(parentTag, targets);
+	};
+	onServiceAcquire = (event) => {
+		const targetTag = event.service.serviceTag;
+		const path = serviceTags(event.resolutionPath, targetTag);
+		const node = this.ensureNode(targetTag);
+		this.ensurePath(path);
+		node.acquisitions += 1;
+		if (event.outcome.status === "failure" && this.includeFailures) node.failures += 1;
+	};
+	/** Return a fresh, deeply detached and sorted graph snapshot. */
+	toJSON() {
+		const nodes = Object.freeze([...this.nodes.entries()].sort(([left], [right]) => compareStrings(left, right)).map(([tag, counters]) => freezeNode({
+			tag,
+			resolutions: counters.resolutions,
+			acquisitions: counters.acquisitions,
+			failures: counters.failures
+		})));
+		const edges = Object.freeze([...this.edges.values()].flatMap((targets) => [...targets.values()]).map((edge) => freezeEdge({ ...edge })).sort(compareEdges));
+		return Object.freeze({
+			nodes,
+			edges
+		});
+	}
+	/** Render the current graph as deterministic Mermaid flowchart source. */
+	toMermaid() {
+		const snapshot = this.toJSON();
+		const serviceIds = new Map(snapshot.nodes.map((node) => [node.tag, mermaidId("service_", node.tag)]));
+		const lines = ["flowchart TD"];
+		const rootTargets = [...this.rootEdges.entries()].sort(([left], [right]) => compareStrings(left, right));
+		const root = this.rootLabel !== void 0 && rootTargets.length > 0 ? {
+			id: mermaidId("root_", this.rootLabel),
+			label: this.rootLabel
+		} : void 0;
+		if (root !== void 0) lines.push(`  ${root.id}["${escapeMermaidLabel(root.label)}"]`);
+		for (const node of snapshot.nodes) {
+			const id = serviceIds.get(node.tag);
+			if (id !== void 0) lines.push(`  ${id}["${escapeMermaidLabel(node.tag)}"]`);
+		}
+		if (root !== void 0) for (const [targetTag, resolutions] of rootTargets) {
+			const targetId = serviceIds.get(targetTag);
+			if (targetId !== void 0) lines.push(`  ${root.id} -->|${resolutions}| ${targetId}`);
+		}
+		for (const edge of snapshot.edges) {
+			const fromId = serviceIds.get(edge.from);
+			const toId = serviceIds.get(edge.to);
+			if (fromId !== void 0 && toId !== void 0) lines.push(`  ${fromId} -->|${edge.resolutions}| ${toId}`);
+		}
+		return lines.join("\n");
+	}
+	/** Discard all observed graph data while keeping this observer reusable. */
+	clear() {
+		this.nodes.clear();
+		this.edges.clear();
+		this.rootEdges.clear();
+	}
+	ensureNode(tag) {
+		const existing = this.nodes.get(tag);
+		if (existing !== void 0) return existing;
+		const node = {
+			resolutions: 0,
+			acquisitions: 0,
+			failures: 0
+		};
+		this.nodes.set(tag, node);
+		return node;
+	}
+	ensurePath(path) {
+		for (const tag of path) this.ensureNode(tag);
+	}
+};
+//#endregion
 //#region src/testing/test-runtime.ts
 /**
 * Thrown when the TestRuntime recorder contains an execution start or end
@@ -836,13 +1016,15 @@ var TestRuntime = class TestRuntime {
 	clock;
 	logger;
 	random;
+	idGenerator;
 	disposalPromise;
-	constructor(runtime, observer, clock, logger, random) {
+	constructor(runtime, observer, clock, logger, random, idGenerator) {
 		this.runtime = runtime;
 		this.observer = observer;
 		this.clock = clock;
 		this.logger = logger;
 		this.random = random;
+		this.idGenerator = idGenerator;
 	}
 	static async make(layer, options) {
 		const resolvedOptions = options === void 0 ? {} : options;
@@ -858,7 +1040,7 @@ var TestRuntime = class TestRuntime {
 		};
 		const typedLayer = composedLayer;
 		const runtime = await Runtime.make(typedLayer, runtimeOptions);
-		return new TestRuntime(runtime, observer, options.clock, options.logger, options.random);
+		return new TestRuntime(runtime, observer, options.clock, options.logger, options.random, options.idGenerator);
 	}
 	/** Run a fully typechecked program in the underlying Runtime. */
 	run(program, options) {
@@ -941,6 +1123,7 @@ const composeTestLayer = (layer, options) => {
 	if (options.clock !== void 0) overrides.push(Layer.succeed(Clock, options.clock));
 	if (options.logger !== void 0) overrides.push(Layer.succeed(Logger, options.logger));
 	if (options.random !== void 0) overrides.push(Layer.succeed(Random, options.random));
+	if (options.idGenerator !== void 0) overrides.push(Layer.succeed(IdGenerator, options.idGenerator));
 	const typedLayer = layer;
 	const typedOverrides = overrides;
 	return Layer.override(typedLayer, ...typedOverrides);
@@ -971,6 +1154,6 @@ const countExecutionScopes = (events) => {
 	return counts;
 };
 //#endregion
-export { ClockTest, ConformanceError, LoggerTest, MapLayerBackend as MemoryLayerBackend, RandomSeeded, RecordedRuntimeObserver, RuntimeObserver, TestRuntime, TestRuntimeObserverError, layerBackendContract, runtimeContextStorageContract };
+export { ClockTest, ConformanceError, IdGeneratorTest, LoggerTest, MapLayerBackend as MemoryLayerBackend, RandomSeeded, RecordedRuntimeObserver, RuntimeGraphObserver, RuntimeObserver, TestRuntime, TestRuntimeObserverError, layerBackendContract, runtimeContextStorageContract };
 
 //# sourceMappingURL=testing.mjs.map