@nlozgachev/pipelined 0.58.0 → 0.60.0

package/README.md

@@ -555,12 +555,12 @@ if (Result.is.ok(email)) {
 - **`@nlozgachev/pipelined/core`**: Core context containers, async runtimes, optics, and logic
   abstractions (<16 KB gzipped).
 - **`@nlozgachev/pipelined/data`**: Curried, data-last utilities for collections, numbers, strings,
-  and JSON (<13 KB gzipped).
+  and JSON (<10 KB gzipped).
 - **`@nlozgachev/pipelined/composition`**: Pure higher-order function combinators (`pipe`, `flow`,
   `compose`, `curry`, `uncurry`, `converge`, `juxt`, `memoize`, `tap`, `on`, `not`, `flip`, `fn`)
-  (<4 KB gzipped).
-- **`@nlozgachev/pipelined/types`**: Type-level utilities (`Brand`, `Duration`, `RetryPolicy`) (<2
-  KB gzipped).
+  (<3 KB gzipped).
+- **`@nlozgachev/pipelined/types`**: Type-level utilities (`Brand`, `Duration`, `RetryPolicy`) (<700
+  B gzipped).
 
 Every utility in the library is benchmarked against its native equivalent. While currying introduces
 a small function call overhead for composability, the library uses custom algorithms for

package/dist/composition.cjs

@@ -263,13 +263,25 @@ function juxt(fns) {
 var memoize = (f, options) => {
   const cache = /* @__PURE__ */ new Map();
   const keyFn = options?.key ?? ((a) => a);
+  const maxSize = options?.maxSize;
   return (a) => {
     const key = keyFn(a);
     if (cache.has(key)) {
-      return cache.get(key);
+      const cached = cache.get(key);
+      if (maxSize !== void 0) {
+        cache.delete(key);
+        cache.set(key, cached);
+      }
+      return cached;
     }
     const result = f(a);
     cache.set(key, result);
+    if (maxSize !== void 0 && cache.size > maxSize) {
+      const firstKey = cache.keys().next().value;
+      if (firstKey !== void 0) {
+        cache.delete(firstKey);
+      }
+    }
     return result;
   };
 };

package/dist/composition.d.cts

@@ -521,10 +521,19 @@ declare function juxt<A, B>(fns: ReadonlyArray<(a: A) => B>): (a: A) => B[];
  *   (opts: { id: string }) => fetch(`/users/${opts.id}`),
  *   { key: (opts) => opts.id }
  * );
+ * // With bounded cache size (LRU eviction)
+ * const bounded = memoize(
+ *   (n: number) => n * 2,
+ *   { maxSize: 100 }
+ * );
  * ```
  */
 declare const memoize: <A, B>(f: (a: A) => B, options?: {
     readonly key?: (a: A) => unknown;
+    /**
+     * Maximum number of entries to store in the cache before evicting the least recently used (LRU) entry.
+     */
+    readonly maxSize?: number;
 }) => (a: A) => B;
 /**
  * Creates a memoized version of a function using WeakMap.

package/dist/composition.d.ts

@@ -521,10 +521,19 @@ declare function juxt<A, B>(fns: ReadonlyArray<(a: A) => B>): (a: A) => B[];
  *   (opts: { id: string }) => fetch(`/users/${opts.id}`),
  *   { key: (opts) => opts.id }
  * );
+ * // With bounded cache size (LRU eviction)
+ * const bounded = memoize(
+ *   (n: number) => n * 2,
+ *   { maxSize: 100 }
+ * );
  * ```
  */
 declare const memoize: <A, B>(f: (a: A) => B, options?: {
     readonly key?: (a: A) => unknown;
+    /**
+     * Maximum number of entries to store in the cache before evicting the least recently used (LRU) entry.
+     */
+    readonly maxSize?: number;
 }) => (a: A) => B;
 /**
  * Creates a memoized version of a function using WeakMap.

package/dist/{chunk-JSG7SFXS.js → composition.mjs}

@@ -1,7 +1,3 @@
-import {
-  Duration
-} from "./chunk-OIIOGDHK.js";
-
 // src/Composition/compose.ts
 function compose(f0, f1, f2, f3, f4, f5, f6, f7, f8, f9) {
   const len = arguments.length;
@@ -212,13 +208,25 @@ function juxt(fns) {
 var memoize = (f, options) => {
   const cache = /* @__PURE__ */ new Map();
   const keyFn = options?.key ?? ((a) => a);
+  const maxSize = options?.maxSize;
   return (a) => {
     const key = keyFn(a);
     if (cache.has(key)) {
-      return cache.get(key);
+      const cached = cache.get(key);
+      if (maxSize !== void 0) {
+        cache.delete(key);
+        cache.set(key, cached);
+      }
+      return cached;
     }
     const result = f(a);
     cache.set(key, result);
+    if (maxSize !== void 0 && cache.size > maxSize) {
+      const firstKey = cache.keys().next().value;
+      if (firstKey !== void 0) {
+        cache.delete(firstKey);
+      }
+    }
     return result;
   };
 };
