CQRS for TypeScript

Purpose

Use CQRS to separate write use cases from read use cases when the separation makes behavior clearer. In TypeScript projects, prefer @cqrsx/core for CQRS primitives and wiring.

CQRS is not a reason to add ceremony by default. Use it when commands and queries have different responsibilities, dependencies, validation, permissions, transaction needs, or result shapes.

Required Package

• Use @cqrsx/core as the default CQRS package for TypeScript projects.
• Do not add another CQRS framework unless the project already uses one or the user explicitly asks.
• The public API currently exports Command, Query, Event, Cqrsx, ICommandHandler, IQueryHandler, and IEventHandler.
• If the installed version differs from the version already known to the project, inspect node_modules/@cqrsx/core/lib/index.d.mts or node_modules/@cqrsx/core/lib/index.d.cts before using newer exports.

@cqrsx/core Usage

Import primitives from @cqrsx/core: