@noddde/testing

Test harnesses and utilities for noddde domains: Given / When / Then style testing for aggregates, projections, sagas, and full domain integration tests.

Documentation | GitHub

Install

yarn add --dev @noddde/testing
# or
npm install --save-dev @noddde/testing

What's Inside

• testAggregate / evolveAggregate — Unit test aggregate decide and evolve handlers
• testProjection — Unit test projection reducers
• testSaga — Unit test saga handlers and returned commands
• testDomain — Integration test a full domain with command dispatch and event flow
• Metadata utilities — stripMetadata, expectValidMetadata, expectSameCorrelation, expectCausationChain

No database or broker setup required. All harnesses run entirely in-memory.

Usage

Aggregate Testing

import { testAggregate } from "@noddde/testing";
import { BankAccount } from "../aggregates/bank-account";

const result = await testAggregate(BankAccount)
  .given(
    { name: "AccountCreated", payload: { id: "acc-1" } },
    { name: "DepositMade", payload: { amount: 1000 } },
  )
  .when({
    name: "Withdraw",
    targetAggregateId: "acc-1",
    payload: { amount: 200 },
  })
  .execute();

expect(result.events[0].name).toBe("WithdrawalMade");
expect(result.state.balance).toBe(800);

Saga Testing

import { testSaga } from "@noddde/testing";
import { OrderFulfillmentSaga } from "../sagas/order-fulfillment";

const result = await testSaga(OrderFulfillmentSaga)
  .given({ orderId: "order-1", status: "pending" })
  .when({
    name: "PaymentCompleted",
    payload: { orderId: "order-1", shipmentId: "ship-1" },
  })
  .execute();

expect(result.commands).toHaveLength(2);
expect(result.state.status).toBe("awaiting_shipment");

Domain Integration Testing

import { testDomain } from "@noddde/testing";
import { BankAccount } from "../aggregates/bank-account";
import { BalanceProjection } from "../projections/balance";

const { domain, spy } = await testDomain({
  aggregates: { BankAccount },
  projections: { BalanceProjection },
});

await domain.dispatchCommand({
  name: "Deposit",
  targetAggregateId: "acc-1",
  payload: { amount: 100 },
});

expect(spy.publishedEvents).toContainEqual(
  expect.objectContaining({ name: "DepositMade" }),
);

Related Packages

| Package | Description | | :--------------------------------------------------------------- | :------------------------------------------ | | @noddde/core | Types, interfaces, and definition functions | | @noddde/engine | Runtime engine with domain orchestration |

License

MIT