@consolidados/results 0.1.4 → 0.2.0

package/dist/result/index.js

@@ -1,17 +1,12 @@
 // src/result/__internal__/return-types/err.ts
-var Err = class _Err extends Error {
+var Err = class _Err {
   error;
   /**
    * Creates a new `Err` instance with the given error value.
-   * @param error The error to wrap in the `Err` instance.
+   * @param error The error to wrap in the `Err` instance. Can be any type.
    */
   constructor(error) {
-    super(typeof error === "string" ? error : error.message);
-    this.error = typeof error === "string" ? new Error(error) : error;
-    Object.setPrototypeOf(this, _Err.prototype);
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, _Err);
-    }
+    this.error = error;
   }
   /**
    * Checks if this result is an `Ok`.
@@ -45,7 +40,7 @@ var Err = class _Err extends Error {
   }
   /**
    * Maps the error value using a transformation function and returns a new `Result` with the transformed error.
-   * @template U The type of the transformed error.
+   * @template U The type of the transformed error. Can be any type.
    * @param fn The transformation function to apply to the error value.
    * @returns A new `Err` containing the transformed error.
    */
@@ -55,8 +50,9 @@ var Err = class _Err extends Error {
   /**
    * Applies a transformation function that returns a `Result` to the value (which does not exist) of this `Err`.
    * @template U The type of the value in the resulting `Result`.
+   * @template F The type of the error in the resulting `Result`.
    * @param _fn The transformation function (ignored in this implementation).
-   * @returns The original `Err` instance.
+   * @returns The original `Err` instance cast to the new error type.
    */
   flatMap(_fn) {
     return this;
@@ -68,6 +64,42 @@ var Err = class _Err extends Error {
   unwrapErr() {
     return this.error;
   }
+  /**
+   * Returns the inner error. After an `isErr()` type guard, TypeScript narrows the return type to `E`.
+   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).
+   * @returns The error value contained in this `Err`.
+   */
+  value() {
+    return this.error;
+  }
+  /**
+   * Returns the contained value if `Ok`, otherwise returns the provided default value.
+   * @template U The type of the default value.
+   * @param defaultValue The value to return since this is an `Err`.
+   * @returns The provided default value.
+   */
+  unwrapOr(defaultValue) {
+    return defaultValue;
+  }
+  /**
+   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.
+   * @template U The type of the default value.
+   * @param fn The function to compute the default value.
+   * @returns The result of calling the provided function with the error.
+   */
+  unwrapOrElse(fn) {
+    return fn(this.error);
+  }
+  /**
+   * Returns this `Err` if it is `Err`, otherwise returns the result of the provided function.
+   * @template T The type of the alternative success value.
+   * @template F The type of the alternative error.
+   * @param fn The function to compute the alternative result.
+   * @returns The result of calling the provided function with the error.
+   */
+  orElse(fn) {
+    return fn(this.error);
+  }
   /**
    * Converts `Result` type to `Option` type.
    * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.
@@ -81,10 +113,10 @@ var Err = class _Err extends Error {
 var Ok = class _Ok {
   /**
    * Creates a new `Ok` instance with the given value.
-   * @param value The value to wrap in the `Ok` instance.
+   * @param _value The value to wrap in the `Ok` instance.
    */
-  constructor(value) {
-    this.value = value;
+  constructor(_value) {
+    this._value = _value;
   }
   /**
    * Checks if this result is an `Ok`.
@@ -105,7 +137,15 @@ var Ok = class _Ok {
    * @returns The value contained in this `Ok`.
    */
   unwrap() {
-    return this.value;
+    return this._value;
+  }
+  /**
+   * Returns the inner value. After an `isOk()` type guard, TypeScript narrows the return type to `T`.
+   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).
+   * @returns The value contained in this `Ok`.
+   */
+  value() {
+    return this._value;
   }
   /**
    * Applies a transformation function to the value contained in this `Ok` and returns a new `Result` with the transformed value.
@@ -114,25 +154,24 @@ var Ok = class _Ok {
    * @returns A new `Ok` containing the transformed value.
    */
   map(fn) {
-    return new _Ok(fn(this.value));
+    return new _Ok(fn(this._value));
   }
   /**
    * Applies a transformation function that returns a `Result` to the value contained in this `Ok`.
    * @template U The type of the value in the resulting `Result`.
+   * @template E The type of the error in the resulting `Result`.
    * @param fn The transformation function to apply to the value.
    * @returns The result of applying the transformation function.
    */
   flatMap(fn) {
-    return fn(this.value);
+    return fn(this._value);
   }
   /**
    * Maps the error value (if any). Since this is an `Ok`, the error mapping function is ignored, and the original `Ok` is returned.
-   * @template U The type of the error (ignored for `Ok`).
+   * @template U The type of the error (ignored for `Ok`). Can be any type.
    * @param _fn The mapping function for errors (not used).
    * @returns The original `Ok` instance.
    */
-  // mapErr<U extends Error | string>(fn: (err: U) => U): Result<T, never> {
-  // 	return this;
   mapErr(_fn) {
     return this;
   }
@@ -143,15 +182,39 @@ var Ok = class _Ok {
   unwrapErr() {
     throw new Error("Called unwrapErr on an Ok value");
   }
+  /**
+   * Returns the contained value if `Ok`, otherwise returns the provided default value.
+   * @template U The type of the default value.
+   * @param defaultValue The value to return if this is an `Err`.
+   * @returns The value contained in this `Ok`.
+   */
+  unwrapOr(defaultValue) {
+    return this._value;
+  }
+  /**
+   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.
+   * @template U The type of the default value.
+   * @param fn The function to compute the default value.
+   * @returns The value contained in this `Ok`.
+   */
+  unwrapOrElse(fn) {
+    return this._value;
+  }
+  /**
+   * Returns this `Ok` if it is `Ok`, otherwise returns the result of the provided function.
+   * @template F The type of the alternative error.
+   * @param fn The function to compute the alternative result.
+   * @returns The original `Ok` instance.
+   */
+  orElse(fn) {
+    return this;
+  }
   /**
    * Converts `Result` type to `Option` type.
    * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.
    */
   ok() {
-    return match(this, {
-      Ok: (v) => Some(v),
-      Err: (_) => None()
-    });
+    return Some(this._value);
   }
 };
 
@@ -164,5 +227,7 @@ function Err2(error) {
 }
 global.Ok = Ok2;
 global.Err = Err2;
+
+export { Err2 as Err, Ok2 as Ok };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/result/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/result/__internal__/return-types/err.ts","../../src/result/__internal__/return-types/ok.ts","../../src/result/result.ts"],"names":["Ok","Err"],"mappings":"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","file":"index.js","sourcesContent":["import type { Ok } from \"./ok\";\nimport type { ResultDefinition } from \"./result\";\n\n/**\n * Represents a failed result (`Err`) that contains an error value.\n * @template E The type of the error contained in this `Err`.\n */\nexport class Err<E extends Error>\n  extends Error\n  implements ResultDefinition<never, E>\n{\n  private error: E;\n  /**\n   * Creates a new `Err` instance with the given error value.\n   * @param error The error to wrap in the `Err` instance.\n   */\n  constructor(error: E | string) {\n    super(typeof error === \"string\" ? error : error.message);\n    this.error =\n      typeof error === \"string\" ? (new Error(error) as E) : (error as E);\n    Object.setPrototypeOf(this, Err.prototype);\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, Err);\n    }\n  }\n\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `false` because this is an `Err`.\n   */\n  isOk(): this is Ok<never> {\n    return false;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `true` because this is an `Err`.\n   */\n  isErr(): this is Err<E extends Error ? E : Error> {\n    return true;\n  }\n\n  /**\n   * Retrieves the value contained in this result. Since this is an `Err`, an error is thrown.\n   * @throws An error because `unwrap` is called on an `Err`.\n   */\n  unwrap(): never {\n    throw new Error(\"Called unwrap on an Err value\");\n  }\n\n  /**\n   * Maps the value (if any). Since this is an `Err`, the mapping function is ignored, and the original `Err` is returned.\n   * @template U The type of the value (ignored for `Err`).\n   * @param _fn The mapping function for values (not used).\n   * @returns The original `Err` instance.\n   */\n  map<U>(_fn: (value: never) => U): ResultDefinition<never, E> {\n    return this as unknown as ResultDefinition<never, E>;\n  }\n\n  /**\n   * Maps the error value using a transformation function and returns a new `Result` with the transformed error.\n   * @template U The type of the transformed error.\n   * @param fn The transformation function to apply to the error value.\n   * @returns A new `Err` containing the transformed error.\n   */\n  mapErr<U extends Error>(fn: (err: E) => U): ResultDefinition<never, U> {\n    return new Err<U>(fn(this.error)) as unknown as ResultDefinition<never, U>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value (which does not exist) of this `Err`.\n   * @template U The type of the value in the resulting `Result`.\n   * @param _fn The transformation function (ignored in this implementation).\n   * @returns The original `Err` instance.\n   */\n  flatMap<U>(\n    _fn: (value: never) => ResultDefinition<U, never>,\n  ): ResultDefinition<never, E> {\n    return this as unknown as ResultDefinition<never, E>;\n  }\n\n  /**\n   * Retrieves the error value contained in this `Err`.\n   * @returns The error value contained in this `Err`.\n   */\n  unwrapErr(): E {\n    return this.error;\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return None();\n  }\n}\n","import type { ResultDefinition } from \"./result\";\nimport type { Err } from \"./err\";\n\n/**\n * Represents a successful result (`Ok`) that contains a value.\n * @template T The type of the value contained in this `Ok`.\n */\nexport class Ok<T> implements ResultDefinition<T, never> {\n  /**\n   * Creates a new `Ok` instance with the given value.\n   * @param value The value to wrap in the `Ok` instance.\n   */\n  constructor(private value: T) {}\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `true` because this is an `Ok`.\n   */\n  isOk(): this is Ok<T> {\n    return true;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `false` because this is an `Ok`.\n   */\n  isErr(): this is Err<never> {\n    return false;\n  }\n\n  /**\n   * Retrieves the value contained in this `Ok`.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrap(): T {\n    return this.value;\n  }\n\n  /**\n   * Applies a transformation function to the value contained in this `Ok` and returns a new `Result` with the transformed value.\n   * @template U The type of the transformed value.\n   * @param fn The transformation function to apply to the value.\n   * @returns A new `Ok` containing the transformed value.\n   */\n  map<U>(fn: (value: T) => U): ResultDefinition<U, never> {\n    return new Ok(fn(this.value)) as ResultDefinition<U, never>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value contained in this `Ok`.\n   * @template U The type of the value in the resulting `Result`.\n   * @param fn The transformation function to apply to the value.\n   * @returns The result of applying the transformation function.\n   */\n  flatMap<U>(\n    fn: (value: T) => ResultDefinition<U, never>,\n  ): ResultDefinition<U, never> {\n    return fn(this.value);\n  }\n\n  /**\n   * Maps the error value (if any). Since this is an `Ok`, the error mapping function is ignored, and the original `Ok` is returned.\n   * @template U The type of the error (ignored for `Ok`).\n   * @param _fn The mapping function for errors (not used).\n   * @returns The original `Ok` instance.\n   */\n  // mapErr<U extends Error | string>(fn: (err: U) => U): Result<T, never> {\n  // \treturn this;\n  mapErr<U extends Error>(_fn: (err: never) => U): ResultDefinition<T, U> {\n    return this as unknown as ResultDefinition<T, U>;\n  }\n\n  /**\n   * Retrieves the error contained in this result. Since this is an `Ok`, an error is thrown.\n   * @throws An error because `unwrapErr` is called on an `Ok`.\n   */\n  unwrapErr(): never {\n    throw new Error(\"Called unwrapErr on an Ok value\");\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return match(this, {\n      Ok: (v) => Some(v),\n      Err: (_) => None(),\n    });\n  }\n}\n","import {\n  Err as ErrType,\n  Ok as OkType,\n  type Result,\n} from \"./__internal__/return-types\";\n\n/**\n * Creates a new `Ok` instance, representing a successful result.\n * @template T The type of the value contained in the `Ok`.\n * @param value The value to wrap in the `Ok` instance.\n * @returns An `Ok` instance containing the given value.\n * @example\n * const result = Ok(42);\n * console.log(result.isOk()); // true\n * console.log(result.unwrap()); // 42\n */\nfunction Ok<T>(value: T): OkType<T> {\n  return new OkType(value);\n}\n\n/**\n * Creates a new `Err` instance, representing a failed result.\n * @template E The type of the error contained in the `Err`.\n * @param error The error to wrap in the `Err` instance.\n * @returns An `Err` instance containing the given error.\n * @example\n * const result = Err(\"Something went wrong\");\n * console.log(result.isErr()); // true\n * console.log(result.unwrapErr()); // \"Something went wrong\"\n */\nfunction Err<E extends Error>(error: E | string): ErrType<E> {\n  return new ErrType(error);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Ok = Ok;\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Err = Err;\n\nexport type { Err, Ok, Result, ErrType, OkType };\n"]}
+{"version":3,"sources":["../../src/result/__internal__/return-types/err.ts","../../src/result/__internal__/return-types/ok.ts","../../src/result/result.ts"],"names":["Ok","Err"],"mappings":"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","file":"index.js","sourcesContent":["import type { Ok } from \"./ok\";\nimport type { ResultDefinition } from \"./result\";\n\n/**\n * Represents a failed result (`Err`) that contains an error value.\n * @template E The type of the error contained in this `Err`. Can be any type (Error, string, enum, etc).\n */\nexport class Err<E> implements ResultDefinition<never, E> {\n  private error: E;\n  /**\n   * Creates a new `Err` instance with the given error value.\n   * @param error The error to wrap in the `Err` instance. Can be any type.\n   */\n  constructor(error: E) {\n    // Store error as-is - conversion is handled by factory function\n    this.error = error;\n    // Object.setPrototypeOf(this, Err.prototype);\n    //\n    // if (Error.captureStackTrace) {\n    //   Error.captureStackTrace(this, Err);\n    // }\n  }\n\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `false` because this is an `Err`.\n   */\n  isOk(): this is Ok<never> {\n    return false;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `true` because this is an `Err`.\n   */\n  isErr(): this is Err<E> {\n    return true;\n  }\n\n  /**\n   * Retrieves the value contained in this result. Since this is an `Err`, an error is thrown.\n   * @throws An error because `unwrap` is called on an `Err`.\n   */\n  unwrap(): never {\n    throw new Error(\"Called unwrap on an Err value\");\n  }\n\n  /**\n   * Maps the value (if any). Since this is an `Err`, the mapping function is ignored, and the original `Err` is returned.\n   * @template U The type of the value (ignored for `Err`).\n   * @param _fn The mapping function for values (not used).\n   * @returns The original `Err` instance.\n   */\n  map<U>(_fn: (value: never) => U): ResultDefinition<never, E> {\n    return this as unknown as ResultDefinition<never, E>;\n  }\n\n  /**\n   * Maps the error value using a transformation function and returns a new `Result` with the transformed error.\n   * @template U The type of the transformed error. Can be any type.\n   * @param fn The transformation function to apply to the error value.\n   * @returns A new `Err` containing the transformed error.\n   */\n  mapErr<U>(fn: (err: E) => U): ResultDefinition<never, U> {\n    return new Err<U>(fn(this.error)) as unknown as ResultDefinition<never, U>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value (which does not exist) of this `Err`.\n   * @template U The type of the value in the resulting `Result`.\n   * @template F The type of the error in the resulting `Result`.\n   * @param _fn The transformation function (ignored in this implementation).\n   * @returns The original `Err` instance cast to the new error type.\n   */\n  flatMap<U, F = E>(\n    _fn: (value: never) => ResultDefinition<U, F>,\n  ): ResultDefinition<U, E> {\n    return this as unknown as ResultDefinition<U, E>;\n  }\n\n  /**\n   * Retrieves the error value contained in this `Err`.\n   * @returns The error value contained in this `Err`.\n   */\n  unwrapErr(): E {\n    return this.error;\n  }\n\n  /**\n   * Returns the inner error. After an `isErr()` type guard, TypeScript narrows the return type to `E`.\n   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).\n   * @returns The error value contained in this `Err`.\n   */\n  value(): E {\n    return this.error;\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise returns the provided default value.\n   * @template U The type of the default value.\n   * @param defaultValue The value to return since this is an `Err`.\n   * @returns The provided default value.\n   */\n  unwrapOr<U>(defaultValue: U): U {\n    return defaultValue;\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.\n   * @template U The type of the default value.\n   * @param fn The function to compute the default value.\n   * @returns The result of calling the provided function with the error.\n   */\n  unwrapOrElse<U>(fn: (error: E) => U): U {\n    return fn(this.error);\n  }\n\n  /**\n   * Returns this `Err` if it is `Err`, otherwise returns the result of the provided function.\n   * @template T The type of the alternative success value.\n   * @template F The type of the alternative error.\n   * @param fn The function to compute the alternative result.\n   * @returns The result of calling the provided function with the error.\n   */\n  orElse<T, F>(\n    fn: (error: E) => ResultDefinition<T, F>,\n  ): ResultDefinition<T, F> {\n    return fn(this.error);\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return None();\n  }\n}\n","import type { ResultDefinition } from \"./result\";\nimport type { Err } from \"./err\";\n\n/**\n * Represents a successful result (`Ok`) that contains a value.\n * @template T The type of the value contained in this `Ok`.\n */\nexport class Ok<T> implements ResultDefinition<T, never> {\n  /**\n   * Creates a new `Ok` instance with the given value.\n   * @param _value The value to wrap in the `Ok` instance.\n   */\n  constructor(private _value: T) {}\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `true` because this is an `Ok`.\n   */\n  isOk(): this is Ok<T> {\n    return true;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `false` because this is an `Ok`.\n   */\n  isErr(): this is Err<never> {\n    return false;\n  }\n\n  /**\n   * Retrieves the value contained in this `Ok`.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrap(): T {\n    return this._value;\n  }\n\n  /**\n   * Returns the inner value. After an `isOk()` type guard, TypeScript narrows the return type to `T`.\n   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).\n   * @returns The value contained in this `Ok`.\n   */\n  value(): T {\n    return this._value;\n  }\n\n  /**\n   * Applies a transformation function to the value contained in this `Ok` and returns a new `Result` with the transformed value.\n   * @template U The type of the transformed value.\n   * @param fn The transformation function to apply to the value.\n   * @returns A new `Ok` containing the transformed value.\n   */\n  map<U>(fn: (value: T) => U): ResultDefinition<U, never> {\n    return new Ok(fn(this._value)) as unknown as ResultDefinition<U, never>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value contained in this `Ok`.\n   * @template U The type of the value in the resulting `Result`.\n   * @template E The type of the error in the resulting `Result`.\n   * @param fn The transformation function to apply to the value.\n   * @returns The result of applying the transformation function.\n   */\n  flatMap<U, E = never>(\n    fn: (value: T) => ResultDefinition<U, E>,\n  ): ResultDefinition<U, E> {\n    return fn(this._value);\n  }\n\n  /**\n   * Maps the error value (if any). Since this is an `Ok`, the error mapping function is ignored, and the original `Ok` is returned.\n   * @template U The type of the error (ignored for `Ok`). Can be any type.\n   * @param _fn The mapping function for errors (not used).\n   * @returns The original `Ok` instance.\n   */\n  mapErr<U>(_fn: (err: never) => U): ResultDefinition<T, U> {\n    return this as unknown as ResultDefinition<T, U>;\n  }\n\n  /**\n   * Retrieves the error contained in this result. Since this is an `Ok`, an error is thrown.\n   * @throws An error because `unwrapErr` is called on an `Ok`.\n   */\n  unwrapErr(): never {\n    throw new Error(\"Called unwrapErr on an Ok value\");\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise returns the provided default value.\n   * @template U The type of the default value.\n   * @param defaultValue The value to return if this is an `Err`.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrapOr<U>(defaultValue: U): T {\n    return this._value;\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.\n   * @template U The type of the default value.\n   * @param fn The function to compute the default value.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrapOrElse<U>(fn: (error: never) => U): T {\n    return this._value;\n  }\n\n  /**\n   * Returns this `Ok` if it is `Ok`, otherwise returns the result of the provided function.\n   * @template F The type of the alternative error.\n   * @param fn The function to compute the alternative result.\n   * @returns The original `Ok` instance.\n   */\n  orElse<F>(fn: (error: never) => ResultDefinition<T, F>): ResultDefinition<T, F> {\n    return this as unknown as ResultDefinition<T, F>;\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return Some(this._value);\n  }\n}\n","import {\n  Err as ErrType,\n  Ok as OkType,\n  type Result,\n} from \"./__internal__/return-types\";\n\n/**\n * Creates a new `Ok` instance, representing a successful result.\n * @template T The type of the value contained in the `Ok`.\n * @param value The value to wrap in the `Ok` instance.\n * @returns An `Ok` instance containing the given value.\n * @example\n * const result = Ok(42);\n * console.log(result.isOk()); // true\n * console.log(result.unwrap()); // 42\n */\nfunction Ok<T>(value: T): OkType<T> {\n  return new OkType(value);\n}\n\n/**\n * Creates an Err - strings are converted to Error, everything else preserved\n */\nfunction Err<E>(error: E): ErrType<E> {\n  return new ErrType(error);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Ok = Ok;\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Err = Err;\n\nexport { Err, Ok, Result, ErrType, OkType };\n"]}

package/dist/result/result.cjs

@@ -1,19 +1,14 @@
 'use strict';
 
 // src/result/__internal__/return-types/err.ts
-var Err = class _Err extends Error {
+var Err = class _Err {
   error;
   /**
    * Creates a new `Err` instance with the given error value.
-   * @param error The error to wrap in the `Err` instance.
+   * @param error The error to wrap in the `Err` instance. Can be any type.
    */
   constructor(error) {
-    super(typeof error === "string" ? error : error.message);
-    this.error = typeof error === "string" ? new Error(error) : error;
-    Object.setPrototypeOf(this, _Err.prototype);
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, _Err);
-    }
+    this.error = error;
   }
   /**
    * Checks if this result is an `Ok`.
@@ -47,7 +42,7 @@ var Err = class _Err extends Error {
   }
   /**
    * Maps the error value using a transformation function and returns a new `Result` with the transformed error.
-   * @template U The type of the transformed error.
+   * @template U The type of the transformed error. Can be any type.
    * @param fn The transformation function to apply to the error value.
    * @returns A new `Err` containing the transformed error.
    */
@@ -57,8 +52,9 @@ var Err = class _Err extends Error {
   /**
    * Applies a transformation function that returns a `Result` to the value (which does not exist) of this `Err`.
    * @template U The type of the value in the resulting `Result`.
+   * @template F The type of the error in the resulting `Result`.
    * @param _fn The transformation function (ignored in this implementation).
-   * @returns The original `Err` instance.
+   * @returns The original `Err` instance cast to the new error type.
    */
   flatMap(_fn) {
     return this;
@@ -70,6 +66,42 @@ var Err = class _Err extends Error {
   unwrapErr() {
     return this.error;
   }
+  /**
+   * Returns the inner error. After an `isErr()` type guard, TypeScript narrows the return type to `E`.
+   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).
+   * @returns The error value contained in this `Err`.
+   */
+  value() {
+    return this.error;
+  }
+  /**
+   * Returns the contained value if `Ok`, otherwise returns the provided default value.
+   * @template U The type of the default value.
+   * @param defaultValue The value to return since this is an `Err`.
+   * @returns The provided default value.
+   */
+  unwrapOr(defaultValue) {
+    return defaultValue;
+  }
+  /**
+   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.
+   * @template U The type of the default value.
+   * @param fn The function to compute the default value.
+   * @returns The result of calling the provided function with the error.
+   */
+  unwrapOrElse(fn) {
+    return fn(this.error);
+  }
+  /**
+   * Returns this `Err` if it is `Err`, otherwise returns the result of the provided function.
+   * @template T The type of the alternative success value.
+   * @template F The type of the alternative error.
+   * @param fn The function to compute the alternative result.
+   * @returns The result of calling the provided function with the error.
+   */
+  orElse(fn) {
+    return fn(this.error);
+  }
   /**
    * Converts `Result` type to `Option` type.
    * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.
@@ -83,10 +115,10 @@ var Err = class _Err extends Error {
 var Ok = class _Ok {
   /**
    * Creates a new `Ok` instance with the given value.
-   * @param value The value to wrap in the `Ok` instance.
+   * @param _value The value to wrap in the `Ok` instance.
    */
-  constructor(value) {
-    this.value = value;
+  constructor(_value) {
+    this._value = _value;
   }
   /**
    * Checks if this result is an `Ok`.
@@ -107,7 +139,15 @@ var Ok = class _Ok {
    * @returns The value contained in this `Ok`.
    */
   unwrap() {
-    return this.value;
+    return this._value;
+  }
+  /**
+   * Returns the inner value. After an `isOk()` type guard, TypeScript narrows the return type to `T`.
+   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).
+   * @returns The value contained in this `Ok`.
+   */
+  value() {
+    return this._value;
   }
   /**
    * Applies a transformation function to the value contained in this `Ok` and returns a new `Result` with the transformed value.
@@ -116,25 +156,24 @@ var Ok = class _Ok {
    * @returns A new `Ok` containing the transformed value.
    */
   map(fn) {
-    return new _Ok(fn(this.value));
+    return new _Ok(fn(this._value));
   }
   /**
    * Applies a transformation function that returns a `Result` to the value contained in this `Ok`.
    * @template U The type of the value in the resulting `Result`.
+   * @template E The type of the error in the resulting `Result`.
    * @param fn The transformation function to apply to the value.
    * @returns The result of applying the transformation function.
    */
   flatMap(fn) {
-    return fn(this.value);
+    return fn(this._value);
   }
   /**
    * Maps the error value (if any). Since this is an `Ok`, the error mapping function is ignored, and the original `Ok` is returned.
-   * @template U The type of the error (ignored for `Ok`).
+   * @template U The type of the error (ignored for `Ok`). Can be any type.
    * @param _fn The mapping function for errors (not used).
    * @returns The original `Ok` instance.
    */
-  // mapErr<U extends Error | string>(fn: (err: U) => U): Result<T, never> {
-  // 	return this;
   mapErr(_fn) {
     return this;
   }
@@ -145,15 +184,39 @@ var Ok = class _Ok {
   unwrapErr() {
     throw new Error("Called unwrapErr on an Ok value");
   }
+  /**
+   * Returns the contained value if `Ok`, otherwise returns the provided default value.
+   * @template U The type of the default value.
+   * @param defaultValue The value to return if this is an `Err`.
+   * @returns The value contained in this `Ok`.
+   */
+  unwrapOr(defaultValue) {
+    return this._value;
+  }
+  /**
+   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.
+   * @template U The type of the default value.
+   * @param fn The function to compute the default value.
+   * @returns The value contained in this `Ok`.
+   */
+  unwrapOrElse(fn) {
+    return this._value;
+  }
+  /**
+   * Returns this `Ok` if it is `Ok`, otherwise returns the result of the provided function.
+   * @template F The type of the alternative error.
+   * @param fn The function to compute the alternative result.
+   * @returns The original `Ok` instance.
+   */
+  orElse(fn) {
+    return this;
+  }
   /**
    * Converts `Result` type to `Option` type.
    * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.
    */
   ok() {
-    return match(this, {
-      Ok: (v) => Some(v),
-      Err: (_) => None()
-    });
+    return Some(this._value);
   }
 };
 
@@ -166,5 +229,10 @@ function Err2(error) {
 }
 global.Ok = Ok2;
 global.Err = Err2;
+
+exports.Err = Err2;
+exports.ErrType = Err;
+exports.Ok = Ok2;
+exports.OkType = Ok;
 //# sourceMappingURL=result.cjs.map
 //# sourceMappingURL=result.cjs.map

package/dist/result/result.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/result/__internal__/return-types/err.ts","../../src/result/__internal__/return-types/ok.ts","../../src/result/result.ts"],"names":["Ok","Err"],"mappings":";;;AAOO,IAAM,GAAA,GAAN,MAAM,IAAA,SACH,KAEV,CAAA;AAAA,EACU,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKR,YAAY,KAAmB,EAAA;AAC7B,IAAA,KAAA,CAAM,OAAO,KAAA,KAAU,QAAW,GAAA,KAAA,GAAQ,MAAM,OAAO,CAAA;AACvD,IAAA,IAAA,CAAK,QACH,OAAO,KAAA,KAAU,WAAY,IAAI,KAAA,CAAM,KAAK,CAAW,GAAA,KAAA;AACzD,IAAO,MAAA,CAAA,cAAA,CAAe,IAAM,EAAA,IAAA,CAAI,SAAS,CAAA;AAEzC,IAAA,IAAI,MAAM,iBAAmB,EAAA;AAC3B,MAAM,KAAA,CAAA,iBAAA,CAAkB,MAAM,IAAG,CAAA;AAAA;AACnC;AACF;AAAA;AAAA;AAAA;AAAA,EAMA,IAA0B,GAAA;AACxB,IAAO,OAAA,KAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA,EAMA,KAAkD,GAAA;AAChD,IAAO,OAAA,IAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,GAAA;AACd,IAAM,MAAA,IAAI,MAAM,+BAA+B,CAAA;AAAA;AACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAO,GAAsD,EAAA;AAC3D,IAAO,OAAA,IAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAwB,EAA+C,EAAA;AACrE,IAAA,OAAO,IAAI,IAAA,CAAO,EAAG,CAAA,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA;AAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QACE,GAC4B,EAAA;AAC5B,IAAO,OAAA,IAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA,EAMA,SAAe,GAAA;AACb,IAAA,OAAO,IAAK,CAAA,KAAA;AAAA;AACd;AAAA;AAAA;AAAA;AAAA,EAMA,EAAK,GAAA;AACH,IAAA,OAAO,IAAK,EAAA;AAAA;AAEhB,CAAA;;;AC3FO,IAAM,EAAA,GAAN,MAAM,GAA4C,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKvD,YAAoB,KAAU,EAAA;AAAV,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAAA;AAAW;AAAA;AAAA;AAAA;AAAA,EAK/B,IAAsB,GAAA;AACpB,IAAO,OAAA,IAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA,EAMA,KAA4B,GAAA;AAC1B,IAAO,OAAA,KAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA,EAMA,MAAY,GAAA;AACV,IAAA,OAAO,IAAK,CAAA,KAAA;AAAA;AACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAO,EAAiD,EAAA;AACtD,IAAA,OAAO,IAAI,GAAA,CAAG,EAAG,CAAA,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA;AAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QACE,EAC4B,EAAA;AAC5B,IAAO,OAAA,EAAA,CAAG,KAAK,KAAK,CAAA;AAAA;AACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAwB,GAAgD,EAAA;AACtE,IAAO,OAAA,IAAA;AAAA;AACT;AAAA;AAAA;AAAA;AAAA,EAMA,SAAmB,GAAA;AACjB,IAAM,MAAA,IAAI,MAAM,iCAAiC,CAAA;AAAA;AACnD;AAAA;AAAA;AAAA;AAAA,EAMA,EAAK,GAAA;AACH,IAAA,OAAO,MAAM,IAAM,EAAA;AAAA,MACjB,EAAI,EAAA,CAAC,CAAM,KAAA,IAAA,CAAK,CAAC,CAAA;AAAA,MACjB,GAAA,EAAK,CAAC,CAAA,KAAM,IAAK;AAAA,KAClB,CAAA;AAAA;AAEL,CAAA;;;ACzEA,SAASA,IAAM,KAAqB,EAAA;AAClC,EAAO,OAAA,IAAI,GAAO,KAAK,CAAA;AACzB;AAYA,SAASC,KAAqB,KAA+B,EAAA;AAC3D,EAAO,OAAA,IAAI,IAAQ,KAAK,CAAA;AAC1B;AAGC,MAAA,CAAe,EAAKD,GAAAA,GAAAA;AAEpB,MAAA,CAAe,GAAMC,GAAAA,IAAAA","file":"result.cjs","sourcesContent":["import type { Ok } from \"./ok\";\nimport type { ResultDefinition } from \"./result\";\n\n/**\n * Represents a failed result (`Err`) that contains an error value.\n * @template E The type of the error contained in this `Err`.\n */\nexport class Err<E extends Error>\n  extends Error\n  implements ResultDefinition<never, E>\n{\n  private error: E;\n  /**\n   * Creates a new `Err` instance with the given error value.\n   * @param error The error to wrap in the `Err` instance.\n   */\n  constructor(error: E | string) {\n    super(typeof error === \"string\" ? error : error.message);\n    this.error =\n      typeof error === \"string\" ? (new Error(error) as E) : (error as E);\n    Object.setPrototypeOf(this, Err.prototype);\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, Err);\n    }\n  }\n\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `false` because this is an `Err`.\n   */\n  isOk(): this is Ok<never> {\n    return false;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `true` because this is an `Err`.\n   */\n  isErr(): this is Err<E extends Error ? E : Error> {\n    return true;\n  }\n\n  /**\n   * Retrieves the value contained in this result. Since this is an `Err`, an error is thrown.\n   * @throws An error because `unwrap` is called on an `Err`.\n   */\n  unwrap(): never {\n    throw new Error(\"Called unwrap on an Err value\");\n  }\n\n  /**\n   * Maps the value (if any). Since this is an `Err`, the mapping function is ignored, and the original `Err` is returned.\n   * @template U The type of the value (ignored for `Err`).\n   * @param _fn The mapping function for values (not used).\n   * @returns The original `Err` instance.\n   */\n  map<U>(_fn: (value: never) => U): ResultDefinition<never, E> {\n    return this as unknown as ResultDefinition<never, E>;\n  }\n\n  /**\n   * Maps the error value using a transformation function and returns a new `Result` with the transformed error.\n   * @template U The type of the transformed error.\n   * @param fn The transformation function to apply to the error value.\n   * @returns A new `Err` containing the transformed error.\n   */\n  mapErr<U extends Error>(fn: (err: E) => U): ResultDefinition<never, U> {\n    return new Err<U>(fn(this.error)) as unknown as ResultDefinition<never, U>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value (which does not exist) of this `Err`.\n   * @template U The type of the value in the resulting `Result`.\n   * @param _fn The transformation function (ignored in this implementation).\n   * @returns The original `Err` instance.\n   */\n  flatMap<U>(\n    _fn: (value: never) => ResultDefinition<U, never>,\n  ): ResultDefinition<never, E> {\n    return this as unknown as ResultDefinition<never, E>;\n  }\n\n  /**\n   * Retrieves the error value contained in this `Err`.\n   * @returns The error value contained in this `Err`.\n   */\n  unwrapErr(): E {\n    return this.error;\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return None();\n  }\n}\n","import type { ResultDefinition } from \"./result\";\nimport type { Err } from \"./err\";\n\n/**\n * Represents a successful result (`Ok`) that contains a value.\n * @template T The type of the value contained in this `Ok`.\n */\nexport class Ok<T> implements ResultDefinition<T, never> {\n  /**\n   * Creates a new `Ok` instance with the given value.\n   * @param value The value to wrap in the `Ok` instance.\n   */\n  constructor(private value: T) {}\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `true` because this is an `Ok`.\n   */\n  isOk(): this is Ok<T> {\n    return true;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `false` because this is an `Ok`.\n   */\n  isErr(): this is Err<never> {\n    return false;\n  }\n\n  /**\n   * Retrieves the value contained in this `Ok`.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrap(): T {\n    return this.value;\n  }\n\n  /**\n   * Applies a transformation function to the value contained in this `Ok` and returns a new `Result` with the transformed value.\n   * @template U The type of the transformed value.\n   * @param fn The transformation function to apply to the value.\n   * @returns A new `Ok` containing the transformed value.\n   */\n  map<U>(fn: (value: T) => U): ResultDefinition<U, never> {\n    return new Ok(fn(this.value)) as ResultDefinition<U, never>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value contained in this `Ok`.\n   * @template U The type of the value in the resulting `Result`.\n   * @param fn The transformation function to apply to the value.\n   * @returns The result of applying the transformation function.\n   */\n  flatMap<U>(\n    fn: (value: T) => ResultDefinition<U, never>,\n  ): ResultDefinition<U, never> {\n    return fn(this.value);\n  }\n\n  /**\n   * Maps the error value (if any). Since this is an `Ok`, the error mapping function is ignored, and the original `Ok` is returned.\n   * @template U The type of the error (ignored for `Ok`).\n   * @param _fn The mapping function for errors (not used).\n   * @returns The original `Ok` instance.\n   */\n  // mapErr<U extends Error | string>(fn: (err: U) => U): Result<T, never> {\n  // \treturn this;\n  mapErr<U extends Error>(_fn: (err: never) => U): ResultDefinition<T, U> {\n    return this as unknown as ResultDefinition<T, U>;\n  }\n\n  /**\n   * Retrieves the error contained in this result. Since this is an `Ok`, an error is thrown.\n   * @throws An error because `unwrapErr` is called on an `Ok`.\n   */\n  unwrapErr(): never {\n    throw new Error(\"Called unwrapErr on an Ok value\");\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return match(this, {\n      Ok: (v) => Some(v),\n      Err: (_) => None(),\n    });\n  }\n}\n","import {\n  Err as ErrType,\n  Ok as OkType,\n  type Result,\n} from \"./__internal__/return-types\";\n\n/**\n * Creates a new `Ok` instance, representing a successful result.\n * @template T The type of the value contained in the `Ok`.\n * @param value The value to wrap in the `Ok` instance.\n * @returns An `Ok` instance containing the given value.\n * @example\n * const result = Ok(42);\n * console.log(result.isOk()); // true\n * console.log(result.unwrap()); // 42\n */\nfunction Ok<T>(value: T): OkType<T> {\n  return new OkType(value);\n}\n\n/**\n * Creates a new `Err` instance, representing a failed result.\n * @template E The type of the error contained in the `Err`.\n * @param error The error to wrap in the `Err` instance.\n * @returns An `Err` instance containing the given error.\n * @example\n * const result = Err(\"Something went wrong\");\n * console.log(result.isErr()); // true\n * console.log(result.unwrapErr()); // \"Something went wrong\"\n */\nfunction Err<E extends Error>(error: E | string): ErrType<E> {\n  return new ErrType(error);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Ok = Ok;\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Err = Err;\n\nexport type { Err, Ok, Result, ErrType, OkType };\n"]}
+{"version":3,"sources":["../../src/result/__internal__/return-types/err.ts","../../src/result/__internal__/return-types/ok.ts","../../src/result/result.ts"],"names":["Ok","Err"],"mappings":"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","file":"result.cjs","sourcesContent":["import type { Ok } from \"./ok\";\nimport type { ResultDefinition } from \"./result\";\n\n/**\n * Represents a failed result (`Err`) that contains an error value.\n * @template E The type of the error contained in this `Err`. Can be any type (Error, string, enum, etc).\n */\nexport class Err<E> implements ResultDefinition<never, E> {\n  private error: E;\n  /**\n   * Creates a new `Err` instance with the given error value.\n   * @param error The error to wrap in the `Err` instance. Can be any type.\n   */\n  constructor(error: E) {\n    // Store error as-is - conversion is handled by factory function\n    this.error = error;\n    // Object.setPrototypeOf(this, Err.prototype);\n    //\n    // if (Error.captureStackTrace) {\n    //   Error.captureStackTrace(this, Err);\n    // }\n  }\n\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `false` because this is an `Err`.\n   */\n  isOk(): this is Ok<never> {\n    return false;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `true` because this is an `Err`.\n   */\n  isErr(): this is Err<E> {\n    return true;\n  }\n\n  /**\n   * Retrieves the value contained in this result. Since this is an `Err`, an error is thrown.\n   * @throws An error because `unwrap` is called on an `Err`.\n   */\n  unwrap(): never {\n    throw new Error(\"Called unwrap on an Err value\");\n  }\n\n  /**\n   * Maps the value (if any). Since this is an `Err`, the mapping function is ignored, and the original `Err` is returned.\n   * @template U The type of the value (ignored for `Err`).\n   * @param _fn The mapping function for values (not used).\n   * @returns The original `Err` instance.\n   */\n  map<U>(_fn: (value: never) => U): ResultDefinition<never, E> {\n    return this as unknown as ResultDefinition<never, E>;\n  }\n\n  /**\n   * Maps the error value using a transformation function and returns a new `Result` with the transformed error.\n   * @template U The type of the transformed error. Can be any type.\n   * @param fn The transformation function to apply to the error value.\n   * @returns A new `Err` containing the transformed error.\n   */\n  mapErr<U>(fn: (err: E) => U): ResultDefinition<never, U> {\n    return new Err<U>(fn(this.error)) as unknown as ResultDefinition<never, U>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value (which does not exist) of this `Err`.\n   * @template U The type of the value in the resulting `Result`.\n   * @template F The type of the error in the resulting `Result`.\n   * @param _fn The transformation function (ignored in this implementation).\n   * @returns The original `Err` instance cast to the new error type.\n   */\n  flatMap<U, F = E>(\n    _fn: (value: never) => ResultDefinition<U, F>,\n  ): ResultDefinition<U, E> {\n    return this as unknown as ResultDefinition<U, E>;\n  }\n\n  /**\n   * Retrieves the error value contained in this `Err`.\n   * @returns The error value contained in this `Err`.\n   */\n  unwrapErr(): E {\n    return this.error;\n  }\n\n  /**\n   * Returns the inner error. After an `isErr()` type guard, TypeScript narrows the return type to `E`.\n   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).\n   * @returns The error value contained in this `Err`.\n   */\n  value(): E {\n    return this.error;\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise returns the provided default value.\n   * @template U The type of the default value.\n   * @param defaultValue The value to return since this is an `Err`.\n   * @returns The provided default value.\n   */\n  unwrapOr<U>(defaultValue: U): U {\n    return defaultValue;\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.\n   * @template U The type of the default value.\n   * @param fn The function to compute the default value.\n   * @returns The result of calling the provided function with the error.\n   */\n  unwrapOrElse<U>(fn: (error: E) => U): U {\n    return fn(this.error);\n  }\n\n  /**\n   * Returns this `Err` if it is `Err`, otherwise returns the result of the provided function.\n   * @template T The type of the alternative success value.\n   * @template F The type of the alternative error.\n   * @param fn The function to compute the alternative result.\n   * @returns The result of calling the provided function with the error.\n   */\n  orElse<T, F>(\n    fn: (error: E) => ResultDefinition<T, F>,\n  ): ResultDefinition<T, F> {\n    return fn(this.error);\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return None();\n  }\n}\n","import type { ResultDefinition } from \"./result\";\nimport type { Err } from \"./err\";\n\n/**\n * Represents a successful result (`Ok`) that contains a value.\n * @template T The type of the value contained in this `Ok`.\n */\nexport class Ok<T> implements ResultDefinition<T, never> {\n  /**\n   * Creates a new `Ok` instance with the given value.\n   * @param _value The value to wrap in the `Ok` instance.\n   */\n  constructor(private _value: T) {}\n  /**\n   * Checks if this result is an `Ok`.\n   * @returns `true` because this is an `Ok`.\n   */\n  isOk(): this is Ok<T> {\n    return true;\n  }\n\n  /**\n   * Checks if this result is an `Err`.\n   * @returns `false` because this is an `Ok`.\n   */\n  isErr(): this is Err<never> {\n    return false;\n  }\n\n  /**\n   * Retrieves the value contained in this `Ok`.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrap(): T {\n    return this._value;\n  }\n\n  /**\n   * Returns the inner value. After an `isOk()` type guard, TypeScript narrows the return type to `T`.\n   * Without a type guard, returns `T | E` (use `isOk()` or `isErr()` for type narrowing).\n   * @returns The value contained in this `Ok`.\n   */\n  value(): T {\n    return this._value;\n  }\n\n  /**\n   * Applies a transformation function to the value contained in this `Ok` and returns a new `Result` with the transformed value.\n   * @template U The type of the transformed value.\n   * @param fn The transformation function to apply to the value.\n   * @returns A new `Ok` containing the transformed value.\n   */\n  map<U>(fn: (value: T) => U): ResultDefinition<U, never> {\n    return new Ok(fn(this._value)) as unknown as ResultDefinition<U, never>;\n  }\n\n  /**\n   * Applies a transformation function that returns a `Result` to the value contained in this `Ok`.\n   * @template U The type of the value in the resulting `Result`.\n   * @template E The type of the error in the resulting `Result`.\n   * @param fn The transformation function to apply to the value.\n   * @returns The result of applying the transformation function.\n   */\n  flatMap<U, E = never>(\n    fn: (value: T) => ResultDefinition<U, E>,\n  ): ResultDefinition<U, E> {\n    return fn(this._value);\n  }\n\n  /**\n   * Maps the error value (if any). Since this is an `Ok`, the error mapping function is ignored, and the original `Ok` is returned.\n   * @template U The type of the error (ignored for `Ok`). Can be any type.\n   * @param _fn The mapping function for errors (not used).\n   * @returns The original `Ok` instance.\n   */\n  mapErr<U>(_fn: (err: never) => U): ResultDefinition<T, U> {\n    return this as unknown as ResultDefinition<T, U>;\n  }\n\n  /**\n   * Retrieves the error contained in this result. Since this is an `Ok`, an error is thrown.\n   * @throws An error because `unwrapErr` is called on an `Ok`.\n   */\n  unwrapErr(): never {\n    throw new Error(\"Called unwrapErr on an Ok value\");\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise returns the provided default value.\n   * @template U The type of the default value.\n   * @param defaultValue The value to return if this is an `Err`.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrapOr<U>(defaultValue: U): T {\n    return this._value;\n  }\n\n  /**\n   * Returns the contained value if `Ok`, otherwise computes and returns the result of the provided function.\n   * @template U The type of the default value.\n   * @param fn The function to compute the default value.\n   * @returns The value contained in this `Ok`.\n   */\n  unwrapOrElse<U>(fn: (error: never) => U): T {\n    return this._value;\n  }\n\n  /**\n   * Returns this `Ok` if it is `Ok`, otherwise returns the result of the provided function.\n   * @template F The type of the alternative error.\n   * @param fn The function to compute the alternative result.\n   * @returns The original `Ok` instance.\n   */\n  orElse<F>(fn: (error: never) => ResultDefinition<T, F>): ResultDefinition<T, F> {\n    return this as unknown as ResultDefinition<T, F>;\n  }\n\n  /**\n   * Converts `Result` type to `Option` type.\n   * @returns `Some` if the result is `Ok`, `None` if the result is `Err`.\n   */\n  ok() {\n    return Some(this._value);\n  }\n}\n","import {\n  Err as ErrType,\n  Ok as OkType,\n  type Result,\n} from \"./__internal__/return-types\";\n\n/**\n * Creates a new `Ok` instance, representing a successful result.\n * @template T The type of the value contained in the `Ok`.\n * @param value The value to wrap in the `Ok` instance.\n * @returns An `Ok` instance containing the given value.\n * @example\n * const result = Ok(42);\n * console.log(result.isOk()); // true\n * console.log(result.unwrap()); // 42\n */\nfunction Ok<T>(value: T): OkType<T> {\n  return new OkType(value);\n}\n\n/**\n * Creates an Err - strings are converted to Error, everything else preserved\n */\nfunction Err<E>(error: E): ErrType<E> {\n  return new ErrType(error);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Ok = Ok;\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\n(global as any).Err = Err;\n\nexport { Err, Ok, Result, ErrType, OkType };\n"]}

package/dist/result/result.d.cts

@@ -1,6 +1,5 @@
-import { E as Err$1, O as Ok$1 } from '../types/globals.cjs';
-export { R as Result } from '../types/globals.cjs';
-import '../option-DpT8KCGE.cjs';
+import { E as Err$1, a as Ok$1 } from '../option-B_KKIecf.cjs';
+export { R as Result } from '../option-B_KKIecf.cjs';
 
 /**
  * Creates a new `Ok` instance, representing a successful result.
@@ -14,15 +13,8 @@ import '../option-DpT8KCGE.cjs';
  */
 declare function Ok<T>(value: T): Ok$1<T>;
 /**
- * Creates a new `Err` instance, representing a failed result.
- * @template E The type of the error contained in the `Err`.
- * @param error The error to wrap in the `Err` instance.
- * @returns An `Err` instance containing the given error.
- * @example
- * const result = Err("Something went wrong");
- * console.log(result.isErr()); // true
- * console.log(result.unwrapErr()); // "Something went wrong"
+ * Creates an Err - strings are converted to Error, everything else preserved
  */
-declare function Err<E extends Error>(error: E | string): Err$1<E>;
+declare function Err<E>(error: E): Err$1<E>;
 
 export { Err, Err$1 as ErrType, Ok, Ok$1 as OkType };

package/dist/result/result.d.ts

@@ -1,6 +1,5 @@
-import { E as Err$1, O as Ok$1 } from '../types/globals.js';
-export { R as Result } from '../types/globals.js';
-import '../option-DpT8KCGE.js';
+import { E as Err$1, a as Ok$1 } from '../option-B_KKIecf.js';
+export { R as Result } from '../option-B_KKIecf.js';
 
 /**
  * Creates a new `Ok` instance, representing a successful result.
@@ -14,15 +13,8 @@ import '../option-DpT8KCGE.js';
  */
 declare function Ok<T>(value: T): Ok$1<T>;
 /**
- * Creates a new `Err` instance, representing a failed result.
- * @template E The type of the error contained in the `Err`.
- * @param error The error to wrap in the `Err` instance.
- * @returns An `Err` instance containing the given error.
- * @example
- * const result = Err("Something went wrong");
- * console.log(result.isErr()); // true
- * console.log(result.unwrapErr()); // "Something went wrong"
+ * Creates an Err - strings are converted to Error, everything else preserved
  */
-declare function Err<E extends Error>(error: E | string): Err$1<E>;
+declare function Err<E>(error: E): Err$1<E>;
 
 export { Err, Err$1 as ErrType, Ok, Ok$1 as OkType };