happy-rusty 1.4.0 → 1.6.0

package/dist/main.mjs

@@ -1,5 +1,5 @@
-const OptionKindSymbol = Symbol("Option kind");
-const ResultKindSymbol = Symbol("Result kind");
+const OptionKindSymbol = /* @__PURE__ */ Symbol("Option kind");
+const ResultKindSymbol = /* @__PURE__ */ Symbol("Result kind");
 
 function isOption(o) {
   return o != null && typeof o === "object" && OptionKindSymbol in o;
@@ -9,7 +9,7 @@ function isResult(r) {
 }
 
 function Some(value) {
-  const some = {
+  const some = Object.freeze({
     [Symbol.toStringTag]: "Option",
     [OptionKindSymbol]: "Some",
     isSome() {
@@ -21,6 +21,15 @@ function Some(value) {
     isSomeAnd(predicate) {
       return predicate(value);
     },
+    isSomeAndAsync(predicate) {
+      return predicate(value);
+    },
+    isNoneOr(predicate) {
+      return predicate(value);
+    },
+    isNoneOrAsync(predicate) {
+      return predicate(value);
+    },
     expect(_msg) {
       return value;
     },
@@ -33,6 +42,9 @@ function Some(value) {
     unwrapOrElse(_fn) {
       return value;
     },
+    unwrapOrElseAsync(_fn) {
+      return Promise.resolve(value);
+    },
     okOr(_error) {
       return Ok(value);
     },
@@ -40,17 +52,15 @@ function Some(value) {
       return Ok(value);
     },
     transpose() {
-      const r = value;
-      assertResult(r);
-      return r.isOk() ? Ok(Some(r.unwrap())) : Err(r.unwrapErr());
+      assertResult(value);
+      return value.isOk() ? Ok(Some(value.unwrap())) : Err(value.unwrapErr());
     },
     filter(predicate) {
       return predicate(value) ? some : None;
     },
     flatten() {
-      const o = value;
-      assertOption(o);
-      return o;
+      assertOption(value);
+      return value;
     },
     map(fn) {
       return Some(fn(value));
@@ -72,7 +82,7 @@ function Some(value) {
     unzip() {
       const tuple = value;
       if (!Array.isArray(tuple) || tuple.length !== 2) {
-        throw new TypeError("Unzip format is incorrect.");
+        throw new TypeError(`Option::unzip() requires a 2-element tuple, received ${Array.isArray(tuple) ? `array with ${tuple.length} elements` : typeof tuple}.`);
       }
       const [a, b] = tuple;
       return [Some(a), Some(b)];
@@ -84,12 +94,18 @@ function Some(value) {
     andThen(fn) {
       return fn(value);
     },
+    andThenAsync(fn) {
+      return fn(value);
+    },
     or(_other) {
       return some;
     },
     orElse(_fn) {
       return some;
     },
+    orElseAsync(_fn) {
+      return Promise.resolve(some);
+    },
     xor(other) {
       assertOption(other);
       return other.isSome() ? None : some;
@@ -105,7 +121,7 @@ function Some(value) {
     toString() {
       return `Some(${value})`;
     }
-  };
+  });
   return some;
 }
 const None = Object.freeze({
@@ -120,11 +136,20 @@ const None = Object.freeze({
   isSomeAnd(_predicate) {
     return false;
   },
+  isSomeAndAsync(_predicate) {
+    return Promise.resolve(false);
+  },
+  isNoneOr(_predicate) {
+    return true;
+  },
+  isNoneOrAsync(_predicate) {
+    return Promise.resolve(true);
+  },
   expect(msg) {
     throw new TypeError(msg);
   },
   unwrap() {
-    throw new TypeError("Called `Option::unwrap()` on a `None` value");
+    throw new TypeError("Option::unwrap() called on a `None` value.");
   },
   unwrapOr(defaultValue) {
     return defaultValue;
@@ -132,6 +157,9 @@ const None = Object.freeze({
   unwrapOrElse(fn) {
     return fn();
   },
+  unwrapOrElseAsync(fn) {
+    return fn();
+  },
   okOr(error) {
     return Err(error);
   },
@@ -171,6 +199,9 @@ const None = Object.freeze({
   andThen(_fn) {
     return None;
   },
+  andThenAsync(_fn) {
+    return Promise.resolve(None);
+  },
   or(other) {
     assertOption(other);
     return other;
@@ -178,6 +209,9 @@ const None = Object.freeze({
   orElse(fn) {
     return fn();
   },
+  orElseAsync(fn) {
+    return fn();
+  },
   xor(other) {
     assertOption(other);
     return other.isSome() ? other : None;
@@ -194,7 +228,7 @@ const None = Object.freeze({
   }
 });
 function Ok(value) {
-  const ok = {
+  const ok = Object.freeze({
     [Symbol.toStringTag]: "Result",
     [ResultKindSymbol]: "Ok",
     isOk() {
@@ -206,9 +240,15 @@ function Ok(value) {
     isOkAnd(predicate) {
       return predicate(value);
     },
+    isOkAndAsync(predicate) {
+      return predicate(value);
+    },
     isErrAnd(_predicate) {
       return false;
     },
+    isErrAndAsync(_predicate) {
+      return Promise.resolve(false);
+    },
     expect(_msg) {
       return value;
     },
@@ -221,11 +261,14 @@ function Ok(value) {
     unwrapOrElse(_fn) {
       return value;
     },
+    unwrapOrElseAsync(_fn) {
+      return Promise.resolve(value);
+    },
     expectErr(msg) {
       throw new TypeError(`${msg}: ${value}`);
     },
     unwrapErr() {
-      throw new TypeError("Called `Result::unwrapErr()` on an `Ok` value");
+      throw new TypeError("Result::unwrapErr() called on an `Ok` value.");
     },
     ok() {
       return Some(value);
@@ -234,9 +277,8 @@ function Ok(value) {
       return None;
     },
     transpose() {
-      const o = value;
-      assertOption(o);
-      return o.isSome() ? Some(Ok(o.unwrap())) : None;
+      assertOption(value);
+      return value.isSome() ? Some(Ok(value.unwrap())) : None;
     },
     map(fn) {
       return Ok(fn(value));
@@ -251,9 +293,8 @@ function Ok(value) {
       return fn(value);
     },
     flatten() {
-      const r = value;
-      assertResult(r);
-      return r;
+      assertResult(value);
+      return value;
     },
     and(other) {
       assertResult(other);
@@ -265,9 +306,15 @@ function Ok(value) {
     andThen(fn) {
       return fn(value);
     },
+    andThenAsync(fn) {
+      return fn(value);
+    },
     orElse(_fn) {
       return ok;
     },
+    orElseAsync(_fn) {
+      return Promise.resolve(ok);
+    },
     inspect(fn) {
       fn(value);
       return ok;
@@ -283,16 +330,16 @@ function Ok(value) {
       return ok;
     },
     asErr() {
-      throw new TypeError("Called `Result::asErr()` on an `Ok` value");
+      throw new TypeError("Result::asErr() called on an `Ok` value.");
     },
     toString() {
       return `Ok(${value})`;
     }
-  };
+  });
   return ok;
 }
 function Err(error) {
-  const err = {
+  const err = Object.freeze({
     [Symbol.toStringTag]: "Result",
     [ResultKindSymbol]: "Err",
     isOk() {
@@ -304,14 +351,20 @@ function Err(error) {
     isOkAnd(_predicate) {
       return false;
     },
+    isOkAndAsync(_predicate) {
+      return Promise.resolve(false);
+    },
     isErrAnd(predicate) {
       return predicate(error);
     },
+    isErrAndAsync(predicate) {
+      return predicate(error);
+    },
     expect(msg) {
       throw new TypeError(`${msg}: ${error}`);
     },
     unwrap() {
-      throw new TypeError("Called `Result::unwrap()` on an `Err` value");
+      throw new TypeError("Result::unwrap() called on an `Err` value.");
     },
     unwrapOr(defaultValue) {
       return defaultValue;
@@ -319,6 +372,9 @@ function Err(error) {
     unwrapOrElse(fn) {
       return fn(error);
     },
+    unwrapOrElseAsync(fn) {
+      return fn(error);
+    },
     expectErr(_msg) {
       return error;
     },
@@ -359,9 +415,15 @@ function Err(error) {
     andThen(_fn) {
       return err;
     },
+    andThenAsync(_fn) {
+      return Promise.resolve(err);
+    },
     orElse(fn) {
       return fn(error);
     },
+    orElseAsync(fn) {
+      return fn(error);
+    },
     inspect(_fn) {
       return err;
     },
@@ -374,7 +436,7 @@ function Err(error) {
       return other.isErr() && other.unwrapErr() === error;
     },
     asOk() {
-      throw new TypeError("Called `Result::asOk()` on an `Err` value");
+      throw new TypeError("Result::asOk() called on an `Err` value.");
     },
     asErr() {
       return err;
@@ -382,17 +444,33 @@ function Err(error) {
     toString() {
       return `Err(${error})`;
     }
-  };
+  });
   return err;
 }
+function safeStringify(value) {
+  try {
+    if (value === null) {
+      return "null";
+    }
+    if (value === void 0) {
+      return "undefined";
+    }
+    if (typeof value === "object") {
+      return Object.prototype.toString.call(value);
+    }
+    return String(value);
+  } catch {
+    return "[unable to stringify]";
+  }
+}
 function assertOption(o) {
   if (!isOption(o)) {
-    throw new TypeError(`This(${o}) is not an Option`);
+    throw new TypeError(`Expected an Option, but received: ${safeStringify(o)}.`);
   }
 }
 function assertResult(r) {
   if (!isResult(r)) {
-    throw new TypeError(`This(${r}) is not a Result`);
+    throw new TypeError(`Expected a Result, but received: ${safeStringify(r)}.`);
   }
 }
 
@@ -401,13 +479,330 @@ const RESULT_FALSE = Ok(false);
 const RESULT_ZERO = Ok(0);
 const RESULT_VOID = Ok();
 
-function promiseToAsyncResult(p) {
-  return p.then((x) => {
-    return Ok(x);
-  }).catch((err) => {
+async function promiseToAsyncResult(p) {
+  try {
+    return Ok(await p);
+  } catch (err) {
     return Err(err);
+  }
+}
+
+const ControlFlowKindSymbol = /* @__PURE__ */ Symbol("ControlFlow kind");
+
+function Break(value) {
+  const brk = Object.freeze({
+    [Symbol.toStringTag]: "ControlFlow",
+    [ControlFlowKindSymbol]: "Break",
+    isBreak() {
+      return true;
+    },
+    isContinue() {
+      return false;
+    },
+    breakValue() {
+      return Some(value);
+    },
+    continueValue() {
+      return None;
+    },
+    mapBreak(fn) {
+      return Break(fn(value));
+    },
+    mapContinue(_fn) {
+      return brk;
+    },
+    breakOk() {
+      return Ok(value);
+    },
+    continueOk() {
+      return Err(value);
+    },
+    toString() {
+      return `Break(${value})`;
+    }
+  });
+  return brk;
+}
+function Continue(value) {
+  const cont = Object.freeze({
+    [Symbol.toStringTag]: "ControlFlow",
+    [ControlFlowKindSymbol]: "Continue",
+    isBreak() {
+      return false;
+    },
+    isContinue() {
+      return true;
+    },
+    breakValue() {
+      return None;
+    },
+    continueValue() {
+      return Some(value);
+    },
+    mapBreak(_fn) {
+      return cont;
+    },
+    mapContinue(fn) {
+      return Continue(fn(value));
+    },
+    breakOk() {
+      return Err(value);
+    },
+    continueOk() {
+      return Ok(value);
+    },
+    toString() {
+      return `Continue(${value})`;
+    }
+  });
+  return cont;
+}
+
+function isControlFlow(cf) {
+  return cf != null && typeof cf === "object" && ControlFlowKindSymbol in cf;
+}
+
+function Lazy(fn) {
+  let value;
+  let initialized = false;
+  return Object.freeze({
+    [Symbol.toStringTag]: "Lazy",
+    force() {
+      if (!initialized) {
+        value = fn();
+        initialized = true;
+      }
+      return value;
+    },
+    get() {
+      return initialized ? Some(value) : None;
+    },
+    isInitialized() {
+      return initialized;
+    },
+    toString() {
+      return initialized ? `Lazy(${value})` : "Lazy(<uninitialized>)";
+    }
+  });
+}
+function LazyAsync(fn) {
+  let value;
+  let initialized = false;
+  let pendingPromise;
+  return Object.freeze({
+    [Symbol.toStringTag]: "LazyAsync",
+    async force() {
+      if (initialized) {
+        return value;
+      }
+      if (pendingPromise) {
+        return pendingPromise;
+      }
+      pendingPromise = (async () => {
+        try {
+          const result = await fn();
+          value = result;
+          initialized = true;
+          return result;
+        } finally {
+          pendingPromise = void 0;
+        }
+      })();
+      return pendingPromise;
+    },
+    get() {
+      return initialized ? Some(value) : None;
+    },
+    isInitialized() {
+      return initialized;
+    },
+    toString() {
+      return initialized ? `LazyAsync(${value})` : "LazyAsync(<uninitialized>)";
+    }
+  });
+}
+
+function Mutex(value) {
+  let currentValue = value;
+  let locked = false;
+  const waitQueue = [];
+  function unlock() {
+    if (waitQueue.length > 0) {
+      const next = waitQueue.shift();
+      next();
+    } else {
+      locked = false;
+    }
+  }
+  function createGuard() {
+    let released = false;
+    return Object.freeze({
+      [Symbol.toStringTag]: "MutexGuard",
+      get value() {
+        if (released) {
+          throw new Error("MutexGuard has been released.");
+        }
+        return currentValue;
+      },
+      set value(newValue) {
+        if (released) {
+          throw new Error("MutexGuard has been released.");
+        }
+        currentValue = newValue;
+      },
+      unlock() {
+        if (released) {
+          return;
+        }
+        released = true;
+        unlock();
+      },
+      toString() {
+        if (released) {
+          return "MutexGuard(<released>)";
+        }
+        return `MutexGuard(${currentValue})`;
+      }
+    });
+  }
+  function lock() {
+    if (!locked) {
+      locked = true;
+      return Promise.resolve(createGuard());
+    }
+    return new Promise((resolve) => {
+      waitQueue.push(() => {
+        resolve(createGuard());
+      });
+    });
+  }
+  return Object.freeze({
+    [Symbol.toStringTag]: "Mutex",
+    async withLock(fn) {
+      const guard = await lock();
+      try {
+        return await fn(guard.value);
+      } finally {
+        guard.unlock();
+      }
+    },
+    lock,
+    tryLock() {
+      if (locked) {
+        return None;
+      }
+      locked = true;
+      return Some(createGuard());
+    },
+    isLocked() {
+      return locked;
+    },
+    toString() {
+      return locked ? "Mutex(<locked>)" : "Mutex(<unlocked>)";
+    }
+  });
+}
+
+function Once() {
+  let value;
+  let initialized = false;
+  let pendingPromise;
+  return Object.freeze({
+    [Symbol.toStringTag]: "Once",
+    get() {
+      return initialized ? Some(value) : None;
+    },
+    set(newValue) {
+      if (initialized) {
+        return Err(newValue);
+      }
+      value = newValue;
+      initialized = true;
+      return Ok(void 0);
+    },
+    getOrInit(fn) {
+      if (!initialized) {
+        value = fn();
+        initialized = true;
+      }
+      return value;
+    },
+    async getOrInitAsync(fn) {
+      if (initialized) {
+        return value;
+      }
+      if (pendingPromise) {
+        return pendingPromise;
+      }
+      pendingPromise = (async () => {
+        try {
+          const result = await fn();
+          value = result;
+          initialized = true;
+          return result;
+        } finally {
+          pendingPromise = void 0;
+        }
+      })();
+      return pendingPromise;
+    },
+    getOrTryInit(fn) {
+      if (initialized) {
+        return Ok(value);
+      }
+      const result = fn();
+      if (result.isOk()) {
+        value = result.unwrap();
+        initialized = true;
+      }
+      return result;
+    },
+    async getOrTryInitAsync(fn) {
+      if (initialized) {
+        return Ok(value);
+      }
+      if (pendingPromise) {
+        try {
+          await pendingPromise;
+          return Ok(value);
+        } catch {
+        }
+      }
+      pendingPromise = (async () => {
+        const result = await fn();
+        if (result.isOk()) {
+          value = result.unwrap();
+          initialized = true;
+          return value;
+        }
+        throw result;
+      })();
+      try {
+        const resultValue = await pendingPromise;
+        return Ok(resultValue);
+      } catch (errResult) {
+        return errResult;
+      } finally {
+        pendingPromise = void 0;
+      }
+    },
+    take() {
+      if (!initialized) {
+        return None;
+      }
+      const taken = value;
+      value = void 0;
+      initialized = false;
+      return Some(taken);
+    },
+    isInitialized() {
+      return initialized;
+    },
+    toString() {
+      return initialized ? `Once(${value})` : "Once(<uninitialized>)";
+    }
   });
 }
 
-export { Err, None, Ok, RESULT_FALSE, RESULT_TRUE, RESULT_VOID, RESULT_ZERO, Some, isOption, isResult, promiseToAsyncResult };
+export { Break, Continue, Err, Lazy, LazyAsync, Mutex, None, Ok, Once, RESULT_FALSE, RESULT_TRUE, RESULT_VOID, RESULT_ZERO, Some, isControlFlow, isOption, isResult, promiseToAsyncResult };
 //# sourceMappingURL=main.mjs.map