better-effect 0.11.0 → 0.12.0

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 { 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-BUEf1qjL.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 { o as ScopeCloseError, s as ScopeClosedError } from "./signal-D2UTcaaG.mjs";
+import { n as Service, r as ServiceRuntime, t as Layer } from "./layer-D56fRdLt.mjs";
+import { i as Scope, o as ScopeRuntime } from "./program-metadata-DhQCCirO.mjs";
+import { i as MapLayerBackend, n as RuntimeObserver, r as classifyRuntimeOutcome, t as Runtime } from "./runtime-CBMrX8Wl.mjs";
+import { d as Random, h as IdGenerator, l as LoggerTest, p as RandomSeeded, r as ClockTest, s as Logger, t as Clock, v as IdGeneratorTest } from "./standard-services-GBZ32tll.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