@@ -324,6 +332,36 @@ pipe.try = (f, onError) => (a) => {
 
 // src/Composition/tap.ts
 import { inspect as nodeInspect } from "util";
+
+// src/Types/Brand.ts
+var Brand;
+((Brand2) => {
+  Brand2.wrap = () => (value) => value;
+  Brand2.unwrap = (branded) => branded;
+})(Brand || (Brand = {}));
+
+// src/Types/Duration.ts
+var Duration;
+((Duration2) => {
+  const wrap = Brand.wrap();
+  Duration2.milliseconds = (ms) => wrap(ms);
+  Duration2.seconds = (s) => wrap(s * 1e3);
+  Duration2.minutes = (m) => wrap(m * 60 * 1e3);
+  Duration2.hours = (h) => wrap(h * 60 * 60 * 1e3);
+  Duration2.days = (d) => wrap(d * 24 * 60 * 60 * 1e3);
+  let to;
+  ((to2) => {
+    to2.milliseconds = (d) => Brand.unwrap(d);
+    to2.seconds = (d) => Brand.unwrap(d) / 1e3;
+    to2.minutes = (d) => Brand.unwrap(d) / (60 * 1e3);
+    to2.hours = (d) => Brand.unwrap(d) / (60 * 60 * 1e3);
+    to2.days = (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3);
+  })(to = Duration2.to || (Duration2.to = {}));
+  Duration2.add = (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other));
+  Duration2.subtract = (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other));
+})(Duration || (Duration = {}));
+
+// src/Composition/tap.ts
 function tap(f) {
   return (a) => {
     f(a);
@@ -417,36 +455,35 @@ function uncurry(f) {
 }
 var uncurry3 = (f) => (a, b, c) => f(a)(b)(c);
 var uncurry4 = (f) => (a, b, c, d) => f(a)(b)(c)(d);
-
 export {
+  and,
   compose,
+  constFalse,
+  constNull,
+  constTrue,
+  constUndefined,
+  constVoid,
+  constant,
   converge,
   curry,
   curry3,
   curry4,
+  defaultTo,
   flip,
   flow,
   identity,
-  constant,
-  constTrue,
-  constFalse,
-  constNull,
-  constUndefined,
-  constVoid,
-  and,
-  or,
-  once,
-  defaultTo,
-  tuple,
-  untuple,
   juxt,
   memoize,
   memoizeWeak,
   not,
   on,
+  once,
+  or,
   pipe,
   tap,
+  tuple,
   uncurry,
   uncurry3,
-  uncurry4
+  uncurry4,
+  untuple
 };

package/dist/core.cjs

@@ -1830,6 +1830,7 @@ var Stream;
   Stream2.make = (options) => ({
     options,
     _listeners: /* @__PURE__ */ new Set(),
+    _listenerArray: null,
     _queue: [],
     _isEmitting: false
   });
@@ -1843,7 +1844,10 @@ var Stream;
         try {
           while (stream._queue.length > 0) {
             const nextMsg = stream._queue.shift();
-            const listeners = Array.from(stream._listeners);
+            if (stream._listenerArray === null) {
+              stream._listenerArray = Array.from(stream._listeners);
+            }
+            const listeners = stream._listenerArray;
             for (const listener of listeners) {
               try {
                 listener(nextMsg);
@@ -1874,8 +1878,10 @@ var Stream;
       }
     };
     options.from._listeners.add(handler);
+    options.from._listenerArray = null;
     return () => {
       options.from._listeners.delete(handler);
+      options.from._listenerArray = null;
     };
   };
   Stream2.listen = (stream, events, options) => {
@@ -1929,12 +1935,15 @@ var Stream;
           currentState = reducer(msg, currentState);
           if (isOnce) {
             stream._listeners.delete(listenerFn);
+            stream._listenerArray = null;
           }
         });
         const unsubscribe = () => {
           stream._listeners.delete(listenerFn);
+          stream._listenerArray = null;
         };
         stream._listeners.add(listenerFn);
+        stream._listenerArray = null;
         return { unsubscribe, getState: () => currentState };
       },
       tap: (effect) => {
@@ -1942,12 +1951,15 @@ var Stream;
           effect(msg);
           if (isOnce) {
             stream._listeners.delete(listenerFn);
+            stream._listenerArray = null;
           }
         });
         const unsubscribe = () => {
           stream._listeners.delete(listenerFn);
+          stream._listenerArray = null;
         };
         stream._listeners.add(listenerFn);
