@hex-di/testing

Testing utilities for HexDI — override adapters, create type-safe mocks, and manage test container lifecycles.

Installation

pnpm add -D @hex-di/testing

Usage

import { TestGraphBuilder } from "@hex-di/testing";

const testGraph = TestGraphBuilder.from(productionGraph).override(MockLoggerAdapter).build();

const container = createContainer({ graph: testGraph, name: "Test" });

Features

• TestGraphBuilder — build a graph with specific adapters swapped out for test doubles
• Mock adapters — type-safe stubs validated against port contracts at compile time
• Automatic cleanup — test containers are disposed after each test without manual teardown
• Graph assertions — runtime helpers for asserting graph completeness and port wiring

License

MIT