@nlozgachev/pipekit 0.1.8 → 0.2.0

package/esm/src/Core/These.js

@@ -6,28 +6,28 @@ export var These;
      *
      * @example
      * ```ts
-     * These.toErr("Something went wrong");
+     * These.err("Something went wrong");
      * ```
      */
-    These.toErr = (error) => Result.toErr(error);
+    These.err = (error) => Result.err(error);
     /**
      * Creates a These holding only a success value (no error).
      *
      * @example
      * ```ts
-     * These.toOk(42);
+     * These.ok(42);
      * ```
      */
-    These.toOk = (value) => Result.toOk(value);
+    These.ok = (value) => Result.ok(value);
     /**
      * Creates a These holding both an error/warning and a success value.
      *
      * @example
      * ```ts
-     * These.toBoth("Deprecated API used", result);
+     * These.both("Deprecated API used", result);
      * ```
      */
-    These.toBoth = (error, value) => ({
+    These.both = (error, value) => ({
         kind: "Both",
         error,
         value,
@@ -57,33 +57,33 @@ export var These;
      *
      * @example
      * ```ts
-     * pipe(These.toOk(5), These.map(n => n * 2));          // Ok(10)
-     * pipe(These.toBoth("warn", 5), These.map(n => n * 2)); // Both("warn", 10)
-     * pipe(These.toErr("err"), These.map(n => n * 2));      // Err("err")
+     * pipe(These.ok(5), These.map(n => n * 2));          // Ok(10)
+     * pipe(These.both("warn", 5), These.map(n => n * 2)); // Both("warn", 10)
+     * pipe(These.err("err"), These.map(n => n * 2));      // Err("err")
      * ```
      */
     These.map = (f) => (data) => {
         if (These.isErr(data))
             return data;
         if (These.isOk(data))
-            return These.toOk(f(data.value));
-        return These.toBoth(data.error, f(data.value));
+            return These.ok(f(data.value));
+        return These.both(data.error, f(data.value));
     };
     /**
      * Transforms the error/warning value, leaving the success value unchanged.
      *
      * @example
      * ```ts
-     * pipe(These.toErr("err"), These.mapErr(e => e.toUpperCase()));         // Err("ERR")
-     * pipe(These.toBoth("warn", 5), These.mapErr(e => e.toUpperCase()));    // Both("WARN", 5)
+     * pipe(These.err("err"), These.mapErr(e => e.toUpperCase()));         // Err("ERR")
+     * pipe(These.both("warn", 5), These.mapErr(e => e.toUpperCase()));    // Both("WARN", 5)
      * ```
      */
     These.mapErr = (f) => (data) => {
         if (These.isOk(data))
             return data;
         if (These.isErr(data))
-            return These.toErr(f(data.error));
-        return These.toBoth(f(data.error), data.value);
+            return These.err(f(data.error));
+        return These.both(f(data.error), data.value);
     };
     /**
      * Transforms both the error and success values independently.
@@ -91,17 +91,17 @@ export var These;
      * @example
      * ```ts
      * pipe(
-     *   These.toBoth("warn", 5),
+     *   These.both("warn", 5),
      *   These.bimap(e => e.toUpperCase(), n => n * 2)
      * ); // Both("WARN", 10)
      * ```
      */
     These.bimap = (onErr, onOk) => (data) => {
         if (These.isErr(data))
-            return These.toErr(onErr(data.error));
+            return These.err(onErr(data.error));
         if (These.isOk(data))
-            return These.toOk(onOk(data.value));
-        return These.toBoth(onErr(data.error), onOk(data.value));
+            return These.ok(onOk(data.value));
+        return These.both(onErr(data.error), onOk(data.value));
     };
     /**
      * Chains These computations by passing the success value to f.
@@ -112,11 +112,11 @@ export var These;
      *
      * @example
      * ```ts
-     * const double = (n: number): These<string, number> => These.toOk(n * 2);
+     * const double = (n: number): These<string, number> => These.ok(n * 2);
      *
-     * pipe(These.toOk(5), These.chain(double));           // Ok(10)
-     * pipe(These.toBoth("warn", 5), These.chain(double)); // Both("warn", 10)
-     * pipe(These.toErr("err"), These.chain(double));      // Err("err")
+     * pipe(These.ok(5), These.chain(double));           // Ok(10)
+     * pipe(These.both("warn", 5), These.chain(double)); // Both("warn", 10)
+     * pipe(These.err("err"), These.chain(double));      // Err("err")
      * ```
      */
     These.chain = (f) => (data) => {
@@ -125,7 +125,7 @@ export var These;
         if (These.isOk(data))
             return f(data.value);
         const result = f(data.value);
-        return These.isOk(result) ? These.toBoth(data.error, result.value) : result;
+        return These.isOk(result) ? These.both(data.error, result.value) : result;
     };
     /**
      * Extracts a value from a These by providing handlers for all three cases.
@@ -176,9 +176,9 @@ export var These;
      *
      * @example
      * ```ts
-     * pipe(These.toOk(5), These.getOrElse(0));           // 5
-     * pipe(These.toBoth("warn", 5), These.getOrElse(0)); // 5
-     * pipe(These.toErr("err"), These.getOrElse(0));      // 0
+     * pipe(These.ok(5), These.getOrElse(0));           // 5
+     * pipe(These.both("warn", 5), These.getOrElse(0)); // 5
+     * pipe(These.err("err"), These.getOrElse(0));      // 0
      * ```
      */
     These.getOrElse = (defaultValue) => (data) => These.hasValue(data) ? data.value : defaultValue;
@@ -199,17 +199,17 @@ export var These;
      *
      * @example
      * ```ts
-     * These.swap(These.toErr("err"));        // Ok("err")
-     * These.swap(These.toOk(5));             // Err(5)
-     * These.swap(These.toBoth("warn", 5));   // Both(5, "warn")
+     * These.swap(These.err("err"));        // Ok("err")
+     * These.swap(These.ok(5));             // Err(5)
+     * These.swap(These.both("warn", 5));   // Both(5, "warn")
      * ```
      */
     These.swap = (data) => {
         if (These.isErr(data))
-            return These.toOk(data.error);
+            return These.ok(data.error);
         if (These.isOk(data))
-            return These.toErr(data.value);
-        return These.toBoth(data.value, data.error);
+            return These.err(data.value);
+        return These.both(data.value, data.error);
     };
     /**
      * Converts a These to an Option.
@@ -217,9 +217,9 @@ export var These;
      *
      * @example
      * ```ts
-     * These.toOption(These.toOk(42));          // Some(42)
-     * These.toOption(These.toBoth("warn", 42)); // Some(42)
-     * These.toOption(These.toErr("err"));       // None
+     * These.toOption(These.ok(42));          // Some(42)
+     * These.toOption(These.both("warn", 42)); // Some(42)
+     * These.toOption(These.err("err"));       // None
      * ```
      */
     These.toOption = (data) => These.hasValue(data) ? { kind: "Some", value: data.value } : { kind: "None" };
@@ -229,14 +229,14 @@ export var These;
      *
      * @example
      * ```ts
-     * These.toResult(These.toOk(42));           // Ok(42)
-     * These.toResult(These.toBoth("warn", 42)); // Ok(42)
-     * These.toResult(These.toErr("err"));       // Err("err")
+     * These.toResult(These.ok(42));           // Ok(42)
+     * These.toResult(These.both("warn", 42)); // Ok(42)
+     * These.toResult(These.err("err"));       // Err("err")
      * ```
      */
     These.toResult = (data) => {
         if (These.hasValue(data))
-            return Result.toOk(data.value);
+            return Result.ok(data.value);
         return data;
     };
 })(These || (These = {}));

package/esm/src/Types/Brand.js

@@ -1,19 +1,19 @@
 export var Brand;
 (function (Brand) {
     /**
-     * Creates a branding constructor for brand K over type T.
+     * 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.make<"PositiveNumber", number>();
+     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
      *
      * const n: PositiveNumber = toPositiveNumber(42);
      * ```
      */
-    Brand.make = () => (value) => value;
+    Brand.wrap = () => (value) => value;
     /**
      * Strips the brand and returns the underlying value.
      * Since Brand<K, T> extends T this is rarely needed, but can improve readability.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nlozgachev/pipekit",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Simple functional programming toolkit for TypeScript",
   "keywords": [
     "functional",

package/script/src/Core/Arr.js

@@ -31,7 +31,7 @@ var Arr;
      * Arr.head([]); // None
      * ```
      */
-    Arr.head = (data) => data.length > 0 ? Option_js_1.Option.toSome(data[0]) : Option_js_1.Option.toNone();
+    Arr.head = (data) => data.length > 0 ? Option_js_1.Option.some(data[0]) : Option_js_1.Option.none();
     /**
      * Returns the last element of an array, or None if the array is empty.
      *
@@ -41,7 +41,7 @@ var Arr;
      * Arr.last([]); // None
      * ```
      */
-    Arr.last = (data) => data.length > 0 ? Option_js_1.Option.toSome(data[data.length - 1]) : Option_js_1.Option.toNone();
+    Arr.last = (data) => data.length > 0 ? Option_js_1.Option.some(data[data.length - 1]) : Option_js_1.Option.none();
     /**
      * Returns all elements except the first, or None if the array is empty.
      *
@@ -51,7 +51,7 @@ var Arr;
      * Arr.tail([]); // None
      * ```
      */
-    Arr.tail = (data) => data.length > 0 ? Option_js_1.Option.toSome(data.slice(1)) : Option_js_1.Option.toNone();
+    Arr.tail = (data) => data.length > 0 ? Option_js_1.Option.some(data.slice(1)) : Option_js_1.Option.none();
     /**
      * Returns all elements except the last, or None if the array is empty.
      *
@@ -61,7 +61,7 @@ var Arr;
      * Arr.init([]); // None
      * ```
      */
-    Arr.init = (data) => data.length > 0 ? Option_js_1.Option.toSome(data.slice(0, -1)) : Option_js_1.Option.toNone();
+    Arr.init = (data) => data.length > 0 ? Option_js_1.Option.some(data.slice(0, -1)) : Option_js_1.Option.none();
     // --- Search ---
     /**
      * Returns the first element matching the predicate, or None.
@@ -73,7 +73,7 @@ var Arr;
      */
     Arr.findFirst = (predicate) => (data) => {
         const idx = data.findIndex(predicate);
-        return idx >= 0 ? Option_js_1.Option.toSome(data[idx]) : Option_js_1.Option.toNone();
+        return idx >= 0 ? Option_js_1.Option.some(data[idx]) : Option_js_1.Option.none();
     };
     /**
      * Returns the last element matching the predicate, or None.
@@ -86,9 +86,9 @@ var Arr;
     Arr.findLast = (predicate) => (data) => {
         for (let i = data.length - 1; i >= 0; i--) {
             if (predicate(data[i]))
-                return Option_js_1.Option.toSome(data[i]);
+                return Option_js_1.Option.some(data[i]);
         }
-        return Option_js_1.Option.toNone();
+        return Option_js_1.Option.none();
     };
     /**
      * Returns the index of the first element matching the predicate, or None.
@@ -100,7 +100,7 @@ var Arr;
      */
     Arr.findIndex = (predicate) => (data) => {
         const idx = data.findIndex(predicate);
-        return idx >= 0 ? Option_js_1.Option.toSome(idx) : Option_js_1.Option.toNone();
+        return idx >= 0 ? Option_js_1.Option.some(idx) : Option_js_1.Option.none();
     };
     // --- Transform ---
     /**
@@ -306,7 +306,7 @@ var Arr;
      * ```ts
      * const parseNum = (s: string): Option<number> => {
      *   const n = Number(s);
-     *   return isNaN(n) ? Option.toNone() : Option.of(n);
+     *   return isNaN(n) ? Option.none() : Option.of(n);
      * };
      *
      * pipe(["1", "2", "3"], Arr.traverse(parseNum)); // Some([1, 2, 3])
@@ -318,10 +318,10 @@ var Arr;
         for (const a of data) {
             const mapped = f(a);
             if (Option_js_1.Option.isNone(mapped))
-                return Option_js_1.Option.toNone();
+                return Option_js_1.Option.none();
             result.push(mapped.value);
         }
-        return Option_js_1.Option.toSome(result);
+        return Option_js_1.Option.some(result);
     };
     /**
      * Maps each element to a Result and collects the results.
@@ -331,7 +331,7 @@ var Arr;
      * ```ts
      * pipe(
      *   [1, 2, 3],
-     *   Arr.traverseResult(n => n > 0 ? Result.toOk(n) : Result.toErr("negative"))
+     *   Arr.traverseResult(n => n > 0 ? Result.ok(n) : Result.err("negative"))
      * ); // Ok([1, 2, 3])
      * ```
      */
@@ -343,7 +343,7 @@ var Arr;
                 return mapped;
             result.push(mapped.value);
         }
-        return Result_js_1.Result.toOk(result);
+        return Result_js_1.Result.ok(result);
     };
     /**
      * Maps each element to a Task and runs all in parallel.
@@ -364,7 +364,7 @@ var Arr;
      * @example
      * ```ts
      * Arr.sequence([Option.of(1), Option.of(2)]); // Some([1, 2])
-     * Arr.sequence([Option.of(1), Option.toNone()]); // None
+     * Arr.sequence([Option.of(1), Option.none()]); // None
      * ```
      */
     Arr.sequence = (data) => Arr.traverse((a) => a)(data);

package/script/src/Core/Option.js

@@ -12,11 +12,11 @@ var Option;
      * Option.of(42); // Some(42)
      * ```
      */
-    Option.of = (value) => Option.toSome(value);
+    Option.of = (value) => Option.some(value);
     /**
      * Creates a Some containing the given value.
      */
-    Option.toSome = (value) => ({ kind: "Some", value });
+    Option.some = (value) => ({ kind: "Some", value });
     /**
      * Type guard that checks if a Option is Some.
      */
@@ -24,7 +24,7 @@ var Option;
     /**
      * Creates a None (empty Option).
      */
-    Option.toNone = () => ({ kind: "None" });
+    Option.none = () => ({ kind: "None" });
     /**
      * Type guard that checks if a Option is None.
      */
@@ -39,7 +39,7 @@ var Option;
      * Option.fromNullable(42); // Some(42)
      * ```
      */
-    Option.fromNullable = (value) => value === null || value === undefined ? Option.toNone() : Option.toSome(value);
+    Option.fromNullable = (value) => value === null || value === undefined ? Option.none() : Option.some(value);
     /**
      * Extracts the value from a Option, returning null if None.
      */
@@ -52,7 +52,7 @@ var Option;
      * Creates a Option from a possibly undefined value.
      * Returns None if undefined, Some otherwise.
      */
-    Option.fromUndefined = (value) => value === undefined ? Option.toNone() : Option.toSome(value);
+    Option.fromUndefined = (value) => value === undefined ? Option.none() : Option.some(value);
     /**
      * Converts an Option to a Result.
      * Some becomes Ok, None becomes Err with the provided error.
@@ -65,33 +65,33 @@ var Option;
      * ); // Ok(42)
      *
      * pipe(
-     *   Option.toNone(),
+     *   Option.none(),
      *   Option.toResult(() => "Value was missing")
      * ); // Err("Value was missing")
      * ```
      */
-    Option.toResult = (onNone) => (data) => Option.isSome(data) ? Result_js_1.Result.toOk(data.value) : Result_js_1.Result.toErr(onNone());
+    Option.toResult = (onNone) => (data) => Option.isSome(data) ? Result_js_1.Result.ok(data.value) : Result_js_1.Result.err(onNone());
     /**
      * Creates an Option from a Result.
      * Ok becomes Some, Err becomes None (the error is discarded).
      *
      * @example
      * ```ts
-     * Option.fromResult(Result.toOk(42)); // Some(42)
-     * Option.fromResult(Result.toErr("oops")); // None
+     * Option.fromResult(Result.ok(42)); // Some(42)
+     * Option.fromResult(Result.err("oops")); // None
      * ```
      */
-    Option.fromResult = (data) => Result_js_1.Result.isOk(data) ? Option.toSome(data.value) : Option.toNone();
+    Option.fromResult = (data) => Result_js_1.Result.isOk(data) ? Option.some(data.value) : Option.none();
     /**
      * Transforms the value inside a Option if it exists.
      *
      * @example
      * ```ts
      * pipe(Option.of(5), Option.map(n => n * 2)); // Some(10)
-     * pipe(Option.toNone(), Option.map(n => n * 2)); // None
+     * pipe(Option.none(), Option.map(n => n * 2)); // None
      * ```
      */
-    Option.map = (f) => (data) => Option.isSome(data) ? Option.toSome(f(data.value)) : data;
+    Option.map = (f) => (data) => Option.isSome(data) ? Option.some(f(data.value)) : data;
     /**
      * Chains Option computations. If the first is Some, passes the value to f.
      * If the first is None, propagates None.
@@ -100,7 +100,7 @@ var Option;
      * ```ts
      * const parseNumber = (s: string): Option<number> => {
      *   const n = parseInt(s, 10);
-     *   return isNaN(n) ? Option.toNone() : Option.of(n);
+     *   return isNaN(n) ? Option.none() : Option.of(n);
      * };
      *
      * pipe(Option.of("42"), Option.chain(parseNumber)); // Some(42)
@@ -144,7 +144,7 @@ var Option;
      * @example
      * ```ts
      * pipe(Option.of(5), Option.getOrElse(0)); // 5
-     * pipe(Option.toNone(), Option.getOrElse(0)); // 0
+     * pipe(Option.none(), Option.getOrElse(0)); // 0
      * ```
      */
     Option.getOrElse = (defaultValue) => (data) => Option.isSome(data) ? data.value : defaultValue;
@@ -176,7 +176,7 @@ var Option;
      * pipe(Option.of(2), Option.filter(n => n > 3)); // None
      * ```
      */
-    Option.filter = (predicate) => (data) => Option.isSome(data) && predicate(data.value) ? data : Option.toNone();
+    Option.filter = (predicate) => (data) => Option.isSome(data) && predicate(data.value) ? data : Option.none();
     /**
      * Recovers from a None by providing a fallback Option.
      */
@@ -194,5 +194,5 @@ var Option;
      * ); // Some(8)
      * ```
      */
-    Option.ap = (arg) => (data) => Option.isSome(data) && Option.isSome(arg) ? Option.toSome(data.value(arg.value)) : Option.toNone();
+    Option.ap = (arg) => (data) => Option.isSome(data) && Option.isSome(arg) ? Option.some(data.value(arg.value)) : Option.none();
 })(Option || (exports.Option = Option = {}));

