unthrown 4.3.0 → 5.0.0-beta.1

package/README.md

@@ -11,7 +11,7 @@ pnpm add unthrown
 ```
 
 ```ts
-import { fromPromise, TaggedError } from "unthrown";
+import { fromPromise, P, TaggedError } from "unthrown";
 
 class NotFound extends TaggedError("NotFound") {} // our modeled domain failure
 class NotFoundError extends Error {} // what `fetchUser` rejects with on a 404
@@ -22,7 +22,7 @@ const user = fromPromise(fetchUser(id), (cause, defect) =>
 
 const status = await user.match({
   ok: () => 200,
-  err: () => 404,
+  err: (matcher) => matcher.with(P._, () => 404), // `err` takes the exhaustive matcher
   defect: () => 500,
 });
 ```
@@ -32,8 +32,9 @@ const status = await user.match({
   observable only via `match` / `recoverDefect`.
 - **Qualification at every boundary** — `fromPromise` / `fromThrowable` force you
   to triage each failure into a modeled error or a defect.
-- **Tagged errors** — `TaggedError(tag)` + the exhaustive `matchTags` fold.
-- Zero runtime dependencies, ESM-first, dual CJS/ESM.
+- **Tagged errors** — `TaggedError(tag)` + `tag(t)`, folded exhaustively through
+  `match`'s ts-pattern error matcher.
+- One tiny runtime dependency (`ts-pattern`), ESM-first, dual CJS/ESM.
 
 See the [full documentation](https://btravstack.github.io/unthrown/) for the guide
 and complete API.