Error Management

What problem does it solve?

Effect-TS applications encode domain errors and defects differently, leading to brittle error handling. This skill provides patterns and conventions to model recoverable errors with typed error channels, differentiate defects, and compose robust error handling across effects.

Core Features & Use Cases

• Create Typed Errors with Schema.TaggedError and explicit Error types for domain failures.
• Catch and recover using Effect.catchAll, Effect.catchTag, and Effect.catchTags; aggregate errors with Effect.all and Effect.validate.
• Transform and map errors with Effect.mapError and Effect.mapBoth; compose fallback strategies via Effect.orElse and Effect.orElseSucceed.
• Reason about defects, sandboxing, and retry/timeouts to build resilient async workflows.
• Use best practices to maintain clear error boundaries, testability, and predictable failure modes.

Quick Start

• Define a typed error (e.g., UserNotFound) and demonstrate a recoverable path via catchTag, with a fallback value when the error occurs.