@nlozgachev/pipekit 0.2.0 → 0.4.0

package/script/src/Core/Option.js

@@ -4,15 +4,6 @@ exports.Option = void 0;
 const Result_js_1 = require("./Result.js");
 var Option;
 (function (Option) {
-    /**
-     * Wraps a value in a Some.
-     *
-     * @example
-     * ```ts
-     * Option.of(42); // Some(42)
-     * ```
-     */
-    Option.of = (value) => Option.some(value);
     /**
      * Creates a Some containing the given value.
      */
@@ -60,7 +51,7 @@ var Option;
      * @example
      * ```ts
      * pipe(
-     *   Option.of(42),
+     *   Option.some(42),
      *   Option.toResult(() => "Value was missing")
      * ); // Ok(42)
      *
@@ -87,7 +78,7 @@ var Option;
      *
      * @example
      * ```ts
-     * pipe(Option.of(5), Option.map(n => n * 2)); // Some(10)
+     * pipe(Option.some(5), Option.map(n => n * 2)); // Some(10)
      * pipe(Option.none(), Option.map(n => n * 2)); // None
      * ```
      */
@@ -100,11 +91,11 @@ var Option;
      * ```ts
      * const parseNumber = (s: string): Option<number> => {
      *   const n = parseInt(s, 10);
-     *   return isNaN(n) ? Option.none() : Option.of(n);
+     *   return isNaN(n) ? Option.none() : Option.some(n);
      * };
      *
-     * pipe(Option.of("42"), Option.chain(parseNumber)); // Some(42)
-     * pipe(Option.of("abc"), Option.chain(parseNumber)); // None
+     * pipe(Option.some("42"), Option.chain(parseNumber)); // Some(42)
+     * pipe(Option.some("abc"), Option.chain(parseNumber)); // None
      * ```
      */
     Option.chain = (f) => (data) => Option.isSome(data) ? f(data.value) : data;
@@ -114,7 +105,7 @@ var Option;
      * @example
      * ```ts
      * pipe(
-     *   Option.of(5),
+     *   Option.some(5),
      *   Option.fold(
      *     () => "No value",
      *     n => `Value: ${n}`
@@ -143,7 +134,7 @@ var Option;
      *
      * @example
      * ```ts
-     * pipe(Option.of(5), Option.getOrElse(0)); // 5
+     * pipe(Option.some(5), Option.getOrElse(0)); // 5
      * pipe(Option.none(), Option.getOrElse(0)); // 0
      * ```
      */
@@ -155,7 +146,7 @@ var Option;
      * @example
      * ```ts
      * pipe(
-     *   Option.of(5),
+     *   Option.some(5),
      *   Option.tap(n => console.log("Value:", n)),
      *   Option.map(n => n * 2)
      * );
@@ -172,8 +163,8 @@ var Option;
      *
      * @example
      * ```ts
-     * pipe(Option.of(5), Option.filter(n => n > 3)); // Some(5)
-     * pipe(Option.of(2), Option.filter(n => n > 3)); // None
+     * pipe(Option.some(5), Option.filter(n => n > 3)); // Some(5)
+     * pipe(Option.some(2), Option.filter(n => n > 3)); // None
      * ```
      */
     Option.filter = (predicate) => (data) => Option.isSome(data) && predicate(data.value) ? data : Option.none();
@@ -188,9 +179,9 @@ var Option;
      * ```ts
      * const add = (a: number) => (b: number) => a + b;
      * pipe(
-     *   Option.of(add),
-     *   Option.ap(Option.of(5)),
-     *   Option.ap(Option.of(3))
+     *   Option.some(add),
+     *   Option.ap(Option.some(5)),
+     *   Option.ap(Option.some(3))
      * ); // Some(8)
      * ```
      */

package/script/src/Core/RemoteData.js

@@ -25,10 +25,6 @@ var RemoteData;
         kind: "Success",
         value,
     });
-    /**
-     * Wraps a value in a Success RemoteData. Alias for `success`.
-     */
-    RemoteData.of = RemoteData.success;
     /**
      * Type guard that checks if a RemoteData is NotAsked.
      */
@@ -50,7 +46,7 @@ var RemoteData;
      *
      * @example
      * ```ts
-     * pipe(RemoteData.of(5), RemoteData.map(n => n * 2)); // Success(10)
+     * pipe(RemoteData.success(5), RemoteData.map(n => n * 2)); // Success(10)
      * pipe(RemoteData.loading(), RemoteData.map(n => n * 2)); // Loading
      * ```
      */
@@ -71,8 +67,8 @@ var RemoteData;
      * @example
      * ```ts
      * pipe(
-     *   RemoteData.of(5),
-     *   RemoteData.chain(n => n > 0 ? RemoteData.of(n) : RemoteData.failure("negative"))
+     *   RemoteData.success(5),
+     *   RemoteData.chain(n => n > 0 ? RemoteData.success(n) : RemoteData.failure("negative"))
      * );
      * ```
      */
@@ -84,9 +80,9 @@ var RemoteData;
      * ```ts
      * const add = (a: number) => (b: number) => a + b;
      * pipe(
-     *   RemoteData.of(add),
-     *   RemoteData.ap(RemoteData.of(5)),
-     *   RemoteData.ap(RemoteData.of(3))
+     *   RemoteData.success(add),
+     *   RemoteData.ap(RemoteData.success(5)),
+     *   RemoteData.ap(RemoteData.success(3))
      * ); // Success(8)
      * ```
      */
@@ -163,7 +159,7 @@ var RemoteData;
      *
      * @example
      * ```ts
-     * pipe(RemoteData.of(5), RemoteData.getOrElse(0)); // 5
+     * pipe(RemoteData.success(5), RemoteData.getOrElse(0)); // 5
      * pipe(RemoteData.loading(), RemoteData.getOrElse(0)); // 0
      * ```
      */
@@ -174,7 +170,7 @@ var RemoteData;
      * @example
      * ```ts
      * pipe(
-     *   RemoteData.of(5),
+     *   RemoteData.success(5),
      *   RemoteData.tap(n => console.log("Value:", n)),
      *   RemoteData.map(n => n * 2)
      * );
@@ -202,7 +198,7 @@ var RemoteData;
      * @example
      * ```ts
      * pipe(
-     *   RemoteData.of(42),
+     *   RemoteData.success(42),
      *   RemoteData.toResult(() => "not loaded")
      * ); // Ok(42)
      * ```

package/script/src/Core/Result.js

@@ -4,22 +4,13 @@ exports.Result = void 0;
 var Result;
 (function (Result) {
     /**
-     * Wraps a value in a successful Result (Ok).
-     *
-     * @example
-     * ```ts
-     * Result.of(42); // Ok(42)
-     * ```
+     * Creates a successful Result with the given value.
      */
-    Result.of = (value) => Result.ok(value);
+    Result.ok = (value) => ({ kind: "Ok", value });
     /**
      * Creates a failed Result with the given error.
      */
     Result.err = (error) => ({ kind: "Error", error });
-    /**
-     * Creates a successful Result with the given value.
-     */
-    Result.ok = (value) => ({ kind: "Ok", value });
     /**
      * Type guard that checks if an Result is Ok.
      */
@@ -54,7 +45,7 @@ var Result;
      *
      * @example
      * ```ts
-     * pipe(Result.of(5), Result.map(n => n * 2)); // Ok(10)
+     * pipe(Result.ok(5), Result.map(n => n * 2)); // Ok(10)
      * pipe(Result.err("error"), Result.map(n => n * 2)); // Err("error")
      * ```
      */
@@ -75,10 +66,10 @@ var Result;
      * @example
      * ```ts
      * const validatePositive = (n: number): Result<string, number> =>
-     *   n > 0 ? Result.of(n) : Result.err("Must be positive");
+     *   n > 0 ? Result.ok(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")
+     * pipe(Result.ok(5), Result.chain(validatePositive)); // Ok(5)
+     * pipe(Result.ok(-1), Result.chain(validatePositive)); // Err("Must be positive")
      * ```
      */
     Result.chain = (f) => (data) => Result.isOk(data) ? f(data.value) : data;
@@ -88,7 +79,7 @@ var Result;
      * @example
      * ```ts
      * pipe(
-     *   Result.of(5),
+     *   Result.ok(5),
      *   Result.fold(
      *     e => `Error: ${e}`,
      *     n => `Value: ${n}`
@@ -117,7 +108,7 @@ var Result;
      *
      * @example
      * ```ts
-     * pipe(Result.of(5), Result.getOrElse(0)); // 5
+     * pipe(Result.ok(5), Result.getOrElse(0)); // 5
      * pipe(Result.err("error"), Result.getOrElse(0)); // 0
      * ```
      */
@@ -129,7 +120,7 @@ var Result;
      * @example
      * ```ts
      * pipe(
-     *   Result.of(5),
+     *   Result.ok(5),
      *   Result.tap(n => console.log("Value:", n)),
      *   Result.map(n => n * 2)
      * );
@@ -166,9 +157,9 @@ var Result;
      * ```ts
      * const add = (a: number) => (b: number) => a + b;
      * pipe(
-     *   Result.of(add),
-     *   Result.ap(Result.of(5)),
-     *   Result.ap(Result.of(3))
+     *   Result.ok(add),
+     *   Result.ap(Result.ok(5)),
+     *   Result.ap(Result.ok(3))
      * ); // Ok(8)
      * ```
      */

package/script/src/Core/Task.js

@@ -5,22 +5,22 @@ const Result_js_1 = require("./Result.js");
 var Task;
 (function (Task) {
     /**
-     * Wraps a value in a Task that immediately resolves to that value.
+     * Creates a Task that immediately resolves to the given value.
      *
      * @example
      * ```ts
-     * const task = Task.of(42);
+     * const task = Task.resolve(42);
      * task().then(console.log); // 42
      * ```
      */
-    Task.of = (value) => () => Promise.resolve(value);
+    Task.resolve = (value) => () => Promise.resolve(value);
     /**
      * Creates a Task from a function that returns a Promise.
      * Alias for directly creating a Task.
      *
      * @example
      * ```ts
-     * const fetchUser = Task.from(() => fetch('/user').then(r => r.json()));
+     * const getTimestamp = Task.from(() => Promise.resolve(Date.now()));
      * ```
      */
     Task.from = (f) => f;
@@ -30,7 +30,7 @@ var Task;
      * @example
      * ```ts
      * pipe(
-     *   Task.of(5),
+     *   Task.resolve(5),
      *   Task.map(n => n * 2)
      * )(); // Promise<10>
      * ```
@@ -41,13 +41,13 @@ var Task;
      *
      * @example
      * ```ts
-     * const fetchUser = (id: string): Task<User> => () => fetch(`/users/${id}`).then(r => r.json());
-     * const fetchPosts = (user: User): Task<Post[]> => () => fetch(`/posts?userId=${user.id}`).then(r => r.json());
+     * const readUserId: Task<string> = () => Promise.resolve(session.userId);
+     * const loadPrefs = (id: string): Task<Preferences> => () => Promise.resolve(prefsCache.get(id));
      *
      * pipe(
-     *   fetchUser("123"),
-     *   Task.chain(fetchPosts)
-     * )(); // Promise<Post[]>
+     *   readUserId,
+     *   Task.chain(loadPrefs)
+     * )(); // Promise<Preferences>
      * ```
      */
     Task.chain = (f) => (data) => () => data().then((a) => f(a)());
@@ -59,9 +59,9 @@ var Task;
      * ```ts
      * const add = (a: number) => (b: number) => a + b;
      * pipe(
-     *   Task.of(add),
-     *   Task.ap(Task.of(5)),
-     *   Task.ap(Task.of(3))
+     *   Task.resolve(add),
+     *   Task.ap(Task.resolve(5)),
+     *   Task.ap(Task.resolve(3))
      * )(); // Promise<8>
      * ```
      */
@@ -73,9 +73,9 @@ var Task;
      * @example
      * ```ts
      * pipe(
-     *   fetchData,
-     *   Task.tap(data => console.log("Fetched:", data)),
-     *   Task.map(transform)
+     *   loadConfig,
+     *   Task.tap(cfg => console.log("Config:", cfg)),
+     *   Task.map(buildReport)
      * );
      * ```
      */
@@ -88,8 +88,8 @@ var Task;
      *
      * @example
      * ```ts
-     * Task.all([fetchUser, fetchPosts, fetchComments])();
-     * // Promise<[User, Post[], Comment[]]>
+     * Task.all([loadConfig, detectLocale, loadTheme])();
+     * // Promise<[Config, string, Theme]>
      * ```
      */
     Task.all = (tasks) => () => Promise.all(tasks.map((t) => t()));
@@ -100,7 +100,7 @@ var Task;
      * @example
      * ```ts
      * pipe(
-     *   Task.of(42),
+     *   Task.resolve(42),
      *   Task.delay(1000)
      * )(); // Resolves after 1 second
      * ```
@@ -161,16 +161,19 @@ var Task;
      * @example
      * ```ts
      * pipe(
-     *   fetchUser,
-     *   Task.timeout(5000, () => new TimeoutError("fetch user timed out")),
-     *   TaskResult.chain(processUser)
+     *   heavyComputation,
+     *   Task.timeout(5000, () => "timed out"),
+     *   TaskResult.chain(processResult)
      * );
      * ```
      */
     Task.timeout = (ms, onTimeout) => (task) => () => {
         let timerId;
         return Promise.race([
-            task().then((a) => { clearTimeout(timerId); return Result_js_1.Result.ok(a); }),
+            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);
             }),

package/script/src/Core/TaskOption.js

@@ -8,19 +8,19 @@ var TaskOption;
     /**
      * Wraps a value in a Some inside a Task.
      */
-    TaskOption.of = (value) => Task_js_1.Task.of(Option_js_1.Option.of(value));
+    TaskOption.some = (value) => Task_js_1.Task.resolve(Option_js_1.Option.some(value));
     /**
      * Creates a TaskOption that resolves to None.
      */
-    TaskOption.none = () => Task_js_1.Task.of(Option_js_1.Option.none());
+    TaskOption.none = () => Task_js_1.Task.resolve(Option_js_1.Option.none());
     /**
      * Lifts an Option into a TaskOption.
      */
-    TaskOption.fromOption = (option) => Task_js_1.Task.of(option);
+    TaskOption.fromOption = (option) => Task_js_1.Task.resolve(option);
     /**
      * Lifts a Task into a TaskOption by wrapping its result in Some.
      */
-    TaskOption.fromTask = (task) => Task_js_1.Task.map(Option_js_1.Option.of)(task);
+    TaskOption.fromTask = (task) => Task_js_1.Task.map(Option_js_1.Option.some)(task);
     /**
      * Creates a TaskOption from a Promise-returning function.
      * Returns Some if the promise resolves, None if it rejects.
@@ -32,7 +32,9 @@ var TaskOption;
      * );
      * ```
      */
-    TaskOption.tryCatch = (f) => () => f().then(Option_js_1.Option.of).catch(() => Option_js_1.Option.none());
+    TaskOption.tryCatch = (f) => () => f()
+        .then(Option_js_1.Option.some)
+        .catch(() => Option_js_1.Option.none());
     /**
      * Transforms the value inside a TaskOption.
      */
@@ -49,7 +51,7 @@ var TaskOption;
      * )();
      * ```
      */
-    TaskOption.chain = (f) => (data) => Task_js_1.Task.chain((option) => Option_js_1.Option.isSome(option) ? f(option.value) : Task_js_1.Task.of(Option_js_1.Option.none()))(data);
+    TaskOption.chain = (f) => (data) => Task_js_1.Task.chain((option) => Option_js_1.Option.isSome(option) ? f(option.value) : Task_js_1.Task.resolve(Option_js_1.Option.none()))(data);
     /**
      * Applies a function wrapped in a TaskOption to a value wrapped in a TaskOption.
      * Both Tasks run in parallel.

package/script/src/Core/TaskResult.js

@@ -8,11 +8,11 @@ var TaskResult;
     /**
      * Wraps a value in a successful TaskResult.
      */
-    TaskResult.of = (value) => Task_js_1.Task.of(Result_js_1.Result.ok(value));
+    TaskResult.ok = (value) => Task_js_1.Task.resolve(Result_js_1.Result.ok(value));
     /**
      * Creates a failed TaskResult with the given error.
      */
-    TaskResult.err = (error) => Task_js_1.Task.of(Result_js_1.Result.err(error));
+    TaskResult.err = (error) => Task_js_1.Task.resolve(Result_js_1.Result.err(error));
     /**
      * Creates a TaskResult from a function that may throw.
      * Catches any errors and transforms them using the onError function.
@@ -41,7 +41,7 @@ var TaskResult;
      * Chains TaskResult computations. If the first succeeds, passes the value to f.
      * If the first fails, propagates the error.
      */
-    TaskResult.chain = (f) => (data) => Task_js_1.Task.chain((result) => Result_js_1.Result.isOk(result) ? f(result.value) : Task_js_1.Task.of(Result_js_1.Result.err(result.error)))(data);
+    TaskResult.chain = (f) => (data) => Task_js_1.Task.chain((result) => Result_js_1.Result.isOk(result) ? f(result.value) : Task_js_1.Task.resolve(Result_js_1.Result.err(result.error)))(data);
     /**
      * Extracts the value from a TaskResult by providing handlers for both cases.
      */
@@ -53,7 +53,7 @@ var TaskResult;
     /**
      * Recovers from an error by providing a fallback TaskResult.
      */
-    TaskResult.recover = (fallback) => (data) => Task_js_1.Task.chain((result) => Result_js_1.Result.isErr(result) ? fallback(result.error) : Task_js_1.Task.of(result))(data);
+    TaskResult.recover = (fallback) => (data) => Task_js_1.Task.chain((result) => Result_js_1.Result.isErr(result) ? fallback(result.error) : Task_js_1.Task.resolve(result))(data);
     /**
      * Returns the success value or a default value if the TaskResult is an error.
      */
@@ -93,8 +93,9 @@ var TaskResult;
                 return result;
             if (left <= 1)
                 return result;
-            if (shouldRetry !== undefined && !shouldRetry(result.error))
+            if (shouldRetry !== undefined && !shouldRetry(result.error)) {
                 return result;
+            }
             const ms = getDelay(attempts - left + 1);
             return (ms > 0 ? new Promise((r) => setTimeout(r, ms)) : Promise.resolve()).then(() => run(left - 1));
         });
@@ -114,7 +115,10 @@ var TaskResult;
     TaskResult.timeout = (ms, onTimeout) => (data) => () => {
         let timerId;
         return Promise.race([
-            data().then((result) => { clearTimeout(timerId); return result; }),
+            data().then((result) => {
+                clearTimeout(timerId);
+                return result;
+            }),
             new Promise((resolve) => {
                 timerId = setTimeout(() => resolve(Result_js_1.Result.err(onTimeout())), ms);
             }),

package/script/src/Core/TaskValidation.js

@@ -8,15 +8,19 @@ var TaskValidation;
     /**
      * Wraps a value in a valid TaskValidation.
      */
-    TaskValidation.of = (value) => Task_js_1.Task.of(Validation_js_1.Validation.of(value));
+    TaskValidation.valid = (value) => Task_js_1.Task.resolve(Validation_js_1.Validation.valid(value));
     /**
      * Creates a failed TaskValidation with a single error.
      */
-    TaskValidation.fail = (error) => Task_js_1.Task.of(Validation_js_1.Validation.fail(error));
+    TaskValidation.invalid = (error) => Task_js_1.Task.resolve(Validation_js_1.Validation.invalid(error));
+    /**
+     * Creates an invalid TaskValidation from multiple errors.
+     */
+    TaskValidation.invalidAll = (errors) => Task_js_1.Task.resolve(Validation_js_1.Validation.invalidAll(errors));
     /**
      * Lifts a Validation into a TaskValidation.
      */
-    TaskValidation.fromValidation = (validation) => Task_js_1.Task.of(validation);
+    TaskValidation.fromValidation = (validation) => Task_js_1.Task.resolve(validation);
     /**
      * Creates a TaskValidation from a Promise-returning function.
      * Catches any errors and transforms them using the onError function.
@@ -31,8 +35,8 @@ var TaskValidation;
      * ```
      */
     TaskValidation.tryCatch = (f, onError) => () => f()
-        .then((Validation_js_1.Validation.of))
-        .catch((e) => Validation_js_1.Validation.fail(onError(e)));
+        .then((Validation_js_1.Validation.valid))
+        .catch((e) => Validation_js_1.Validation.invalid(onError(e)));
     /**
      * Transforms the success value inside a TaskValidation.
      */
@@ -45,7 +49,7 @@ var TaskValidation;
      */
     TaskValidation.chain = (f) => (data) => Task_js_1.Task.chain((validation) => Validation_js_1.Validation.isValid(validation)
         ? f(validation.value)
-        : Task_js_1.Task.of(Validation_js_1.Validation.toInvalid(validation.errors)))(data);
+        : Task_js_1.Task.resolve(Validation_js_1.Validation.invalidAll(validation.errors)))(data);
     /**
      * Applies a function wrapped in a TaskValidation to a value wrapped in a
      * TaskValidation. Both Tasks run in parallel and errors from both sides
@@ -54,7 +58,7 @@ var TaskValidation;
      * @example
      * ```ts
      * pipe(
-     *   TaskValidation.of((name: string) => (age: number) => ({ name, age })),
+     *   TaskValidation.valid((name: string) => (age: number) => ({ name, age })),
      *   TaskValidation.ap(validateName(name)),
      *   TaskValidation.ap(validateAge(age))
      * )();
@@ -92,5 +96,5 @@ var TaskValidation;
     /**
      * Recovers from an Invalid state by providing a fallback TaskValidation.
      */
-    TaskValidation.recover = (fallback) => (data) => Task_js_1.Task.chain((validation) => Validation_js_1.Validation.isValid(validation) ? Task_js_1.Task.of(validation) : fallback())(data);
+    TaskValidation.recover = (fallback) => (data) => Task_js_1.Task.chain((validation) => Validation_js_1.Validation.isValid(validation) ? Task_js_1.Task.resolve(validation) : fallback())(data);
 })(TaskValidation || (exports.TaskValidation = TaskValidation = {}));