package/script/src/Core/Rec.js

@@ -90,7 +90,7 @@ var Rec;
      * pipe({ a: 1, b: 2 }, Rec.lookup("c")); // None
      * ```
      */
-    Rec.lookup = (key) => (data) => Object.prototype.hasOwnProperty.call(data, key) ? Option_js_1.Option.toSome(data[key]) : Option_js_1.Option.toNone();
+    Rec.lookup = (key) => (data) => Object.prototype.hasOwnProperty.call(data, key) ? Option_js_1.Option.some(data[key]) : Option_js_1.Option.none();
     /**
      * Returns all keys of a record.
      */

package/script/src/Core/Result.js

@@ -11,15 +11,15 @@ var Result;
      * Result.of(42); // Ok(42)
      * ```
      */
-    Result.of = (value) => Result.toOk(value);
+    Result.of = (value) => Result.ok(value);
     /**
      * Creates a failed Result with the given error.
      */
-    Result.toErr = (error) => ({ kind: "Error", error });
+    Result.err = (error) => ({ kind: "Error", error });
     /**
      * Creates a successful Result with the given value.
      */
-    Result.toOk = (value) => ({ kind: "Ok", value });
+    Result.ok = (value) => ({ kind: "Ok", value });
     /**
      * Type guard that checks if an Result is Ok.
      */
