tsentials-errors

What problem does it solve?

This Skill solves the problem of handling errors as structured, typed values instead of untyped exceptions, so your application can return consistent error codes, descriptions, and metadata across sync and async flows.

Core Features & Use Cases

• Create rich AppError values using Err factories for failure, validation, notFound, conflict, unauthorized, forbidden, and unexpected outcomes.
• Attach and manage error metadata with ErrorMetadata as a ReadonlyMap, generated from plain records or caught exceptions.
• Convert exceptions into typed errors via Err.fromException and optionally override both the error type and code.
• Combine and compare errors using Err.combine (collect multiple AppErrors) and Err.equals (structural equality by code/description/type).

Quick Start

Use the tsentials-errors skill to define an AppError for a failing request by calling Err.validation('User.InvalidAge', 'Must be 18+', ErrorMetadata.fromRecord({ field: 'age', value: 15 })).