@nlozgachev/pipelined 0.40.0 → 0.42.0

package/dist/index.js

@@ -402,10 +402,120 @@ pipe.try = (f, onError) => (a) => {
 };
 
 // src/Composition/tap.ts
-var tap = (f) => (a) => {
-  f(a);
-  return a;
-};
+var import_node_util = require("util");
+
+// src/Types/Brand.ts
+var Brand;
+((Brand2) => {
+  Brand2.wrap = () => (value) => value;
+  Brand2.unwrap = (branded) => branded;
+})(Brand || (Brand = {}));
+
+// src/Types/NonEmptyList.ts
+var isNonEmptyList = (list) => list.length > 0;
+
+// 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);
+  Duration2.toMilliseconds = (d) => Brand.unwrap(d);
+  Duration2.toSeconds = (d) => Brand.unwrap(d) / 1e3;
+  Duration2.toMinutes = (d) => Brand.unwrap(d) / (60 * 1e3);
+  Duration2.toHours = (d) => Brand.unwrap(d) / (60 * 60 * 1e3);
+  Duration2.toDays = (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3);
+  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);
+    return a;
+  };
+}
+((tap2) => {
+  tap2.log = (options) => (a) => {
+    const logger = options?.logger ?? console.log;
+    const formatter = options?.formatter ?? ((val) => {
+      try {
+        return typeof val === "object" && val !== null ? JSON.stringify(val) : String(val);
+      } catch {
+        return String(val);
+      }
+    });
+    const formatted = formatter(a);
+    if (options?.label !== void 0) {
+      logger(`[${options.label}]: ${formatted}`);
+    } else {
+      logger(formatted);
+    }
+    return a;
+  };
+  tap2.inspect = (options) => (a) => {
+    const label = options?.label;
+    const depth = options?.depth ?? null;
+    const colors = options?.colors ?? true;
+    let formatted;
+    if (typeof import_node_util.inspect === "function") {
+      formatted = (0, import_node_util.inspect)(a, { depth, colors });
+    } else {
+      try {
+        formatted = JSON.stringify(a, null, 2);
+      } catch {
+        formatted = String(a);
+      }
+    }
+    if (label !== void 0) {
+      console.log(`[${label}]: ${formatted}`);
+    } else {
+      console.log(formatted);
+    }
+    return a;
+  };
+  tap2.async = (fn, options) => (a) => {
+    const onError = options?.onError ?? console.error;
+    fn(a).catch((err2) => {
+      onError(err2);
+    });
+    return a;
+  };
+  tap2.time = (fn, config) => (a) => {
+    const start = performance.now();
+    const triggerFinish = (duration) => {
+      if (config.label !== void 0) {
+        console.log(`[${config.label}]: ${Duration.toMilliseconds(duration)}ms`);
+      } else {
+        config.onFinish(duration);
+      }
+    };
+    try {
+      const res = fn(a);
+      if (res instanceof Promise) {
+        res.then(() => {
+          const duration = Duration.milliseconds(performance.now() - start);
+          triggerFinish(duration);
+        }, () => {
+          const duration = Duration.milliseconds(performance.now() - start);
+          triggerFinish(duration);
+        });
+      } else {
+        const duration = Duration.milliseconds(performance.now() - start);
+        triggerFinish(duration);
+      }
+    } catch (err2) {
+      const duration = Duration.milliseconds(performance.now() - start);
+      triggerFinish(duration);
+      throw err2;
+    }
+    return a;
+  };
+})(tap || (tap = {}));
 
 // src/Composition/uncurry.ts
 function uncurry(f) {
@@ -575,34 +685,6 @@ var Maybe;
   };
 })(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);