@@ -43,10 +43,10 @@ var Result;
      */
     Result.tryCatch = (f, onError) => {
         try {
-            return Result.toOk(f());
+            return Result.ok(f());
         }
         catch (e) {
-            return Result.toErr(onError(e));
+            return Result.err(onError(e));
         }
     };
     /**
@@ -55,19 +55,19 @@ var Result;
      * @example
      * ```ts
      * pipe(Result.of(5), Result.map(n => n * 2)); // Ok(10)
-     * pipe(Result.toErr("error"), Result.map(n => n * 2)); // Err("error")
+     * pipe(Result.err("error"), Result.map(n => n * 2)); // Err("error")
      * ```
      */
-    Result.map = (f) => (data) => Result.isOk(data) ? Result.toOk(f(data.value)) : data;
+    Result.map = (f) => (data) => Result.isOk(data) ? Result.ok(f(data.value)) : data;
     /**
      * Transforms the error value inside an Result.
      *
      * @example
      * ```ts
-     * pipe(Result.toErr("oops"), Result.mapError(e => e.toUpperCase())); // Err("OOPS")
+     * pipe(Result.err("oops"), Result.mapError(e => e.toUpperCase())); // Err("OOPS")
      * ```
      */
-    Result.mapError = (f) => (data) => Result.isErr(data) ? Result.toErr(f(data.error)) : data;
+    Result.mapError = (f) => (data) => Result.isErr(data) ? Result.err(f(data.error)) : data;
     /**
      * Chains Result computations. If the first is Ok, passes the value to f.
      * If the first is Err, propagates the error.
@@ -75,7 +75,7 @@ var Result;
      * @example
      * ```ts
      * const validatePositive = (n: number): Result<string, number> =>
-     *   n > 0 ? Result.of(n) : Result.toErr("Must be positive");
+     *   n > 0 ? Result.of(n) : Result.err("Must be positive");
      *
      * pipe(Result.of(5), Result.chain(validatePositive)); // Ok(5)
      * pipe(Result.of(-1), Result.chain(validatePositive)); // Err("Must be positive")
@@ -118,7 +118,7 @@ var Result;
      * @example
      * ```ts
      * pipe(Result.of(5), Result.getOrElse(0)); // 5
-     * pipe(Result.toErr("error"), Result.getOrElse(0)); // 0
+     * pipe(Result.err("error"), Result.getOrElse(0)); // 0
      * ```
      */
     Result.getOrElse = (defaultValue) => (data) => Result.isOk(data) ? data.value : defaultValue;
