utilful 3.0.2 → 3.2.0

package/dist/result.d.mts

@@ -24,11 +24,10 @@ declare class Ok<T, E = never> {
   mapError<E2>(_fn: (error: E) => E2): Ok<T, E2>;
   /** Chains a `Result`-returning function. */
   andThen<U, E2>(fn: (value: T) => Result<U, E2>): Result<U, E | E2>;
-  /** Extracts the value. */
   unwrap(_message?: string): T;
+  unwrapErr(message?: string): never;
   /** Returns the value, ignoring the fallback. */
   unwrapOr<U>(_fallback: U): T;
-  /** Pattern matches on the `Result`. */
   match<R>(handlers: {
     ok: (value: T) => R;
     err: (error: E) => R;
@@ -49,11 +48,10 @@ declare class Err<T, E> {
   mapError<E2>(fn: (error: E) => E2): Err<T, E2>;
   /** Returns this `Err` unchanged, with a widened error type. */
   andThen<U, E2>(_fn: (value: T) => Result<U, E2>): Err<U, E | E2>;
-  /** Throws an error with the given message. */
   unwrap(message?: string): never;
+  unwrapErr(_message?: string): E;
   /** Returns the fallback value. */
   unwrapOr<U>(fallback: U): T | U;
-  /** Pattern matches on the `Result`. */
   match<R>(handlers: {
     ok: (value: T) => R;
     err: (error: E) => R;

package/dist/result.mjs

@@ -21,15 +21,16 @@ var Ok = class Ok {
 	andThen(fn) {
 		return fn(this.value);
 	}
-	/** Extracts the value. */
 	unwrap(_message) {
 		return this.value;
 	}
+	unwrapErr(message) {
+		throw new Error(message ?? `unwrapErr called on Ok: ${String(this.value)}`);
+	}
 	/** Returns the value, ignoring the fallback. */
 	unwrapOr(_fallback) {
 		return this.value;
 	}
-	/** Pattern matches on the `Result`. */
 	match(handlers) {
 		return handlers.ok(this.value);
 	}
@@ -56,15 +57,16 @@ var Err = class Err {
 	andThen(_fn) {
 		return this;
 	}
-	/** Throws an error with the given message. */
 	unwrap(message) {
-		throw new Error(message ?? `Unwrap called on Err: ${String(this.error)}`);
+		throw new Error(message ?? `unwrap called on Err: ${String(this.error)}`);
+	}
+	unwrapErr(_message) {
+		return this.error;
 	}
 	/** Returns the fallback value. */
 	unwrapOr(fallback) {
 		return fallback;
 	}
-	/** Pattern matches on the `Result`. */
 	match(handlers) {
 		return handlers.err(this.error);
 	}

package/dist/types.d.mts

@@ -1,6 +1,4 @@
 //#region src/types.d.ts
-type AutocompletableString = string & {};
-type LooseAutocomplete<T extends string> = T | AutocompletableString;
 /** Also commonly referred to as `Prettify`. */
 type UnifyIntersection<T> = { [K in keyof T]: T[K]; } & {};
 declare const brand: unique symbol;
@@ -8,4 +6,4 @@ type BrandedType<T, B> = T & {
   [brand]: B;
 };
 //#endregion
-export { AutocompletableString, BrandedType, LooseAutocomplete, UnifyIntersection };
+export { BrandedType, UnifyIntersection };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "utilful",
   "type": "module",
-  "version": "3.0.2",
+  "version": "3.2.0",
   "packageManager": "pnpm@11.15.1",
   "description": "A collection of TypeScript utilities",
   "author": "Johann Schopplich <hello@johannschopplich.com>",
@@ -14,6 +14,16 @@
   "bugs": {
     "url": "https://github.com/johannschopplich/utilful/issues"
   },
+  "keywords": [
+    "cli",
+    "csv",
+    "defu",
+    "emitter",
+    "result",
+    "typescript",
+    "url",
+    "utilities"
+  ],
   "sideEffects": false,
   "exports": {
     ".": {
@@ -24,6 +34,14 @@
       "types": "./dist/array.d.mts",
       "default": "./dist/array.mjs"
     },
+    "./cli": {
+      "types": "./dist/cli/index.d.mts",
+      "default": "./dist/cli/index.mjs"
+    },
+    "./cli/testing": {
+      "types": "./dist/cli/testing.d.mts",
+      "default": "./dist/cli/testing.mjs"
+    },
     "./csv": {
       "types": "./dist/csv.d.mts",
       "default": "./dist/csv.mjs"
@@ -77,6 +95,14 @@
     "test:types": "tsc --noEmit",
     "release": "bumpp"
   },
+  "peerDependencies": {
+    "vitest": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@antfu/eslint-config": "^9.1.0",
     "@types/node": "^26.1.1",