---
title: 'CHR0054: Reactor method has an unsupported return type'
editUrl: https://github.com/Cratis/Chronicle/edit/main/Documentation/code-analysis/CHR0054.mdx
description: CHR0054 warns when a reactor method in Cratis Chronicle returns a type the analyzer does not recognize as a supported return shape.
lastUpdated: 2026-11-05T00:00:00.000Z
---


## Rule description

A reactor method whose first parameter is an `[EventType]` but whose synchronous return type is neither a built-in supported shape nor claimed by a registered side-effect handler is skipped during handler discovery. CHR0054 reports return types the analyzer cannot recognize, rather than treating them as unresolvable parameters.

## Severity

Warning

## Supported returns

- `void` or `Task`.
- A registered event type, `EventForEventSourceId`, or `EventsWithConcurrencyScopes`.
- A custom type marked `[ReactorSideEffect]` from `Cratis.Chronicle.Reactors.SideEffects`, including types deriving from a marked base class or implementing a marked interface.
- A one-dimensional array or `IEnumerable<T>` implementation where `T` is a registered event type, `EventForEventSourceId`, `object` (for mixed events and targeted events), or a marked side-effect type.
- `Task<T>` for any side effect that a registered reactor side-effect handler can process, including the shapes above.

Synchronous custom side effects require a registered `IReactorSideEffectHandler` whose `CanHandleReturnType(Type)` claims the declared return type and which processes the returned value. Mark the custom type `[ReactorSideEffect]` so the analyzer accepts it; the marker only informs the analyzer and registers nothing. For a collection return, the handler must claim and process the collection type, not only its elements. See [Custom return type handlers](/chronicle/reactors/side-effects/#custom-return-type-handlers).

## Related rules

- [CHR0004](/chronicle/code-analysis/chr0004/): Reactor method has a parameter that cannot be resolved.
- [CHR0005](/chronicle/code-analysis/chr0005/): Reactor event parameter must have `[EventType]` attribute.