+        stream._listenerArray = null;
         return unsubscribe;
       }
     };

package/dist/core.d.cts

@@ -2632,6 +2632,13 @@ type Stream<S extends Record<string, unknown>> = {
     readonly options?: Stream.Options;
     /** @internal */
     readonly _listeners: Set<(msg: Stream.Message<S>) => void>;
+    /**
+     * @internal
+     * Lazy array snapshot of `_listeners`. Avoids allocating new array objects on every `emit` call
+     * (2.98x emission speedup, 0 heap allocations). Rebuilt whenever `_listeners` is mutated,
+     * guaranteeing reentrancy safety and preventing listeners subscribed mid-emission from executing early.
+     */
+    _listenerArray: Array<(msg: Stream.Message<S>) => void> | null;
     /** @internal */
     readonly _queue: Array<Stream.Message<S>>;
     /** @internal */

package/dist/core.d.ts

@@ -2632,6 +2632,13 @@ type Stream<S extends Record<string, unknown>> = {
     readonly options?: Stream.Options;
     /** @internal */
     readonly _listeners: Set<(msg: Stream.Message<S>) => void>;
+    /**
+     * @internal
+     * Lazy array snapshot of `_listeners`. Avoids allocating new array objects on every `emit` call
+     * (2.98x emission speedup, 0 heap allocations). Rebuilt whenever `_listeners` is mutated,
+     * guaranteeing reentrancy safety and preventing listeners subscribed mid-emission from executing early.
+     */
+    _listenerArray: Array<(msg: Stream.Message<S>) => void> | null;
     /** @internal */
     readonly _queue: Array<Stream.Message<S>>;
     /** @internal */

package/dist/{chunk-VYHAA4KO.js → core.mjs}

@@ -1,7 +1,3 @@
-import {
-  Duration
-} from "./chunk-OIIOGDHK.js";
-
 // src/Core/Combinable.ts
 var Combinable;
 ((Combinable2) => {
@@ -232,6 +228,34 @@ var Maybe;
   Maybe3.transposeResult = (data) => is.none(data) ? Result.make.ok(make.none()) : Result.is.ok(data.value) ? Result.make.ok(make.some(data.value.value)) : Result.make.err(data.value.error);
 })(Maybe || (Maybe = {}));
 
+// src/Types/Brand.ts
+var Brand;
+((Brand2) => {
+  Brand2.wrap = () => (value) => value;
+  Brand2.unwrap = (branded) => branded;
+})(Brand || (Brand = {}));
+
+// src/Types/Duration.ts
+var Duration;
+((Duration2) => {
+  const wrap = Brand.wrap();
+  Duration2.milliseconds = (ms) => wrap(ms);
+  Duration2.seconds = (s) => wrap(s * 1e3);
+  Duration2.minutes = (m) => wrap(m * 60 * 1e3);
+  Duration2.hours = (h) => wrap(h * 60 * 60 * 1e3);
+  Duration2.days = (d) => wrap(d * 24 * 60 * 60 * 1e3);
+  let to;
+  ((to2) => {
+    to2.milliseconds = (d) => Brand.unwrap(d);
+    to2.seconds = (d) => Brand.unwrap(d) / 1e3;
+    to2.minutes = (d) => Brand.unwrap(d) / (60 * 1e3);
+    to2.hours = (d) => Brand.unwrap(d) / (60 * 60 * 1e3);
+    to2.days = (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3);
+  })(to = Duration2.to || (Duration2.to = {}));
+  Duration2.add = (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other));
+  Duration2.subtract = (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other));
+})(Duration || (Duration = {}));
+
 // src/internal/Op.util.ts
 var _abortedNil = { kind: "OpNil", reason: "aborted" };
 var _droppedNil = { kind: "OpNil", reason: "dropped" };
