@terrygonguet/utils 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -8,8 +8,10 @@ declare function exhaustive(_: never): never;
 declare function hash(message: string): Promise<ArrayBuffer>;
 declare function range(start: number, end: number, step?: number): Generator<number, void, unknown>;
 declare function yesno(value?: string): boolean;
+declare function mapListPush<Key, T>(map: Map<Key, T[]>, key: Key, value: T): Map<Key, T[]>;
+declare function recordListPush<Key extends string, T>(record: Record<Key, T[]>, key: Key, value: T): Record<Key, T[]>;
 type ExecResult<T, Err = Error> = [null, T] | [Err, null];
 declare function tryCatch<F extends (...args: any) => any>(f: F, ...args: Parameters<F>): ReturnType<F> extends Promise<any> ? Promise<ExecResult<Awaited<ReturnType<F>>>> : ExecResult<ReturnType<F>>;
 declare function tryCatch<Err, F extends (...args: any) => any>(f: F, ...args: Parameters<F>): ReturnType<F> extends Promise<any> ? Promise<ExecResult<Awaited<ReturnType<F>>, Err>> : ExecResult<ReturnType<F>, Err>;
 
-export { type ExecResult, clamp, createNoopProxy, exhaustive, hash, noop, range, tryCatch, yesno };
+export { type ExecResult, clamp, createNoopProxy, exhaustive, hash, mapListPush, noop, range, recordListPush, tryCatch, yesno };

package/dist/index.js

@@ -47,6 +47,17 @@ function yesno(value) {
       return false;
   }
 }
+function mapListPush(map, key, value) {
+  const arr = map.get(key) ?? [];
+  arr.push(value);
+  return map.set(key, arr);
+}
+function recordListPush(record, key, value) {
+  const arr = record[key] ?? [];
+  arr.push(value);
+  record[key] = arr;
+  return record;
+}
 function tryCatch(f, ...args) {
   try {
     const promiseOrResult = f(...args);
@@ -65,8 +76,10 @@ export {
   createNoopProxy,
   exhaustive,
   hash,
+  mapListPush,
   noop,
   range,
+  recordListPush,
   tryCatch,
   yesno
 };

package/dist/result.d.ts

@@ -11,6 +11,7 @@ declare class Result<Err extends Error, T> {
         error: null;
     };
     andThen<Err2 extends Error, F extends (value: T) => any>(f: F): ReturnType<F> extends Promise<any> ? AsyncResult<Err | Err2, Awaited<ReturnType<F>>> : Result<Err | Err2, ReturnType<F>>;
+    recover<Err2 extends Error, F extends (error: Err) => T | Promise<T>>(f: F): ReturnType<F> extends Promise<any> ? AsyncResult<Err2, T> : Result<Err2, T>;
     unwrap(): T;
     unwrapErr(): Err;
 }
@@ -27,6 +28,7 @@ declare class AsyncResult<Err extends Error, T> {
     }>;
     then<U>(cb: (value: Result<Err, T>) => U | Promise<U>): Promise<U>;
     andThen<Err2 extends Error, F extends (value: T) => any>(f: F): AsyncResult<Err | Err2, Awaited<ReturnType<F>>>;
+    recover<Err2 extends Error, F extends (error: Err) => T | Promise<T>>(f: F): AsyncResult<Err2, T>;
     unwrap(): Promise<T>;
     unwrapErr(): Promise<Err>;
 }

package/dist/result.js

@@ -23,6 +23,17 @@ var Result = class _Result {
       return new _Result(null, RawError.wrap(error));
     }
   }
+  recover(f) {
+    if (!this.error) return this;
+    try {
+      const newValue = f(this.error);
+      if (newValue instanceof Promise)
+        return new AsyncResult(newValue);
+      else return new _Result(newValue, null);
+    } catch (error) {
+      return new _Result(null, RawError.wrap(error));
+    }
+  }
   unwrap() {
     if (this.value && !this.error) return this.value;
     else throw new Error("Tried to unwrap a failed Result");
@@ -52,6 +63,14 @@ var AsyncResult = class _AsyncResult {
   andThen(f) {
     return new _AsyncResult(this.promise.then((value) => f(value)));
   }
+  recover(f) {
+    return new _AsyncResult(
+      this.promise.then(
+        (value) => value,
+        (error) => f(error)
+      )
+    );
+  }
   unwrap() {
     return this.then((result) => result.unwrap());
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terrygonguet/utils",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"type": "module",
 	"license": "MIT",
 	"scripts": {
@@ -38,11 +38,11 @@
 		}
 	},
 	"devDependencies": {
-		"prettier": "^3.5.3",
-		"tsup": "^8.4.0",
-		"typescript": "^5.8.3",
-		"vite": "^6.3.5",
-		"vitest": "^3.1.3"
+		"prettier": "^3.6.2",
+		"tsup": "^8.5.0",
+		"typescript": "^5.9.3",
+		"vite": "^6.3.6",
+		"vitest": "^3.2.4"
 	},
 	"author": {
 		"email": "terry@gonguet.com",