@trailhead/core

> Foundation package providing unified Result types, enhanced error handling, and performance-optimized utilities


Foundation package for the Trailhead ecosystem providing unified Result types, enhanced error handling, and performance-optimized type guards.

Installation

``bash
npm install @trailhead/core
`

Quick Example

`typescript
import { ok, err, type Result } from '@trailhead/core'

const divide = (a: number, b: number): Result => {
if (b === 0) {
return err(new Error('Division by zero'))
}
return ok(a / b)
}

const result = divide(10, 2)
if (result.isOk()) {
console.log('Result:', result.value) // 5
} else {
console.error('Error:', result.error.message)
}
``

Key Features

- Unified Result types - Single source of truth for Result operations across the ecosystem
- Enhanced error context - Rich debugging with operation context, timestamps, and severity
- Performance-optimized type guards - Zero-overhead validation for critical paths
- Functional utilities - Composition helpers and Result-based patterns

Documentation

- API Documentation - Complete API reference

License

MIT © esteban-url