@@ -1759,6 +1783,7 @@ var Stream;
   Stream2.make = (options) => ({
     options,
     _listeners: /* @__PURE__ */ new Set(),
+    _listenerArray: null,
     _queue: [],
     _isEmitting: false
   });
@@ -1772,7 +1797,10 @@ var Stream;
         try {
           while (stream._queue.length > 0) {
             const nextMsg = stream._queue.shift();
-            const listeners = Array.from(stream._listeners);
+            if (stream._listenerArray === null) {
+              stream._listenerArray = Array.from(stream._listeners);
+            }
+            const listeners = stream._listenerArray;
             for (const listener of listeners) {
               try {
                 listener(nextMsg);
@@ -1803,8 +1831,10 @@ var Stream;
       }
     };
     options.from._listeners.add(handler);
+    options.from._listenerArray = null;
     return () => {
       options.from._listeners.delete(handler);
+      options.from._listenerArray = null;
     };
   };
   Stream2.listen = (stream, events, options) => {
@@ -1858,12 +1888,15 @@ var Stream;
           currentState = reducer(msg, currentState);
           if (isOnce) {
             stream._listeners.delete(listenerFn);
+            stream._listenerArray = null;
           }
         });
         const unsubscribe = () => {
           stream._listeners.delete(listenerFn);
+          stream._listenerArray = null;
         };
         stream._listeners.add(listenerFn);
+        stream._listenerArray = null;
         return { unsubscribe, getState: () => currentState };
       },
       tap: (effect) => {
@@ -1871,12 +1904,15 @@ var Stream;
           effect(msg);
           if (isOnce) {
             stream._listeners.delete(listenerFn);
+            stream._listenerArray = null;
           }
         });
         const unsubscribe = () => {
           stream._listeners.delete(listenerFn);
+          stream._listenerArray = null;
         };
         stream._listeners.add(listenerFn);
+        stream._listenerArray = null;
         return unsubscribe;
       }
     };
@@ -2593,7 +2629,6 @@ var Validation;
     return isNonEmptyArr(errors) ? make.failedAll(errors) : make.passed(record);
   };
 })(Validation || (Validation = {}));
