@satoshibits/functional 1.1.3 → 1.2.0

package/dist/predicates.test.js

@@ -0,0 +1,375 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var vitest_1 = require("vitest");
+var predicates_mjs_1 = require("./predicates.mjs");
+(0, vitest_1.describe)('predicates', function () {
+    (0, vitest_1.describe)('and', function () {
+        (0, vitest_1.it)('should return true when all predicates are true', function () {
+            var isPositive = function (n) { return n > 0; };
+            var isEven = function (n) { return n % 2 === 0; };
+            var isPositiveEven = (0, predicates_mjs_1.and)(isPositive, isEven);
+            (0, vitest_1.expect)(isPositiveEven(4)).toBe(true);
+            (0, vitest_1.expect)(isPositiveEven(2)).toBe(true);
+        });
+        (0, vitest_1.it)('should return false when any predicate is false', function () {
+            var isPositive = function (n) { return n > 0; };
+            var isEven = function (n) { return n % 2 === 0; };
+            var isPositiveEven = (0, predicates_mjs_1.and)(isPositive, isEven);
+            (0, vitest_1.expect)(isPositiveEven(-2)).toBe(false); // not positive
+            (0, vitest_1.expect)(isPositiveEven(3)).toBe(false); // not even
+        });
+        (0, vitest_1.it)('should handle empty predicate list', function () {
+            var alwaysTrue = (0, predicates_mjs_1.and)();
+            (0, vitest_1.expect)(alwaysTrue(42)).toBe(true);
+        });
+        (0, vitest_1.it)('should work with multiple predicates', function () {
+            var hasName = function (user) { return !!user.name; };
+            var hasEmail = function (user) { return !!user.email; };
+            var isAdult = function (user) { var _a; return ((_a = user.age) !== null && _a !== void 0 ? _a : 0) >= 18; };
+            var isValidAdultUser = (0, predicates_mjs_1.and)(hasName, hasEmail, isAdult);
+            (0, vitest_1.expect)(isValidAdultUser({ name: 'John', email: 'john@example.com', age: 25 })).toBe(true);
+            (0, vitest_1.expect)(isValidAdultUser({ name: 'John', email: 'john@example.com', age: 17 })).toBe(false);
+            (0, vitest_1.expect)(isValidAdultUser({ name: 'John', age: 25 })).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('or', function () {
+        (0, vitest_1.it)('should return true when at least one predicate is true', function () {
+            var isAdmin = function (user) { return user.role === 'admin'; };
+            var isModerator = function (user) { return user.role === 'moderator'; };
+            var hasPrivileges = (0, predicates_mjs_1.or)(isAdmin, isModerator);
+            (0, vitest_1.expect)(hasPrivileges({ role: 'admin' })).toBe(true);
+            (0, vitest_1.expect)(hasPrivileges({ role: 'moderator' })).toBe(true);
+        });
+        (0, vitest_1.it)('should return false when all predicates are false', function () {
+            var isAdmin = function (user) { return user.role === 'admin'; };
+            var isModerator = function (user) { return user.role === 'moderator'; };
+            var hasPrivileges = (0, predicates_mjs_1.or)(isAdmin, isModerator);
+            (0, vitest_1.expect)(hasPrivileges({ role: 'user' })).toBe(false);
+        });
+        (0, vitest_1.it)('should handle empty predicate list', function () {
+            var alwaysFalse = (0, predicates_mjs_1.or)();
+            (0, vitest_1.expect)(alwaysFalse(42)).toBe(false);
+        });
+        (0, vitest_1.it)('should work with multiple payment methods', function () {
+            var hasCreditCard = function (payment) { return payment.type === 'credit'; };
+            var hasPayPal = function (payment) { return payment.type === 'paypal'; };
+            var hasCrypto = function (payment) { return payment.type === 'crypto'; };
+            var acceptsPayment = (0, predicates_mjs_1.or)(hasCreditCard, hasPayPal, hasCrypto);
+            (0, vitest_1.expect)(acceptsPayment({ type: 'paypal' })).toBe(true);
+            (0, vitest_1.expect)(acceptsPayment({ type: 'cash' })).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('not', function () {
+        (0, vitest_1.it)('should invert predicate result', function () {
+            var isPositive = function (n) { return n > 0; };
+            var isNegativeOrZero = (0, predicates_mjs_1.not)(isPositive);
+            (0, vitest_1.expect)(isNegativeOrZero(-5)).toBe(true);
+            (0, vitest_1.expect)(isNegativeOrZero(0)).toBe(true);
+            (0, vitest_1.expect)(isNegativeOrZero(5)).toBe(false);
+        });
+        (0, vitest_1.it)('should work with complex predicates', function () {
+            var isError = function (log) { return log.level === 'error'; };
+            var isNotError = (0, predicates_mjs_1.not)(isError);
+            (0, vitest_1.expect)(isNotError({ level: 'info' })).toBe(true);
+            (0, vitest_1.expect)(isNotError({ level: 'error' })).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('xor', function () {
+        (0, vitest_1.it)('should return true when exactly one predicate is true', function () {
+            var hasUsername = function (auth) { return !!auth.username; };
+            var hasEmail = function (auth) { return !!auth.email; };
+            var hasExactlyOneIdentifier = (0, predicates_mjs_1.xor)(hasUsername, hasEmail);
+            (0, vitest_1.expect)(hasExactlyOneIdentifier({ username: 'john' })).toBe(true);
+            (0, vitest_1.expect)(hasExactlyOneIdentifier({ email: 'john@example.com' })).toBe(true);
+        });
+        (0, vitest_1.it)('should return false when both or neither predicate is true', function () {
+            var hasUsername = function (auth) { return !!auth.username; };
+            var hasEmail = function (auth) { return !!auth.email; };
+            var hasExactlyOneIdentifier = (0, predicates_mjs_1.xor)(hasUsername, hasEmail);
+            (0, vitest_1.expect)(hasExactlyOneIdentifier({ username: 'john', email: 'j@e.com' })).toBe(false);
+            (0, vitest_1.expect)(hasExactlyOneIdentifier({})).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('isNotNil', function () {
+        (0, vitest_1.it)('should return true for non-null/undefined values', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)('string')).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)(0)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)(false)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)('')).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)([])).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)({})).toBe(true);
+        });
+        (0, vitest_1.it)('should return false for null and undefined', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)(null)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotNil)(undefined)).toBe(false);
+        });
+        (0, vitest_1.it)('should work as type guard in filter', function () {
+            var values = ['a', null, 'b', undefined, 'c'];
+            var nonNullValues = values.filter(predicates_mjs_1.isNotNil);
+            (0, vitest_1.expect)(nonNullValues).toEqual(['a', 'b', 'c']);
+        });
+    });
+    (0, vitest_1.describe)('isNil', function () {
+        (0, vitest_1.it)('should return true for null and undefined', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNil)(null)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNil)(undefined)).toBe(true);
+        });
+        (0, vitest_1.it)('should return false for non-null/undefined values', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNil)('string')).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNil)(0)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNil)(false)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNil)('')).toBe(false);
+        });
+        (0, vitest_1.it)('should work in filtering', function () {
+            var values = [1, null, 2, undefined, 3];
+            var nilValues = values.filter(predicates_mjs_1.isNil);
+            (0, vitest_1.expect)(nilValues).toEqual([null, undefined]);
+        });
+    });
+    (0, vitest_1.describe)('isEmpty', function () {
+        (0, vitest_1.it)('should return true for empty values', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)(null)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)(undefined)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)('')).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)([])).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)({})).toBe(true);
+        });
+        (0, vitest_1.it)('should return false for non-empty values', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)('hello')).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)([1, 2, 3])).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)({ a: 1 })).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)(0)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isEmpty)(false)).toBe(false);
+        });
+        (0, vitest_1.it)('should work with form validation', function () {
+            var formData = { name: '', email: 'test@example.com', bio: null };
+            var emptyFields = Object.entries(formData)
+                .filter(function (_a) {
+                var value = _a[1];
+                return (0, predicates_mjs_1.isEmpty)(value);
+            })
+                .map(function (_a) {
+                var key = _a[0];
+                return key;
+            });
+            (0, vitest_1.expect)(emptyFields).toEqual(['name', 'bio']);
+        });
+    });
+    (0, vitest_1.describe)('isNotEmpty', function () {
+        (0, vitest_1.it)('should return true for non-empty values', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)('hello')).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)([1])).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)({ a: 1 })).toBe(true);
+        });
+        (0, vitest_1.it)('should return false for empty values', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)('')).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)([])).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)({})).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.isNotEmpty)(null)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('equals', function () {
+        (0, vitest_1.it)('should create a predicate checking equality', function () {
+            var isJohn = (0, predicates_mjs_1.equals)('John');
+            (0, vitest_1.expect)(isJohn('John')).toBe(true);
+            (0, vitest_1.expect)(isJohn('Jane')).toBe(false);
+        });
+        (0, vitest_1.it)('should work with filtering', function () {
+            var names = ['John', 'Jane', 'John', 'Jack'];
+            var johns = names.filter((0, predicates_mjs_1.equals)('John'));
+            (0, vitest_1.expect)(johns).toEqual(['John', 'John']);
+        });
+        (0, vitest_1.it)('should work with numbers', function () {
+            var isZero = (0, predicates_mjs_1.equals)(0);
+            (0, vitest_1.expect)(isZero(0)).toBe(true);
+            (0, vitest_1.expect)(isZero(1)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('oneOf', function () {
+        (0, vitest_1.it)('should check if value is in array', function () {
+            var isWeekend = (0, predicates_mjs_1.oneOf)(['Saturday', 'Sunday']);
+            (0, vitest_1.expect)(isWeekend('Saturday')).toBe(true);
+            (0, vitest_1.expect)(isWeekend('Monday')).toBe(false);
+        });
+        (0, vitest_1.it)('should work with permissions', function () {
+            var canEdit = (0, predicates_mjs_1.oneOf)(['admin', 'editor', 'author']);
+            (0, vitest_1.expect)(canEdit('admin')).toBe(true);
+            (0, vitest_1.expect)(canEdit('viewer')).toBe(false);
+        });
+        (0, vitest_1.it)('should handle empty array', function () {
+            var neverTrue = (0, predicates_mjs_1.oneOf)([]);
+            (0, vitest_1.expect)(neverTrue('anything')).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('inRange', function () {
+        (0, vitest_1.it)('should check inclusive range', function () {
+            var isValidAge = (0, predicates_mjs_1.inRange)(18, 65);
+            (0, vitest_1.expect)(isValidAge(17)).toBe(false);
+            (0, vitest_1.expect)(isValidAge(18)).toBe(true);
+            (0, vitest_1.expect)(isValidAge(30)).toBe(true);
+            (0, vitest_1.expect)(isValidAge(65)).toBe(true);
+            (0, vitest_1.expect)(isValidAge(66)).toBe(false);
+        });
+        (0, vitest_1.it)('should work with decimal numbers', function () {
+            var isValidGPA = (0, predicates_mjs_1.inRange)(0.0, 4.0);
+            (0, vitest_1.expect)(isValidGPA(-0.1)).toBe(false);
+            (0, vitest_1.expect)(isValidGPA(2.5)).toBe(true);
+            (0, vitest_1.expect)(isValidGPA(4.1)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('matches', function () {
+        (0, vitest_1.it)('should match regular expressions', function () {
+            var isEmail = (0, predicates_mjs_1.matches)(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
+            (0, vitest_1.expect)(isEmail('test@example.com')).toBe(true);
+            (0, vitest_1.expect)(isEmail('invalid-email')).toBe(false);
+        });
+        (0, vitest_1.it)('should work with phone numbers', function () {
+            var isPhoneNumber = (0, predicates_mjs_1.matches)(/^\+?[\d\s-()]+$/);
+            (0, vitest_1.expect)(isPhoneNumber('+1 (555) 123-4567')).toBe(true);
+            (0, vitest_1.expect)(isPhoneNumber('not a phone')).toBe(false);
+        });
+        (0, vitest_1.it)('should handle case sensitivity', function () {
+            var startsWithHello = (0, predicates_mjs_1.matches)(/^hello/);
+            var startsWithHelloIgnoreCase = (0, predicates_mjs_1.matches)(/^hello/i);
+            (0, vitest_1.expect)(startsWithHello('Hello world')).toBe(false);
+            (0, vitest_1.expect)(startsWithHelloIgnoreCase('Hello world')).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)('hasProperty', function () {
+        (0, vitest_1.it)('should check for property existence', function () {
+            var hasEmail = (0, predicates_mjs_1.hasProperty)('email');
+            var users = [
+                { name: 'John', email: 'john@example.com' },
+                { name: 'Jane' }
+            ];
+            var usersWithEmail = users.filter(hasEmail);
+            (0, vitest_1.expect)(usersWithEmail).toEqual([{ name: 'John', email: 'john@example.com' }]);
+        });
+        (0, vitest_1.it)('should work as type guard', function () {
+            var obj = { a: 1 };
+            if ((0, predicates_mjs_1.hasProperty)('a')(obj)) {
+                // TypeScript knows obj has property 'a' here
+                (0, vitest_1.expect)(obj.a).toBe(1);
+            }
+        });
+        (0, vitest_1.it)('should work with symbol properties', function () {
+            var _a;
+            var sym = Symbol('test');
+            var hasSymbol = (0, predicates_mjs_1.hasProperty)(sym);
+            var obj1 = (_a = {}, _a[sym] = 'value', _a);
+            var obj2 = {};
+            (0, vitest_1.expect)(hasSymbol(obj1)).toBe(true);
+            (0, vitest_1.expect)(hasSymbol(obj2)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('includes', function () {
+        (0, vitest_1.it)('should check array inclusion', function () {
+            var hasFavorite = (0, predicates_mjs_1.includes)('JavaScript');
+            (0, vitest_1.expect)(hasFavorite(['Python', 'JavaScript', 'Go'])).toBe(true);
+            (0, vitest_1.expect)(hasFavorite(['Python', 'Go'])).toBe(false);
+        });
+        (0, vitest_1.it)('should work with tag filtering', function () {
+            var hasUrgentTag = (0, predicates_mjs_1.includes)('urgent');
+            var tasks = [
+                { name: 'Task 1', tags: ['urgent', 'bug'] },
+                { name: 'Task 2', tags: ['feature'] }
+            ];
+            var urgentTasks = tasks.filter(function (task) { return hasUrgentTag(task.tags); });
+            (0, vitest_1.expect)(urgentTasks).toHaveLength(1);
+        });
+        (0, vitest_1.it)('should handle empty arrays', function () {
+            var hasAny = (0, predicates_mjs_1.includes)('any');
+            (0, vitest_1.expect)(hasAny([])).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('alwaysTrue', function () {
+        (0, vitest_1.it)('should always return true', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysTrue)(null)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysTrue)(undefined)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysTrue)(42)).toBe(true);
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysTrue)('string')).toBe(true);
+        });
+        (0, vitest_1.it)('should work as default filter', function () {
+            var items = [1, 2, 3];
+            var filtered = items.filter(predicates_mjs_1.alwaysTrue);
+            (0, vitest_1.expect)(filtered).toEqual(items);
+        });
+    });
+    (0, vitest_1.describe)('alwaysFalse', function () {
+        (0, vitest_1.it)('should always return false', function () {
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysFalse)(null)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysFalse)(undefined)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysFalse)(42)).toBe(false);
+            (0, vitest_1.expect)((0, predicates_mjs_1.alwaysFalse)('string')).toBe(false);
+        });
+        (0, vitest_1.it)('should work as disabled filter', function () {
+            var items = [1, 2, 3];
+            var filtered = items.filter(predicates_mjs_1.alwaysFalse);
+            (0, vitest_1.expect)(filtered).toEqual([]);
+        });
+    });
+    (0, vitest_1.describe)('predicateUtils', function () {
+        (0, vitest_1.describe)('propEquals', function () {
+            (0, vitest_1.it)('should check property equality', function () {
+                var isAdminRole = predicates_mjs_1.predicateUtils.propEquals('role', 'admin');
+                (0, vitest_1.expect)(isAdminRole({ role: 'admin', name: 'John' })).toBe(true);
+                (0, vitest_1.expect)(isAdminRole({ role: 'user', name: 'Jane' })).toBe(false);
+            });
+            (0, vitest_1.it)('should work with filtering', function () {
+                var users = [
+                    { id: 1, role: 'admin' },
+                    { id: 2, role: 'user' },
+                    { id: 3, role: 'admin' }
+                ];
+                var admins = users.filter(predicates_mjs_1.predicateUtils.propEquals('role', 'admin'));
+                (0, vitest_1.expect)(admins).toHaveLength(2);
+            });
+        });
+        (0, vitest_1.describe)('propsMatch', function () {
+            (0, vitest_1.it)('should check multiple properties', function () {
+                var isJohnDoe = predicates_mjs_1.predicateUtils.propsMatch({
+                    firstName: 'John',
+                    lastName: 'Doe'
+                });
+                (0, vitest_1.expect)(isJohnDoe({ firstName: 'John', lastName: 'Doe', age: 30 })).toBe(true);
+                (0, vitest_1.expect)(isJohnDoe({ firstName: 'John', lastName: 'Smith' })).toBe(false);
+                (0, vitest_1.expect)(isJohnDoe({ firstName: 'Jane', lastName: 'Doe' })).toBe(false);
+            });
+            (0, vitest_1.it)('should handle empty object', function () {
+                var matchesNothing = predicates_mjs_1.predicateUtils.propsMatch({});
+                (0, vitest_1.expect)(matchesNothing({ a: 1, b: 2 })).toBe(true);
+            });
+        });
+        (0, vitest_1.describe)('contramap', function () {
+            (0, vitest_1.it)('should transform before testing', function () {
+                var hasLongName = predicates_mjs_1.predicateUtils.contramap(function (user) { return user.name; }, function (name) { return name.length > 10; });
+                (0, vitest_1.expect)(hasLongName({ name: 'John' })).toBe(false);
+                (0, vitest_1.expect)(hasLongName({ name: 'Alexander Hamilton' })).toBe(true);
+            });
+            (0, vitest_1.it)('should enable case-insensitive comparison', function () {
+                var isCaseInsensitiveMatch = function (target) {
+                    return predicates_mjs_1.predicateUtils.contramap(function (s) { return s.toLowerCase(); }, (0, predicates_mjs_1.equals)(target.toLowerCase()));
+                };
+                var isHello = isCaseInsensitiveMatch('hello');
+                (0, vitest_1.expect)(isHello('HELLO')).toBe(true);
+                (0, vitest_1.expect)(isHello('Hello')).toBe(true);
+                (0, vitest_1.expect)(isHello('hello')).toBe(true);
+                (0, vitest_1.expect)(isHello('hi')).toBe(false);
+            });
+            (0, vitest_1.it)('should work with complex transformations', function () {
+                var hasExpensiveItems = predicates_mjs_1.predicateUtils.contramap(function (order) {
+                    return order.items.map(function (item) { return item.price; });
+                }, function (prices) {
+                    return prices.some(function (price) { return price > 100; });
+                });
+                (0, vitest_1.expect)(hasExpensiveItems({
+                    items: [{ price: 50 }, { price: 150 }]
+                })).toBe(true);
+                (0, vitest_1.expect)(hasExpensiveItems({
+                    items: [{ price: 50 }, { price: 75 }]
+                })).toBe(false);
+            });
+        });
+    });
+});
+//# sourceMappingURL=predicates.test.js.map

package/dist/predicates.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.test.js","sourceRoot":"","sources":["../src/predicates.test.ts"],"names":[],"mappings":"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"}

package/dist/reader-result.d.mts

@@ -308,6 +308,78 @@ export declare const ReaderResult: {
      * Bind a computation result to a name (for Do notation)
      */
     bind: <R, E, A extends object, K extends string, B>(name: K, f: (a: A) => ReaderResult<R, E, B>) => (fa: ReaderResult<R, E, A>) => ReaderResult<R, E, A & Record<K, B>>;
+    /**
+     * Executes a ReaderResult for its side effects, discarding the result.
+     * @description Runs a ReaderResult-returning function but preserves the original value.
+     * Useful for logging, metrics, or auditing within a ReaderResult pipeline.
+     *
+     * @template R - The environment/dependencies type
+     * @template E - The error type
+     * @template A - The type of the value
+     * @param {function(A): ReaderResult<R, E, unknown>} f - Function that returns a ReaderResult (result discarded)
+     * @returns {function(ReaderResult<R, E, A>): ReaderResult<R, E, A>} A function that executes side effects
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Deps = { logger: { info: (msg: string) => void } };
+     *
+     * const logCreated = (id: string): ReaderResult<Deps, never, void> =>
+     *   ReaderResult.asks(deps => { deps.logger.info(`Created: ${id}`); });
+     *
+     * pipe(
+     *   ReaderResult.Do<Deps, Error>(),
+     *   ReaderResult.bind('user', () => createUser(input)),
+     *   ReaderResult.tap(({ user }) => logCreated(user.id)),
+     *   ReaderResult.map(({ user }) => user)
+     * );
+     * ```
+     *
+     * @since 2025-01-21
+     */
+    tap: <R, E, A>(f: (a: A) => ReaderResult<R, E, unknown>) => (self: ReaderResult<R, E, A>) => ReaderResult<R, E, A>;
+    /**
+     * Alias for {@link tap}. Executes a ReaderResult for its side effects, discarding the result.
+     * @description Provided for consistency with other monadic types (Reader, Result, Task, IO).
+     *
+     * @see tap
+     * @since 2025-01-21
+     */
+    chainFirst: <R, E, A>(f: (a: A) => ReaderResult<R, E, unknown>) => (self: ReaderResult<R, E, A>) => ReaderResult<R, E, A>;
+    /**
+     * Executes a side effect with direct access to both value and dependencies.
+     * @description Ergonomic alternative to {@link tap} when you just need to perform
+     * a sync/async effect without constructing a full ReaderResult.
+     *
+     * @remarks
+     * **Warning:** Any error thrown by the side effect will be cast to type `E`
+     * without validation. Ensure your side effect throws errors compatible with `E`,
+     * or handle exceptions internally within the callback.
+     *
+     * @template R - The environment/dependencies type
+     * @template E - The error type
+     * @template A - The type of the value
+     * @param {function(A, R): unknown} f - Side effect function with value and deps access (can be async)
+     * @returns {function(ReaderResult<R, E, A>): ReaderResult<R, E, A>} A function that executes side effects
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Deps = { logger: { info: (data: object, msg: string) => void } };
+     *
+     * pipe(
+     *   ReaderResult.Do<Deps, Error>(),
+     *   ReaderResult.bind('user', () => createUser(input)),
+     *   ReaderResult.tapDeps(({ user }, deps) => {
+     *     deps.logger.info({ userId: user.id }, 'User created');
+     *   }),
+     *   ReaderResult.map(({ user }) => user)
+     * );
+     * ```
+     *
+     * @since 2025-01-21
+     */
+    tapDeps: <R, E, A>(f: (a: A, deps: R) => unknown) => (self: ReaderResult<R, E, A>) => ReaderResult<R, E, A>;
     /**
      * Bind a value to a name (for Do notation)
      */

package/dist/reader-result.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"reader-result.d.mts","sourceRoot":"","sources":["../src/reader-result.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reader-result.d.mts","sourceRoot":"","sources":["../src/reader-result.mts"],"names":[],"mappings":"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"}

package/dist/reader-result.mjs

@@ -467,6 +467,95 @@ export var ReaderResult = {
             })(f(a));
         })(fa);
     }; },
+    /**
+     * Executes a ReaderResult for its side effects, discarding the result.
+     * @description Runs a ReaderResult-returning function but preserves the original value.
+     * Useful for logging, metrics, or auditing within a ReaderResult pipeline.
+     *
+     * @template R - The environment/dependencies type
+     * @template E - The error type
+     * @template A - The type of the value
+     * @param {function(A): ReaderResult<R, E, unknown>} f - Function that returns a ReaderResult (result discarded)
+     * @returns {function(ReaderResult<R, E, A>): ReaderResult<R, E, A>} A function that executes side effects
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Deps = { logger: { info: (msg: string) => void } };
+     *
+     * const logCreated = (id: string): ReaderResult<Deps, never, void> =>
+     *   ReaderResult.asks(deps => { deps.logger.info(`Created: ${id}`); });
+     *
+     * pipe(
+     *   ReaderResult.Do<Deps, Error>(),
+     *   ReaderResult.bind('user', () => createUser(input)),
+     *   ReaderResult.tap(({ user }) => logCreated(user.id)),
+     *   ReaderResult.map(({ user }) => user)
+     * );
+     * ```
+     *
+     * @since 2025-01-21
+     */
+    tap: function (f) { return function (self) {
+        return ReaderResult.chain(function (a) {
+            return ReaderResult.map(function () { return a; })(f(a));
+        })(self);
+    }; },
+    /**
+     * Alias for {@link tap}. Executes a ReaderResult for its side effects, discarding the result.
+     * @description Provided for consistency with other monadic types (Reader, Result, Task, IO).
+     *
+     * @see tap
+     * @since 2025-01-21
+     */
+    chainFirst: function (f) { return function (self) {
+        return ReaderResult.tap(f)(self);
+    }; },
+    /**
+     * Executes a side effect with direct access to both value and dependencies.
+     * @description Ergonomic alternative to {@link tap} when you just need to perform
+     * a sync/async effect without constructing a full ReaderResult.
+     *
+     * @remarks
+     * **Warning:** Any error thrown by the side effect will be cast to type `E`
+     * without validation. Ensure your side effect throws errors compatible with `E`,
+     * or handle exceptions internally within the callback.
+     *
+     * @template R - The environment/dependencies type
+     * @template E - The error type
+     * @template A - The type of the value
+     * @param {function(A, R): unknown} f - Side effect function with value and deps access (can be async)
+     * @returns {function(ReaderResult<R, E, A>): ReaderResult<R, E, A>} A function that executes side effects
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Deps = { logger: { info: (data: object, msg: string) => void } };
+     *
+     * pipe(
+     *   ReaderResult.Do<Deps, Error>(),
+     *   ReaderResult.bind('user', () => createUser(input)),
+     *   ReaderResult.tapDeps(({ user }, deps) => {
+     *     deps.logger.info({ userId: user.id }, 'User created');
+     *   }),
+     *   ReaderResult.map(({ user }) => user)
+     * );
+     * ```
+     *
+     * @since 2025-01-21
+     */
+    tapDeps: function (f) { return function (self) {
+        return ReaderResult.tap(function (a) {
+            return ReaderResult.tryCatch(function (deps) { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, f(a, deps)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            }); }); }, function (error) { return error; });
+        })(self);
+    }; },
     /**
      * Bind a value to a name (for Do notation)
      */