Skip to content
This repository was archived by the owner on Nov 11, 2026. It is now read-only.

Latest commit

 

History

History
54 lines (39 loc) · 2.22 KB

GLOSSARY.md

File metadata and controls

54 lines (39 loc) · 2.22 KB

tryharder

A small execution layer for TypeScript: callers keep writing plain functions, while execution policy and failure become explicit, typed parts of the returned value.

Language

Terminal execution API: The point where work actually runs and a result union is produced (run, runSync). Avoid: executor, runner

Policy builder: A chainable step (retry, timeout, signal) that runs no work itself; it configures the next terminal call and widens its result union. Avoid: modifier, middleware, decorator

Result union: The return type of a terminal execution: the success value together with every failure that execution can produce. Avoid: Result type, Either, error tuple

Domain failure: A failure the caller maps into their own value with catch; an expected outcome of the domain. Avoid: business error

Policy failure: A failure introduced by a policy builder (TimeoutError, CancellationError, RetryExhaustedError). It surfaces typed in the result union and never passes through catch. Avoid: system error, infrastructure error

Panic: A thrown signal of programmer misuse (invalid builder chain, invalid task graph). Never part of a result union. Avoid: error, exception (for this concept)

Attempt: One execution of the work under a retry policy. The first execution is an attempt; retry(limit) counts it. Avoid: retry (as a noun for the count)

Total deadline: The single time budget timeout(ms) enforces — across all attempts for terminal execution, across the whole task graph for orchestration. Avoid: per-attempt timeout

Task graph: An object-shaped map of named tasks handed to orchestration; tasks read earlier results through this.$result. Avoid: task list, promise array

Orchestration: Running a task graph through all, allSettled, or flow.

Settled outcome: The per-task fulfilled-or-rejected record preserved by allSettled instead of short-circuiting on failure.

Exit: The explicit termination of a flow through $exit; the only way a flow completes. Avoid: early return, break

Cooperative cancellation: Cancellation that takes effect only when the running work observes its $signal. Aborting requests a stop; it does not force one.