A lightweight JavaScript library for building domain-driven applications
DomainDrivenJS provides a powerful, type-safe toolkit for implementing Domain-Driven Design patterns in JavaScript or TypeScript. It helps you create rich domain models that enforce business rules, maintain consistency, and evolve with your business requirements.
- Core DDD Building Blocks: Create value objects, entities, aggregates, domain events, and repositories
- Type-Safe Domain Models: Integrated with Zod for runtime validation and type safety
- Immutable By Design: All domain objects are immutable to prevent accidental state changes
- Event-Driven Architecture: Publish and subscribe to domain events
- Repository Adapters: Easily connect to different data stores
- Flexible Composition: Extend and compose domain components
npm install domaindrivenjs zodimport { z } from 'zod';
import { valueObject, entity, aggregate } from 'domaindrivenjs';
// Define a Money value object
const Money = valueObject({
name: 'Money',
schema: z.object({
amount: z.number().nonnegative(),
currency: z.string().length(3)
}),
methodsFactory: (factory) => ({
add(other) {
if (this.currency !== other.currency) {
throw new Error(`Cannot add ${other.currency} to ${this.currency}`);
}
return factory.create({
amount: this.amount + other.amount,
currency: this.currency
});
}
})
});
// Create and use a value object
const price = Money.create({ amount: 99.99, currency: 'USD' });
const tax = Money.create({ amount: 8.00, currency: 'USD' });
const total = price.add(tax);
console.log(total.format()); // $107.99For full documentation, visit our documentation site.
MIT