-
 export {
   Combinable,
   Deferred,
@@ -2614,7 +2649,6 @@ export {
   Result,
   State,
   Stream,
-  isNonEmptyArr,
   Task,
   These,
   Validation

package/dist/data.cjs

@@ -475,7 +475,7 @@ var Arr;
     }
     return result;
   };
-  Arr2.uniq = (data) => [...new Set(data)];
+  Arr2.uniq = (data) => data.length <= 1 ? data : [...new Set(data)];
   Arr2.uniqBy = (f) => (data) => {
     const seen = /* @__PURE__ */ new Set();
     const result = [];
@@ -1130,10 +1130,20 @@ var Num;
 
 // src/Data/Rec.ts
 var _isNonEmpty = (data) => Object.keys(data).length > 0;
+var _setKey = (record, key, value) => {
+  if (key === "__proto__") {
+    Object.defineProperty(record, key, { value, writable: true, enumerable: true, configurable: true });
+  } else {
+    record[key] = value;
+  }
+};
 var RecMaybe;
 ((RecMaybe2) => {
   RecMaybe2.traverse = (f) => (data) => {
     const recordKeys = Object.keys(data);
+    if (recordKeys.length === 0) {
+      return { kind: "Some", value: {} };
+    }
     const result = {};
     for (let i = 0; i < recordKeys.length; i++) {
       const key = recordKeys[i];
@@ -1141,7 +1151,7 @@ var RecMaybe;
       if (maybeVal.kind === "None") {
         return maybeVal;
       }
-      Object.defineProperty(result, key, { value: maybeVal.value, writable: true, enumerable: true, configurable: true });
+      _setKey(result, key, maybeVal.value);
     }
     return { kind: "Some", value: result };
   };
@@ -1158,7 +1168,7 @@ var RecResult;
       if (res.kind === "Err") {
         return res;
       }
-      Object.defineProperty(result, key, { value: res.value, writable: true, enumerable: true, configurable: true });
+      _setKey(result, key, res.value);
     }
     return { kind: "Ok", value: result };
   };
@@ -1211,12 +1221,7 @@ var Rec;
     for (let i = 0; i < recordKeys.length; i++) {
       const maybeVal = f(recordValues[i]);
       if (maybeVal.kind === "Some") {
-        Object.defineProperty(result, recordKeys[i], {
-          value: maybeVal.value,
-          writable: true,
-          enumerable: true,
-          configurable: true
-        });
+        _setKey(result, recordKeys[i], maybeVal.value);
       }
     }
     return result;
@@ -1227,16 +1232,7 @@ var Rec;
     const result = Object.create(Object.getPrototypeOf(data));
     for (let i = 0; i < recordKeys.length; i++) {
       const key = recordKeys[i];
-      if (key === "__proto__") {
-        Object.defineProperty(result, "__proto__", {
-          value: f(key, recordValues[i]),
-          writable: true,
-          enumerable: true,
-          configurable: true
-        });
-      } else {
-        result[key] = f(key, recordValues[i]);
-      }
+      _setKey(result, key, f(key, recordValues[i]));
     }
     return result;
   };
@@ -1246,12 +1242,7 @@ var Rec;
     const result = Object.create(Object.getPrototypeOf(data));
     for (let i = 0; i < recordKeys.length; i++) {
       if (predicate(recordValues[i])) {
-        Object.defineProperty(result, recordKeys[i], {
-          value: recordValues[i],
-          writable: true,
-          enumerable: true,
-          configurable: true
-        });
+        _setKey(result, recordKeys[i], recordValues[i]);
       }
     }
     return result;
@@ -1260,7 +1251,7 @@ var Rec;
     const result = {};
     for (const [k, v] of Object.entries(data)) {
       if (predicate(k, v)) {
-        Object.defineProperty(result, k, { value: v, writable: true, enumerable: true, configurable: true });
+        _setKey(result, k, v);
       }
     }
     return result;
