@pvorona/failable 0.0.3 → 0.2.0

package/README.md

@@ -1,6 +1,8 @@
 # @pvorona/failable
 
-A typed result type for expected failures. `Failable<T, E>` is a discriminated union of `Success<T>` and `Failure<E>`, with ergonomic accessors and structured-clone support.
+Typed success/failure results for expected failures in TypeScript.
+
+`Failable<T, E>` is a discriminated union of `Success<T>` and `Failure<E>`. In the common case, you model the return type explicitly, construct with `success(...)` / `failure(...)`, and branch with `isSuccess(...)` / `isFailure(...)` or the `isSuccess` / `isError` flags.
 
 ## Install
 
@@ -8,326 +10,187 @@ A typed result type for expected failures. `Failable<T, E>` is a discriminated u
 npm i @pvorona/failable
 ```
 
-## Usage
+## Quick start
 
 ```ts
-import { Failable } from '@pvorona/failable';
+import type { Failable } from '@pvorona/failable';
+import { failure, isFailure, success } from '@pvorona/failable';
 
-const result = Failable.from(() => JSON.parse(text));
+function divide(a: number, b: number): Failable<number, string> {
+  if (b === 0) return failure('Cannot divide by zero');
 
-if (result.isSuccess) {
-  console.log(result.data);
-} else {
-  console.error(result.error);
+  return success(a / b);
 }
-```
-
-### Factories
-
-```ts
-import { Failable } from '@pvorona/failable';
-
-const success = Failable.ofSuccess(42);
-const failure = Failable.ofError(new Error('boom'));
-```
-
-### Fallbacks
-
-```ts
-import { Failable } from '@pvorona/failable';
-
-const failure = Failable.ofError(new Error('boom'));
-
-const value = failure.getOr('default'); // 'default'
-const recovered = failure.or('fallback'); // Success<'fallback'>
-```
-
-### Wrapping async work
-
-```ts
-import { Failable } from '@pvorona/failable';
-
-const result = await Failable.from(fetch('/api'));
-```
-
-### Structured-clone transport
-
-`Failable` instances use Symbols and prototype methods that do not survive structured cloning (`postMessage`, `chrome.runtime.sendMessage`, etc.). Convert to a plain object first:
-
-```ts
-import { Failable } from '@pvorona/failable';
-
-// sender
-const wire = Failable.toFailableLike(result);
-postMessage(wire);
-
-// receiver
-const hydrated = Failable.from(wire);
-```
-
-## API
-
-### `const enum FailableStatus`
 
-The discriminant for `FailableLike` and `Failable` instances.
+const result = divide(10, 2);
 
-```ts
-export const enum FailableStatus {
-  Success = 'success',
-  Failure = 'failure',
+if (isFailure(result)) {
+  console.error(result.error);
+} else {
+  console.log(result.data);
 }
 ```
 
-Example:
-
-```ts
-import { FailableStatus, type FailableLike } from '@pvorona/failable';
-
-const ok: FailableLike<number, string> = {
-  status: FailableStatus.Success,
-  data: 1,
-};
-```
+## Core API
 
 ### `type Failable<T, E>`
 
 Alias for `Success<T> | Failure<E>`.
 
-Example:
-
-```ts
-import type { Failable } from '@pvorona/failable';
-import { Failable as FailableNS } from '@pvorona/failable';
-
-export function parseIntSafe(input: string): Failable<number, Error> {
-  const n = Number(input);
-  if (!Number.isInteger(n)) return FailableNS.ofError(new Error('Not an int'));
-
-  return FailableNS.ofSuccess(n);
-}
-```
-
-### `type Success<T>`
+### `success(data)` and `failure(error)`
 
-The success variant.
-
-Key fields/methods:
-
-- `status: 'success'`, `isSuccess: true`, `isError: false`
-- `data: T`, `error: null`
-- `or(value)` returns itself
-- `getOr(_)` returns `data`
-- `getOrThrow()` returns `data`
-
-Example:
+Use these when you already know whether you are returning success or failure:
 
 ```ts
-import { Failable } from '@pvorona/failable';
+import { failure, success } from '@pvorona/failable';
 
-const s = Failable.ofSuccess(123);
-s.getOr(0); // 123
-s.or('x'); // Success<number>
+const ok = success({ id: '1' });
+const err = failure({ code: 'bad_request' });
 ```
 
-### `type Failure<E>`
+### `isSuccess(...)` and `isFailure(...)`
 
-The failure variant.
-
-Key fields/methods:
-
-- `status: 'failure'`, `isSuccess: false`, `isError: true`
-- `error: E`, `data: null`
-- `or(value)` converts to `Success<typeof value>`
-- `getOr(fallback)` returns `fallback`
-- `getOrThrow()` throws `error`
-
-Example:
+Use the guards or the instance booleans (`result.isSuccess` / `result.isError`) to branch:
 
 ```ts
-import { Failable } from '@pvorona/failable';
-
-const f = Failable.ofError(new Error('boom'));
-f.getOr('default'); // 'default'
-f.or(42).data; // 42
-```
-
-### `type FailableLike<T, E>`
-
-Structured-clone-friendly representation of a result:
+import { failure, isSuccess, success } from '@pvorona/failable';
 
-- `{ status: 'success', data }`
-- `{ status: 'failure', error }`
+const result = Math.random() > 0.5 ? success(123) : failure('boom');
 
-Example:
-
-```ts
-import type { FailableLike } from '@pvorona/failable';
-
-type Wire = FailableLike<{ id: string }, { code: string }>;
+if (isSuccess(result)) {
+  console.log(result.data);
+} else {
+  console.error(result.error);
+}
 ```
 
-### `type FailableLikeSuccess<T>`
-
-The success-shaped `FailableLike`.
-
-Example:
-
-```ts
-import { FailableStatus, type FailableLikeSuccess } from '@pvorona/failable';
-
-const wireOk: FailableLikeSuccess<number> = {
-  status: FailableStatus.Success,
-  data: 1,
-};
-```
+### `createFailable(...)`
 
-### `type FailableLikeFailure<E>`
+`createFailable(...)` is a convenience wrapper when you want to capture thrown or rejected values:
 
-The failure-shaped `FailableLike`.
+- `createFailable(failable)` returns the same instance
+- `createFailable(failableLike)` rehydrates into a real `Success` / `Failure`
+- `createFailable(() => value)` captures sync throws into `Failure`
+- `createFailable(promise)` captures promise rejections into `Failure`
 
 Example:
 
 ```ts
-import { FailableStatus, type FailableLikeFailure } from '@pvorona/failable';
-
-const wireErr: FailableLikeFailure<string> = {
-  status: FailableStatus.Failure,
-  error: 'bad_request',
-};
-```
-
-### `FailableTag`, `SuccessTag`, `FailureTag` (Symbols)
+import { createFailable, isFailure } from '@pvorona/failable';
 
-Low-level Symbol tags used to mark hydrated `Failable` instances at runtime.
+const responseResult = await createFailable(fetch('https://example.com/items'));
 
-Most code should prefer `result.isSuccess` / `result.isError` or the guards `Failable.isSuccess(...)` / `Failable.isFailure(...)`.
-
-Example (advanced):
-
-```ts
-import { FailableTag } from '@pvorona/failable';
-
-export function isHydratedFailable(value: unknown): boolean {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    (value as any)[FailableTag] === true
-  );
+if (isFailure(responseResult)) {
+  console.error('Network failure:', responseResult.error);
+} else if (!responseResult.data.ok) {
+  console.error(`Unexpected status: ${responseResult.data.status}`);
+} else {
+  const text = await responseResult.data.text();
+  const parseResult = createFailable(() => JSON.parse(text));
+
+  if (isFailure(parseResult)) {
+    console.error('Invalid JSON:', parseResult.error);
+  } else {
+    console.log(parseResult.data);
+  }
 }
 ```
 
-### `const Failable`
+## Important semantics
 
-Namespace-style factory + utilities for producing and working with `Failable<T, E>`.
+- `createFailable(async () => value)` is a footgun. The async function itself is treated as a sync return value, so the result is `Success<Promise<T>>`. If you want rejection capture, pass the promise directly: `await createFailable(somePromise)`.
+- `or(...)` and `getOr(...)` are eager. The fallback expression runs before the method call.
+- `isFailableLike(...)` is intentionally strict. It only accepts exactly `{ status, data }` or `{ status, error }` with no extra enumerable keys.
+- By default, `createFailable(...)` preserves raw thrown and rejected values. If something throws `'boom'`, `{ code: 'bad_request' }`, or `[error1, error2]`, that exact value becomes `.error`.
+- `createFailable(input, NormalizedErrors)` converts non-`Error` failures into `Error` values:
+  - existing `Error` values pass through unchanged
+  - arrays become `AggregateError`
+  - other values become `Error`
+  - the original raw value is preserved in `error.cause`
+- `createFailable(input, { normalizeError })` lets you supply your own normalization strategy.
+- The library still uses private runtime tags internally for hydrated instances, but those details are not part of the public API.
+- This package is ESM-only. Use `import` syntax; there is no `require` export condition.
 
-#### `Failable.ofSuccess<T>(data: T): Success<T>`
+## Normalizing errors
 
-Example:
-
-```ts
-import { Failable } from '@pvorona/failable';
-
-const ok = Failable.ofSuccess({ id: '1' });
-```
-
-#### `Failable.ofError<E>(error: E): Failure<E>`
-
-Example:
+If you want `Error`-shaped handling at the boundary, opt in explicitly:
 
 ```ts
-import { Failable } from '@pvorona/failable';
+import {
+  createFailable,
+  isFailure,
+  NormalizedErrors,
+} from '@pvorona/failable';
 
-const err = Failable.ofError({ code: 'bad_request' });
-```
-
-#### `Failable.isFailable(value): value is Failable<unknown, unknown>`
-
-Checks whether a value is a hydrated `Failable` instance (Symbol-tagged).
-
-Example:
+const result = createFailable(
+  () => {
+    throw { code: 'bad_request' };
+  },
+  NormalizedErrors
+);
 
-```ts
-import { Failable } from '@pvorona/failable';
-
-const maybe: unknown = Failable.ofSuccess(1);
-if (Failable.isFailable(maybe)) {
-  // narrowed
+if (isFailure(result)) {
+  console.error(result.error.message);
+  console.error(result.error.cause); // { code: 'bad_request' }
 }
 ```
 
-#### `Failable.isSuccess(value): value is Success<unknown>`
-
-Example:
+For custom normalization:
 
 ```ts
-import { Failable } from '@pvorona/failable';
+import { createFailable } from '@pvorona/failable';
 
-const maybe: unknown = Failable.ofSuccess(1);
-if (Failable.isSuccess(maybe)) {
-  maybe.data; // ok
-}
+const result = createFailable(doThing, {
+  normalizeError(error) {
+    return error instanceof Error
+      ? error
+      : new Error('Operation failed', { cause: error });
+  },
+});
 ```
 
-#### `Failable.isFailure(value): value is Failure<unknown>`
+## Structured-clone transport
 
-Example:
+Hydrated `Failable` instances have methods and private runtime details that do not survive structured cloning (`postMessage`, `MessagePort`, extension messaging, etc.). Convert them to plain objects first:
 
 ```ts
-import { Failable } from '@pvorona/failable';
-
-const maybe: unknown = Failable.ofError('nope');
-if (Failable.isFailure(maybe)) {
-  console.log(maybe.error);
-}
-```
-
-#### `Failable.toFailableLike(result): FailableLike<...>`
+import { createFailable, toFailableLike } from '@pvorona/failable';
 
-Converts a hydrated `Failable` into a structured-clone-friendly representation.
-
-Example:
+const result = createFailable(() => JSON.parse('{"ok":true}'));
 
-```ts
-import { Failable } from '@pvorona/failable';
+// sender
+const wire = toFailableLike(result);
+postMessage(wire);
 
-const res = Failable.ofSuccess(1);
-const wire = Failable.toFailableLike(res);
+// receiver
+const hydrated = createFailable(wire);
 ```
 
-#### `Failable.isFailableLike(value): value is FailableLike<unknown, unknown>`
+The transport shape is:
 
-Strictly checks for `{ status, data }` or `{ status, error }` with no extra enumerable keys.
+- `FailableLikeSuccess<T>`: `{ status: FailableStatus.Success, data: T }`
+- `FailableLikeFailure<E>`: `{ status: FailableStatus.Failure, error: E }`
 
-Example:
+`FailableStatus` is a runtime object:
 
 ```ts
-import { Failable } from '@pvorona/failable';
+import { FailableStatus, type FailableLike } from '@pvorona/failable';
 
-const wire: unknown = { status: 'success', data: 1 };
-Failable.isFailableLike(wire); // true
+const wire: FailableLike<number, string> = {
+  status: FailableStatus.Success,
+  data: 1,
+};
 ```
 
-#### `Failable.from(...)`
+## API at a glance
 
-Overloads:
-
-- `from(failable)` → returns the same instance
-- `from(failableLike)` → rehydrates into a real `Success` / `Failure`
-- `from(() => value)` → captures throws into `Failure`
-- `from(promise)` → captures rejections into `Failure`
-
-Examples:
-
-```ts
-import { Failable } from '@pvorona/failable';
-
-// function wrapper (captures throws)
-const res1 = Failable.from(() => JSON.parse('{'));
-
-// promise wrapper (captures rejections)
-const res2 = await Failable.from(fetch('https://example.com'));
-
-// rehydrate from structured clone
-const wire = Failable.toFailableLike(Failable.ofError('bad'));
-const hydrated = Failable.from(wire);
-```
+- `type Failable<T, E>`: `Success<T> | Failure<E>`
+- `type Success<T>`: success variant with `data`, `or(...)`, `getOr(...)`, and `getOrThrow()`
+- `type Failure<E>`: failure variant with `error`, `or(...)`, `getOr(...)`, and `getOrThrow()`
+- `const FailableStatus`: runtime `{ Success, Failure }` object
+- `const NormalizedErrors`: built-in token for `Error` normalization
+- `success(data)` / `failure(error)`: explicit constructors
+- `isFailable(...)`, `isSuccess(...)`, `isFailure(...)`: runtime guards for hydrated values
+- `toFailableLike(...)`: convert a hydrated result into a structured-clone-friendly value
+- `isFailableLike(...)`: validate the strict structured-clone shape
+- `createFailable(...)`: wrap, rehydrate, or normalize results

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 export * from './lib/failable.js';
-export * from './lib/constants.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,80 +1,119 @@
-import { isObject as s, isFunction as l } from "@pvorona/assert";
-import { notImplemented as o } from "@pvorona/not-implemented";
-const i = /* @__PURE__ */ Symbol("Failable"), u = /* @__PURE__ */ Symbol("Success"), a = /* @__PURE__ */ Symbol("Failure");
-var b = /* @__PURE__ */ ((r) => (r.Success = "success", r.Failure = "failure", r))(b || {});
-function O(r) {
-  return s(r) && Object.keys(r).length === 2 && Object.getOwnPropertyDescriptor(r, "status")?.value === "success" && Object.prototype.hasOwnProperty.call(r, "data");
+import { isFunction as s, isObject as i } from "@pvorona/assert";
+import { notImplemented as f } from "@pvorona/not-implemented";
+const E = /* @__PURE__ */ Symbol("Failable"), g = /* @__PURE__ */ Symbol("Success"), h = /* @__PURE__ */ Symbol("Failure"), n = Object.freeze({
+  Success: "success",
+  Failure: "failure"
+}), d = Object.freeze({
+  mode: "normalized-errors"
+});
+function j(r) {
+  return i(r) && Object.keys(r).length === 2 && Object.getOwnPropertyDescriptor(r, "status")?.value === n.Success && Object.prototype.hasOwnProperty.call(r, "data");
 }
-function F(r) {
-  return s(r) && Object.keys(r).length === 2 && Object.getOwnPropertyDescriptor(r, "status")?.value === "failure" && Object.prototype.hasOwnProperty.call(r, "error");
+function m(r) {
+  return i(r) && Object.keys(r).length === 2 && Object.getOwnPropertyDescriptor(r, "status")?.value === n.Failure && Object.prototype.hasOwnProperty.call(r, "error");
+}
+function a(r) {
+  return m(r) || j(r);
 }
-const f = {
-  [i]: !0,
+const b = {
+  [E]: !0,
   isSuccess: !1,
   isError: !1,
   data: null,
   error: null,
-  or: o,
-  getOr: o,
-  getOrThrow: o
-}, S = (() => {
-  const r = Object.create(f);
-  return r[u] = !0, r.status = "success", r.isSuccess = !0, r.or = function() {
+  or: f,
+  getOr: f,
+  getOrThrow: f
+}, w = (() => {
+  const r = Object.create(b);
+  return r[g] = !0, r.status = n.Success, r.isSuccess = !0, r.or = function() {
     return this;
   }, r.getOr = function() {
     return this.data;
   }, r.getOrThrow = function() {
     return this.data;
   }, Object.freeze(r);
-})(), g = (() => {
-  const r = Object.create(f);
-  return r[a] = !0, r.status = "failure", r.isError = !0, r.or = function(c) {
-    return t.ofSuccess(c);
-  }, r.getOr = function(c) {
-    return c;
+})(), y = (() => {
+  const r = Object.create(b);
+  return r[h] = !0, r.status = n.Failure, r.isError = !0, r.or = function(t) {
+    return c(t);
+  }, r.getOr = function(t) {
+    return t;
   }, r.getOrThrow = function() {
     throw this.error;
   }, Object.freeze(r);
-})(), t = {
-  isFailable: (r) => s(r) && r[i] === !0,
-  isSuccess: (r) => s(r) && r[u] === !0,
-  isFailure: (r) => s(r) && r[a] === !0,
-  ofSuccess: (r) => {
-    const e = Object.create(S);
-    return e.data = r, Object.freeze(e);
-  },
-  ofError: (r) => {
-    const e = Object.create(g);
-    return e.error = r, Object.freeze(e);
-  },
-  toFailableLike: h,
-  isFailableLike: (r) => F(r) || O(r),
-  from: j
-};
-function h(r) {
-  return r.status === "failure" ? { status: "failure", error: r.error } : { status: "success", data: r.data };
+})();
+function F(r) {
+  return !(!i(r) || r.status !== n.Success || r.isSuccess !== !0 || r.isError !== !1 || !("data" in r) || r.error !== null || !s(r.or) || !s(r.getOr) || !s(r.getOrThrow));
 }
-function j(r) {
-  return t.isFailable(r) ? r : t.isFailableLike(r) ? n(r) : l(r) ? m(r) : p(r);
+function O(r) {
+  return !(!i(r) || r.status !== n.Failure || r.isSuccess !== !1 || r.isError !== !0 || !("error" in r) || r.data !== null || !s(r.or) || !s(r.getOr) || !s(r.getOrThrow));
 }
-function n(r) {
-  return r.status === "success" ? t.ofSuccess(r.data) : t.ofError(r.error);
+function l(r) {
+  return O(r) || F(r);
 }
-function m(r) {
+function B(r) {
+  return F(r);
+}
+function C(r) {
+  return O(r);
+}
+function c(r) {
+  const e = Object.create(w);
+  return e.data = r, Object.freeze(e);
+}
+function o(r) {
+  const e = Object.create(y);
+  return e.error = r, Object.freeze(e);
+}
+function I(r) {
+  return r.status === n.Failure ? { status: n.Failure, error: r.error } : { status: n.Success, data: r.data };
+}
+function U(r, e) {
+  return l(r) ? u(r, e) : a(r) ? u(S(r), e) : s(r) ? A(r, e) : p(r, e);
+}
+function S(r) {
+  return r.status === n.Success ? c(r.data) : o(r.error);
+}
+function A(r, e) {
   try {
-    const e = r();
-    return t.isFailable(e) ? e : t.isFailableLike(e) ? n(e) : t.ofSuccess(e);
-  } catch (e) {
-    return t.ofError(e);
+    const t = r();
+    return l(t) ? u(t, e) : a(t) ? u(S(t), e) : c(t);
+  } catch (t) {
+    return u(o(t), e);
   }
 }
-function p(r) {
-  return r.then((e) => t.isFailable(e) ? e : t.isFailableLike(e) ? n(e) : t.ofSuccess(e), t.ofError);
+function p(r, e) {
+  return Promise.resolve(r).then(
+    (t) => l(t) ? u(t, e) : a(t) ? u(S(t), e) : c(t),
+    (t) => u(o(t), e)
+  );
+}
+function u(r, e) {
+  const t = P(e);
+  return t === null || r.status === n.Success || r.error instanceof Error ? r : o(t(r.error));
+}
+function P(r) {
+  return r === void 0 ? null : T(r) ? k : L(r) ? r.normalizeError : null;
+}
+function T(r) {
+  return !i(r) || Object.keys(r).length !== 1 ? !1 : Object.getOwnPropertyDescriptor(r, "mode")?.value === d.mode;
+}
+function L(r) {
+  return i(r) ? s(r.normalizeError) : !1;
+}
+function k(r) {
+  return r instanceof Error ? r : Array.isArray(r) ? new AggregateError(r, "Multiple errors", { cause: r }) : new Error(String(r), { cause: r });
 }
 export {
-  t as Failable,
-  b as FailableStatus,
-  i as FailableTag,
-  a as FailureTag,
-  u as SuccessTag
+  n as FailableStatus,
+  d as NormalizedErrors,
+  U as createFailable,
+  o as failure,
+  l as isFailable,
+  a as isFailableLike,
+  C as isFailure,
+  B as isSuccess,
+  c as success,
+  I as toFailableLike
 };

package/dist/lib/failable.d.ts

@@ -1,8 +1,15 @@
-import { FailableTag, SuccessTag, FailureTag } from './constants.js';
-export declare const enum FailableStatus {
-    Success = "success",
-    Failure = "failure"
-}
+export declare const FailableStatus: Readonly<{
+    readonly Success: "success";
+    readonly Failure: "failure";
+}>;
+export type FailableStatus = (typeof FailableStatus)[keyof typeof FailableStatus];
+export declare const NormalizedErrors: Readonly<{
+    readonly mode: "normalized-errors";
+}>;
+export type CreateFailableNormalizeErrorOptions = {
+    readonly normalizeError: (error: unknown) => Error;
+};
+type CreateFailableNormalizeErrorInput = typeof NormalizedErrors | CreateFailableNormalizeErrorOptions;
 export type Failable<T, E> = Success<T> | Failure<E>;
 /**
  * Structured-clone-friendly representation of {@link Failable}.
@@ -14,24 +21,23 @@ export type Failable<T, E> = Success<T> | Failure<E>;
  * A {@link Failable} instance relies on Symbols and prototype methods, which do not survive structured cloning.
  *
  * Boundary rule:
- * - **sender**: `Failable.toFailableLike(result)`
- * - **receiver**: `Failable.from(message.result)` (rehydrates into a real {@link Failable})
+ * - **sender**: `toFailableLike(result)`
+ * - **receiver**: `createFailable(message.result)` (rehydrates into a real {@link Failable})
  *
  * Note: `data` / `error` must themselves be structured-cloneable.
  */
 export type FailableLike<T, E> = FailableLikeSuccess<T> | FailableLikeFailure<E>;
 export type FailableLikeSuccess<T> = {
-    readonly status: FailableStatus.Success;
+    readonly status: typeof FailableStatus.Success;
     readonly data: T;
 };
 export type FailableLikeFailure<E> = {
-    readonly status: FailableStatus.Failure;
+    readonly status: typeof FailableStatus.Failure;
     readonly error: E;
 };
+export declare function isFailableLike(value: unknown): value is FailableLike<unknown, unknown>;
 export type Success<T> = {
-    readonly [FailableTag]: true;
-    readonly [SuccessTag]: true;
-    readonly status: FailableStatus.Success;
+    readonly status: typeof FailableStatus.Success;
     readonly isSuccess: true;
     readonly isError: false;
     readonly data: T;
@@ -41,9 +47,7 @@ export type Success<T> = {
     readonly getOrThrow: () => T;
 };
 export type Failure<E> = {
-    readonly [FailableTag]: true;
-    readonly [FailureTag]: true;
-    readonly status: FailableStatus.Failure;
+    readonly status: typeof FailableStatus.Failure;
     readonly isSuccess: false;
     readonly isError: true;
     readonly error: E;
@@ -52,74 +56,32 @@ export type Failure<E> = {
     readonly getOr: <U>(value: U) => U;
     readonly getOrThrow: () => never;
 };
-/**
- * Namespace-style factory + utilities for the {@link Failable} result type.
- *
- * `Failable<T, E>` is a discriminated union of:
- * - {@link Success}: `{ status: 'success', isSuccess: true, data: T, error: null }`
- * - {@link Failure}: `{ status: 'failure', isError: true, error: E, data: null }`
- *
- * Design goals:
- * - Prefer explicit, typed results over exceptions.
- * - Provide tiny ergonomics (`or`, `getOr`, `getOrThrow`) with minimal allocation.
- * - Support transport across structured-clone boundaries via {@link FailableLike}.
- *
- * Runtime model / invariants:
- * - Instances are shallow-immutable (`Object.freeze`) and tagged with Symbols.
- * - They are NOT class instances; do not use `instanceof`. Prefer `result.isSuccess` / `result.isError`
- *   or the guards {@link Failable.isSuccess} / {@link Failable.isFailure}.
- * - Exactly one of `data` / `error` is non-null.
- *
- * Structured-clone boundary rule (RPC, `postMessage`, `chrome.*` messaging):
- * - **sender**: `Failable.toFailableLike(result)`
- * - **receiver**: `Failable.from(payload)` (rehydrates methods + Symbol tags)
- *
- * `Failable.from(...)` overloads:
- * - `from(failable)` returns the same instance (no wrapping).
- * - `from(failableLike)` rehydrates into a real `Success` / `Failure`.
- * - `from(() => value)` captures thrown values into `Failure` and preserves/rehydrates returned
- *   `Failable` / `FailableLike`.
- * - `from(promise)` captures rejection values into `Failure` and preserves/rehydrates resolved
- *   `Failable` / `FailableLike`.
- *
- * Gotchas:
- * - `Failable.isFailableLike` is intentionally strict: only `{ status, data }` or `{ status, error }`
- *   with no extra enumerable keys. If you need metadata, wrap it: `{ result: failableLike, meta }`.
- * - `or(...)` and `getOr(...)` are eager (fallback is evaluated before the call). Use branching for
- *   lazy fallbacks.
- * - No error normalization is performed: whatever you throw/reject becomes `.error`.
- * - `from(() => somePromise)` does NOT await; pass the promise directly: `from(somePromise)`.
- *
- * @example
- * const res = Failable.from(() => JSON.parse(text));
- * if (res.isSuccess) return res.data;
- * console.error(res.error);
- *
- * @example
- * // Structured-clone transport
- * const wire = Failable.toFailableLike(res);
- * // ... send wire ...
- * const hydrated = Failable.from(wire);
- */
-export declare const Failable: {
-    readonly isFailable: (value: unknown) => value is Failable<unknown, unknown>;
-    readonly isSuccess: (value: unknown) => value is Success<unknown>;
-    readonly isFailure: (value: unknown) => value is Failure<unknown>;
-    readonly ofSuccess: <T = void>(data: T) => Success<T>;
-    readonly ofError: <E = void>(error: E) => Failure<E>;
-    readonly toFailableLike: typeof toFailableLike;
-    readonly isFailableLike: (value: unknown) => value is FailableLike<unknown, unknown>;
-    readonly from: typeof from;
-};
-declare function toFailableLike<T>(value: Success<T>): FailableLikeSuccess<T>;
-declare function toFailableLike<E>(value: Failure<E>): FailableLikeFailure<E>;
-declare function toFailableLike<T, E>(value: Failable<T, E>): FailableLike<T, E>;
-type InferReturnTypeFromFunction<F extends () => R, E = Error, R = ReturnType<F>> = [R] extends [never] ? Failure<E> : R extends Success<infer A> ? Success<A> : R extends Failure<infer A> ? Failure<A> : R extends FailableLikeSuccess<infer A> ? Success<A> : R extends FailableLikeFailure<infer A> ? Failure<A> : R extends Failable<infer A, infer B> ? Failable<A, B> : Failable<R, E>;
-type InferReturnTypeFromPromise<T, E = Error, P extends PromiseLike<T> = PromiseLike<T>> = [Awaited<P>] extends [never] ? Promise<Failure<E>> : Awaited<P> extends Promise<Success<infer A>> ? Promise<Success<A>> : Awaited<P> extends Promise<Failure<infer A>> ? Promise<Failure<A>> : Awaited<P> extends Failable<unknown, unknown> ? Promise<Awaited<P>> : Awaited<P> extends FailableLikeSuccess<infer A> ? Promise<Success<A>> : Awaited<P> extends FailableLikeFailure<infer A> ? Promise<Failure<A>> : Awaited<P> extends FailableLike<infer A, infer B> ? Promise<Failable<A, B>> : Promise<Failable<Awaited<P>, E>>;
-declare function from<T>(value: FailableLikeSuccess<T>): Success<T>;
-declare function from<E>(value: FailableLikeFailure<E>): Failure<E>;
-declare function from<T, E>(value: FailableLike<T, E>): Failable<T, E>;
-declare function from<F extends () => R, E = Error, R = ReturnType<F>>(fun: F): InferReturnTypeFromFunction<F, E, R>;
-declare function from<T, E = Error, P extends PromiseLike<T> = PromiseLike<T>>(promise: P): InferReturnTypeFromPromise<T, E, P>;
+export declare function isFailable(value: unknown): value is Failable<unknown, unknown>;
+export declare function isSuccess(value: unknown): value is Success<unknown>;
+export declare function isFailure(value: unknown): value is Failure<unknown>;
+export declare function success<T = void>(data: T): Success<T>;
+export declare function failure<E = void>(error: E): Failure<E>;
+export declare function toFailableLike<T>(value: Success<T>): FailableLikeSuccess<T>;
+export declare function toFailableLike<E>(value: Failure<E>): FailableLikeFailure<E>;
+export declare function toFailableLike<T, E>(value: Failable<T, E>): FailableLike<T, E>;
+type InferReturnTypeFromFunction<F extends () => R, E = unknown, R = ReturnType<F>> = [R] extends [never] ? Failure<E> : R extends Success<infer A> ? Success<A> : R extends Failure<infer A> ? Failure<A> : R extends FailableLikeSuccess<infer A> ? Success<A> : R extends FailableLikeFailure<infer A> ? Failure<A> : R extends Failable<infer A, infer B> ? Failable<A, B> : R extends FailableLike<infer A, infer B> ? Failable<A, B> : Failable<R, E>;
+type InferReturnTypeFromPromise<T, E = unknown, P extends PromiseLike<T> = PromiseLike<T>> = [Awaited<P>] extends [never] ? Promise<Failure<E>> : Awaited<P> extends Success<infer A> ? Promise<Success<A>> : Awaited<P> extends Failure<infer A> ? Promise<Failure<A>> : Awaited<P> extends Failable<unknown, unknown> ? Promise<Awaited<P>> : Awaited<P> extends FailableLikeSuccess<infer A> ? Promise<Success<A>> : Awaited<P> extends FailableLikeFailure<infer A> ? Promise<Failure<A>> : Awaited<P> extends FailableLike<infer A, infer B> ? Promise<Failable<A, B>> : Promise<Failable<Awaited<P>, E>>;
+type NormalizeCreateFailableResult<T> = [T] extends [never] ? Failure<Error> : T extends Success<infer A> ? Success<A> : T extends Failure<unknown> ? Failure<Error> : T extends FailableLikeSuccess<infer A> ? Success<A> : T extends FailableLikeFailure<unknown> ? Failure<Error> : T extends Failable<infer A, unknown> ? Failable<A, Error> : T extends FailableLike<infer A, unknown> ? Failable<A, Error> : Failable<T, Error>;
+export declare function createFailable<T>(value: Success<T>): Success<T>;
+export declare function createFailable<E>(value: Failure<E>): Failure<E>;
+export declare function createFailable<T, E>(value: Failable<T, E>): Failable<T, E>;
+export declare function createFailable<T>(value: FailableLikeSuccess<T>): Success<T>;
+export declare function createFailable<E>(value: FailableLikeFailure<E>): Failure<E>;
+export declare function createFailable<T, E>(value: FailableLike<T, E>): Failable<T, E>;
+export declare function createFailable<T>(value: Success<T>, normalizeOption: CreateFailableNormalizeErrorInput): Success<T>;
+export declare function createFailable<E>(value: Failure<E>, normalizeOption: CreateFailableNormalizeErrorInput): Failure<Error>;
+export declare function createFailable<T, E>(value: Failable<T, E>, normalizeOption: CreateFailableNormalizeErrorInput): Failable<T, Error>;
+export declare function createFailable<T>(value: FailableLikeSuccess<T>, normalizeOption: CreateFailableNormalizeErrorInput): Success<T>;
+export declare function createFailable<E>(value: FailableLikeFailure<E>, normalizeOption: CreateFailableNormalizeErrorInput): Failure<Error>;
+export declare function createFailable<T, E>(value: FailableLike<T, E>, normalizeOption: CreateFailableNormalizeErrorInput): Failable<T, Error>;
+export declare function createFailable<F extends () => R, E = unknown, R = ReturnType<F>>(fun: F): InferReturnTypeFromFunction<F, E, R>;
+export declare function createFailable<F extends () => R, R = ReturnType<F>>(fun: F, normalizeOption: CreateFailableNormalizeErrorInput): NormalizeCreateFailableResult<R>;
+export declare function createFailable<T, E = unknown, P extends PromiseLike<T> = PromiseLike<T>>(promise: P): InferReturnTypeFromPromise<T, E, P>;
+export declare function createFailable<T, P extends PromiseLike<T> = PromiseLike<T>>(promise: P, normalizeOption: CreateFailableNormalizeErrorInput): Promise<NormalizeCreateFailableResult<Awaited<P>>>;
 export {};
 //# sourceMappingURL=failable.d.ts.map

package/dist/lib/failable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failable.d.ts","sourceRoot":"","sources":["../../src/lib/failable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"failable.d.ts","sourceRoot":"","sources":["../../src/lib/failable.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,22 @@
 {
   "name": "@pvorona/failable",
-  "version": "0.0.3",
+  "version": "0.2.0",
+  "description": "Typed success/failure results for expected failures in TypeScript.",
+  "keywords": [
+    "failable",
+    "result",
+    "typescript",
+    "error-handling"
+  ],
   "license": "MIT",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     "./package.json": "./package.json",
     ".": {

package/dist/lib/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const FailableTag: unique symbol;
-export declare const SuccessTag: unique symbol;
-export declare const FailureTag: unique symbol;
-//# sourceMappingURL=constants.d.ts.map

package/dist/lib/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,eAAqB,CAAC;AAC9C,eAAO,MAAM,UAAU,eAAoB,CAAC;AAC5C,eAAO,MAAM,UAAU,eAAoB,CAAC"}