@@ -154,8 +154,8 @@ var Result;
      *
      * @example
      * ```ts
-     * Result.toOption(Result.toOk(42)); // Some(42)
-     * Result.toOption(Result.toErr("oops")); // None
+     * Result.toOption(Result.ok(42)); // Some(42)
+     * Result.toOption(Result.err("oops")); // None
      * ```
      */
     Result.toOption = (data) => Result.isOk(data) ? { kind: "Some", value: data.value } : { kind: "None" };
@@ -172,5 +172,5 @@ var Result;
      * ); // Ok(8)
      * ```
      */
-    Result.ap = (arg) => (data) => Result.isOk(data) && Result.isOk(arg) ? Result.toOk(data.value(arg.value)) : Result.isErr(data) ? data : arg;
+    Result.ap = (arg) => (data) => Result.isOk(data) && Result.isOk(arg) ? Result.ok(data.value(arg.value)) : Result.isErr(data) ? data : arg;
 })(Result || (exports.Result = Result = {}));

package/script/src/Core/Task.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Task = void 0;
+const Result_js_1 = require("./Result.js");
 var Task;
 (function (Task) {
     /**
@@ -13,10 +14,6 @@ var Task;
      * ```
      */
     Task.of = (value) => () => Promise.resolve(value);
-    /**
-     * Creates a Task that will reject with the given error.
-     */
-    Task.fail = (error) => () => Promise.reject(error);
     /**
      * Creates a Task from a function that returns a Promise.
      * Alias for directly creating a Task.
@@ -40,7 +37,7 @@ var Task;
      */
     Task.map = (f) => (data) => () => data().then(f);
     /**
-     * Chains Task computations. If the first succeeds, passes the value to f.
+     * Chains Task computations. Passes the resolved value of the first Task to f.
      *
      * @example
      * ```ts
@@ -98,6 +95,7 @@ var Task;
     Task.all = (tasks) => () => Promise.all(tasks.map((t) => t()));
     /**
      * Delays the execution of a Task by the specified milliseconds.
+     * Useful for debouncing or rate limiting.
      *
      * @example
      * ```ts
@@ -108,4 +106,74 @@ var Task;
      * ```
      */
     Task.delay = (ms) => (data) => () => new Promise((resolve, reject) => setTimeout(() => data().then(resolve, reject), ms));
