@tempots/std 0.24.0 → 0.25.0

package/result-BrVFeaNO.js

@@ -0,0 +1,462 @@
+import { AsyncResult as n } from "./async-result.js";
+const i = {
+  /**
+   * Creates a valid `Validation`.
+   * @returns A `Validation` that is `Valid`.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  valid: { type: "valid" },
+  /**
+   * Creates an invalid `Validation`.
+   * @param error - The error associated with the invalid value.
+   * @returns A `Validation` that is `Invalid`.
+   */
+  invalid(e) {
+    return { type: "invalid", error: e };
+  },
+  /**
+   * Checks if a `Validation` is `Valid`.
+   * @param r - The `Validation` to check.
+   * @returns `true` if the `Validation` is `Valid`, otherwise `false`.
+   */
+  isValid(e) {
+    return e.type === "valid";
+  },
+  /**
+   * Checks if a `Validation` is `Invalid`.
+   * @param r - The `Validation` to check.
+   * @returns `true` if the `Validation` is `Invalid`, otherwise `false`.
+   */
+  isInvalid(e) {
+    return e.type === "invalid";
+  },
+  /**
+   * Maps the value of a `Validation` to a new value.
+   * @param r - The `Validation` to map.
+   * @param valid - The mapping function for a valid value.
+   * @param invalid - The mapping function for an invalid value.
+   * @returns The mapped value.
+   */
+  match: (e, r, u) => i.isValid(e) ? r() : u(e.error),
+  /**
+   * Maps the value of a `Validation` to a new `Validation`.
+   * @param validation - The `Validation` to map.
+   * @param value - The value to map.
+   * @returns A new `Validation` with the mapped value.
+   */
+  toResult: (e, r) => i.match(
+    e,
+    () => s.success(r),
+    (u) => s.failure(u)
+  ),
+  /**
+   * Execute a function when the `Validation` is valid.
+   *
+   * @param r - The `Validation` to check.
+   * @param apply - The function to execute when the `Validation` is valid.
+   * @returns The `Validation` object.
+   */
+  whenValid: (e, r) => (i.isValid(e) && r(), e),
+  /**
+   * Execute a function when the `Validation` is invalid.
+   *
+   * @param r - The `Validation` to check.
+   * @param apply - The function to execute when the `Validation` is invalid.
+   * @returns The `Validation` object.
+   */
+  whenInvalid: (e, r) => (i.isInvalid(e) && r(e.error), e),
+  /**
+   * Maps the error of an invalid `Validation` to a new error using the provided function.
+   * For valid validations, the validation is preserved unchanged.
+   * @param v - The `Validation` to map the error of.
+   * @param f - The mapping function to apply to the error.
+   * @returns A new `Validation` with the mapped error if invalid, otherwise the original valid.
+   * @public
+   */
+  mapError: (e, r) => e.type === "invalid" ? i.invalid(r(e.error)) : e,
+  /**
+   * Maps the error of an invalid `Validation` to a new `Validation` using the provided function.
+   * This allows recovery from errors by returning a valid validation.
+   * @param v - The `Validation` to recover from.
+   * @param f - The recovery function that returns a new `Validation`.
+   * @returns The result of the recovery function if invalid, otherwise the original valid.
+   * @public
+   */
+  flatMapError: (e, r) => e.type === "invalid" ? r(e.error) : e,
+  /**
+   * Combines two validations. Both must be valid for the result to be valid.
+   * If both are invalid, errors are combined using the provided function.
+   * @param v1 - The first validation.
+   * @param v2 - The second validation.
+   * @param combineErrors - The function to combine two errors.
+   * @returns A combined validation.
+   * @public
+   */
+  combine: (e, r, u) => i.isValid(e) && i.isValid(r) ? i.valid : i.isInvalid(e) && i.isInvalid(r) ? i.invalid(u(e.error, r.error)) : i.isInvalid(e) ? e : r,
+  /**
+   * Combines multiple validations into a single validation.
+   * All must be valid for the result to be valid.
+   * Returns the first invalid validation if any.
+   * @param validations - The validations to combine.
+   * @returns A single validation that is valid only if all inputs are valid.
+   * @public
+   */
+  all: (e) => {
+    for (const r of e)
+      if (i.isInvalid(r))
+        return r;
+    return i.valid;
+  },
+  /**
+   * Combines multiple validations, accumulating all errors.
+   * All must be valid for the result to be valid.
+   * If any are invalid, all errors are collected into an array.
+   * @param validations - The validations to combine.
+   * @returns A validation that is valid only if all inputs are valid, otherwise contains all errors.
+   * @public
+   */
+  allErrors: (e) => {
+    const r = [];
+    for (const u of e)
+      i.isInvalid(u) && r.push(u.error);
+    return r.length > 0 ? i.invalid(r) : i.valid;
+  },
+  /**
+   * Compares two validations for equality.
+   * @param v1 - The first validation.
+   * @param v2 - The second validation.
+   * @param errorEquals - Optional custom equality function for errors. Defaults to strict equality.
+   * @returns `true` if the validations are equal, `false` otherwise.
+   * @public
+   */
+  equals: (e, r, u = (t, l) => t === l) => e.type === "valid" && r.type === "valid" ? !0 : e.type === "invalid" && r.type === "invalid" ? u(e.error, r.error) : !1,
+  /**
+   * Recovers from an invalid validation by returning a valid validation.
+   * @param v - The `Validation` to recover from.
+   * @returns A valid validation regardless of the input.
+   * @public
+   */
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  recover: (e) => i.valid,
+  /**
+   * Gets the error if the validation is invalid, otherwise returns undefined.
+   * @param v - The validation to get the error from.
+   * @returns The error if invalid, otherwise undefined.
+   * @public
+   */
+  getError: (e) => {
+    if (i.isInvalid(e))
+      return e.error;
+  },
+  /**
+   * Gets the error if the validation is invalid, otherwise returns the default value.
+   * @param v - The validation to get the error from.
+   * @param defaultError - The default error to return if valid.
+   * @returns The error if invalid, otherwise the default error.
+   * @public
+   */
+  getErrorOrElse: (e, r) => i.isInvalid(e) ? e.error : r
+}, s = {
+  /**
+   * Creates a successful `Result`.
+   * @param value - The value to wrap in a `Success` type.
+   * @returns A `Result` that is a `Success`.
+   * @public
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  success(e) {
+    return { type: "Success", value: e };
+  },
+  /**
+   * Creates a failure `Result`.
+   * @param error - The error to wrap in a `Failure` type.
+   * @returns A `Result` that is a `Failure`.
+   * @public
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  failure(e) {
+    return { type: "Failure", error: e };
+  },
+  /**
+   * Maps the value of a `Result` to a new value.
+   * @param r - The `Result` to map.
+   * @param f - The mapping function.
+   * @returns A new `Result` with the mapped value.
+   * @public
+   */
+  map: (e, r) => e.type === "Success" ? s.success(r(e.value)) : e,
+  /**
+   * Maps the value of a `Result` to a new `Result`.
+   * @param r - The `Result` to map.
+   * @param f - The mapping function.
+   * @returns A new `Result` with the mapped value.
+   * @public
+   */
+  flatMap: (e, r) => e.type === "Success" ? r(e.value) : e,
+  /**
+   * Converts a `Result` to an `AsyncResult`.
+   * @param r - The `Result` to convert.
+   * @returns An `AsyncResult` that is equivalent to the input `Result`.
+   * @public
+   */
+  toAsync(e) {
+    return s.match(
+      e,
+      (r) => n.success(r),
+      (r) => n.failure(r)
+    );
+  },
+  /**
+   * Converts a `Result` to a `Validation`.
+   * @param r - The `Result` to convert.
+   * @returns A `Validation` that is equivalent to the input `Result`.
+   * @public
+   */
+  toValidation(e) {
+    return s.match(
+      e,
+      () => i.valid,
+      (r) => i.invalid(r)
+    );
+  },
+  /**
+   * Checks if a `Result` is a success.
+   * @param r - The `Result` to check.
+   * @returns `true` if the `Result` is a `Success`, `false` otherwise.
+   * @public
+   */
+  isSuccess(e) {
+    return e.type === "Success";
+  },
+  /**
+   * Checks if a `Result` is a failure.
+   * @param r - The `Result` to check.
+   * @returns `true` if the `Result` is a `Failure`, `false` otherwise.
+   * @public
+   */
+  isFailure(e) {
+    return e.type === "Failure";
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns the provided default value.
+   * @param r - The `Result` to get the value from.
+   * @param alt - The default value to return if the `Result` is a `Failure`.
+   * @returns The value of the `Result` if it is a `Success`, otherwise the default value.
+   * @public
+   */
+  getOrElse(e, r) {
+    return s.isSuccess(e) ? e.value : r;
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns the result of the provided function.
+   * @param r - The `Result` to get the value from.
+   * @param altf - The function to call if the `Result` is a `Failure`.
+   * @returns The value of the `Result` if it is a `Success`, otherwise the result of the function.
+   * @public
+   */
+  getOrElseLazy(e, r) {
+    return s.isSuccess(e) ? e.value : r();
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns `null`.
+   * @param r - The `Result` to get the value from.
+   * @returns The value of the `Result` if it is a `Success`, otherwise `null`.
+   * @public
+   */
+  getOrNull(e) {
+    return s.isSuccess(e) ? e.value : null;
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns `undefined`.
+   * @param r - The `Result` to get the value from.
+   * @returns The value of the `Result` if it is a `Success`, otherwise `undefined`.
+   * @public
+   */
+  getOrUndefined(e) {
+    return s.isSuccess(e) ? e.value : void 0;
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise it throws the error contained in the `Failure`.
+   * @param r - The `Result` to get the value from.
+   * @returns The value of the `Result` if it is a `Success`.
+   */
+  getUnsafe: (e) => {
+    if (s.isSuccess(e))
+      return e.value;
+    throw e.error;
+  },
+  /**
+   * Based on the state of the result, it picks the appropriate function to call and returns the result.
+   * @param success - The function to call if the result is a success.
+   * @param failure - The function to call if the result is a failure.
+   * @returns The result of calling the appropriate function based on the state of the result.
+   * @public
+   */
+  match: (e, r, u) => s.isSuccess(e) ? r(e.value) : u(e.error),
+  /**
+   * Calls the provided function if the result is a success.
+   * @param apply - The function to call if the result is a success.
+   * @returns A function that takes a `Result` and calls the provided function if the result is a success.
+   * @public
+   */
+  whenSuccess: (e, r) => (s.isSuccess(e) && r(e.value), e),
+  whenFailure: (e, r) => (s.isFailure(e) && r(e.error), e),
+  /**
+   * Combines two results into a single result.
+   * @param r1 - The first result.
+   * @param r2 - The second result.
+   * @param combineV - The function to combine two values.
+   * @param combineE - The function to combine two errors.
+   * @returns The combined result.
+   * @public
+   */
+  combine: (e, r, u, t) => s.match(
+    e,
+    (l) => s.match(
+      r,
+      (a) => s.success(u(l, a)),
+      (a) => s.failure(a)
+    ),
+    (l) => s.match(
+      r,
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      (a) => s.failure(l),
+      (a) => s.failure(t(l, a))
+    )
+  ),
+  /**
+   * Compares two results for equality.
+   * @param r1 - The first result.
+   * @param r2 - The second result.
+   * @param options - The options to use for comparison. By default, uses strict equality.
+   * @returns `true` if the results are equal, `false` otherwise.
+   */
+  equals: (e, r, u = {
+    valueEquals: (t, l) => t === l,
+    errorEquals: (t, l) => t === l
+  }) => e.type === "Success" && r.type === "Success" ? u.valueEquals(e.value, r.value) : e.type === "Failure" && r.type === "Failure" ? u.errorEquals(e.error, r.error) : !1,
+  /**
+   * Combines multiple results into a single result.
+   * @param results - The results to combine.
+   * @returns A single result that is a success if all the input results are successes, otherwise a failure.
+   */
+  all: (e) => {
+    const r = [];
+    for (const u of e)
+      if (s.isSuccess(u))
+        r.push(u.value);
+      else
+        return u;
+    return s.success(r);
+  },
+  /**
+   * Maps the error of a failed `Result` to a new error using the provided function.
+   * For success results, the result is preserved unchanged.
+   * @param r - The `Result` to map the error of.
+   * @param f - The mapping function to apply to the error.
+   * @returns A new `Result` with the mapped error if failed, otherwise the original success.
+   * @public
+   */
+  mapError: (e, r) => e.type === "Failure" ? s.failure(r(e.error)) : e,
+  /**
+   * Maps the error of a failed `Result` to a new `Result` using the provided function.
+   * This allows recovery from errors by returning a new successful result.
+   * @param r - The `Result` to recover from.
+   * @param f - The recovery function that returns a new `Result`.
+   * @returns The result of the recovery function if failed, otherwise the original success.
+   * @public
+   */
+  flatMapError: (e, r) => e.type === "Failure" ? r(e.error) : e,
+  /**
+   * Recovers from a failure by providing an alternative value.
+   * @param r - The `Result` to recover from.
+   * @param f - The function that provides an alternative value given the error.
+   * @returns A successful `Result` with the alternative value if failed, otherwise the original success.
+   * @public
+   */
+  recover: (e, r) => e.type === "Failure" ? { type: "Success", value: r(e.error) } : e,
+  /**
+   * Applies a function wrapped in a `Result` to a value wrapped in a `Result`.
+   * Useful for applying multiple arguments to a function in a safe way.
+   * @param resultFn - The `Result` containing the function.
+   * @param resultVal - The `Result` containing the value.
+   * @returns A new `Result` with the result of applying the function to the value.
+   * @public
+   */
+  ap: (e, r) => s.isSuccess(e) && s.isSuccess(r) ? s.success(e.value(r.value)) : s.isFailure(e) ? s.failure(e.error) : s.failure(r.error),
+  /**
+   * Maps two `Result` values using a function.
+   * @param r1 - The first `Result`.
+   * @param r2 - The second `Result`.
+   * @param f - The function to apply to both values.
+   * @returns A new `Result` with the result of applying the function to both values.
+   * @public
+   */
+  map2: (e, r, u) => s.isSuccess(e) && s.isSuccess(r) ? s.success(u(e.value, r.value)) : s.isFailure(e) ? s.failure(e.error) : s.failure(r.error),
+  /**
+   * Maps three `Result` values using a function.
+   * @param r1 - The first `Result`.
+   * @param r2 - The second `Result`.
+   * @param r3 - The third `Result`.
+   * @param f - The function to apply to all three values.
+   * @returns A new `Result` with the result of applying the function to all three values.
+   * @public
+   */
+  map3: (e, r, u, t) => s.isSuccess(e) && s.isSuccess(r) && s.isSuccess(u) ? s.success(t(e.value, r.value, u.value)) : s.isFailure(e) ? s.failure(e.error) : s.isFailure(r) ? s.failure(r.error) : s.failure(u.error),
+  /**
+   * Converts a Promise to a Result.
+   * @param p - The Promise to convert.
+   * @returns A Promise that resolves to a Result.
+   * @public
+   */
+  ofPromise: async (e) => {
+    try {
+      const r = await e;
+      return s.success(r);
+    } catch (r) {
+      return s.failure(r instanceof Error ? r : new Error(String(r)));
+    }
+  },
+  /**
+   * Swaps the success and failure values of a Result.
+   * A success becomes a failure with the value as the error,
+   * and a failure becomes a success with the error as the value.
+   * @param r - The Result to swap.
+   * @returns A new Result with swapped success and failure.
+   * @public
+   */
+  swap: (e) => s.isSuccess(e) ? s.failure(e.value) : s.success(e.error),
+  /**
+   * Converts a nullable value to a Result.
+   * @param value - The nullable value.
+   * @param error - The error to use if the value is null or undefined.
+   * @returns A Result containing the value if not null/undefined, otherwise a failure.
+   * @public
+   */
+  fromNullable: (e, r) => e == null ? s.failure(r) : s.success(e),
+  /**
+   * Converts a nullable value to a Result using a lazy error function.
+   * @param value - The nullable value.
+   * @param errorFn - The function to call to get the error if the value is null or undefined.
+   * @returns A Result containing the value if not null/undefined, otherwise a failure.
+   * @public
+   */
+  fromNullableLazy: (e, r) => e == null ? s.failure(r()) : s.success(e),
+  /**
+   * Wraps a function that may throw into a function that returns a Result.
+   * @param f - The function that may throw.
+   * @returns A function that returns a Result instead of throwing.
+   * @public
+   */
+  tryCatch: (e) => {
+    try {
+      return s.success(e());
+    } catch (r) {
+      return s.failure(r instanceof Error ? r : new Error(String(r)));
+    }
+  }
+};
+export {
+  s as R,
+  i as V
+};

package/result-cY1uEC-G.cjs

@@ -0,0 +1 @@
+"use strict";const n=require("./async-result.cjs"),i={valid:{type:"valid"},invalid(e){return{type:"invalid",error:e}},isValid(e){return e.type==="valid"},isInvalid(e){return e.type==="invalid"},match:(e,r,u)=>i.isValid(e)?r():u(e.error),toResult:(e,r)=>i.match(e,()=>s.success(r),u=>s.failure(u)),whenValid:(e,r)=>(i.isValid(e)&&r(),e),whenInvalid:(e,r)=>(i.isInvalid(e)&&r(e.error),e),mapError:(e,r)=>e.type==="invalid"?i.invalid(r(e.error)):e,flatMapError:(e,r)=>e.type==="invalid"?r(e.error):e,combine:(e,r,u)=>i.isValid(e)&&i.isValid(r)?i.valid:i.isInvalid(e)&&i.isInvalid(r)?i.invalid(u(e.error,r.error)):i.isInvalid(e)?e:r,all:e=>{for(const r of e)if(i.isInvalid(r))return r;return i.valid},allErrors:e=>{const r=[];for(const u of e)i.isInvalid(u)&&r.push(u.error);return r.length>0?i.invalid(r):i.valid},equals:(e,r,u=(t,l)=>t===l)=>e.type==="valid"&&r.type==="valid"?!0:e.type==="invalid"&&r.type==="invalid"?u(e.error,r.error):!1,recover:e=>i.valid,getError:e=>{if(i.isInvalid(e))return e.error},getErrorOrElse:(e,r)=>i.isInvalid(e)?e.error:r},s={success(e){return{type:"Success",value:e}},failure(e){return{type:"Failure",error:e}},map:(e,r)=>e.type==="Success"?s.success(r(e.value)):e,flatMap:(e,r)=>e.type==="Success"?r(e.value):e,toAsync(e){return s.match(e,r=>n.AsyncResult.success(r),r=>n.AsyncResult.failure(r))},toValidation(e){return s.match(e,()=>i.valid,r=>i.invalid(r))},isSuccess(e){return e.type==="Success"},isFailure(e){return e.type==="Failure"},getOrElse(e,r){return s.isSuccess(e)?e.value:r},getOrElseLazy(e,r){return s.isSuccess(e)?e.value:r()},getOrNull(e){return s.isSuccess(e)?e.value:null},getOrUndefined(e){return s.isSuccess(e)?e.value:void 0},getUnsafe:e=>{if(s.isSuccess(e))return e.value;throw e.error},match:(e,r,u)=>s.isSuccess(e)?r(e.value):u(e.error),whenSuccess:(e,r)=>(s.isSuccess(e)&&r(e.value),e),whenFailure:(e,r)=>(s.isFailure(e)&&r(e.error),e),combine:(e,r,u,t)=>s.match(e,l=>s.match(r,a=>s.success(u(l,a)),a=>s.failure(a)),l=>s.match(r,a=>s.failure(l),a=>s.failure(t(l,a)))),equals:(e,r,u={valueEquals:(t,l)=>t===l,errorEquals:(t,l)=>t===l})=>e.type==="Success"&&r.type==="Success"?u.valueEquals(e.value,r.value):e.type==="Failure"&&r.type==="Failure"?u.errorEquals(e.error,r.error):!1,all:e=>{const r=[];for(const u of e)if(s.isSuccess(u))r.push(u.value);else return u;return s.success(r)},mapError:(e,r)=>e.type==="Failure"?s.failure(r(e.error)):e,flatMapError:(e,r)=>e.type==="Failure"?r(e.error):e,recover:(e,r)=>e.type==="Failure"?{type:"Success",value:r(e.error)}:e,ap:(e,r)=>s.isSuccess(e)&&s.isSuccess(r)?s.success(e.value(r.value)):s.isFailure(e)?s.failure(e.error):s.failure(r.error),map2:(e,r,u)=>s.isSuccess(e)&&s.isSuccess(r)?s.success(u(e.value,r.value)):s.isFailure(e)?s.failure(e.error):s.failure(r.error),map3:(e,r,u,t)=>s.isSuccess(e)&&s.isSuccess(r)&&s.isSuccess(u)?s.success(t(e.value,r.value,u.value)):s.isFailure(e)?s.failure(e.error):s.isFailure(r)?s.failure(r.error):s.failure(u.error),ofPromise:async e=>{try{const r=await e;return s.success(r)}catch(r){return s.failure(r instanceof Error?r:new Error(String(r)))}},swap:e=>s.isSuccess(e)?s.failure(e.value):s.success(e.error),fromNullable:(e,r)=>e==null?s.failure(r):s.success(e),fromNullableLazy:(e,r)=>e==null?s.failure(r()):s.success(e),tryCatch:e=>{try{return s.success(e())}catch(r){return s.failure(r instanceof Error?r:new Error(String(r)))}}};exports.Result=s;exports.Validation=i;

package/result.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./async-result.cjs");const e=require("./result-CdwVhaAc.cjs");exports.Result=e.Result;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./async-result.cjs");const e=require("./result-cY1uEC-G.cjs");exports.Result=e.Result;

package/result.d.ts

@@ -175,4 +175,97 @@ export declare const Result: {
      * @returns A single result that is a success if all the input results are successes, otherwise a failure.
      */
     all: <V, E>(results: Result<V, E>[]) => Result<V[], E>;
+    /**
+     * Maps the error of a failed `Result` to a new error using the provided function.
+     * For success results, the result is preserved unchanged.
+     * @param r - The `Result` to map the error of.
+     * @param f - The mapping function to apply to the error.
+     * @returns A new `Result` with the mapped error if failed, otherwise the original success.
+     * @public
+     */
+    mapError: <V, E, F>(r: Result<V, E>, f: (error: E) => F) => Result<V, F>;
+    /**
+     * Maps the error of a failed `Result` to a new `Result` using the provided function.
+     * This allows recovery from errors by returning a new successful result.
+     * @param r - The `Result` to recover from.
+     * @param f - The recovery function that returns a new `Result`.
+     * @returns The result of the recovery function if failed, otherwise the original success.
+     * @public
+     */
+    flatMapError: <V, E, F>(r: Result<V, E>, f: (error: E) => Result<V, F>) => Result<V, F>;
+    /**
+     * Recovers from a failure by providing an alternative value.
+     * @param r - The `Result` to recover from.
+     * @param f - The function that provides an alternative value given the error.
+     * @returns A successful `Result` with the alternative value if failed, otherwise the original success.
+     * @public
+     */
+    recover: <V, E>(r: Result<V, E>, f: (error: E) => V) => Result<V, never>;
+    /**
+     * Applies a function wrapped in a `Result` to a value wrapped in a `Result`.
+     * Useful for applying multiple arguments to a function in a safe way.
+     * @param resultFn - The `Result` containing the function.
+     * @param resultVal - The `Result` containing the value.
+     * @returns A new `Result` with the result of applying the function to the value.
+     * @public
+     */
+    ap: <V, U, E>(resultFn: Result<(v: V) => U, E>, resultVal: Result<V, E>) => Result<U, E>;
+    /**
+     * Maps two `Result` values using a function.
+     * @param r1 - The first `Result`.
+     * @param r2 - The second `Result`.
+     * @param f - The function to apply to both values.
+     * @returns A new `Result` with the result of applying the function to both values.
+     * @public
+     */
+    map2: <V1, V2, U, E>(r1: Result<V1, E>, r2: Result<V2, E>, f: (v1: V1, v2: V2) => U) => Result<U, E>;
+    /**
+     * Maps three `Result` values using a function.
+     * @param r1 - The first `Result`.
+     * @param r2 - The second `Result`.
+     * @param r3 - The third `Result`.
+     * @param f - The function to apply to all three values.
+     * @returns A new `Result` with the result of applying the function to all three values.
+     * @public
+     */
+    map3: <V1, V2, V3, U, E>(r1: Result<V1, E>, r2: Result<V2, E>, r3: Result<V3, E>, f: (v1: V1, v2: V2, v3: V3) => U) => Result<U, E>;
+    /**
+     * Converts a Promise to a Result.
+     * @param p - The Promise to convert.
+     * @returns A Promise that resolves to a Result.
+     * @public
+     */
+    ofPromise: <V>(p: Promise<V>) => Promise<Result<V, Error>>;
+    /**
+     * Swaps the success and failure values of a Result.
+     * A success becomes a failure with the value as the error,
+     * and a failure becomes a success with the error as the value.
+     * @param r - The Result to swap.
+     * @returns A new Result with swapped success and failure.
+     * @public
+     */
+    swap: <V, E>(r: Result<V, E>) => Result<E, V>;
+    /**
+     * Converts a nullable value to a Result.
+     * @param value - The nullable value.
+     * @param error - The error to use if the value is null or undefined.
+     * @returns A Result containing the value if not null/undefined, otherwise a failure.
+     * @public
+     */
+    fromNullable: <V, E>(value: V | null | undefined, error: E) => Result<V, E>;
+    /**
+     * Converts a nullable value to a Result using a lazy error function.
+     * @param value - The nullable value.
+     * @param errorFn - The function to call to get the error if the value is null or undefined.
+     * @returns A Result containing the value if not null/undefined, otherwise a failure.
+     * @public
+     */
+    fromNullableLazy: <V, E>(value: V | null | undefined, errorFn: () => E) => Result<V, E>;
+    /**
+     * Wraps a function that may throw into a function that returns a Result.
+     * @param f - The function that may throw.
+     * @returns A function that returns a Result instead of throwing.
+     * @public
+     */
+    tryCatch: <V>(f: () => V) => Result<V, Error>;
 };

package/result.js

@@ -1,5 +1,5 @@
 import "./async-result.js";
-import { R as e } from "./result-CGd0jCdl.js";
+import { R as e } from "./result-BrVFeaNO.js";
 export {
   e as Result
 };

package/string.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("./error.cjs"),f=require("./regexp.cjs"),T=(t,e)=>{const n=t.indexOf(e);return n<0?"":t.substring(n+e.length)},z=(t,e)=>{const n=t.lastIndexOf(e);return n<0?"":t.substring(n+e.length)},j=(t,e)=>{const n=t.indexOf(e);return n<0?"":t.substring(0,n)},M=(t,e)=>{const n=t.lastIndexOf(e);return n<0?"":t.substring(0,n)},a=t=>t.substring(0,1).toUpperCase()+t.substring(1),p=t=>t.toUpperCase(),N=(t,e=!1)=>e?f.mapRegExp(a(t),Ut,p):f.mapRegExp(a(t),Mt,p),_=t=>t.replace(Ht,`
-`),U=(t,e)=>t==null&&e==null?0:t==null?-1:e==null?1:d(t.toLowerCase(),e.toLowerCase()),k=(t,e)=>t.substring(t.length-e.length).toLowerCase()===e.toLowerCase(),F=(t,e)=>t.substring(0,e.length).toLowerCase()===e.toLowerCase(),H=(t,e)=>S(t.toLowerCase(),e.map(n=>n.toLowerCase())),$=(t,e)=>I(t.toLowerCase(),e.map(n=>n.toLowerCase())),D=t=>t.trim().replace(E," "),d=(t,e)=>t<e?-1:t>e?1:0,g=(t,e)=>t.toLowerCase().includes(e.toLowerCase()),R=(t,e)=>t.split(e).length-1,P=(t,e)=>e.some(n=>g(t,n)),Z=(t,e)=>e.some(n=>t.includes(n)),q=(t,e)=>e.every(n=>g(t,n)),Q=(t,e)=>e.every(n=>t.includes(n)),G=t=>t.replace(/_/g,"-"),K=(t,e)=>{if(t===e)return-1;const n=Math.min(t.length,e.length);for(let r=0;r<n;r++)if(t.substring(r,r+1)!==e.substring(r,r+1))return r;return n},C=(t,e=20,n="…")=>{const r=t.length,s=n.length;return r>e?e<s?n.slice(s-e,e):t.slice(0,e-s)+n:t},J=(t,e=20,n="…")=>{const r=t.length,s=n.length;if(r>e){if(e<=s)return C(t,e,n);const c=Math.ceil((e-s)/2),u=Math.floor((e-s)/2);return t.slice(0,c)+n+t.slice(r-u)}else return t},S=(t,e)=>e.some(n=>t.endsWith(n)),V=(t,e)=>Array.from(t).filter(e).join(""),X=(t,e)=>w(t).filter(e).map(r=>String.fromCharCode(r)).join(""),Y=(t,e=2166136261)=>{let n=e;for(let r=0,s=t.length;r<s;r++)n^=t.charCodeAt(r),n+=(n<<1)+(n<<4)+(n<<7)+(n<<8)+(n<<24);return n>>>0},v=t=>t!=null&&t.length>0,tt=t=>W(t).split("_").join(" "),et=t=>t.length>0&&!_t.test(t),nt=t=>kt.test(t),rt=t=>!Nt.test(t),st=t=>t.toLowerCase()===t,it=t=>t.toUpperCase()===t,ot=(t,e)=>t!=null&&t!==""?t:e,ct=t=>Ft.test(t),ut=t=>t==null||t==="",at=t=>t.substring(0,1).toLowerCase()+t.substring(1),A=(t,e=1)=>{const n=Math.floor((t.length-e+1)*Math.random());return t.substring(n,n+e)},b=(t,e)=>Array.from({length:e},()=>A(t)).join(""),lt=t=>b(jt,t),gt=(t,e)=>Array.from(e).map(t),ft=(t,e)=>t.split(e).join(""),pt=(t,e)=>t.endsWith(e)?t.substring(0,t.length-e.length):t,ht=(t,e,n)=>t.substring(0,e)+t.substring(e+n),dt=(t,e)=>t.startsWith(e)?t.substring(e.length):t,Ct=(t,e)=>{const n=t.indexOf(e);return n<0?t:t.substring(0,n)+t.substring(n+e.length)},St=t=>{const e=Array.from(t);return e.reverse(),e.join("")},m=(t,e="'")=>e==="'"?t.includes("'")?t.includes('"')?"'"+t.split("'").join("\\'")+"'":'"'+t+'"':"'"+t+"'":t.includes('"')?t.includes("'")?'"'+t.split('"').join('\\"')+'"':"'"+t+"'":'"'+t+'"',L=(t,e="'")=>e+t.split(e).join("\\"+e)+e,At=(t,e="'")=>t.indexOf(`
-`)>=0?L(t,"`"):m(t,e),bt=(t,e)=>{const n=t.indexOf(e);return n<0?[t]:[t.substring(0,n),t.substring(n+e.length)]},I=(t,e)=>e.some(n=>t.startsWith(n)),mt=(t,e,n=e)=>`${e}${t}${n}`,w=t=>Array.from({length:t.length},(e,n)=>t.charCodeAt(n)),Lt=(t,e)=>{const n=[];for(;t.length>0;)n.push(t.substring(0,e)),t=t.substring(e);return n},It=t=>t.split(B),wt=(t,e)=>y(x(t,e),e),x=(t,e)=>{let n=0;for(let r=0;r<t.length&&e.includes(t.charAt(r));r++)n++;return t.substring(n)},y=(t,e)=>{const n=t.length;let r=n,s;for(let c=0;c<n&&(s=n-c-1,e.includes(t.charAt(s)));c++)r=s;return t.substring(0,r)},W=t=>(t=t.replace(/::/g,"/"),t=t.replace(/([A-Z]+)([A-Z][a-z])/g,"$1_$2"),t=t.replace(/([a-z\d])([A-Z])/g,"$1_$2"),t=t.replace(/-/g,"_"),t.toLowerCase()),xt=t=>t.substring(0,1).toUpperCase()+t.substring(1),yt=(t,e=78,n="",r=`
-`)=>t.split(B).map(s=>O(s.replace(E," ").trim(),e,n,r)).join(r),l=(t,e)=>{if(e<0||e>=t.length)return!1;const n=t.charCodeAt(e);return n===9||n===10||n===11||n===12||n===13||n===32},Wt=t=>{if(typeof Buffer<"u")return Buffer.from(t).toString("base64");if(typeof btoa<"u")return btoa(t);throw new h.MissingImplementationError("No implementation found for base64 encoding")},Ot=t=>{if(typeof Buffer<"u")return Buffer.from(t,"base64").toString("utf8");if(typeof atob<"u")return atob(t);throw new h.MissingImplementationError("No implementation found for base64 decoding")},O=(t,e,n,r)=>{const s=[],c=t.length,u=n.length;let o=0;for(e-=u;;){if(o+e>=c-u){s.push(t.substring(o));break}let i=0;for(;!l(t,o+e-i)&&i<e;)i++;if(i===e){for(i=0;!l(t,o+e+i)&&o+e+i<c;)i++;s.push(t.substring(o,o+e+i)),o+=e+i+1}else s.push(t.substring(o,o+e-i)),o+=e-i+1}return n+s.join(r+n)},Et=(t,e,n)=>{const r=n-t.length;return r>0?e.repeat(r)+t:t},Bt=(t,e,n)=>{const r=n-t.length;return r>0?t+e.repeat(r):t},Tt=(t,e)=>{const n=t.lastIndexOf(e);return n>=0?[t.substring(0,n),t.substring(n+e.length)]:[t]},zt=(t,e)=>{const n=t.indexOf(e);return n>=0?[t.substring(0,n),t.substring(n+e.length)]:[t]},jt="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",Mt=/[^a-zA-Z]([a-z])/g,Nt=/[^\t\n\r ]/,_t=/[^a-zA-Z]/,Ut=/[ \t\r\n][a-z]/g,kt=/^[a-z0-9]+$/i,Ft=/^[0-9]+$/,E=/[ \t\r\n]+/g,B=/\r\n|\n\r|\n|\r/g,Ht=/\r\n|\n\r|\r/g;exports.canonicalizeNewlines=_;exports.capitalize=a;exports.capitalizeWords=N;exports.chunkString=Lt;exports.collapseText=D;exports.compareCaseInsensitive=U;exports.compareStrings=d;exports.containsAllText=Q;exports.containsAllTextCaseInsensitive=q;exports.containsAnyText=Z;exports.containsAnyTextCaseInsensitive=P;exports.countStringOccurrences=R;exports.dasherize=G;exports.decodeBase64=Ot;exports.deleteFirstFromString=Ct;exports.deleteStringAfter=pt;exports.deleteStringBefore=dt;exports.deleteSubstring=ft;exports.ellipsis=C;exports.ellipsisMiddle=J;exports.encodeBase64=Wt;exports.filterCharcodes=X;exports.filterChars=V;exports.humanize=tt;exports.ifEmptyString=ot;exports.isAlpha=et;exports.isAlphaNum=nt;exports.isBreakingWhitespace=rt;exports.isDigitsOnly=ct;exports.isEmptyString=ut;exports.isLowerCase=st;exports.isSpaceAt=l;exports.isUpperCase=it;exports.jsQuote=At;exports.lowerCaseFirst=at;exports.lpad=Et;exports.mapChars=gt;exports.quote=L;exports.randomStringSequence=b;exports.randomStringSequenceBase64=lt;exports.randomSubString=A;exports.reverseString=St;exports.rpad=Bt;exports.smartQuote=m;exports.splitStringOnFirst=zt;exports.splitStringOnLast=Tt;exports.splitStringOnce=bt;exports.stringEndsWithAny=S;exports.stringHasContent=v;exports.stringHashCode=Y;exports.stringStartsWithAny=I;exports.stringToCharcodes=w;exports.stringsDifferAtIndex=K;exports.substringAfter=T;exports.substringAfterLast=z;exports.substringBefore=j;exports.substringBeforeLast=M;exports.surroundString=mt;exports.textContainsCaseInsensitive=g;exports.textEndsWithAnyCaseInsensitive=H;exports.textEndsWithCaseInsensitive=k;exports.textStartsWithAnyCaseInsensitive=$;exports.textStartsWithCaseInsensitive=F;exports.textToLines=It;exports.trimChars=wt;exports.trimCharsLeft=x;exports.trimCharsRight=y;exports.trimStringSlice=ht;exports.underscore=W;exports.upperCaseFirst=xt;exports.wrapColumns=yt;exports.wrapLine=O;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("./error.cjs"),f=require("./regexp.cjs"),T=(t,e)=>{const n=t.indexOf(e);return n<0?"":t.substring(n+e.length)},z=(t,e)=>{const n=t.lastIndexOf(e);return n<0?"":t.substring(n+e.length)},j=(t,e)=>{const n=t.indexOf(e);return n<0?"":t.substring(0,n)},M=(t,e)=>{const n=t.lastIndexOf(e);return n<0?"":t.substring(0,n)},u=t=>t.substring(0,1).toUpperCase()+t.substring(1),p=t=>t.toUpperCase(),N=(t,e=!1)=>e?f.mapRegExp(u(t),Ut,p):f.mapRegExp(u(t),Mt,p),_=t=>t.replace(Ht,`
+`),U=(t,e)=>t==null&&e==null?0:t==null?-1:e==null?1:d(t.toLowerCase(),e.toLowerCase()),k=(t,e)=>t.substring(t.length-e.length).toLowerCase()===e.toLowerCase(),F=(t,e)=>t.substring(0,e.length).toLowerCase()===e.toLowerCase(),H=(t,e)=>C(t.toLowerCase(),e.map(n=>n.toLowerCase())),$=(t,e)=>I(t.toLowerCase(),e.map(n=>n.toLowerCase())),D=t=>t.trim().replace(E," "),d=(t,e)=>t<e?-1:t>e?1:0,g=(t,e)=>t.toLowerCase().includes(e.toLowerCase()),R=(t,e)=>t.split(e).length-1,P=(t,e)=>e.some(n=>g(t,n)),Z=(t,e)=>e.some(n=>t.includes(n)),q=(t,e)=>e.every(n=>g(t,n)),Q=(t,e)=>e.every(n=>t.includes(n)),G=t=>t.replace(/_/g,"-"),K=(t,e)=>{if(t===e)return-1;const n=Math.min(t.length,e.length);for(let r=0;r<n;r++)if(t.substring(r,r+1)!==e.substring(r,r+1))return r;return n},S=(t,e=20,n="…")=>{const r=t.length,s=n.length;return r>e?e<s?n.slice(s-e,e):t.slice(0,e-s)+n:t},J=(t,e=20,n="…")=>{const r=t.length,s=n.length;if(r>e){if(e<=s)return S(t,e,n);const c=Math.ceil((e-s)/2),a=Math.floor((e-s)/2);return t.slice(0,c)+n+t.slice(r-a)}else return t},C=(t,e)=>e.some(n=>t.endsWith(n)),V=(t,e)=>Array.from(t).filter(e).join(""),X=(t,e)=>w(t).filter(e).map(r=>String.fromCharCode(r)).join(""),Y=(t,e=2166136261)=>{let n=e;for(let r=0,s=t.length;r<s;r++)n^=t.charCodeAt(r),n+=(n<<1)+(n<<4)+(n<<7)+(n<<8)+(n<<24);return n>>>0},v=t=>t!=null&&t.length>0,tt=t=>W(t).split("_").join(" "),et=t=>t.length>0&&!_t.test(t),nt=t=>kt.test(t),rt=t=>!Nt.test(t),st=t=>t.toLowerCase()===t,it=t=>t.toUpperCase()===t,ot=(t,e)=>t!=null&&t!==""?t:e,ct=t=>Ft.test(t),at=t=>t==null||t==="",ut=t=>t.substring(0,1).toLowerCase()+t.substring(1),A=(t,e=1)=>{const n=Math.floor((t.length-e+1)*Math.random());return t.substring(n,n+e)},b=(t,e)=>Array.from({length:e},()=>A(t)).join(""),lt=t=>b(jt,t),gt=(t,e)=>Array.from(e).map(t),ft=(t,e)=>t.split(e).join(""),pt=(t,e)=>t.endsWith(e)?t.substring(0,t.length-e.length):t,ht=(t,e,n)=>t.substring(0,e)+t.substring(e+n),dt=(t,e)=>t.startsWith(e)?t.substring(e.length):t,St=(t,e)=>{const n=t.indexOf(e);return n<0?t:t.substring(0,n)+t.substring(n+e.length)},Ct=t=>{const e=Array.from(t);return e.reverse(),e.join("")},m=(t,e="'")=>e==="'"?t.includes("'")?t.includes('"')?"'"+t.split("'").join("\\'")+"'":'"'+t+'"':"'"+t+"'":t.includes('"')?t.includes("'")?'"'+t.split('"').join('\\"')+'"':"'"+t+"'":'"'+t+'"',L=(t,e="'")=>e+t.split(e).join("\\"+e)+e,At=(t,e="'")=>t.indexOf(`
+`)>=0?L(t,"`"):m(t,e),bt=(t,e)=>{const n=t.indexOf(e);return n<0?[t]:[t.substring(0,n),t.substring(n+e.length)]},I=(t,e)=>e.some(n=>t.startsWith(n)),mt=(t,e,n=e)=>`${e}${t}${n}`,w=t=>Array.from({length:t.length},(e,n)=>t.charCodeAt(n)),Lt=(t,e)=>{const n=[];for(let r=0;r<t.length;r+=e)n.push(t.substring(r,r+e));return n},It=t=>t.split(B),wt=(t,e)=>y(x(t,e),e),x=(t,e)=>{const n=new Set(e);let r=0;for(let s=0;s<t.length&&n.has(t.charAt(s));s++)r++;return t.substring(r)},y=(t,e)=>{const n=new Set(e),r=t.length;let s=r,c;for(let a=0;a<r&&(c=r-a-1,n.has(t.charAt(c)));a++)s=c;return t.substring(0,s)},W=t=>(t=t.replace(/::/g,"/"),t=t.replace(/([A-Z]+)([A-Z][a-z])/g,"$1_$2"),t=t.replace(/([a-z\d])([A-Z])/g,"$1_$2"),t=t.replace(/-/g,"_"),t.toLowerCase()),xt=t=>t.substring(0,1).toUpperCase()+t.substring(1),yt=(t,e=78,n="",r=`
+`)=>t.split(B).map(s=>O(s.replace(E," ").trim(),e,n,r)).join(r),l=(t,e)=>{if(e<0||e>=t.length)return!1;const n=t.charCodeAt(e);return n===9||n===10||n===11||n===12||n===13||n===32},Wt=t=>{if(typeof Buffer<"u")return Buffer.from(t).toString("base64");if(typeof btoa<"u")return btoa(t);throw new h.MissingImplementationError("No implementation found for base64 encoding")},Ot=t=>{if(typeof Buffer<"u")return Buffer.from(t,"base64").toString("utf8");if(typeof atob<"u")return atob(t);throw new h.MissingImplementationError("No implementation found for base64 decoding")},O=(t,e,n,r)=>{const s=[],c=t.length,a=n.length;let o=0;for(e-=a;;){if(o+e>=c-a){s.push(t.substring(o));break}let i=0;for(;!l(t,o+e-i)&&i<e;)i++;if(i===e){for(i=0;!l(t,o+e+i)&&o+e+i<c;)i++;s.push(t.substring(o,o+e+i)),o+=e+i+1}else s.push(t.substring(o,o+e-i)),o+=e-i+1}return n+s.join(r+n)},Et=(t,e,n)=>{const r=n-t.length;return r>0?e.repeat(r)+t:t},Bt=(t,e,n)=>{const r=n-t.length;return r>0?t+e.repeat(r):t},Tt=(t,e)=>{const n=t.lastIndexOf(e);return n>=0?[t.substring(0,n),t.substring(n+e.length)]:[t]},zt=(t,e)=>{const n=t.indexOf(e);return n>=0?[t.substring(0,n),t.substring(n+e.length)]:[t]},jt="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",Mt=/[^a-zA-Z]([a-z])/g,Nt=/[^\t\n\r ]/,_t=/[^a-zA-Z]/,Ut=/[ \t\r\n][a-z]/g,kt=/^[a-z0-9]+$/i,Ft=/^[0-9]+$/,E=/[ \t\r\n]+/g,B=/\r\n|\n\r|\n|\r/g,Ht=/\r\n|\n\r|\r/g;exports.canonicalizeNewlines=_;exports.capitalize=u;exports.capitalizeWords=N;exports.chunkString=Lt;exports.collapseText=D;exports.compareCaseInsensitive=U;exports.compareStrings=d;exports.containsAllText=Q;exports.containsAllTextCaseInsensitive=q;exports.containsAnyText=Z;exports.containsAnyTextCaseInsensitive=P;exports.countStringOccurrences=R;exports.dasherize=G;exports.decodeBase64=Ot;exports.deleteFirstFromString=St;exports.deleteStringAfter=pt;exports.deleteStringBefore=dt;exports.deleteSubstring=ft;exports.ellipsis=S;exports.ellipsisMiddle=J;exports.encodeBase64=Wt;exports.filterCharcodes=X;exports.filterChars=V;exports.humanize=tt;exports.ifEmptyString=ot;exports.isAlpha=et;exports.isAlphaNum=nt;exports.isBreakingWhitespace=rt;exports.isDigitsOnly=ct;exports.isEmptyString=at;exports.isLowerCase=st;exports.isSpaceAt=l;exports.isUpperCase=it;exports.jsQuote=At;exports.lowerCaseFirst=ut;exports.lpad=Et;exports.mapChars=gt;exports.quote=L;exports.randomStringSequence=b;exports.randomStringSequenceBase64=lt;exports.randomSubString=A;exports.reverseString=Ct;exports.rpad=Bt;exports.smartQuote=m;exports.splitStringOnFirst=zt;exports.splitStringOnLast=Tt;exports.splitStringOnce=bt;exports.stringEndsWithAny=C;exports.stringHasContent=v;exports.stringHashCode=Y;exports.stringStartsWithAny=I;exports.stringToCharcodes=w;exports.stringsDifferAtIndex=K;exports.substringAfter=T;exports.substringAfterLast=z;exports.substringBefore=j;exports.substringBeforeLast=M;exports.surroundString=mt;exports.textContainsCaseInsensitive=g;exports.textEndsWithAnyCaseInsensitive=H;exports.textEndsWithCaseInsensitive=k;exports.textStartsWithAnyCaseInsensitive=$;exports.textStartsWithCaseInsensitive=F;exports.textToLines=It;exports.trimChars=wt;exports.trimCharsLeft=x;exports.trimCharsRight=y;exports.trimStringSlice=ht;exports.underscore=W;exports.upperCaseFirst=xt;exports.wrapColumns=yt;exports.wrapLine=O;