@pvorona/failable 0.1.0 → 0.2.1

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,322 +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 { createFailable } from '@pvorona/failable';
+import type { Failable } from '@pvorona/failable';
+import { failure, isFailure, success } from '@pvorona/failable';
 
-const result = createFailable(() => 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 { failure, success } from '@pvorona/failable';
-
-const ok = success(42);
-const err = failure(new Error('boom'));
-```
-
-### Fallbacks
-
-```ts
-import { failure } from '@pvorona/failable';
-
-const err = failure(new Error('boom'));
-
-const value = err.getOr('default'); // 'default'
-const recovered = err.or('fallback'); // Success<'fallback'>
-```
-
-### Wrapping async work
-
-```ts
-import { createFailable } from '@pvorona/failable';
-
-const result = await createFailable(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 { createFailable, toFailableLike } from '@pvorona/failable';
-
-// sender
-const wire = toFailableLike(result);
-postMessage(wire);
-
-// receiver
-const hydrated = createFailable(wire);
-```
-
-## API
 
-### `const enum FailableStatus`
+const result = divide(10, 2);
 
-The discriminant for `FailableLike` and `Failable` instances.
-
-```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 { failure, success } from '@pvorona/failable';
-
-export function parseIntSafe(input: string): Failable<number, Error> {
-  const n = Number(input);
-  if (!Number.isInteger(n)) return failure(new Error('Not an int'));
-
-  return success(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 { success } from '@pvorona/failable';
+import { failure, success } from '@pvorona/failable';
 
-const s = success(123);
-s.getOr(0); // 123
-s.or('x'); // Success<number>
+const ok = success({ id: '1' });
+const err = failure({ code: 'bad_request' });
 ```
 
-### `type Failure<E>`
-
-The failure variant.
+### `isSuccess(...)` and `isFailure(...)`
 
-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 { failure } from '@pvorona/failable';
-
-const f = failure(new Error('boom'));
-f.getOr('default'); // 'default'
-f.or(42).data; // 42
-```
-
-### `type FailableLike<T, E>`
+import { failure, isSuccess, success } from '@pvorona/failable';
 
-Structured-clone-friendly representation of a result:
+const result = Math.random() > 0.5 ? success(123) : failure('boom');
 
-- `{ status: 'success', data }`
-- `{ status: 'failure', error }`
-
-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 `isSuccess(...)` / `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);
+  }
 }
 ```
 
-### `success<T>(data: T): Success<T>`
+## Important semantics
 
-Example:
+- `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.
 
-```ts
-import { success } from '@pvorona/failable';
+## Normalizing errors
 
-const ok = success({ id: '1' });
-```
-
-### `failure<E>(error: E): Failure<E>`
-
-Example:
+If you want `Error`-shaped handling at the boundary, opt in explicitly:
 
 ```ts
-import { failure } from '@pvorona/failable';
-
-const err = failure({ code: 'bad_request' });
-```
+import {
+  createFailable,
+  isFailure,
+  NormalizedErrors,
+} from '@pvorona/failable';
 
-### `isFailable(value): value is Failable<unknown, unknown>`
+const result = createFailable(
+  () => {
+    throw { code: 'bad_request' };
+  },
+  NormalizedErrors
+);
 
-Checks whether a value is a hydrated `Failable` instance (Symbol-tagged).
-
-Example:
-
-```ts
-import { isFailable, success } from '@pvorona/failable';
-
-const maybe: unknown = success(1);
-if (isFailable(maybe)) {
-  // narrowed
+if (isFailure(result)) {
+  console.error(result.error.message);
+  console.error(result.error.cause); // { code: 'bad_request' }
 }
 ```
 
-### `isSuccess(value): value is Success<unknown>`
-
-Example:
+For custom normalization:
 
 ```ts
-import { isSuccess, success } from '@pvorona/failable';
+import { createFailable } from '@pvorona/failable';
 
-const maybe: unknown = success(1);
-if (isSuccess(maybe)) {
-  maybe.data; // ok
-}
+const result = createFailable(doThing, {
+  normalizeError(error) {
+    return error instanceof Error
+      ? error
+      : new Error('Operation failed', { cause: error });
+  },
+});
 ```
 
-### `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 { failure, isFailure } from '@pvorona/failable';
-
-const maybe: unknown = failure('nope');
-if (isFailure(maybe)) {
-  console.log(maybe.error);
-}
-```
-
-### `toFailableLike(result): FailableLike<...>`
-
-Converts a hydrated `Failable` into a structured-clone-friendly representation.
+import { createFailable, toFailableLike } from '@pvorona/failable';
 
-Example:
+const result = createFailable(() => JSON.parse('{"ok":true}'));
 
-```ts
-import { success, toFailableLike } from '@pvorona/failable';
+// sender
+const wire = toFailableLike(result);
+postMessage(wire);
 
-const res = success(1);
-const wire = toFailableLike(res);
+// receiver
+const hydrated = createFailable(wire);
 ```
 
-### `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 { isFailableLike } from '@pvorona/failable';
+import { FailableStatus, type FailableLike } from '@pvorona/failable';
 
-const wire: unknown = { status: 'success', data: 1 };
-isFailableLike(wire); // true
+const wire: FailableLike<number, string> = {
+  status: FailableStatus.Success,
+  data: 1,
+};
 ```
 
-### `createFailable(...)`
+## API at a glance
 
-Overloads:
-
-- `createFailable(failable)` → returns the same instance
-- `createFailable(failableLike)` → rehydrates into a real `Success` / `Failure`
-- `createFailable(() => value)` → captures throws into `Failure`
-- `createFailable(promise)` → captures rejections into `Failure`
-
-Examples:
-
-```ts
-import { createFailable, failure, toFailableLike } from '@pvorona/failable';
-
-// function wrapper (captures throws)
-const res1 = createFailable(() => JSON.parse('{'));
-
-// promise wrapper (captures rejections)
-const res2 = await createFailable(fetch('https://example.com'));
-
-// rehydrate from structured clone
-const wire = toFailableLike(failure('bad'));
-const hydrated = createFailable(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,92 +1,119 @@
-import { isFunction as F, isObject as e } from "@pvorona/assert";
-import { notImplemented as c } from "@pvorona/not-implemented";
-const f = /* @__PURE__ */ Symbol("Failable"), O = /* @__PURE__ */ Symbol("Success"), l = /* @__PURE__ */ Symbol("Failure");
-var S = /* @__PURE__ */ ((r) => (r.Success = "success", r.Failure = "failure", r))(S || {});
-function g(r) {
-  return e(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 h(r) {
-  return e(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 u(r) {
-  return h(r) || g(r);
+function a(r) {
+  return m(r) || j(r);
 }
 const b = {
-  [f]: !0,
+  [E]: !0,
   isSuccess: !1,
   isError: !1,
   data: null,
   error: null,
-  or: c,
-  getOr: c,
-  getOrThrow: c
-}, j = (() => {
+  or: f,
+  getOr: f,
+  getOrThrow: f
+}, w = (() => {
   const r = Object.create(b);
-  return r[O] = !0, r.status = "success", r.isSuccess = !0, r.or = function() {
+  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);
-})(), m = (() => {
+})(), y = (() => {
   const r = Object.create(b);
-  return r[l] = !0, r.status = "failure", r.isError = !0, r.or = function(s) {
-    return n(s);
-  }, r.getOr = function(s) {
-    return s;
+  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);
 })();
-function o(r) {
-  return e(r) && r[f] === !0;
+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 E(r) {
-  return e(r) && r[O] === !0;
+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 T(r) {
-  return e(r) && r[l] === !0;
+function l(r) {
+  return O(r) || F(r);
 }
-function n(r) {
-  const t = Object.create(j);
-  return t.data = r, Object.freeze(t);
+function B(r) {
+  return F(r);
 }
-function i(r) {
-  const t = Object.create(m);
-  return t.error = r, Object.freeze(t);
+function C(r) {
+  return O(r);
 }
-function A(r) {
-  return r.status === "failure" ? { status: "failure", error: r.error } : { status: "success", data: r.data };
+function c(r) {
+  const e = Object.create(w);
+  return e.data = r, Object.freeze(e);
 }
-function L(r) {
-  return o(r) ? r : u(r) ? a(r) : F(r) ? p(r) : y(r);
+function o(r) {
+  const e = Object.create(y);
+  return e.error = r, Object.freeze(e);
 }
-function a(r) {
-  return r.status === "success" ? n(r.data) : i(r.error);
+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 p(r) {
+function A(r, e) {
   try {
     const t = r();
-    return o(t) ? t : u(t) ? a(t) : n(t);
+    return l(t) ? u(t, e) : a(t) ? u(S(t), e) : c(t);
   } catch (t) {
-    return i(t);
+    return u(o(t), e);
   }
 }
-function y(r) {
-  return Promise.resolve(r).then((t) => o(t) ? t : u(t) ? a(t) : n(t), i);
+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 {
-  S as FailableStatus,
-  f as FailableTag,
-  l as FailureTag,
-  O as SuccessTag,
-  L as createFailable,
-  i as failure,
-  o as isFailable,
-  u as isFailableLike,
-  T as isFailure,
-  E as isSuccess,
-  n as success,
-  A as toFailableLike
+  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}.
@@ -21,18 +28,16 @@ export type Failable<T, E> = Success<T> | Failure<E>;
  */
 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;
@@ -42,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;
@@ -53,55 +56,6 @@ export type Failure<E> = {
     readonly getOr: <U>(value: U) => U;
     readonly getOrThrow: () => never;
 };
-/**
- * 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 isSuccess} / {@link isFailure}.
- * - Exactly one of `data` / `error` is non-null.
- *
- * Structured-clone boundary rule (RPC, `postMessage`, `chrome.*` messaging):
- * - **sender**: `toFailableLike(result)`
- * - **receiver**: `createFailable(payload)` (rehydrates methods + Symbol tags)
- *
- * `createFailable(...)` overloads:
- * - `createFailable(failable)` returns the same instance (no wrapping).
- * - `createFailable(failableLike)` rehydrates into a real `Success` / `Failure`.
- * - `createFailable(() => value)` captures thrown values into `Failure` and preserves/rehydrates returned
- *   `Failable` / `FailableLike`.
- * - `createFailable(promise)` captures rejection values into `Failure` and preserves/rehydrates resolved
- *   `Failable` / `FailableLike`.
- *
- * Gotchas:
- * - `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`.
- * - `createFailable(() => somePromise)` does NOT await; pass the promise directly: `createFailable(somePromise)`.
- *
- * @example
- * const res = createFailable(() => JSON.parse(text));
- * if (res.isSuccess) return res.data;
- * console.error(res.error);
- *
- * @example
- * // Structured-clone transport
- * const wire = toFailableLike(res);
- * // ... send wire ...
- * const hydrated = createFailable(wire);
- */
 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>;
@@ -110,12 +64,24 @@ 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 = 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>>;
+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<F extends () => R, E = Error, R = ReturnType<F>>(fun: F): InferReturnTypeFromFunction<F, E, R>;
-export declare function createFailable<T, E = Error, P extends PromiseLike<T> = PromiseLike<T>>(promise: P): InferReturnTypeFromPromise<T, E, P>;
+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,15 +1,25 @@
 {
   "name": "@pvorona/failable",
-  "version": "0.1.0",
+  "version": "0.2.1",
+  "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",
     ".": {
-      "@pvorona/source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
@@ -19,6 +29,10 @@
     "dist",
     "!**/*.tsbuildinfo"
   ],
+  "scripts": {
+    "check-package-surface": "node ./scripts/check-package-surface.mjs",
+    "prepublishOnly": "npm run check-package-surface"
+  },
   "publishConfig": {
     "access": "public"
   },

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"}