+    /**
+     * Runs a Task a fixed number of times sequentially, collecting all results into an array.
+     * An optional delay (ms) can be inserted between runs.
+     *
+     * @example
+     * ```ts
+     * pipe(
+     *   pollSensor,
+     *   Task.repeat({ times: 5, delay: 1000 })
+     * )(); // Task<Reading[]> — 5 readings, one per second
+     * ```
+     */
+    Task.repeat = (options) => (task) => () => {
+        const { times, delay: ms } = options;
+        if (times <= 0)
+            return Promise.resolve([]);
+        const results = [];
+        const wait = () => ms !== undefined && ms > 0 ? new Promise((r) => setTimeout(r, ms)) : Promise.resolve();
+        const run = (left) => task().then((a) => {
+            results.push(a);
+            if (left <= 1)
+                return results;
+            return wait().then(() => run(left - 1));
+        });
+        return run(times);
+    };
+    /**
+     * Runs a Task repeatedly until the result satisfies a predicate, returning that result.
+     * An optional delay (ms) can be inserted between runs.
+     *
+     * @example
+     * ```ts
+     * pipe(
+     *   checkStatus,
+     *   Task.repeatUntil({ when: (s) => s === "ready", delay: 500 })
+     * )(); // polls every 500ms until status is "ready"
+     * ```
+     */
+    Task.repeatUntil = (options) => (task) => () => {
+        const { when: predicate, delay: ms } = options;
+        const wait = () => ms !== undefined && ms > 0 ? new Promise((r) => setTimeout(r, ms)) : Promise.resolve();
+        const run = () => task().then((a) => {
+            if (predicate(a))
+                return a;
+            return wait().then(run);
+        });
+        return run();
+    };
+    /**
+     * Converts a `Task<A>` into a `Task<Result<E, A>>`, resolving to `Err` if the
+     * Task does not complete within the given time.
+     *
+     * @example
+     * ```ts
+     * pipe(
+     *   fetchUser,
+     *   Task.timeout(5000, () => new TimeoutError("fetch user timed out")),
+     *   TaskResult.chain(processUser)
+     * );
+     * ```
+     */
+    Task.timeout = (ms, onTimeout) => (task) => () => {
+        let timerId;
+        return Promise.race([
+            task().then((a) => { clearTimeout(timerId); return Result_js_1.Result.ok(a); }),
+            new Promise((resolve) => {
+                timerId = setTimeout(() => resolve(Result_js_1.Result.err(onTimeout())), ms);
+            }),
+        ]);
+    };
 })(Task || (exports.Task = Task = {}));