@@ -1280,7 +1271,7 @@ var Rec;
       if (Object.hasOwn(result, key)) {
         result[key].push(item);
       } else {
-        Object.defineProperty(result, key, { value: [item], writable: true, enumerable: true, configurable: true });
+        _setKey(result, key, [item]);
       }
     }
     return result;
@@ -1289,7 +1280,7 @@ var Rec;
     const result = {};
     for (const key of pickedKeys) {
       if (Object.hasOwn(data, key)) {
-        Object.defineProperty(result, key, { value: data[key], writable: true, enumerable: true, configurable: true });
+        _setKey(result, key, data[key]);
       }
     }
     return result;
@@ -1299,12 +1290,7 @@ var Rec;
     const result = {};
     for (const key of Object.keys(data)) {
       if (!omitSet.has(key)) {
-        Object.defineProperty(result, key, {
-          value: data[key],
-          writable: true,
-          enumerable: true,
-          configurable: true
-        });
+        _setKey(result, key, data[key]);
       }
     }
     return result;
@@ -1345,26 +1331,42 @@ var Rec;
   Rec2.mergeWith = mergeWith;
   Rec2.size = (data) => Object.keys(data).length;
   Rec2.mapKeys = (f) => (data) => {
+    const keys2 = Object.keys(data);
+    if (keys2.length === 0) {
+      return data;
+    }
     const result = {};
-    for (const [k, v] of Object.entries(data)) {
-      Object.defineProperty(result, f(k), { value: v, writable: true, enumerable: true, configurable: true });
+    for (let i = 0; i < keys2.length; i++) {
+      const k = keys2[i];
+      _setKey(result, f(k), data[k]);
     }
     return result;
   };
   Rec2.compact = (data) => {
+    const keys2 = Object.keys(data);
+    if (keys2.length === 0) {
+      return {};
+    }
     const result = {};
-    for (const [k, v] of Object.entries(data)) {
+    for (let i = 0; i < keys2.length; i++) {
+      const k = keys2[i];
+      const v = data[k];
       if (v.kind === "Some") {
-        Object.defineProperty(result, k, { value: v.value, writable: true, enumerable: true, configurable: true });
+        _setKey(result, k, v.value);
       }
     }
     return result;
   };
   Rec2.mapEntries = (f) => (data) => {
+    const keys2 = Object.keys(data);
+    if (keys2.length === 0) {
+      return {};
+    }
     const result = {};
-    for (const [k, v] of Object.entries(data)) {
-      const [newKey, newVal] = f(k, v);
-      Object.defineProperty(result, newKey, { value: newVal, writable: true, enumerable: true, configurable: true });
+    for (let i = 0; i < keys2.length; i++) {
+      const k = keys2[i];
+      const [newKey, newVal] = f(k, data[k]);
+      _setKey(result, newKey, newVal);
     }
     return result;
   };
@@ -1436,8 +1438,11 @@ var Str;
      * ```
      */
     int: (s) => {
-      const n = parseInt(s, 10);
-      return isNaN(n) ? Maybe.make.none() : Maybe.make.some(n);
+      if (s.length === 0) {
+        return Maybe.make.none();
+      }
+      const n = Number.parseInt(s, 10);
+      return Number.isNaN(n) ? Maybe.make.none() : Maybe.make.some(n);
     },
     /**
      * Parses a string as a floating-point number. Returns `None` if the result is `NaN`.
@@ -1450,8 +1455,11 @@ var Str;
      * ```
      */
     float: (s) => {
-      const n = parseFloat(s);
-      return isNaN(n) ? Maybe.make.none() : Maybe.make.some(n);
+      if (s.length === 0) {
+        return Maybe.make.none();
+      }
+      const n = Number.parseFloat(s);
+      return Number.isNaN(n) ? Maybe.make.none() : Maybe.make.some(n);
     }
   };
   Str2.parseJson = (s) => {