@rotomeca/rop 3.0.1 → 4.0.0

package/dist/cjs/src/classes/Fail.js

@@ -74,6 +74,15 @@ class Fail extends internal_1.ATresult {
     unwrapOr(defaultValue) {
         return defaultValue;
     }
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param fn A function to execute with the error value.
+     * @returns The original result.
+     */
+    tapError(fn) {
+        fn(this.error);
+        return this;
+    }
     /**
      * Creates a new Fail instance.
      * @param error The error value.

package/dist/cjs/src/classes/Success.js

@@ -73,6 +73,14 @@ class Success extends internal_1.ATresult {
     unwrapOr(_) {
         return this.value;
     }
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param _ Unused function since this is a Success.
+     * @returns The original Success result.
+     */
+    tapError(_) {
+        return this;
+    }
     /**
      * Creates a new Success instance.
      * @param value The success value.

package/dist/esm/src/classes/Fail.d.ts

@@ -55,6 +55,12 @@ export declare class Fail<TSuccess, TE = Error> extends ATresult<TSuccess, TE> {
      * @returns The success value if the result is a success, otherwise the default value.
      */
     unwrapOr(defaultValue: TSuccess): TSuccess;
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param fn A function to execute with the error value.
+     * @returns The original result.
+     */
+    tapError(fn: (error: TE) => void): ITResult<TSuccess, TE>;
     /**
      * Creates a new Fail instance.
      * @param error The error value.

package/dist/esm/src/classes/Fail.js

@@ -71,6 +71,15 @@ export class Fail extends ATresult {
     unwrapOr(defaultValue) {
         return defaultValue;
     }
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param fn A function to execute with the error value.
+     * @returns The original result.
+     */
+    tapError(fn) {
+        fn(this.error);
+        return this;
+    }
     /**
      * Creates a new Fail instance.
      * @param error The error value.

package/dist/esm/src/classes/Success.d.ts

@@ -54,6 +54,12 @@ export declare class Success<TSuccess, TE = Error> extends ATresult<TSuccess, TE
      * @returns The success value if the result is a success, otherwise the default value.
      */
     unwrapOr(_: TSuccess): TSuccess;
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param _ Unused function since this is a Success.
+     * @returns The original Success result.
+     */
+    tapError(_: (error: TE) => void): ITResult<TSuccess, TE>;
     /**
      * Creates a new Success instance.
      * @param value The success value.

package/dist/esm/src/classes/Success.js

@@ -70,6 +70,14 @@ export class Success extends ATresult {
     unwrapOr(_) {
         return this.value;
     }
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param _ Unused function since this is a Success.
+     * @returns The original Success result.
+     */
+    tapError(_) {
+        return this;
+    }
     /**
      * Creates a new Success instance.
      * @param value The success value.

package/dist/esm/src/classes/abstracts/ATresult.d.ts

@@ -51,6 +51,12 @@ export declare abstract class ATresult<Success, E = Error> implements ITResult<S
      * @returns The success value if the result is a success, otherwise the default value.
      */
     abstract unwrapOr(defaultValue: Success): Success;
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param fn A function to execute with the error value.
+     * @returns The original result.
+     */
+    abstract tapError(fn: (error: E) => void): ITResult<Success, E>;
     /**
      * Checks if the result is a success.
      *

package/dist/esm/src/interfaces/ITResult.d.ts

@@ -78,4 +78,10 @@ export declare interface ITResult<Success, Error> {
      * @returns The success value if the result is a success, otherwise the default value.
      */
     unwrapOr(defaultValue: Success): Success;
+    /**
+     * Executes the provided function if the result is an error, then returns the original result.
+     * @param fn A function to execute with the error value.
+     * @returns The original result.
+     */
+    tapError(fn: (error: Error) => void): ITResult<Success, Error>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rotomeca/rop",
-  "version": "3.0.1",
+  "version": "4.0.0",
   "type": "module", 
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",