-  Duration2.toMilliseconds = (d) => Brand.unwrap(d);
-  Duration2.toSeconds = (d) => Brand.unwrap(d) / 1e3;
-  Duration2.toMinutes = (d) => Brand.unwrap(d) / (60 * 1e3);
-  Duration2.toHours = (d) => Brand.unwrap(d) / (60 * 60 * 1e3);
-  Duration2.toDays = (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3);
-  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/Types/NonEmptyList.ts
-var isNonEmptyList = (list) => list.length > 0;
-
 // src/internal/Op.util.ts
 var _abortedNil = { kind: "OpNil", reason: "aborted" };
 var _droppedNil = { kind: "OpNil", reason: "dropped" };
@@ -2046,9 +2128,7 @@ var Task;
     (signal) => new Promise((res) => {
       let timerId;
       const onAbort = () => {
-        if (timerId !== void 0) {
-          clearTimeout(timerId);
-        }
+        clearTimeout(timerId);
         res(toPromise(data, signal));
       };
       if (signal) {
@@ -2069,27 +2149,20 @@ var Task;
       return Promise.resolve([]);
     }
     const results = [];
-    const wait = () => {
-      if (signal?.aborted) {
-        return Promise.resolve();
+    const wait = () => new Promise((r) => {
+      let timerId;
+      const onAbort = () => {
+        clearTimeout(timerId);
+        r();
+      };
+      if (signal) {
+        signal.addEventListener("abort", onAbort, { once: true });
       }
-      return new Promise((r) => {
-        let timerId;
-        const onAbort = () => {
-          if (timerId !== void 0) {
-            clearTimeout(timerId);
-          }
-          r();
-        };
-        if (signal) {
-          signal.addEventListener("abort", onAbort, { once: true });
-        }
-        timerId = setTimeout(() => {
-          signal?.removeEventListener("abort", onAbort);
-          r();
-        }, delayDuration ? getMs2(delayDuration) : 0);
-      });
-    };
+      timerId = setTimeout(() => {
+        signal?.removeEventListener("abort", onAbort);
+        r();
+      }, delayDuration ? getMs2(delayDuration) : 0);
+    });
     const run2 = (left) => {
       if (signal?.aborted) {
         return Promise.resolve(results);
@@ -2106,27 +2179,20 @@ var Task;
   });
   Task2.repeatUntil = (options) => (task) => (0, Task2.from)((signal) => {
     const { when: predicate, delay: delayDuration, maxAttempts } = options;
-    const wait = () => {
-      if (signal?.aborted) {
-        return Promise.resolve();
+    const wait = () => new Promise((r) => {
+      let timerId;
+      const onAbort = () => {
+        clearTimeout(timerId);
+        r();
+      };
+      if (signal) {
+        signal.addEventListener("abort", onAbort, { once: true });
       }
-      return new Promise((r) => {
-        let timerId;
-        const onAbort = () => {
-          if (timerId !== void 0) {
-            clearTimeout(timerId);
-          }
-          r();
-        };
-        if (signal) {
-          signal.addEventListener("abort", onAbort, { once: true });
-        }
-        timerId = setTimeout(() => {
-          signal?.removeEventListener("abort", onAbort);
-          r();
-        }, delayDuration ? getMs2(delayDuration) : 0);
-      });
-    };
+      timerId = setTimeout(() => {
+        signal?.removeEventListener("abort", onAbort);
+        r();
+      }, delayDuration ? getMs2(delayDuration) : 0);
+    });
     const run2 = (attempt, lastValue) => {
       if (signal?.aborted && lastValue !== void 0) {
         return Promise.resolve(lastValue);
@@ -2195,9 +2261,7 @@ var Task;
     const controller = new AbortController();
     let timerId;
     function cleanUp() {
-      if (timerId !== void 0) {
-        clearTimeout(timerId);
-      }
+      clearTimeout(timerId);
       outerSignal?.removeEventListener("abort", onOuterAbort);
     }
     function onOuterAbort() {
@@ -2243,7 +2307,7 @@ var Task;
     };
     return { task, abort };
   };
-  Task2.run = (signal) => (task) => Deferred.toPromise(task(signal));
+  Task2.run = (signal) => (task) => task(signal);
   Task2.bindTo = (key) => (data) => (0, Task2.map)((a) => ({ [key]: a }))(data);
   Task2.bind = (key, f) => (data) => (0, Task2.chain)(
     (a) => (0, Task2.map)((b) => ({ ...a, [key]: b }))(f(a))
@@ -2307,7 +2371,7 @@ var TaskResult3;
       ([of_, oa]) => Result.ap(oa)(of_)
     )
   );
-  TaskResult4.run = (signal) => (task) => Deferred.toPromise(task(signal));
+  TaskResult4.run = (signal) => (task) => task(signal);
   TaskResult4.bindTo = (key) => (data) => (0, TaskResult4.map)((a) => ({ [key]: a }))(data);
   TaskResult4.bind = (key, f) => (data) => (0, TaskResult4.chain)(
     (a) => (0, TaskResult4.map)((b) => ({ ...a, [key]: b }))(f(a))
@@ -3035,6 +3099,7 @@ var Num;
   };
   Num2.clamp = (min2, max2) => (n) => Math.min(Math.max(n, min2), max2);
   Num2.between = (min2, max2) => (n) => n >= min2 && n <= max2;
+  Num2.inRange = (start, end) => (n) => n >= start && n < end;
   Num2.parse = (s) => {
     if (s.trim() === "") {
       return Maybe.none();

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   uncurry,
   uncurry3,
   uncurry4
-} from "./chunk-3Q5UBRYB.mjs";
+} from "./chunk-F6SBU7GB.mjs";
 import {
   Arr,
   Dict,
@@ -35,7 +35,7 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-BQKKTTJS.mjs";
+} from "./chunk-6VYLZTAM.mjs";
 import {
   Combinable,
   Deferred,
@@ -61,12 +61,12 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-4R4XUP4M.mjs";
+} from "./chunk-OAP765G3.mjs";
 import {
   Brand,
   Duration,
   isNonEmptyList
-} from "./chunk-5AFEEFE4.mjs";
+} from "./chunk-GBB6LVLI.mjs";
 export {
   Arr,
   Brand,

package/dist/types.d.mts

@@ -1,128 +1,4 @@
-declare const _brand: unique symbol;
-/**
- * Brand<K, T> creates a nominal type by tagging T with a phantom brand K.
- * Prevents accidentally mixing up values that share the same underlying type.
- *
- * @example
- * ```ts
- * type UserId = Brand<"UserId", string>;
- * type ProductId = Brand<"ProductId", string>;
- *
- * const toUserId = Brand.wrap<"UserId", string>();
- * const toProductId = Brand.wrap<"ProductId", string>();
- *
- * const userId: UserId = toUserId("user-123");
- * const productId: ProductId = toProductId("prod-456");
- *
- * // Type error: ProductId is not assignable to UserId
- * // const wrong: UserId = productId;
- * ```
- */
-type Brand<K extends string, T> = T & {
-    readonly [_brand]: K;
-};
-declare namespace Brand {
-    /**
-     * Returns a constructor that wraps a value of type T in brand K.
-     * The resulting function performs an unchecked cast — only use when the raw
-     * value is known to satisfy the brand's invariants.
-     *
-     * @example
-     * ```ts
-     * type PositiveNumber = Brand<"PositiveNumber", number>;
-     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
-     *
-     * const n: PositiveNumber = toPositiveNumber(42);
-     * ```
-     */
-    const wrap: <K extends string, T>() => (value: T) => Brand<K, T>;
-    /**
-     * Strips the brand and returns the underlying value.
-     * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
-     *
-     * @example
-     * ```ts
-     * const userId: UserId = toUserId("user-123");
-     * const raw: string = Brand.unwrap(userId); // "user-123"
-     * ```
-     */
-    const unwrap: <K extends string, T>(branded: Brand<K, T>) => T;
-}
-
-/**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
- *
- * @example
- * ```ts
- * const halfSecond = Duration.milliseconds(500);
- * const twoSeconds = Duration.seconds(2);
- * const total = pipe(halfSecond, Duration.add(twoSeconds));
- *
- * Duration.toSeconds(total); // 2.5
- * ```
- */
-type Duration = Brand<"Duration", number>;
-declare namespace Duration {
-    /**
-     * Creates a Duration from milliseconds.
-     */
-    const milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     */
-    const seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     */
-    const minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     */
-    const hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     */
-    const days: (d: number) => Duration;
-    /**
-     * Converts a Duration back to raw milliseconds.
-     */
-    const toMilliseconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to seconds.
-     */
-    const toSeconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to minutes.
-     */
-    const toMinutes: (d: Duration) => number;
-    /**
-     * Converts a Duration to hours.
-     */
-    const toHours: (d: Duration) => number;
-    /**
-     * Converts a Duration to days.
-     */
-    const toDays: (d: Duration) => number;
-    /**
-     * Adds two Durations together.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
-     * ```
-     */
-    const add: (other: Duration) => (self: Duration) => Duration;
-    /**
-     * Subtracts the other Duration from this one.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
-     * ```
-     */
-    const subtract: (other: Duration) => (self: Duration) => Duration;
-}
+export { B as Brand, D as Duration } from './Duration-BTeT9D-q.mjs';
 
 /**
  * A list that is guaranteed to have at least one element.
@@ -153,4 +29,4 @@ type NonEmptyList<A> = readonly [A, ...A[]];
  */
 declare const isNonEmptyList: <A>(list: readonly A[]) => list is NonEmptyList<A>;
 
-export { Brand, Duration, type NonEmptyList, isNonEmptyList };
+export { type NonEmptyList, isNonEmptyList };

package/dist/types.d.ts

@@ -1,128 +1,4 @@
-declare const _brand: unique symbol;
-/**
- * Brand<K, T> creates a nominal type by tagging T with a phantom brand K.
- * Prevents accidentally mixing up values that share the same underlying type.
- *
- * @example
- * ```ts
- * type UserId = Brand<"UserId", string>;
- * type ProductId = Brand<"ProductId", string>;
- *
- * const toUserId = Brand.wrap<"UserId", string>();
- * const toProductId = Brand.wrap<"ProductId", string>();
- *
- * const userId: UserId = toUserId("user-123");
- * const productId: ProductId = toProductId("prod-456");
- *
- * // Type error: ProductId is not assignable to UserId
- * // const wrong: UserId = productId;
- * ```
- */
-type Brand<K extends string, T> = T & {
-    readonly [_brand]: K;
-};
-declare namespace Brand {
-    /**
-     * Returns a constructor that wraps a value of type T in brand K.
-     * The resulting function performs an unchecked cast — only use when the raw
-     * value is known to satisfy the brand's invariants.
-     *
-     * @example
-     * ```ts
-     * type PositiveNumber = Brand<"PositiveNumber", number>;
-     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
-     *
-     * const n: PositiveNumber = toPositiveNumber(42);
-     * ```
-     */
-    const wrap: <K extends string, T>() => (value: T) => Brand<K, T>;
-    /**
-     * Strips the brand and returns the underlying value.
-     * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
-     *
-     * @example
-     * ```ts
-     * const userId: UserId = toUserId("user-123");
-     * const raw: string = Brand.unwrap(userId); // "user-123"
-     * ```
-     */
-    const unwrap: <K extends string, T>(branded: Brand<K, T>) => T;
-}
-
-/**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
- *
- * @example
- * ```ts
- * const halfSecond = Duration.milliseconds(500);
- * const twoSeconds = Duration.seconds(2);
- * const total = pipe(halfSecond, Duration.add(twoSeconds));
- *
- * Duration.toSeconds(total); // 2.5
- * ```
- */
-type Duration = Brand<"Duration", number>;
-declare namespace Duration {
-    /**
-     * Creates a Duration from milliseconds.
-     */
-    const milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     */
-    const seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     */
-    const minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     */
-    const hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     */
-    const days: (d: number) => Duration;
-    /**
-     * Converts a Duration back to raw milliseconds.
-     */
-    const toMilliseconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to seconds.
-     */
-    const toSeconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to minutes.
-     */
-    const toMinutes: (d: Duration) => number;
-    /**
-     * Converts a Duration to hours.
-     */
-    const toHours: (d: Duration) => number;
-    /**
-     * Converts a Duration to days.
-     */
-    const toDays: (d: Duration) => number;
-    /**
-     * Adds two Durations together.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
-     * ```
-     */
-    const add: (other: Duration) => (self: Duration) => Duration;
-    /**
-     * Subtracts the other Duration from this one.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
-     * ```
-     */
-    const subtract: (other: Duration) => (self: Duration) => Duration;
-}
+export { B as Brand, D as Duration } from './Duration-BTeT9D-q.js';
 
 /**
  * A list that is guaranteed to have at least one element.
@@ -153,4 +29,4 @@ type NonEmptyList<A> = readonly [A, ...A[]];
  */
 declare const isNonEmptyList: <A>(list: readonly A[]) => list is NonEmptyList<A>;
 
-export { Brand, Duration, type NonEmptyList, isNonEmptyList };
+export { type NonEmptyList, isNonEmptyList };

package/dist/types.mjs

@@ -2,7 +2,7 @@ import {
   Brand,
   Duration,
   isNonEmptyList
-} from "./chunk-5AFEEFE4.mjs";
+} from "./chunk-GBB6LVLI.mjs";
 export {
   Brand,
   Duration,

package/dist/utils.d.mts

@@ -1,5 +1,6 @@
-import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-DcXhCZYg.mjs';
+import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-BprUabHP.mjs';
 import { NonEmptyList } from './types.mjs';
+import './Duration-BTeT9D-q.mjs';
 
 /**
  * Functional array utilities that compose well with pipe.
@@ -893,6 +894,17 @@ declare namespace Num {
      * ```
      */
     const between: (min: number, max: number) => (n: number) => boolean;
+    /**
+     * Returns `true` when the number is in the range `[start, end)` (inclusive of `start`, exclusive of `end`).
+     *
+     * @example
+     * ```ts
+     * pipe(5, Num.inRange(1, 10));  // true
+     * pipe(1, Num.inRange(1, 10));  // true
+     * pipe(10, Num.inRange(1, 10)); // false
+     * ```
+     */
+    const inRange: (start: number, end: number) => (n: number) => boolean;
     /**
      * Parses a string as a number. Returns `None` when the result is `NaN`.
      *

package/dist/utils.d.ts

@@ -1,5 +1,6 @@
-import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-uupX7xd9.js';
+import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-Dt3ZMen6.js';
 import { NonEmptyList } from './types.js';
+import './Duration-BTeT9D-q.js';
 
 /**
  * Functional array utilities that compose well with pipe.
@@ -893,6 +894,17 @@ declare namespace Num {
      * ```
      */
     const between: (min: number, max: number) => (n: number) => boolean;
+    /**
+     * Returns `true` when the number is in the range `[start, end)` (inclusive of `start`, exclusive of `end`).
+     *
+     * @example
+     * ```ts
+     * pipe(5, Num.inRange(1, 10));  // true
+     * pipe(1, Num.inRange(1, 10));  // true
+     * pipe(10, Num.inRange(1, 10)); // false
+     * ```
+     */
+    const inRange: (start: number, end: number) => (n: number) => boolean;
     /**
      * Parses a string as a number. Returns `None` when the result is `NaN`.
      *