Skip to content
Cratis
Search
Ctrl
K
Cancel
Blog
GitHub
Discord
YouTube
Select theme
Dark
Light
Auto
Cratis Stack
Chronicle
Arc
Components
AuthProxy
Screenplay
Prologue
CLI
AI
Fundamentals
Contributing
Architecture
Overview
Start here
Getting started
Quickstart
Overview
Choose an application host model
Console
Worker Service
ASP.NET Core
Tutorial
Tutorial
Overview
1. Your first event
2. Building a read model
3. Reacting to events
Scenarios
Overview
Rebuild a read model
Enforce a unique value
React to an event
Get read models
Test a slice
Evolve an event's shape
Client SDKs
Overview
.NET client
Overview
Get started
Observing artifact registration
Captures
Overview
Declarative Captures
Model-Bound Captures
External Services
Behavior Patterns
Kotlin client
Overview
Get Started
Guides
Guides
Artifact Registration
Spring Boot
Strongly-typed Identifiers
Tracing
Captures
Testing
Appending Events
Reactors
Read Model Reactors
Reducers
Projections
Constraints
Seeding
PII Compliance
Transactions
Event Evolution
External Services
Reference
Reference
Annotations
EventStore API
Geospatial types
Configuration
Elixir client
Chronicle Elixir Client
Get Started
Connections
Connections
Resilience and the Connection Lifecycle
Connection Strings
Context Management
Event Store Discovery
Event Store Subscriptions
Jobs
WebHooks
External Services
Failed Partitions
Sinks
Seeding
TypeScript client
TypeScript Client
Get Started
Runtime
Sinks
Jobs
Webhooks
External Services
Seeding
Identity
Causation
Correlation
Failed Partitions
Concepts and architecture
Why Event Sourcing
CRUD, EF Core, and Chronicle
Understanding constraints
Understanding event evolution
Concepts
Overview
Event
Event Type
Modeling events well
Event Type Migrations
Event Source
Subject
Event Store
Namespaces
Event Sequence
Observers
Projections, reducers, and reactors
Projection
Designing read models
Deep dive: consistency
Constraints
Event Metadata Tags
Correlation, identity, and causation
Tagging
Tagging Reactors
Geospatial Coordinates
When to use event sourcing
Glossary
Architecture
Dynamic Consistency Boundary
Overview
Chronicle
Event store
Events
Overview
Event Source Id
Appending
Appending with tags
Filtering
Overview
By tag
By event source type
By event stream type
Appending many
Transactions
Observing appends
Getting events
Getting state
Concurrency
Cross-cutting properties
Overriding schema representation
Revision
Redaction
Event Seeding
Overview
Seeding with C#
Namespaces
Overview
DotNET client usage
ASP.NET Core namespace resolution
Constraints
Overview
Declarative
Overview
Unique property constraint
Unique event type constraint
Model-Bound
Overview
Unique property constraint
Unique event type constraint
Closing Streams
Migrations
Overview
C# usage
Generation validation
Compliance
Overview
PII Attribute
Applying PII to ConceptAs types
Working with compliance from the client
Read models and PII
Erasing a subject
The encryption key lifecycle
Compliance in Arc applications
Read models and processing
Read Models
Overview
Consistency Models
Empty Child Collections
Getting a Single Instance
Getting a Collection of Instances
Querying Read Models
Materialized Read Models
Getting Snapshots
Watching Read Models
Releasing PII
Reacting to Changes
Pagination and Observation
Projections
Overview
Choose a read-model style
Architecture
Eventual Consistency
Registration lifecycle
Tagging Projections
Nested Objects (Design)
Projection Declaration Language
Overview
Ad-hoc Querying
Model-Bound Projections
Overview
Basic Mapping
Set Constant Value
Clearing Values
Convention-Based
FromEvery
FromAll
Counters
Constant key
Children
Nested Objects
Removal
Joins
Event Sequence Source
Not Rewindable
Passive
Declarative Projections
Overview
Simple projection
AutoMap
Passive
Set properties
Children
Nested Objects
Joins
Functions
Composite keys
Constant key
Event context
FromEvery
FromAll
Initial values
RemoveWithJoin
FromEventSequence
NotRewindable
Reactors
Overview
Getting Started
Quickstart
Event Processing
Returning Side Effects
Event Sequence
Subscribe to External Event Stores
OnceOnly
Replay
Delivery identity
Reducers
Overview
Getting Started
Quickstart
Passive Reducers
Event Processing
Event Sequence
Subscribe to External Event Stores
Tagging Reducers
Subscriptions
Overview
Implicit Event Store Subscriptions
Explicit Event Store Subscriptions
Outbox and Inbox
Compliance and PII
Sinks
Jobs
Webhooks
Running Chronicle
Hosting
Overview
Production
Data Protection Key Encryption
Configuration
Overview
Configuration File
Root Properties
Features
Storage
Compliance Storage
Clustering
Observers
Read Models
Events
Authentication
TLS
Health Endpoint
Identity Provider Certificate
Client Bootstrap
Environment Variables
Open Telemetry
Docker Configuration
Configuration Precedence
Best Practices
Port Reference
Job Throttling
Aspire
Docker Compose
Local Certificates
Configuration
Overview
ChronicleOptions Reference
Camel Casing
gRPC Message Size
Structural Dependencies
TLS
Connection Strings
Overview
Server support
DotNET client usage
Configuration
Testing
Overview
Events
Overview
EventScenario
Append Assertions
Event Sequence Assertions
Read Models
Overview
ReadModelScenario
Reactors
Overview
ReactorScenario
Troubleshooting
Workbench
Overview
Development
Reference
Code Analysis
Code Analysis Rules
CHR0001 - Event type must have [EventType] attribute
CHR0002 - Declarative projection event type must have [EventType] attribute
CHR0003 - Model bound projection attribute must reference event type
CHR0004 - Reactor method has a parameter that cannot be resolved
CHR0005 - Reactor event parameter must have [EventType] attribute
CHR0006 - Reducer method signature must match allowed signatures
CHR0007 - Reducer event parameter must have [EventType] attribute
CHR0012 - Event types should avoid nullable properties
CHR0013 - Reactor cannot combine EventStore with explicit event sequence
CHR0014 - Reducer cannot combine EventStore with explicit event sequence
CHR0015 - Projection must not have side effects
CHR0016 - Projection Define() must not contain imperative code
CHR0017 - Constraint must not have side effects
CHR0018 - Constraint Define() must not contain imperative code
CHR0019 - Projection expression lambda must only access members
CHR0020 - Constraint expression lambda must only access members
CHR0021 - Event types should be record types
CHR0022 - Reactor methods returning event side effects must be marked with [OnceOnly]
CHR0023 - Ambiguous parent key for [ChildrenFrom] collection
CHR0024 - Read model property has no mapping source
CHR0025 - Explicitly sourced property may be overwritten by AutoMap
CHR0026 - [Key] or [Subject] on an EventSourceId identity is redundant
CHR0027 - Ambiguous event stream id
CHR0028 - Redundant .AutoMap() call
CHR0029 - Redundant .Set().To() with matching property names
CHR0030 - [ChildrenFrom] child collection property auto-maps to nothing
CHR0031 - Reactor must not have mutable state
CHR0032 - Reactor must not access storage directly
CHR0034 - [PII] cannot be applied to an EventSourceId
CHR0035 - Read model declares a reserved compliance subject property
CHR0036 - Reducer must not have mutable state
CHR0037 - Event type migration generations must belong to one event type
CHR0039 - Assertion result is discarded and can never fail
CHR0040 - Several [SetFromContext] for the same event type on one member
CHR0041 - Event filter attribute on a projection has no effect
CHR0042 - A joined property is also written locally
CHR0043 - Key redirection carries a [PII] value across the compliance subject
CHR0045 - Event stream metadata attribute on an event type has no effect
CHR0046 - Passive read model redirects the document key away from the event's own stream
CHR0047 - Retired - a clear declaration is never applied by projection construction
CHR0048 - A clear is declared for a member that cannot hold null
CHR0049 - [EventTypeGenerationFor<T>] must reference a type marked with [EventType]
Statistics
Contributing
Overview
Integration Tests
PrimeUI License
Clients
Contributing to Clients
Client Types
The Value Contract
.NET
REST API
Internalization
Protobuf Extraction
TypeScript gRPC Client
Kernel
Overview
Contracts
Services
Patches
Captures
Overview
Capture Declaration Language
Overview
Grammar (EBNF)
External Services
Behavior Patterns
Building a Client
Overview
The checklist
Two ways to start
Layering an idiomatic client
Authentication and bearer tokens
Clustering and the connection lifecycle
Connection string elements
Documentation and snippets
Blog
GitHub
Discord
YouTube
Select theme
Dark
Light
Auto
PII
Copy Markdown
Open
Open in ChatGPT
Open in Claude
View in Markdown
PII classification and release behavior are shared Chronicle compliance topics.
PII
Compliance
TypeScript client setup
