@semyonf/kamchazky 0.3.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -48,25 +48,15 @@ Union of `OkResult<T> | ErrResult<E>`.
48
48
  type OkResult<T> = {
49
49
  readonly ok: true;
50
50
  readonly value: T;
51
- map<U>(fn: (value: T) => U): OkResult<U>;
52
- flatMap<U, F extends Error = never>(fn: (value: T) => Result<U, F>): Result<U, F>;
53
- mapError<F extends Error>(fn: (error: never) => F): OkResult<T>;
54
- inspect(fn: (value: T) => void): OkResult<T>;
55
- inspectError(fn: (error: never) => void): OkResult<T>;
56
51
  };
57
52
  ```
58
53
 
59
54
  #### `ErrResult<E extends Error>`
60
55
 
61
56
  ```typescript
62
- type ErrResult<E extends Error = Error> = {
57
+ type ErrResult<E extends Error> = {
63
58
  readonly ok: false;
64
59
  readonly error: E;
65
- map<U>(fn: (value: never) => U): ErrResult<E>;
66
- flatMap<U, F extends Error = never>(fn: (value: never) => Result<U, F>): ErrResult<E>;
67
- mapError<F extends Error>(fn: (error: E) => F): ErrResult<F>;
68
- inspect(fn: (value: never) => void): ErrResult<E>;
69
- inspectError(fn: (error: E) => void): ErrResult<E>;
70
60
  };
71
61
  ```
72
62
 
@@ -136,23 +126,11 @@ Result.inspect(result, (value) => console.log("got", value));
136
126
  Result.inspectError(result, (error) => console.error(error));
137
127
  ```
138
128
 
139
- All transformations are also available as instance methods for chaining:
140
-
141
- ```typescript
142
- ok(10)
143
- .inspect((x) => console.log("start:", x))
144
- .map((x) => x + 5)
145
- .flatMap((x) => x > 10 ? ok(x) : err(new Error("too small")))
146
- .mapError((e) => new AppError(e.message))
147
- .inspectError((e) => console.error(e));
148
- ```
149
-
150
129
  #### Extracting values
151
130
 
152
131
  ```typescript
153
132
  Result.unwrap(result); // returns value or throws error
154
133
  Result.unwrapOr(result, fallback); // returns value or fallback (same type)
155
- Result.expect(result, "msg"); // returns value or throws with message
156
134
  ```
157
135
 
158
136
  `unwrapOr` requires the fallback to be the same type `T` as the success value. Use `match` when you need a different return type.
@@ -212,10 +190,6 @@ Union of `Some<T> | None`.
212
190
  type Some<T> = {
213
191
  readonly some: true;
214
192
  readonly value: T;
215
- map<U>(fn: (value: T) => U): Some<U>;
216
- flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>;
217
- filter(predicate: (value: T) => boolean): Maybe<T>;
218
- inspect(fn: (value: T) => void): Some<T>;
219
193
  };
220
194
  ```
221
195
 
@@ -224,10 +198,6 @@ type Some<T> = {
224
198
  ```typescript
225
199
  type None = {
226
200
  readonly some: false;
227
- map<U>(fn: (value: never) => U): None;
228
- flatMap<U>(fn: (value: never) => Maybe<U>): None;
229
- filter(predicate: (value: never) => boolean): None;
230
- inspect(fn: (value: never) => void): None;
231
201
  };
232
202
  ```
233
203
 
@@ -271,22 +241,11 @@ Maybe.filter(maybe, (x) => x > 0);
271
241
  Maybe.inspect(maybe, (value) => console.log("got", value));
272
242
  ```
273
243
 
274
- All transformations are also available as instance methods for chaining:
275
-
276
- ```typescript
277
- some(10)
278
- .inspect((x) => console.log("start:", x))
279
- .map((x) => x + 5)
280
- .flatMap((x) => x > 10 ? some(x) : none())
281
- .filter((x) => x < 100);
282
- ```
283
-
284
244
  #### Extracting values
285
245
 
286
246
  ```typescript
287
247
  Maybe.unwrap(maybe); // returns value or throws
288
248
  Maybe.unwrapOr(maybe, fallback); // returns value or fallback (same type)
289
- Maybe.expect(maybe, "msg"); // returns value or throws with message
290
249
  ```
291
250
 
292
251
  #### Pattern matching
@@ -321,13 +280,13 @@ Convert between `Result` and `Maybe`:
321
280
  Result.toMaybe(ok(42)); // some(42)
322
281
  Result.toMaybe(err(new Error())); // none()
323
282
 
324
- // Maybe → Result (requires an error for the None case)
325
- Result.fromMaybe(some(42), new Error("missing")); // ok(42)
326
- Result.fromMaybe(none(), new Error("missing")); // err(Error("missing"))
283
+ // Maybe → Result (requires an error factory for the None case)
284
+ Result.fromMaybe(some(42), () => new Error("missing")); // ok(42)
285
+ Result.fromMaybe(none(), () => new Error("missing")); // err(Error("missing"))
327
286
 
328
287
  // Same operations from the Maybe side
329
- Maybe.fromResult(ok(42)); // some(42)
330
- Maybe.toResult(some(42), new Error("missing")); // ok(42)
288
+ Maybe.fromResult(ok(42)); // some(42)
289
+ Maybe.toResult(some(42), () => new Error("missing")); // ok(42)
331
290
  ```
332
291
 
333
292
  ---
package/dist/index.cjs CHANGED
@@ -33,55 +33,20 @@ __export(src_exports, {
33
33
  some: () => some
34
34
  });
35
35
  module.exports = __toCommonJS(src_exports);
36
- function ok(value) {
37
- const self = Object.freeze({
36
+ function createOk(value) {
37
+ return Object.freeze({
38
38
  ok: true,
39
- value,
40
- map: (fn) => ok(fn(value)),
41
- flatMap: (fn) => fn(value),
42
- mapError: (_fn) => self,
43
- inspect: (fn) => {
44
- fn(value);
45
- return self;
46
- },
47
- inspectError: (_fn) => self,
48
- match: (handlers) => handlers.ok(value),
49
- unwrap: () => value,
50
- unwrapOr: (_fallback) => value,
51
- unwrapOrElse: (_fn) => value,
52
- expect: (_message) => value
39
+ value
53
40
  });
54
- return self;
41
+ }
42
+ function ok(...args) {
43
+ return args.length === 0 ? createOk(void 0) : createOk(args[0]);
55
44
  }
56
45
  function err(error) {
57
- const self = Object.freeze({
46
+ return Object.freeze({
58
47
  ok: false,
59
- error,
60
- map: (_fn) => self,
61
- flatMap: (_fn) => self,
62
- mapError: (fn) => err(fn(error)),
63
- inspect: (_fn) => self,
64
- inspectError: (fn) => {
65
- fn(error);
66
- return self;
67
- },
68
- match: (handlers) => handlers.err(error),
69
- unwrap: () => {
70
- throw error;
71
- },
72
- unwrapOr: (fallback) => fallback,
73
- unwrapOrElse: (fn) => fn(),
74
- expect: (message) => {
75
- const thrown = new Error(`${message}: ${error.message}`, {
76
- cause: error
77
- });
78
- Object.setPrototypeOf(thrown, error.constructor.prototype);
79
- if (error.stack !== void 0)
80
- thrown.stack = error.stack;
81
- throw thrown;
82
- }
48
+ error
83
49
  });
84
- return self;
85
50
  }
86
51
  function isOk(result) {
87
52
  return result.ok;
@@ -144,17 +109,6 @@ function unwrapOr(result, fallback) {
144
109
  function unwrapOrElse(result, fn) {
145
110
  return result.ok ? result.value : fn();
146
111
  }
147
- function expect(result, message) {
148
- if (result.ok)
149
- return result.value;
150
- const thrown = new Error(`${message}: ${result.error.message}`, {
151
- cause: result.error
152
- });
153
- Object.setPrototypeOf(thrown, result.error.constructor.prototype);
154
- if (result.error.stack !== void 0)
155
- thrown.stack = result.error.stack;
156
- throw thrown;
157
- }
158
112
  function fromNullable(value, errorFactory) {
159
113
  return value != null ? ok(value) : err(errorFactory());
160
114
  }
@@ -267,39 +221,13 @@ function collect(...results) {
267
221
  return ok(values);
268
222
  }
269
223
  function some(value) {
270
- const self = Object.freeze({
224
+ return Object.freeze({
271
225
  some: true,
272
- value,
273
- map: (fn) => some(fn(value)),
274
- flatMap: (fn) => fn(value),
275
- filter: (predicate) => predicate(value) ? self : NONE,
276
- inspect: (fn) => {
277
- fn(value);
278
- return self;
279
- },
280
- match: (handlers) => handlers.some(value),
281
- unwrap: () => value,
282
- expect: (_message) => value,
283
- unwrapOr: (_fallback) => value,
284
- unwrapOrElse: (_fn) => value
226
+ value
285
227
  });
286
- return self;
287
228
  }
288
229
  var NONE = Object.freeze({
289
- some: false,
290
- map: (_fn) => NONE,
291
- flatMap: (_fn) => NONE,
292
- filter: (_predicate) => NONE,
293
- inspect: (_fn) => NONE,
294
- match: (handlers) => handlers.none(),
295
- unwrap: () => {
296
- throw new Error("Called unwrap on None");
297
- },
298
- expect: (message) => {
299
- throw new Error(message);
300
- },
301
- unwrapOr: (fallback) => fallback,
302
- unwrapOrElse: (fn) => fn()
230
+ some: false
303
231
  });
304
232
  function none() {
305
233
  return NONE;
@@ -341,11 +269,6 @@ function maybeUnwrapOr(maybe, fallback) {
341
269
  function maybeUnwrapOrElse(maybe, fn) {
342
270
  return maybe.some ? maybe.value : fn();
343
271
  }
344
- function maybeExpect(maybe, message) {
345
- if (maybe.some)
346
- return maybe.value;
347
- throw new Error(message);
348
- }
349
272
  function maybeFromNullable(value) {
350
273
  return value != null ? some(value) : NONE;
351
274
  }
@@ -421,7 +344,6 @@ var Maybe = {
421
344
  unwrap: maybeUnwrap,
422
345
  unwrapOr: maybeUnwrapOr,
423
346
  unwrapOrElse: maybeUnwrapOrElse,
424
- expect: maybeExpect,
425
347
  fromNullable: maybeFromNullable,
426
348
  fromPredicate: maybeFromPredicate,
427
349
  all: maybeAll,
@@ -450,7 +372,6 @@ var Result = {
450
372
  unwrap,
451
373
  unwrapOr,
452
374
  unwrapOrElse,
453
- expect,
454
375
  fromNullable,
455
376
  fromPredicate,
456
377
  normalizeError,
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** A successful result containing a value of type `T`. */\nexport type OkResult<T> = {\n readonly ok: true;\n readonly value: T;\n map<U>(fn: (value: T) => U): OkResult<U>;\n flatMap<U, F extends Error = never>(\n fn: (value: T) => Result<U, F>\n ): Result<U, F>;\n mapError<F extends Error>(fn: (error: never) => F): OkResult<T>;\n inspect(fn: (value: T) => void): OkResult<T>;\n inspectError(fn: (error: never) => void): OkResult<T>;\n match<R>(handlers: { ok: (value: T) => R; err: (error: never) => R }): R;\n unwrap(): T;\n unwrapOr(fallback: T): T;\n unwrapOrElse(fn: () => T): T;\n expect(message: string): T;\n};\n\n/** A failed result containing an error of type `E`. */\nexport type ErrResult<E extends Error = Error> = {\n readonly ok: false;\n readonly error: E;\n map<U>(fn: (value: never) => U): ErrResult<E>;\n flatMap<U, F extends Error = never>(\n fn: (value: never) => Result<U, F>\n ): ErrResult<E>;\n mapError<F extends Error>(fn: (error: E) => F): ErrResult<F>;\n inspect(fn: (value: never) => void): ErrResult<E>;\n inspectError(fn: (error: E) => void): ErrResult<E>;\n match<R>(handlers: { ok: (value: never) => R; err: (error: E) => R }): R;\n unwrap(): never;\n unwrapOr<T>(fallback: T): T;\n unwrapOrElse<T>(fn: () => T): T;\n expect(message: string): never;\n};\n\n/**\n * A value that is either a success (`OkResult<T>`) or a failure\n * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the\n * companion `Result.*` functions or instance methods to transform.\n */\nexport type Result<T, E extends Error = Error> = OkResult<T> | ErrResult<E>;\n\ntype AnyResult = Result<unknown, Error>;\n\ntype ValueOf<R> = R extends OkResult<infer T> ? T : never;\ntype ErrorOf<R> = R extends ErrResult<infer E> ? E : never;\n\ntype TupleValues<R extends readonly AnyResult[]> = {\n [K in keyof R]: ValueOf<R[K]>;\n};\ntype TupleErrors<R extends readonly AnyResult[]> = ErrorOf<R[number]>;\n\n/** Create a successful `Result` containing `value`. */\nfunction ok(): OkResult<undefined>;\nfunction ok<T>(value: T): OkResult<T>;\nfunction ok<T>(value?: T): OkResult<T | undefined> {\n const self: OkResult<T | undefined> = Object.freeze({\n ok: true as const,\n value,\n map: <U>(fn: (value: T | undefined) => U): OkResult<U> => ok(fn(value)),\n flatMap: <U, F extends Error = never>(\n fn: (value: T | undefined) => Result<U, F>\n ): Result<U, F> => fn(value),\n mapError: <F extends Error>(\n _fn: (error: never) => F\n ): OkResult<T | undefined> => self,\n inspect: (fn: (value: T | undefined) => void): OkResult<T | undefined> => {\n fn(value);\n return self;\n },\n inspectError: (_fn: (error: never) => void): OkResult<T | undefined> =>\n self,\n match: <R>(handlers: {\n ok: (value: T | undefined) => R;\n err: (error: never) => R;\n }): R => handlers.ok(value),\n unwrap: (): T | undefined => value,\n unwrapOr: (_fallback: T | undefined): T | undefined => value,\n unwrapOrElse: (_fn: () => T | undefined): T | undefined => value,\n expect: (_message: string): T | undefined => value,\n });\n return self;\n}\n\n/** Create a failed `Result` containing `error`. */\nfunction err<E extends Error>(error: E): ErrResult<E> {\n const self: ErrResult<E> = Object.freeze({\n ok: false as const,\n error,\n map: <U>(_fn: (value: never) => U): ErrResult<E> => self,\n flatMap: <U, F extends Error = never>(\n _fn: (value: never) => Result<U, F>\n ): ErrResult<E> => self,\n mapError: <F extends Error>(fn: (error: E) => F): ErrResult<F> =>\n err(fn(error)),\n inspect: (_fn: (value: never) => void): ErrResult<E> => self,\n inspectError: (fn: (error: E) => void): ErrResult<E> => {\n fn(error);\n return self;\n },\n match: <R>(handlers: {\n ok: (value: never) => R;\n err: (error: E) => R;\n }): R => handlers.err(error),\n unwrap: (): never => {\n throw error;\n },\n unwrapOr: <T>(fallback: T): T => fallback,\n unwrapOrElse: <T>(fn: () => T): T => fn(),\n expect: (message: string): never => {\n const thrown = new Error(`${message}: ${error.message}`, {\n cause: error,\n });\n Object.setPrototypeOf(thrown, error.constructor.prototype);\n if (error.stack !== undefined) thrown.stack = error.stack;\n throw thrown;\n },\n });\n return self;\n}\n\n/** Narrow a `Result` to `OkResult`. */\nfunction isOk<T, E extends Error>(result: Result<T, E>): result is OkResult<T> {\n return result.ok;\n}\n\n/** Narrow a `Result` to `ErrResult`. */\nfunction isErr<T, E extends Error>(\n result: Result<T, E>\n): result is ErrResult<E> {\n return !result.ok;\n}\n\n/** Transform the value inside an `Ok`, leaving `Err` unchanged. */\nfunction map<T, U>(result: OkResult<T>, fn: (value: T) => U): OkResult<U>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E> {\n return result.ok ? ok(fn(result.value)) : result;\n}\n\n/** Transform the error inside an `Err`, leaving `Ok` unchanged. */\nfunction mapError<T>(\n result: OkResult<T>,\n fn: (error: never) => Error\n): OkResult<T>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => F\n): Result<T, F>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: OkResult<T> | Result<T, E>,\n fn: ((error: never) => Error) | ((error: E) => F)\n): OkResult<T> | Result<T, F> {\n return result.ok ? result : err((fn as (error: E) => F)(result.error));\n}\n\n/** Run a side-effect on the `Ok` value without transforming the result. */\nfunction inspect<T>(result: OkResult<T>, fn: (value: T) => void): OkResult<T>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E> {\n if (result.ok) fn(result.value);\n return result;\n}\n\n/** Run a side-effect on the `Err` error without transforming the result. */\nfunction inspectError<E extends Error>(\n result: ErrResult<E>,\n fn: (error: E) => void\n): ErrResult<E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E> {\n if (!result.ok) fn(result.error);\n return result;\n}\n\n/** Chain a `Result`-returning function on the `Ok` value. */\nfunction flatMap<T, U, E extends Error, F extends Error = never>(\n result: Result<T, E>,\n fn: (value: T) => Result<U, F>\n): Result<U, E | F> {\n if (result.ok) return fn(result.value);\n // Safe: ErrResult<E> ⊆ Result<U, E | F> — error type is widened, value\n // channel is unused. The assertion is needed because ErrResult's methods\n // make E invariant in TypeScript's structural checker.\n return result as ErrResult<E | F>;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias: `flatMapErr`.\n */\nfunction orElse<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n if (!result.ok) return fn(result.error);\n // Safe: OkResult<T> ⊆ Result<T, F> — same variance pattern as flatMap.\n return result as OkResult<T>;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias for `orElse`.\n */\nfunction flatMapErr<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n return orElse(result, fn);\n}\n\n/** Flatten a nested `Result<Result<T, E>, F>` into `Result<T, E | F>`. */\nfunction flatten<T, E extends Error, F extends Error>(\n result: Result<Result<T, E>, F>\n): Result<T, E | F> {\n // Safe: both branches widen the error type — same variance pattern as flatMap.\n return (result.ok ? result.value : result) as Result<T, E | F>;\n}\n\n/** Exhaustively handle both `Ok` and `Err` branches, returning `R`. */\nfunction match<T, E extends Error, R>(\n result: Result<T, E>,\n handlers: { ok: (value: T) => R; err: (error: E) => R }\n): R {\n return result.ok ? handlers.ok(result.value) : handlers.err(result.error);\n}\n\n/** Compile-time exhaustiveness guard — only accepts `never`. */\nfunction exhaustive(value: never): never {\n let detail: string;\n try {\n detail = JSON.stringify(value);\n } catch {\n detail = String(value);\n }\n throw new Error(`Unhandled result case: ${detail}`);\n}\n\n/** Return the `Ok` value or throw the contained error. */\nfunction unwrap<T, E extends Error>(result: Result<T, E>): T {\n if (result.ok) return result.value;\n throw result.error;\n}\n\n/**\n * Return the `Ok` value or `fallback`.\n *\n * The fallback must be the same type `T` as the success value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T {\n return result.ok ? result.value : fallback;\n}\n\n/** Return the `Ok` value, or compute a fallback from `fn`. */\nfunction unwrapOrElse<T, E extends Error>(\n result: Result<T, E>,\n fn: () => T\n): T {\n return result.ok ? result.value : fn();\n}\n\n/** Return the `Ok` value or throw with a custom `message`. */\nfunction expect<T, E extends Error>(result: Result<T, E>, message: string): T {\n if (result.ok) return result.value;\n const thrown = new Error(`${message}: ${result.error.message}`, {\n cause: result.error,\n });\n Object.setPrototypeOf(thrown, result.error.constructor.prototype);\n if (result.error.stack !== undefined) thrown.stack = result.error.stack;\n throw thrown;\n}\n\n/** Convert a nullable value to a `Result`. */\nfunction fromNullable<T, E extends Error>(\n value: T | null | undefined,\n errorFactory: () => E\n): Result<NonNullable<T>, E> {\n return value != null ? ok(value as NonNullable<T>) : err(errorFactory());\n}\n\n/** Convert a predicate check to a `Result`. Supports type-guard predicates. */\nfunction fromPredicate<T, S extends T, E extends Error>(\n value: T,\n predicate: (value: T) => value is S,\n errorFactory: () => E\n): Result<S, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E> {\n return predicate(value) ? ok(value) : err(errorFactory());\n}\n\n/** Convert an unknown thrown value to an `Error` instance. */\nfunction normalizeError(error: unknown): Error {\n if (error instanceof Error) return error;\n if (error === null || error === undefined) return new Error(String(error));\n if (typeof error === \"object\") {\n try {\n const json = JSON.stringify(error);\n if (json !== \"{}\") return new Error(json);\n // JSON.stringify produced '{}' — likely RegExp or similar with no\n // enumerable own properties. Fall through to String().\n } catch {\n // JSON.stringify throws on BigInt and circular references\n }\n }\n try {\n return new Error(String(error));\n } catch {\n return new Error(\"Non-stringifiable thrown value\");\n }\n}\n\n/** Wrap a synchronous function that may throw into a `Result`. */\nfunction tryCatch<T>(fn: () => T): Result<T, Error>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError: (error: unknown) => E\n): Result<T, E>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError?: (error: unknown) => E\n): Result<T, E | Error> {\n try {\n return ok(fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap an asynchronous function that may reject into a `Result`. */\nfunction tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;\nfunction tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap a `Promise` that may reject into a `Result`. */\nfunction fromPromise<T>(promise: Promise<T>): Promise<Result<T, Error>>;\nfunction fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await promise);\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/**\n * Combine multiple `Result`s into a single `Result` containing a tuple of\n * values. Returns the first `Err` encountered (fail-fast).\n *\n * Pass results as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction all<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, TupleErrors<R>> {\n const values: unknown[] = [];\n for (const result of results) {\n if (!result.ok) return err(result.error) as ErrResult<TupleErrors<R>>;\n values.push(result.value);\n }\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n/**\n * Like `all`, but accepts promises of `Result`s. All promises are resolved\n * concurrently via `Promise.allSettled` before checking for errors.\n *\n * Promises are expected to resolve to `Result`s — not reject. If a promise\n * does reject, the rejection is caught and wrapped as an `Err`.\n *\n * @breaking v0.2 — Uses `Promise.allSettled` instead of `Promise.all`. All\n * promises are now always awaited to completion; the first error found during\n * iteration is returned.\n */\nasync function allAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<\n Result<\n { [K in keyof R]: ValueOf<Awaited<R[K]>> },\n ErrorOf<Awaited<R[number]>> | Error\n >\n> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n type Errors = ErrorOf<Awaited<R[number]>> | Error;\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n return err(normalizeError(s.reason)) as ErrResult<Errors>;\n }\n if (!s.value.ok) {\n return err(s.value.error) as ErrResult<Errors>;\n }\n values.push(s.value.value);\n }\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Like `collect`, but for promises of `Result`s. Resolves all promises\n * via `Promise.allSettled`, then collects all errors. Returns an\n * `AggregateError` containing every error found.\n */\nasync function collectAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<Result<{ [K in keyof R]: ValueOf<Awaited<R[K]>> }, AggregateError>> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n errors.push(normalizeError(s.reason));\n } else if (!s.value.ok) {\n errors.push(s.value.error);\n } else {\n values.push(s.value.value);\n }\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Combine multiple `Result`s, collecting **all** errors instead of\n * short-circuiting on the first one. Returns an `AggregateError` whose\n * `.errors` array contains every individual error.\n */\nfunction collect<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, AggregateError> {\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const result of results) {\n if (result.ok) values.push(result.value);\n else errors.push(result.error);\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n// ===========================================================================\n// Maybe\n// ===========================================================================\n\n/** A `Maybe` that contains a value of type `T`. */\nexport type Some<T> = {\n readonly some: true;\n readonly value: T;\n map<U>(fn: (value: T) => U): Some<U>;\n flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>;\n filter(predicate: (value: T) => boolean): Maybe<T>;\n inspect(fn: (value: T) => void): Some<T>;\n match<R>(handlers: { some: (value: T) => R; none: () => R }): R;\n unwrap(): T;\n expect(message: string): T;\n unwrapOr(fallback: T): T;\n unwrapOrElse(fn: () => T): T;\n};\n\n/** A `Maybe` that contains no value. */\nexport type None = {\n readonly some: false;\n map<U>(fn: (value: never) => U): None;\n flatMap<U>(fn: (value: never) => Maybe<U>): None;\n filter(predicate: (value: never) => boolean): None;\n inspect(fn: (value: never) => void): None;\n match<R>(handlers: { some: (value: never) => R; none: () => R }): R;\n unwrap(): never;\n expect(message: string): never;\n unwrapOr<T>(fallback: T): T;\n unwrapOrElse<T>(fn: () => T): T;\n};\n\n/**\n * A value that is either present (`Some<T>`) or absent (`None`).\n * Use `Maybe.some` / `Maybe.none` to construct, and the companion `Maybe.*`\n * functions or instance methods to transform.\n */\nexport type Maybe<T> = Some<T> | None;\n\ntype AnyMaybe = Maybe<unknown>;\n\ntype MaybeValueOf<M> = M extends Some<infer T> ? T : never;\n\ntype TupleMaybeValues<M extends readonly AnyMaybe[]> = {\n [K in keyof M]: MaybeValueOf<M[K]>;\n};\n\n/** Create a `Maybe` containing `value`. */\nfunction some<T>(value: T): Some<T> {\n const self: Some<T> = Object.freeze({\n some: true as const,\n value,\n map: <U>(fn: (value: T) => U): Some<U> => some(fn(value)),\n flatMap: <U>(fn: (value: T) => Maybe<U>): Maybe<U> => fn(value),\n filter: (predicate: (value: T) => boolean): Maybe<T> =>\n predicate(value) ? self : NONE,\n inspect: (fn: (value: T) => void): Some<T> => {\n fn(value);\n return self;\n },\n match: <R>(handlers: { some: (value: T) => R; none: () => R }): R =>\n handlers.some(value),\n unwrap: (): T => value,\n expect: (_message: string): T => value,\n unwrapOr: (_fallback: T): T => value,\n unwrapOrElse: (_fn: () => T): T => value,\n });\n return self;\n}\n\nconst NONE: None = Object.freeze({\n some: false as const,\n map: <U>(_fn: (value: never) => U): None => NONE,\n flatMap: <U>(_fn: (value: never) => Maybe<U>): None => NONE,\n filter: (_predicate: (value: never) => boolean): None => NONE,\n inspect: (_fn: (value: never) => void): None => NONE,\n match: <R>(handlers: { some: (value: never) => R; none: () => R }): R =>\n handlers.none(),\n unwrap: (): never => {\n throw new Error(\"Called unwrap on None\");\n },\n expect: (message: string): never => {\n throw new Error(message);\n },\n unwrapOr: <T>(fallback: T): T => fallback,\n unwrapOrElse: <T>(fn: () => T): T => fn(),\n});\n\n/** Create an empty `Maybe`. */\nfunction none(): None {\n return NONE;\n}\n\n/** Narrow a `Maybe` to `Some`. */\nfunction isSome<T>(maybe: Maybe<T>): maybe is Some<T> {\n return maybe.some;\n}\n\n/** Narrow a `Maybe` to `None`. */\nfunction isNone<T>(maybe: Maybe<T>): maybe is None {\n return !maybe.some;\n}\n\n/** Transform the value inside a `Some`, leaving `None` unchanged. */\nfunction maybeMap<T, U>(maybe: Some<T>, fn: (value: T) => U): Some<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U> {\n return maybe.some ? some(fn(maybe.value)) : NONE;\n}\n\n/** Chain a `Maybe`-returning function on the `Some` value. */\nfunction maybeFlatMap<T, U>(\n maybe: Maybe<T>,\n fn: (value: T) => Maybe<U>\n): Maybe<U> {\n return maybe.some ? fn(maybe.value) : NONE;\n}\n\n/** Flatten a nested `Maybe<Maybe<T>>` into `Maybe<T>`. */\nfunction maybeFlatten<T>(maybe: Maybe<Maybe<T>>): Maybe<T> {\n return maybe.some ? maybe.value : NONE;\n}\n\n/** Keep the `Some` value only if `predicate` returns true. */\nfunction maybeFilter<T, S extends T>(\n maybe: Maybe<T>,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return maybe.some && predicate(maybe.value) ? maybe : NONE;\n}\n\n/** Run a side-effect on the `Some` value without transforming the maybe. */\nfunction maybeInspect<T>(maybe: Some<T>, fn: (value: T) => void): Some<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T> {\n if (maybe.some) fn(maybe.value);\n return maybe;\n}\n\n/** Exhaustively handle both `Some` and `None` branches, returning `R`. */\nfunction maybeMatch<T, R>(\n maybe: Maybe<T>,\n handlers: { some: (value: T) => R; none: () => R }\n): R {\n return maybe.some ? handlers.some(maybe.value) : handlers.none();\n}\n\n/** Return the `Some` value or throw. */\nfunction maybeUnwrap<T>(maybe: Maybe<T>): T {\n if (maybe.some) return maybe.value;\n throw new Error(\"Called unwrap on None\");\n}\n\n/**\n * Return the `Some` value or `fallback`.\n *\n * The fallback must be the same type `T` as the contained value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction maybeUnwrapOr<T>(maybe: Maybe<T>, fallback: T): T {\n return maybe.some ? maybe.value : fallback;\n}\n\n/** Return the `Some` value, or compute a fallback from `fn`. */\nfunction maybeUnwrapOrElse<T>(maybe: Maybe<T>, fn: () => T): T {\n return maybe.some ? maybe.value : fn();\n}\n\n/** Return the `Some` value or throw with a custom `message`. */\nfunction maybeExpect<T>(maybe: Maybe<T>, message: string): T {\n if (maybe.some) return maybe.value;\n throw new Error(message);\n}\n\n/** Convert a nullable value to a `Maybe`. */\nfunction maybeFromNullable<T>(\n value: T | null | undefined\n): Maybe<NonNullable<T>> {\n return value != null ? some(value as NonNullable<T>) : NONE;\n}\n\n/** Convert a predicate check to a `Maybe`. Supports type-guard predicates. */\nfunction maybeFromPredicate<T, S extends T>(\n value: T,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return predicate(value) ? some(value) : NONE;\n}\n\n/**\n * Combine multiple `Maybe`s into a single `Maybe` containing a tuple of\n * values. Returns `None` if any input is `None` (fail-fast).\n *\n * Pass maybes as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction maybeAll<const M extends readonly AnyMaybe[]>(\n ...maybes: M\n): Maybe<TupleMaybeValues<M>> {\n const values: unknown[] = [];\n for (const m of maybes) {\n if (!m.some) return NONE;\n values.push(m.value);\n }\n return some(values) as Some<TupleMaybeValues<M>>;\n}\n\n/** Return the first `Some` found, or `None` if all are `None`. */\nfunction maybeFirstSome<T>(...maybes: Maybe<T>[]): Maybe<T> {\n for (const m of maybes) {\n if (m.some) return m;\n }\n return NONE;\n}\n\n/** Like `all`, but for promises of `Maybe`s. Resolves all promises\n * concurrently via `Promise.allSettled`. */\nasync function maybeAllAsync<const M extends readonly Promise<AnyMaybe>[]>(\n ...promises: M\n): Promise<Maybe<{ [K in keyof M]: MaybeValueOf<Awaited<M[K]>> }>> {\n type Values = { [K in keyof M]: MaybeValueOf<Awaited<M[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") return NONE;\n if (!s.value.some) return NONE;\n values.push(s.value.value);\n }\n return some(values) as Some<Values>;\n}\n\n/** Combine multiple `Maybe's, returning `None` if any is `None`.\n * Same as `all` — `None` carries no error data to collect,\n * unlike `Result.collect` which gathers all errors.\n */\nconst maybeCollect = maybeAll;\n\n// ---------------------------------------------------------------------------\n// Maybe <-> Result interop\n// ---------------------------------------------------------------------------\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`. The factory is only called when the Maybe is\n * None, avoiding unnecessary error construction for Some.\n */\nfunction maybeToResult<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybe.some ? ok(maybe.value) : err(errorFactory());\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction maybeFromResult<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return result.ok ? some(result.value) : NONE;\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction resultToMaybe<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return maybeFromResult(result);\n}\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n * Alias for `maybeToResult`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`.\n */\nfunction resultFromMaybe<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybeToResult(maybe, errorFactory);\n}\n\n/** Convert a `Result<Maybe<T>, E>` to `Maybe<Result<T, E>>`. */\nfunction resultTranspose<T, E extends Error>(\n result: Result<Maybe<T>, E>\n): Maybe<Result<T, E>> {\n if (!result.ok) return some(result as ErrResult<E>);\n if (result.value.some) return some(ok(result.value.value));\n return NONE;\n}\n\n/** Convert a `Maybe<Result<T, E>>` to `Result<Maybe<T>, E>`. */\nfunction maybeTranspose<T, E extends Error>(\n maybe: Maybe<Result<T, E>>\n): Result<Maybe<T>, E> {\n if (!maybe.some) return ok(NONE) as OkResult<Maybe<T>>;\n if (maybe.value.ok) return ok(some(maybe.value.value));\n return err(maybe.value.error) as ErrResult<E>;\n}\n\nexport const Maybe = {\n some,\n none,\n isSome,\n isNone,\n map: maybeMap,\n flatMap: maybeFlatMap,\n flatten: maybeFlatten,\n filter: maybeFilter,\n inspect: maybeInspect,\n match: maybeMatch,\n unwrap: maybeUnwrap,\n unwrapOr: maybeUnwrapOr,\n unwrapOrElse: maybeUnwrapOrElse,\n expect: maybeExpect,\n fromNullable: maybeFromNullable,\n fromPredicate: maybeFromPredicate,\n all: maybeAll,\n allAsync: maybeAllAsync,\n collect: maybeCollect,\n firstSome: maybeFirstSome,\n toResult: maybeToResult,\n fromResult: maybeFromResult,\n transpose: maybeTranspose,\n} as const satisfies Record<string, (...args: never[]) => unknown>;\n\n// Add interop to Result namespace\nexport const Result = {\n ok,\n err,\n isOk,\n isErr,\n map,\n mapError,\n inspect,\n inspectError,\n flatMap,\n flatMapErr,\n orElse,\n flatten,\n match,\n exhaustive,\n unwrap,\n unwrapOr,\n unwrapOrElse,\n expect,\n fromNullable,\n fromPredicate,\n normalizeError,\n tryCatch,\n tryCatchAsync,\n fromPromise,\n all,\n allAsync,\n collect,\n collectAsync,\n toMaybe: resultToMaybe,\n fromMaybe: resultFromMaybe,\n transpose: resultTranspose,\n} as const satisfies Record<string, (...args: never[]) => unknown>;\n\nexport { err, isErr, isNone, isOk, isSome, none, normalizeError, ok, some };\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** A successful result containing a value of type `T`. */\nexport type OkResult<T> = {\n readonly ok: true;\n readonly value: T;\n};\n\n/** A failed result containing an error of type `E`. */\nexport type ErrResult<E extends Error = Error> = {\n readonly ok: false;\n readonly error: E;\n};\n\n/**\n * A value that is either a success (`OkResult<T>`) or a failure\n * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the\n * companion `Result.*` functions to transform.\n */\nexport type Result<T, E extends Error = Error> = OkResult<T> | ErrResult<E>;\n\ntype AnyResult = Result<unknown, Error>;\n\ntype ValueOf<R> = R extends OkResult<infer T> ? T : never;\ntype ErrorOf<R> = R extends ErrResult<infer E> ? E : never;\n\ntype TupleValues<R extends readonly AnyResult[]> = {\n [K in keyof R]: ValueOf<R[K]>;\n};\ntype TupleErrors<R extends readonly AnyResult[]> = ErrorOf<R[number]>;\n\nfunction createOk<T>(value: T): OkResult<T> {\n return Object.freeze({\n ok: true as const,\n value,\n });\n}\n\nfunction ok(): OkResult<undefined>;\nfunction ok<T>(value: T): OkResult<T>;\nfunction ok<T>(...args: [] | [value: T]): OkResult<undefined> | OkResult<T> {\n return args.length === 0 ? createOk(undefined) : createOk(args[0]);\n}\n\n/** Create a failed `Result` containing `error`. */\nfunction err<E extends Error>(error: E): ErrResult<E> {\n return Object.freeze({\n ok: false as const,\n error,\n });\n}\n\n/** Narrow a `Result` to `OkResult`. */\nfunction isOk<T, E extends Error>(result: Result<T, E>): result is OkResult<T> {\n return result.ok;\n}\n\n/** Narrow a `Result` to `ErrResult`. */\nfunction isErr<T, E extends Error>(\n result: Result<T, E>\n): result is ErrResult<E> {\n return !result.ok;\n}\n\n/** Transform the value inside an `Ok`, leaving `Err` unchanged. */\nfunction map<T, U>(result: OkResult<T>, fn: (value: T) => U): OkResult<U>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E> {\n return result.ok ? ok(fn(result.value)) : result;\n}\n\n/** Transform the error inside an `Err`, leaving `Ok` unchanged. */\nfunction mapError<T>(\n result: OkResult<T>,\n fn: (error: never) => Error\n): OkResult<T>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => F\n): Result<T, F>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: OkResult<T> | Result<T, E>,\n fn: ((error: never) => Error) | ((error: E) => F)\n): OkResult<T> | Result<T, F> {\n return result.ok ? result : err((fn as (error: E) => F)(result.error));\n}\n\n/** Run a side-effect on the `Ok` value without transforming the result. */\nfunction inspect<T>(result: OkResult<T>, fn: (value: T) => void): OkResult<T>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E> {\n if (result.ok) fn(result.value);\n return result;\n}\n\n/** Run a side-effect on the `Err` error without transforming the result. */\nfunction inspectError<E extends Error>(\n result: ErrResult<E>,\n fn: (error: E) => void\n): ErrResult<E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E> {\n if (!result.ok) fn(result.error);\n return result;\n}\n\n/** Chain a `Result`-returning function on the `Ok` value. */\nfunction flatMap<T, U, E extends Error, F extends Error = never>(\n result: Result<T, E>,\n fn: (value: T) => Result<U, F>\n): Result<U, E | F> {\n if (result.ok) return fn(result.value);\n return result;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias: `flatMapErr`.\n */\nfunction orElse<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n if (!result.ok) return fn(result.error);\n return result;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias for `orElse`.\n */\nfunction flatMapErr<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n return orElse(result, fn);\n}\n\n/** Flatten a nested `Result<Result<T, E>, F>` into `Result<T, E | F>`. */\nfunction flatten<T, E extends Error, F extends Error>(\n result: Result<Result<T, E>, F>\n): Result<T, E | F> {\n return result.ok ? result.value : result;\n}\n\n/** Exhaustively handle both `Ok` and `Err` branches, returning `R`. */\nfunction match<T, E extends Error, R>(\n result: Result<T, E>,\n handlers: { ok: (value: T) => R; err: (error: E) => R }\n): R {\n return result.ok ? handlers.ok(result.value) : handlers.err(result.error);\n}\n\n/** Compile-time exhaustiveness guard — only accepts `never`. */\nfunction exhaustive(value: never): never {\n let detail: string;\n try {\n detail = JSON.stringify(value);\n } catch {\n detail = String(value);\n }\n throw new Error(`Unhandled result case: ${detail}`);\n}\n\n/** Return the `Ok` value or throw the contained error. */\nfunction unwrap<T, E extends Error>(result: Result<T, E>): T {\n if (result.ok) return result.value;\n throw result.error;\n}\n\n/**\n * Return the `Ok` value or `fallback`.\n *\n * The fallback must be the same type `T` as the success value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T {\n return result.ok ? result.value : fallback;\n}\n\n/** Return the `Ok` value, or compute a fallback from `fn`. */\nfunction unwrapOrElse<T, E extends Error>(\n result: Result<T, E>,\n fn: () => T\n): T {\n return result.ok ? result.value : fn();\n}\n\n/** Convert a nullable value to a `Result`. */\nfunction fromNullable<T, E extends Error>(\n value: T | null | undefined,\n errorFactory: () => E\n): Result<NonNullable<T>, E> {\n return value != null ? ok(value) : err(errorFactory());\n}\n\n/** Convert a predicate check to a `Result`. Supports type-guard predicates. */\nfunction fromPredicate<T, S extends T, E extends Error>(\n value: T,\n predicate: (value: T) => value is S,\n errorFactory: () => E\n): Result<S, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E> {\n return predicate(value) ? ok(value) : err(errorFactory());\n}\n\n/** Convert an unknown thrown value to an `Error` instance. */\nfunction normalizeError(error: unknown): Error {\n if (error instanceof Error) return error;\n if (error === null || error === undefined) return new Error(String(error));\n if (typeof error === \"object\") {\n try {\n const json = JSON.stringify(error);\n if (json !== \"{}\") return new Error(json);\n // JSON.stringify produced '{}' — likely RegExp or similar with no\n // enumerable own properties. Fall through to String().\n } catch {\n // JSON.stringify throws on BigInt and circular references\n }\n }\n try {\n return new Error(String(error));\n } catch {\n return new Error(\"Non-stringifiable thrown value\");\n }\n}\n\n/** Wrap a synchronous function that may throw into a `Result`. */\nfunction tryCatch<T>(fn: () => T): Result<T, Error>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError: (error: unknown) => E\n): Result<T, E>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError?: (error: unknown) => E\n): Result<T, E | Error> {\n try {\n return ok(fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap an asynchronous function that may reject into a `Result`. */\nfunction tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;\nfunction tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap a `Promise` that may reject into a `Result`. */\nfunction fromPromise<T>(promise: Promise<T>): Promise<Result<T, Error>>;\nfunction fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await promise);\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/**\n * Combine multiple `Result`s into a single `Result` containing a tuple of\n * values. Returns the first `Err` encountered (fail-fast).\n *\n * Pass results as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction all<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, TupleErrors<R>> {\n const values: unknown[] = [];\n for (const result of results) {\n if (!result.ok) return err(result.error) as ErrResult<TupleErrors<R>>;\n values.push(result.value);\n }\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n/**\n * Like `all`, but accepts promises of `Result`s. All promises are resolved\n * concurrently via `Promise.allSettled` before checking for errors.\n *\n * Promises are expected to resolve to `Result`s — not reject. If a promise\n * does reject, the rejection is caught and wrapped as an `Err`.\n *\n * @breaking v0.2 — Uses `Promise.allSettled` instead of `Promise.all`. All\n * promises are now always awaited to completion; the first error found during\n * iteration is returned.\n */\nasync function allAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<\n Result<\n { [K in keyof R]: ValueOf<Awaited<R[K]>> },\n ErrorOf<Awaited<R[number]>> | Error\n >\n> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n type Errors = ErrorOf<Awaited<R[number]>> | Error;\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n return err(normalizeError(s.reason)) as ErrResult<Errors>;\n }\n if (!s.value.ok) {\n return err(s.value.error) as ErrResult<Errors>;\n }\n values.push(s.value.value);\n }\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Like `collect`, but for promises of `Result`s. Resolves all promises\n * via `Promise.allSettled`, then collects all errors. Returns an\n * `AggregateError` containing every error found.\n */\nasync function collectAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<Result<{ [K in keyof R]: ValueOf<Awaited<R[K]>> }, AggregateError>> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n errors.push(normalizeError(s.reason));\n } else if (!s.value.ok) {\n errors.push(s.value.error);\n } else {\n values.push(s.value.value);\n }\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Combine multiple `Result`s, collecting **all** errors instead of\n * short-circuiting on the first one. Returns an `AggregateError` whose\n * `.errors` array contains every individual error.\n */\nfunction collect<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, AggregateError> {\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const result of results) {\n if (result.ok) values.push(result.value);\n else errors.push(result.error);\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n// ===========================================================================\n// Maybe\n// ===========================================================================\n\n/** A `Maybe` that contains a value of type `T`. */\nexport type Some<T> = {\n readonly some: true;\n readonly value: T;\n};\n\n/** A `Maybe` that contains no value. */\nexport type None = {\n readonly some: false;\n};\n\n/**\n * A value that is either present (`Some<T>`) or absent (`None`).\n * Use `Maybe.some` / `Maybe.none` to construct, and the companion `Maybe.*`\n * functions to transform.\n */\nexport type Maybe<T> = Some<T> | None;\n\ntype AnyMaybe = Maybe<unknown>;\n\ntype MaybeValueOf<M> = M extends Some<infer T> ? T : never;\n\ntype TupleMaybeValues<M extends readonly AnyMaybe[]> = {\n [K in keyof M]: MaybeValueOf<M[K]>;\n};\n\n/** Create a `Maybe` containing `value`. */\nfunction some<T>(value: T): Some<T> {\n return Object.freeze({\n some: true as const,\n value,\n });\n}\n\nconst NONE: None = Object.freeze({\n some: false as const,\n});\n\n/** Create an empty `Maybe`. */\nfunction none(): None {\n return NONE;\n}\n\n/** Narrow a `Maybe` to `Some`. */\nfunction isSome<T>(maybe: Maybe<T>): maybe is Some<T> {\n return maybe.some;\n}\n\n/** Narrow a `Maybe` to `None`. */\nfunction isNone<T>(maybe: Maybe<T>): maybe is None {\n return !maybe.some;\n}\n\n/** Transform the value inside a `Some`, leaving `None` unchanged. */\nfunction maybeMap<T, U>(maybe: Some<T>, fn: (value: T) => U): Some<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U> {\n return maybe.some ? some(fn(maybe.value)) : NONE;\n}\n\n/** Chain a `Maybe`-returning function on the `Some` value. */\nfunction maybeFlatMap<T, U>(\n maybe: Maybe<T>,\n fn: (value: T) => Maybe<U>\n): Maybe<U> {\n return maybe.some ? fn(maybe.value) : NONE;\n}\n\n/** Flatten a nested `Maybe<Maybe<T>>` into `Maybe<T>`. */\nfunction maybeFlatten<T>(maybe: Maybe<Maybe<T>>): Maybe<T> {\n return maybe.some ? maybe.value : NONE;\n}\n\n/** Keep the `Some` value only if `predicate` returns true. */\nfunction maybeFilter<T, S extends T>(\n maybe: Maybe<T>,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return maybe.some && predicate(maybe.value) ? maybe : NONE;\n}\n\n/** Run a side-effect on the `Some` value without transforming the maybe. */\nfunction maybeInspect<T>(maybe: Some<T>, fn: (value: T) => void): Some<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T> {\n if (maybe.some) fn(maybe.value);\n return maybe;\n}\n\n/** Exhaustively handle both `Some` and `None` branches, returning `R`. */\nfunction maybeMatch<T, R>(\n maybe: Maybe<T>,\n handlers: { some: (value: T) => R; none: () => R }\n): R {\n return maybe.some ? handlers.some(maybe.value) : handlers.none();\n}\n\n/** Return the `Some` value or throw. */\nfunction maybeUnwrap<T>(maybe: Maybe<T>): T {\n if (maybe.some) return maybe.value;\n throw new Error(\"Called unwrap on None\");\n}\n\n/**\n * Return the `Some` value or `fallback`.\n *\n * The fallback must be the same type `T` as the contained value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction maybeUnwrapOr<T>(maybe: Maybe<T>, fallback: T): T {\n return maybe.some ? maybe.value : fallback;\n}\n\n/** Return the `Some` value, or compute a fallback from `fn`. */\nfunction maybeUnwrapOrElse<T>(maybe: Maybe<T>, fn: () => T): T {\n return maybe.some ? maybe.value : fn();\n}\n\n/** Convert a nullable value to a `Maybe`. */\nfunction maybeFromNullable<T>(\n value: T | null | undefined\n): Maybe<NonNullable<T>> {\n return value != null ? some(value) : NONE;\n}\n\n/** Convert a predicate check to a `Maybe`. Supports type-guard predicates. */\nfunction maybeFromPredicate<T, S extends T>(\n value: T,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return predicate(value) ? some(value) : NONE;\n}\n\n/**\n * Combine multiple `Maybe`s into a single `Maybe` containing a tuple of\n * values. Returns `None` if any input is `None` (fail-fast).\n *\n * Pass maybes as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction maybeAll<const M extends readonly AnyMaybe[]>(\n ...maybes: M\n): Maybe<TupleMaybeValues<M>> {\n const values: unknown[] = [];\n for (const m of maybes) {\n if (!m.some) return NONE;\n values.push(m.value);\n }\n return some(values) as Some<TupleMaybeValues<M>>;\n}\n\n/** Return the first `Some` found, or `None` if all are `None`. */\nfunction maybeFirstSome<T>(...maybes: Maybe<T>[]): Maybe<T> {\n for (const m of maybes) {\n if (m.some) return m;\n }\n return NONE;\n}\n\n/** Like `all`, but for promises of `Maybe`s. Resolves all promises\n * concurrently via `Promise.allSettled`. */\nasync function maybeAllAsync<const M extends readonly Promise<AnyMaybe>[]>(\n ...promises: M\n): Promise<Maybe<{ [K in keyof M]: MaybeValueOf<Awaited<M[K]>> }>> {\n type Values = { [K in keyof M]: MaybeValueOf<Awaited<M[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") return NONE;\n if (!s.value.some) return NONE;\n values.push(s.value.value);\n }\n return some(values) as Some<Values>;\n}\n\n/** Combine multiple `Maybe's, returning `None` if any is `None`.\n * Same as `all` — `None` carries no error data to collect,\n * unlike `Result.collect` which gathers all errors.\n */\nconst maybeCollect = maybeAll;\n\n// ---------------------------------------------------------------------------\n// Maybe <-> Result interop\n// ---------------------------------------------------------------------------\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`. The factory is only called when the Maybe is\n * None, avoiding unnecessary error construction for Some.\n */\nfunction maybeToResult<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybe.some ? ok(maybe.value) : err(errorFactory());\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction maybeFromResult<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return result.ok ? some(result.value) : NONE;\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction resultToMaybe<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return maybeFromResult(result);\n}\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n * Alias for `maybeToResult`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`.\n */\nfunction resultFromMaybe<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybeToResult(maybe, errorFactory);\n}\n\n/** Convert a `Result<Maybe<T>, E>` to `Maybe<Result<T, E>>`. */\nfunction resultTranspose<T, E extends Error>(\n result: Result<Maybe<T>, E>\n): Maybe<Result<T, E>> {\n if (!result.ok) return some(result);\n if (result.value.some) return some(ok(result.value.value));\n return NONE;\n}\n\n/** Convert a `Maybe<Result<T, E>>` to `Result<Maybe<T>, E>`. */\nfunction maybeTranspose<T, E extends Error>(\n maybe: Maybe<Result<T, E>>\n): Result<Maybe<T>, E> {\n if (!maybe.some) return ok(NONE);\n if (maybe.value.ok) return ok(some(maybe.value.value));\n return err(maybe.value.error);\n}\n\nexport const Maybe = {\n some,\n none,\n isSome,\n isNone,\n map: maybeMap,\n flatMap: maybeFlatMap,\n flatten: maybeFlatten,\n filter: maybeFilter,\n inspect: maybeInspect,\n match: maybeMatch,\n unwrap: maybeUnwrap,\n unwrapOr: maybeUnwrapOr,\n unwrapOrElse: maybeUnwrapOrElse,\n fromNullable: maybeFromNullable,\n fromPredicate: maybeFromPredicate,\n all: maybeAll,\n allAsync: maybeAllAsync,\n collect: maybeCollect,\n firstSome: maybeFirstSome,\n toResult: maybeToResult,\n fromResult: maybeFromResult,\n transpose: maybeTranspose,\n} as const;\n\n// Add interop to Result namespace\nexport const Result = {\n ok,\n err,\n isOk,\n isErr,\n map,\n mapError,\n inspect,\n inspectError,\n flatMap,\n flatMapErr,\n orElse,\n flatten,\n match,\n exhaustive,\n unwrap,\n unwrapOr,\n unwrapOrElse,\n fromNullable,\n fromPredicate,\n normalizeError,\n tryCatch,\n tryCatchAsync,\n fromPromise,\n all,\n allAsync,\n collect,\n collectAsync,\n toMaybe: resultToMaybe,\n fromMaybe: resultFromMaybe,\n transpose: resultTranspose,\n} as const;\n\nexport { err, isErr, isNone, isOk, isSome, none, normalizeError, ok, some };\n"],"mappings":"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","names":[]}
package/dist/index.d.cts CHANGED
@@ -2,37 +2,11 @@
2
2
  type OkResult<T> = {
3
3
  readonly ok: true;
4
4
  readonly value: T;
5
- map<U>(fn: (value: T) => U): OkResult<U>;
6
- flatMap<U, F extends Error = never>(fn: (value: T) => Result<U, F>): Result<U, F>;
7
- mapError<F extends Error>(fn: (error: never) => F): OkResult<T>;
8
- inspect(fn: (value: T) => void): OkResult<T>;
9
- inspectError(fn: (error: never) => void): OkResult<T>;
10
- match<R>(handlers: {
11
- ok: (value: T) => R;
12
- err: (error: never) => R;
13
- }): R;
14
- unwrap(): T;
15
- unwrapOr(fallback: T): T;
16
- unwrapOrElse(fn: () => T): T;
17
- expect(message: string): T;
18
5
  };
19
6
  /** A failed result containing an error of type `E`. */
20
7
  type ErrResult<E extends Error = Error> = {
21
8
  readonly ok: false;
22
9
  readonly error: E;
23
- map<U>(fn: (value: never) => U): ErrResult<E>;
24
- flatMap<U, F extends Error = never>(fn: (value: never) => Result<U, F>): ErrResult<E>;
25
- mapError<F extends Error>(fn: (error: E) => F): ErrResult<F>;
26
- inspect(fn: (value: never) => void): ErrResult<E>;
27
- inspectError(fn: (error: E) => void): ErrResult<E>;
28
- match<R>(handlers: {
29
- ok: (value: never) => R;
30
- err: (error: E) => R;
31
- }): R;
32
- unwrap(): never;
33
- unwrapOr<T>(fallback: T): T;
34
- unwrapOrElse<T>(fn: () => T): T;
35
- expect(message: string): never;
36
10
  };
37
11
  type AnyResult = Result<unknown, Error>;
38
12
  type ValueOf<R> = R extends OkResult<infer T> ? T : never;
@@ -41,7 +15,6 @@ type TupleValues<R extends readonly AnyResult[]> = {
41
15
  [K in keyof R]: ValueOf<R[K]>;
42
16
  };
43
17
  type TupleErrors<R extends readonly AnyResult[]> = ErrorOf<R[number]>;
44
- /** Create a successful `Result` containing `value`. */
45
18
  declare function ok(): OkResult<undefined>;
46
19
  declare function ok<T>(value: T): OkResult<T>;
47
20
  /** Create a failed `Result` containing `error`. */
@@ -94,8 +67,6 @@ declare function unwrap<T, E extends Error>(result: Result<T, E>): T;
94
67
  declare function unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T;
95
68
  /** Return the `Ok` value, or compute a fallback from `fn`. */
96
69
  declare function unwrapOrElse<T, E extends Error>(result: Result<T, E>, fn: () => T): T;
97
- /** Return the `Ok` value or throw with a custom `message`. */
98
- declare function expect<T, E extends Error>(result: Result<T, E>, message: string): T;
99
70
  /** Convert a nullable value to a `Result`. */
100
71
  declare function fromNullable<T, E extends Error>(value: T | null | undefined, errorFactory: () => E): Result<NonNullable<T>, E>;
101
72
  /** Convert a predicate check to a `Result`. Supports type-guard predicates. */
@@ -152,34 +123,10 @@ declare function collect<const R extends readonly AnyResult[]>(...results: R): R
152
123
  type Some<T> = {
153
124
  readonly some: true;
154
125
  readonly value: T;
155
- map<U>(fn: (value: T) => U): Some<U>;
156
- flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>;
157
- filter(predicate: (value: T) => boolean): Maybe<T>;
158
- inspect(fn: (value: T) => void): Some<T>;
159
- match<R>(handlers: {
160
- some: (value: T) => R;
161
- none: () => R;
162
- }): R;
163
- unwrap(): T;
164
- expect(message: string): T;
165
- unwrapOr(fallback: T): T;
166
- unwrapOrElse(fn: () => T): T;
167
126
  };
168
127
  /** A `Maybe` that contains no value. */
169
128
  type None = {
170
129
  readonly some: false;
171
- map<U>(fn: (value: never) => U): None;
172
- flatMap<U>(fn: (value: never) => Maybe<U>): None;
173
- filter(predicate: (value: never) => boolean): None;
174
- inspect(fn: (value: never) => void): None;
175
- match<R>(handlers: {
176
- some: (value: never) => R;
177
- none: () => R;
178
- }): R;
179
- unwrap(): never;
180
- expect(message: string): never;
181
- unwrapOr<T>(fallback: T): T;
182
- unwrapOrElse<T>(fn: () => T): T;
183
130
  };
184
131
  type AnyMaybe = Maybe<unknown>;
185
132
  type MaybeValueOf<M> = M extends Some<infer T> ? T : never;
@@ -223,8 +170,6 @@ declare function maybeUnwrap<T>(maybe: Maybe<T>): T;
223
170
  declare function maybeUnwrapOr<T>(maybe: Maybe<T>, fallback: T): T;
224
171
  /** Return the `Some` value, or compute a fallback from `fn`. */
225
172
  declare function maybeUnwrapOrElse<T>(maybe: Maybe<T>, fn: () => T): T;
226
- /** Return the `Some` value or throw with a custom `message`. */
227
- declare function maybeExpect<T>(maybe: Maybe<T>, message: string): T;
228
173
  /** Convert a nullable value to a `Maybe`. */
229
174
  declare function maybeFromNullable<T>(value: T | null | undefined): Maybe<NonNullable<T>>;
230
175
  /** Convert a predicate check to a `Maybe`. Supports type-guard predicates. */
@@ -270,7 +215,7 @@ declare function maybeTranspose<T, E extends Error>(maybe: Maybe<Result<T, E>>):
270
215
  /**
271
216
  * A value that is either present (`Some<T>`) or absent (`None`).
272
217
  * Use `Maybe.some` / `Maybe.none` to construct, and the companion `Maybe.*`
273
- * functions or instance methods to transform.
218
+ * functions to transform.
274
219
  */
275
220
  type Maybe<T> = Some<T> | None;
276
221
  declare const Maybe: {
@@ -287,7 +232,6 @@ declare const Maybe: {
287
232
  readonly unwrap: typeof maybeUnwrap;
288
233
  readonly unwrapOr: typeof maybeUnwrapOr;
289
234
  readonly unwrapOrElse: typeof maybeUnwrapOrElse;
290
- readonly expect: typeof maybeExpect;
291
235
  readonly fromNullable: typeof maybeFromNullable;
292
236
  readonly fromPredicate: typeof maybeFromPredicate;
293
237
  readonly all: typeof maybeAll;
@@ -300,8 +244,8 @@ declare const Maybe: {
300
244
  };
301
245
  /**
302
246
  * A value that is either a success (`OkResult<T>`) or a failure
303
- * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the
304
- * companion `Result.*` functions or instance methods to transform.
247
+ * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the
248
+ * companion `Result.*` functions to transform.
305
249
  */
306
250
  type Result<T, E extends Error = Error> = OkResult<T> | ErrResult<E>;
307
251
  declare const Result: {
@@ -322,7 +266,6 @@ declare const Result: {
322
266
  readonly unwrap: typeof unwrap;
323
267
  readonly unwrapOr: typeof unwrapOr;
324
268
  readonly unwrapOrElse: typeof unwrapOrElse;
325
- readonly expect: typeof expect;
326
269
  readonly fromNullable: typeof fromNullable;
327
270
  readonly fromPredicate: typeof fromPredicate;
328
271
  readonly normalizeError: typeof normalizeError;
package/dist/index.d.ts CHANGED
@@ -2,37 +2,11 @@
2
2
  type OkResult<T> = {
3
3
  readonly ok: true;
4
4
  readonly value: T;
5
- map<U>(fn: (value: T) => U): OkResult<U>;
6
- flatMap<U, F extends Error = never>(fn: (value: T) => Result<U, F>): Result<U, F>;
7
- mapError<F extends Error>(fn: (error: never) => F): OkResult<T>;
8
- inspect(fn: (value: T) => void): OkResult<T>;
9
- inspectError(fn: (error: never) => void): OkResult<T>;
10
- match<R>(handlers: {
11
- ok: (value: T) => R;
12
- err: (error: never) => R;
13
- }): R;
14
- unwrap(): T;
15
- unwrapOr(fallback: T): T;
16
- unwrapOrElse(fn: () => T): T;
17
- expect(message: string): T;
18
5
  };
19
6
  /** A failed result containing an error of type `E`. */
20
7
  type ErrResult<E extends Error = Error> = {
21
8
  readonly ok: false;
22
9
  readonly error: E;
23
- map<U>(fn: (value: never) => U): ErrResult<E>;
24
- flatMap<U, F extends Error = never>(fn: (value: never) => Result<U, F>): ErrResult<E>;
25
- mapError<F extends Error>(fn: (error: E) => F): ErrResult<F>;
26
- inspect(fn: (value: never) => void): ErrResult<E>;
27
- inspectError(fn: (error: E) => void): ErrResult<E>;
28
- match<R>(handlers: {
29
- ok: (value: never) => R;
30
- err: (error: E) => R;
31
- }): R;
32
- unwrap(): never;
33
- unwrapOr<T>(fallback: T): T;
34
- unwrapOrElse<T>(fn: () => T): T;
35
- expect(message: string): never;
36
10
  };
37
11
  type AnyResult = Result<unknown, Error>;
38
12
  type ValueOf<R> = R extends OkResult<infer T> ? T : never;
@@ -41,7 +15,6 @@ type TupleValues<R extends readonly AnyResult[]> = {
41
15
  [K in keyof R]: ValueOf<R[K]>;
42
16
  };
43
17
  type TupleErrors<R extends readonly AnyResult[]> = ErrorOf<R[number]>;
44
- /** Create a successful `Result` containing `value`. */
45
18
  declare function ok(): OkResult<undefined>;
46
19
  declare function ok<T>(value: T): OkResult<T>;
47
20
  /** Create a failed `Result` containing `error`. */
@@ -94,8 +67,6 @@ declare function unwrap<T, E extends Error>(result: Result<T, E>): T;
94
67
  declare function unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T;
95
68
  /** Return the `Ok` value, or compute a fallback from `fn`. */
96
69
  declare function unwrapOrElse<T, E extends Error>(result: Result<T, E>, fn: () => T): T;
97
- /** Return the `Ok` value or throw with a custom `message`. */
98
- declare function expect<T, E extends Error>(result: Result<T, E>, message: string): T;
99
70
  /** Convert a nullable value to a `Result`. */
100
71
  declare function fromNullable<T, E extends Error>(value: T | null | undefined, errorFactory: () => E): Result<NonNullable<T>, E>;
101
72
  /** Convert a predicate check to a `Result`. Supports type-guard predicates. */
@@ -152,34 +123,10 @@ declare function collect<const R extends readonly AnyResult[]>(...results: R): R
152
123
  type Some<T> = {
153
124
  readonly some: true;
154
125
  readonly value: T;
155
- map<U>(fn: (value: T) => U): Some<U>;
156
- flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>;
157
- filter(predicate: (value: T) => boolean): Maybe<T>;
158
- inspect(fn: (value: T) => void): Some<T>;
159
- match<R>(handlers: {
160
- some: (value: T) => R;
161
- none: () => R;
162
- }): R;
163
- unwrap(): T;
164
- expect(message: string): T;
165
- unwrapOr(fallback: T): T;
166
- unwrapOrElse(fn: () => T): T;
167
126
  };
168
127
  /** A `Maybe` that contains no value. */
169
128
  type None = {
170
129
  readonly some: false;
171
- map<U>(fn: (value: never) => U): None;
172
- flatMap<U>(fn: (value: never) => Maybe<U>): None;
173
- filter(predicate: (value: never) => boolean): None;
174
- inspect(fn: (value: never) => void): None;
175
- match<R>(handlers: {
176
- some: (value: never) => R;
177
- none: () => R;
178
- }): R;
179
- unwrap(): never;
180
- expect(message: string): never;
181
- unwrapOr<T>(fallback: T): T;
182
- unwrapOrElse<T>(fn: () => T): T;
183
130
  };
184
131
  type AnyMaybe = Maybe<unknown>;
185
132
  type MaybeValueOf<M> = M extends Some<infer T> ? T : never;
@@ -223,8 +170,6 @@ declare function maybeUnwrap<T>(maybe: Maybe<T>): T;
223
170
  declare function maybeUnwrapOr<T>(maybe: Maybe<T>, fallback: T): T;
224
171
  /** Return the `Some` value, or compute a fallback from `fn`. */
225
172
  declare function maybeUnwrapOrElse<T>(maybe: Maybe<T>, fn: () => T): T;
226
- /** Return the `Some` value or throw with a custom `message`. */
227
- declare function maybeExpect<T>(maybe: Maybe<T>, message: string): T;
228
173
  /** Convert a nullable value to a `Maybe`. */
229
174
  declare function maybeFromNullable<T>(value: T | null | undefined): Maybe<NonNullable<T>>;
230
175
  /** Convert a predicate check to a `Maybe`. Supports type-guard predicates. */
@@ -270,7 +215,7 @@ declare function maybeTranspose<T, E extends Error>(maybe: Maybe<Result<T, E>>):
270
215
  /**
271
216
  * A value that is either present (`Some<T>`) or absent (`None`).
272
217
  * Use `Maybe.some` / `Maybe.none` to construct, and the companion `Maybe.*`
273
- * functions or instance methods to transform.
218
+ * functions to transform.
274
219
  */
275
220
  type Maybe<T> = Some<T> | None;
276
221
  declare const Maybe: {
@@ -287,7 +232,6 @@ declare const Maybe: {
287
232
  readonly unwrap: typeof maybeUnwrap;
288
233
  readonly unwrapOr: typeof maybeUnwrapOr;
289
234
  readonly unwrapOrElse: typeof maybeUnwrapOrElse;
290
- readonly expect: typeof maybeExpect;
291
235
  readonly fromNullable: typeof maybeFromNullable;
292
236
  readonly fromPredicate: typeof maybeFromPredicate;
293
237
  readonly all: typeof maybeAll;
@@ -300,8 +244,8 @@ declare const Maybe: {
300
244
  };
301
245
  /**
302
246
  * A value that is either a success (`OkResult<T>`) or a failure
303
- * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the
304
- * companion `Result.*` functions or instance methods to transform.
247
+ * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the
248
+ * companion `Result.*` functions to transform.
305
249
  */
306
250
  type Result<T, E extends Error = Error> = OkResult<T> | ErrResult<E>;
307
251
  declare const Result: {
@@ -322,7 +266,6 @@ declare const Result: {
322
266
  readonly unwrap: typeof unwrap;
323
267
  readonly unwrapOr: typeof unwrapOr;
324
268
  readonly unwrapOrElse: typeof unwrapOrElse;
325
- readonly expect: typeof expect;
326
269
  readonly fromNullable: typeof fromNullable;
327
270
  readonly fromPredicate: typeof fromPredicate;
328
271
  readonly normalizeError: typeof normalizeError;
package/dist/index.js CHANGED
@@ -1,53 +1,18 @@
1
1
  // src/index.ts
2
- function ok(value) {
3
- const self = Object.freeze({
2
+ function createOk(value) {
3
+ return Object.freeze({
4
4
  ok: true,
5
- value,
6
- map: (fn) => ok(fn(value)),
7
- flatMap: (fn) => fn(value),
8
- mapError: (_fn) => self,
9
- inspect: (fn) => {
10
- fn(value);
11
- return self;
12
- },
13
- inspectError: (_fn) => self,
14
- match: (handlers) => handlers.ok(value),
15
- unwrap: () => value,
16
- unwrapOr: (_fallback) => value,
17
- unwrapOrElse: (_fn) => value,
18
- expect: (_message) => value
5
+ value
19
6
  });
20
- return self;
7
+ }
8
+ function ok(...args) {
9
+ return args.length === 0 ? createOk(void 0) : createOk(args[0]);
21
10
  }
22
11
  function err(error) {
23
- const self = Object.freeze({
12
+ return Object.freeze({
24
13
  ok: false,
25
- error,
26
- map: (_fn) => self,
27
- flatMap: (_fn) => self,
28
- mapError: (fn) => err(fn(error)),
29
- inspect: (_fn) => self,
30
- inspectError: (fn) => {
31
- fn(error);
32
- return self;
33
- },
34
- match: (handlers) => handlers.err(error),
35
- unwrap: () => {
36
- throw error;
37
- },
38
- unwrapOr: (fallback) => fallback,
39
- unwrapOrElse: (fn) => fn(),
40
- expect: (message) => {
41
- const thrown = new Error(`${message}: ${error.message}`, {
42
- cause: error
43
- });
44
- Object.setPrototypeOf(thrown, error.constructor.prototype);
45
- if (error.stack !== void 0)
46
- thrown.stack = error.stack;
47
- throw thrown;
48
- }
14
+ error
49
15
  });
50
- return self;
51
16
  }
52
17
  function isOk(result) {
53
18
  return result.ok;
@@ -110,17 +75,6 @@ function unwrapOr(result, fallback) {
110
75
  function unwrapOrElse(result, fn) {
111
76
  return result.ok ? result.value : fn();
112
77
  }
113
- function expect(result, message) {
114
- if (result.ok)
115
- return result.value;
116
- const thrown = new Error(`${message}: ${result.error.message}`, {
117
- cause: result.error
118
- });
119
- Object.setPrototypeOf(thrown, result.error.constructor.prototype);
120
- if (result.error.stack !== void 0)
121
- thrown.stack = result.error.stack;
122
- throw thrown;
123
- }
124
78
  function fromNullable(value, errorFactory) {
125
79
  return value != null ? ok(value) : err(errorFactory());
126
80
  }
@@ -233,39 +187,13 @@ function collect(...results) {
233
187
  return ok(values);
234
188
  }
235
189
  function some(value) {
236
- const self = Object.freeze({
190
+ return Object.freeze({
237
191
  some: true,
238
- value,
239
- map: (fn) => some(fn(value)),
240
- flatMap: (fn) => fn(value),
241
- filter: (predicate) => predicate(value) ? self : NONE,
242
- inspect: (fn) => {
243
- fn(value);
244
- return self;
245
- },
246
- match: (handlers) => handlers.some(value),
247
- unwrap: () => value,
248
- expect: (_message) => value,
249
- unwrapOr: (_fallback) => value,
250
- unwrapOrElse: (_fn) => value
192
+ value
251
193
  });
252
- return self;
253
194
  }
254
195
  var NONE = Object.freeze({
255
- some: false,
256
- map: (_fn) => NONE,
257
- flatMap: (_fn) => NONE,
258
- filter: (_predicate) => NONE,
259
- inspect: (_fn) => NONE,
260
- match: (handlers) => handlers.none(),
261
- unwrap: () => {
262
- throw new Error("Called unwrap on None");
263
- },
264
- expect: (message) => {
265
- throw new Error(message);
266
- },
267
- unwrapOr: (fallback) => fallback,
268
- unwrapOrElse: (fn) => fn()
196
+ some: false
269
197
  });
270
198
  function none() {
271
199
  return NONE;
@@ -307,11 +235,6 @@ function maybeUnwrapOr(maybe, fallback) {
307
235
  function maybeUnwrapOrElse(maybe, fn) {
308
236
  return maybe.some ? maybe.value : fn();
309
237
  }
310
- function maybeExpect(maybe, message) {
311
- if (maybe.some)
312
- return maybe.value;
313
- throw new Error(message);
314
- }
315
238
  function maybeFromNullable(value) {
316
239
  return value != null ? some(value) : NONE;
317
240
  }
@@ -387,7 +310,6 @@ var Maybe = {
387
310
  unwrap: maybeUnwrap,
388
311
  unwrapOr: maybeUnwrapOr,
389
312
  unwrapOrElse: maybeUnwrapOrElse,
390
- expect: maybeExpect,
391
313
  fromNullable: maybeFromNullable,
392
314
  fromPredicate: maybeFromPredicate,
393
315
  all: maybeAll,
@@ -416,7 +338,6 @@ var Result = {
416
338
  unwrap,
417
339
  unwrapOr,
418
340
  unwrapOrElse,
419
- expect,
420
341
  fromNullable,
421
342
  fromPredicate,
422
343
  normalizeError,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** A successful result containing a value of type `T`. */\nexport type OkResult<T> = {\n readonly ok: true;\n readonly value: T;\n map<U>(fn: (value: T) => U): OkResult<U>;\n flatMap<U, F extends Error = never>(\n fn: (value: T) => Result<U, F>\n ): Result<U, F>;\n mapError<F extends Error>(fn: (error: never) => F): OkResult<T>;\n inspect(fn: (value: T) => void): OkResult<T>;\n inspectError(fn: (error: never) => void): OkResult<T>;\n match<R>(handlers: { ok: (value: T) => R; err: (error: never) => R }): R;\n unwrap(): T;\n unwrapOr(fallback: T): T;\n unwrapOrElse(fn: () => T): T;\n expect(message: string): T;\n};\n\n/** A failed result containing an error of type `E`. */\nexport type ErrResult<E extends Error = Error> = {\n readonly ok: false;\n readonly error: E;\n map<U>(fn: (value: never) => U): ErrResult<E>;\n flatMap<U, F extends Error = never>(\n fn: (value: never) => Result<U, F>\n ): ErrResult<E>;\n mapError<F extends Error>(fn: (error: E) => F): ErrResult<F>;\n inspect(fn: (value: never) => void): ErrResult<E>;\n inspectError(fn: (error: E) => void): ErrResult<E>;\n match<R>(handlers: { ok: (value: never) => R; err: (error: E) => R }): R;\n unwrap(): never;\n unwrapOr<T>(fallback: T): T;\n unwrapOrElse<T>(fn: () => T): T;\n expect(message: string): never;\n};\n\n/**\n * A value that is either a success (`OkResult<T>`) or a failure\n * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the\n * companion `Result.*` functions or instance methods to transform.\n */\nexport type Result<T, E extends Error = Error> = OkResult<T> | ErrResult<E>;\n\ntype AnyResult = Result<unknown, Error>;\n\ntype ValueOf<R> = R extends OkResult<infer T> ? T : never;\ntype ErrorOf<R> = R extends ErrResult<infer E> ? E : never;\n\ntype TupleValues<R extends readonly AnyResult[]> = {\n [K in keyof R]: ValueOf<R[K]>;\n};\ntype TupleErrors<R extends readonly AnyResult[]> = ErrorOf<R[number]>;\n\n/** Create a successful `Result` containing `value`. */\nfunction ok(): OkResult<undefined>;\nfunction ok<T>(value: T): OkResult<T>;\nfunction ok<T>(value?: T): OkResult<T | undefined> {\n const self: OkResult<T | undefined> = Object.freeze({\n ok: true as const,\n value,\n map: <U>(fn: (value: T | undefined) => U): OkResult<U> => ok(fn(value)),\n flatMap: <U, F extends Error = never>(\n fn: (value: T | undefined) => Result<U, F>\n ): Result<U, F> => fn(value),\n mapError: <F extends Error>(\n _fn: (error: never) => F\n ): OkResult<T | undefined> => self,\n inspect: (fn: (value: T | undefined) => void): OkResult<T | undefined> => {\n fn(value);\n return self;\n },\n inspectError: (_fn: (error: never) => void): OkResult<T | undefined> =>\n self,\n match: <R>(handlers: {\n ok: (value: T | undefined) => R;\n err: (error: never) => R;\n }): R => handlers.ok(value),\n unwrap: (): T | undefined => value,\n unwrapOr: (_fallback: T | undefined): T | undefined => value,\n unwrapOrElse: (_fn: () => T | undefined): T | undefined => value,\n expect: (_message: string): T | undefined => value,\n });\n return self;\n}\n\n/** Create a failed `Result` containing `error`. */\nfunction err<E extends Error>(error: E): ErrResult<E> {\n const self: ErrResult<E> = Object.freeze({\n ok: false as const,\n error,\n map: <U>(_fn: (value: never) => U): ErrResult<E> => self,\n flatMap: <U, F extends Error = never>(\n _fn: (value: never) => Result<U, F>\n ): ErrResult<E> => self,\n mapError: <F extends Error>(fn: (error: E) => F): ErrResult<F> =>\n err(fn(error)),\n inspect: (_fn: (value: never) => void): ErrResult<E> => self,\n inspectError: (fn: (error: E) => void): ErrResult<E> => {\n fn(error);\n return self;\n },\n match: <R>(handlers: {\n ok: (value: never) => R;\n err: (error: E) => R;\n }): R => handlers.err(error),\n unwrap: (): never => {\n throw error;\n },\n unwrapOr: <T>(fallback: T): T => fallback,\n unwrapOrElse: <T>(fn: () => T): T => fn(),\n expect: (message: string): never => {\n const thrown = new Error(`${message}: ${error.message}`, {\n cause: error,\n });\n Object.setPrototypeOf(thrown, error.constructor.prototype);\n if (error.stack !== undefined) thrown.stack = error.stack;\n throw thrown;\n },\n });\n return self;\n}\n\n/** Narrow a `Result` to `OkResult`. */\nfunction isOk<T, E extends Error>(result: Result<T, E>): result is OkResult<T> {\n return result.ok;\n}\n\n/** Narrow a `Result` to `ErrResult`. */\nfunction isErr<T, E extends Error>(\n result: Result<T, E>\n): result is ErrResult<E> {\n return !result.ok;\n}\n\n/** Transform the value inside an `Ok`, leaving `Err` unchanged. */\nfunction map<T, U>(result: OkResult<T>, fn: (value: T) => U): OkResult<U>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E> {\n return result.ok ? ok(fn(result.value)) : result;\n}\n\n/** Transform the error inside an `Err`, leaving `Ok` unchanged. */\nfunction mapError<T>(\n result: OkResult<T>,\n fn: (error: never) => Error\n): OkResult<T>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => F\n): Result<T, F>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: OkResult<T> | Result<T, E>,\n fn: ((error: never) => Error) | ((error: E) => F)\n): OkResult<T> | Result<T, F> {\n return result.ok ? result : err((fn as (error: E) => F)(result.error));\n}\n\n/** Run a side-effect on the `Ok` value without transforming the result. */\nfunction inspect<T>(result: OkResult<T>, fn: (value: T) => void): OkResult<T>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E> {\n if (result.ok) fn(result.value);\n return result;\n}\n\n/** Run a side-effect on the `Err` error without transforming the result. */\nfunction inspectError<E extends Error>(\n result: ErrResult<E>,\n fn: (error: E) => void\n): ErrResult<E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E> {\n if (!result.ok) fn(result.error);\n return result;\n}\n\n/** Chain a `Result`-returning function on the `Ok` value. */\nfunction flatMap<T, U, E extends Error, F extends Error = never>(\n result: Result<T, E>,\n fn: (value: T) => Result<U, F>\n): Result<U, E | F> {\n if (result.ok) return fn(result.value);\n // Safe: ErrResult<E> ⊆ Result<U, E | F> — error type is widened, value\n // channel is unused. The assertion is needed because ErrResult's methods\n // make E invariant in TypeScript's structural checker.\n return result as ErrResult<E | F>;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias: `flatMapErr`.\n */\nfunction orElse<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n if (!result.ok) return fn(result.error);\n // Safe: OkResult<T> ⊆ Result<T, F> — same variance pattern as flatMap.\n return result as OkResult<T>;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias for `orElse`.\n */\nfunction flatMapErr<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n return orElse(result, fn);\n}\n\n/** Flatten a nested `Result<Result<T, E>, F>` into `Result<T, E | F>`. */\nfunction flatten<T, E extends Error, F extends Error>(\n result: Result<Result<T, E>, F>\n): Result<T, E | F> {\n // Safe: both branches widen the error type — same variance pattern as flatMap.\n return (result.ok ? result.value : result) as Result<T, E | F>;\n}\n\n/** Exhaustively handle both `Ok` and `Err` branches, returning `R`. */\nfunction match<T, E extends Error, R>(\n result: Result<T, E>,\n handlers: { ok: (value: T) => R; err: (error: E) => R }\n): R {\n return result.ok ? handlers.ok(result.value) : handlers.err(result.error);\n}\n\n/** Compile-time exhaustiveness guard — only accepts `never`. */\nfunction exhaustive(value: never): never {\n let detail: string;\n try {\n detail = JSON.stringify(value);\n } catch {\n detail = String(value);\n }\n throw new Error(`Unhandled result case: ${detail}`);\n}\n\n/** Return the `Ok` value or throw the contained error. */\nfunction unwrap<T, E extends Error>(result: Result<T, E>): T {\n if (result.ok) return result.value;\n throw result.error;\n}\n\n/**\n * Return the `Ok` value or `fallback`.\n *\n * The fallback must be the same type `T` as the success value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T {\n return result.ok ? result.value : fallback;\n}\n\n/** Return the `Ok` value, or compute a fallback from `fn`. */\nfunction unwrapOrElse<T, E extends Error>(\n result: Result<T, E>,\n fn: () => T\n): T {\n return result.ok ? result.value : fn();\n}\n\n/** Return the `Ok` value or throw with a custom `message`. */\nfunction expect<T, E extends Error>(result: Result<T, E>, message: string): T {\n if (result.ok) return result.value;\n const thrown = new Error(`${message}: ${result.error.message}`, {\n cause: result.error,\n });\n Object.setPrototypeOf(thrown, result.error.constructor.prototype);\n if (result.error.stack !== undefined) thrown.stack = result.error.stack;\n throw thrown;\n}\n\n/** Convert a nullable value to a `Result`. */\nfunction fromNullable<T, E extends Error>(\n value: T | null | undefined,\n errorFactory: () => E\n): Result<NonNullable<T>, E> {\n return value != null ? ok(value as NonNullable<T>) : err(errorFactory());\n}\n\n/** Convert a predicate check to a `Result`. Supports type-guard predicates. */\nfunction fromPredicate<T, S extends T, E extends Error>(\n value: T,\n predicate: (value: T) => value is S,\n errorFactory: () => E\n): Result<S, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E> {\n return predicate(value) ? ok(value) : err(errorFactory());\n}\n\n/** Convert an unknown thrown value to an `Error` instance. */\nfunction normalizeError(error: unknown): Error {\n if (error instanceof Error) return error;\n if (error === null || error === undefined) return new Error(String(error));\n if (typeof error === \"object\") {\n try {\n const json = JSON.stringify(error);\n if (json !== \"{}\") return new Error(json);\n // JSON.stringify produced '{}' — likely RegExp or similar with no\n // enumerable own properties. Fall through to String().\n } catch {\n // JSON.stringify throws on BigInt and circular references\n }\n }\n try {\n return new Error(String(error));\n } catch {\n return new Error(\"Non-stringifiable thrown value\");\n }\n}\n\n/** Wrap a synchronous function that may throw into a `Result`. */\nfunction tryCatch<T>(fn: () => T): Result<T, Error>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError: (error: unknown) => E\n): Result<T, E>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError?: (error: unknown) => E\n): Result<T, E | Error> {\n try {\n return ok(fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap an asynchronous function that may reject into a `Result`. */\nfunction tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;\nfunction tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap a `Promise` that may reject into a `Result`. */\nfunction fromPromise<T>(promise: Promise<T>): Promise<Result<T, Error>>;\nfunction fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await promise);\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/**\n * Combine multiple `Result`s into a single `Result` containing a tuple of\n * values. Returns the first `Err` encountered (fail-fast).\n *\n * Pass results as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction all<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, TupleErrors<R>> {\n const values: unknown[] = [];\n for (const result of results) {\n if (!result.ok) return err(result.error) as ErrResult<TupleErrors<R>>;\n values.push(result.value);\n }\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n/**\n * Like `all`, but accepts promises of `Result`s. All promises are resolved\n * concurrently via `Promise.allSettled` before checking for errors.\n *\n * Promises are expected to resolve to `Result`s — not reject. If a promise\n * does reject, the rejection is caught and wrapped as an `Err`.\n *\n * @breaking v0.2 — Uses `Promise.allSettled` instead of `Promise.all`. All\n * promises are now always awaited to completion; the first error found during\n * iteration is returned.\n */\nasync function allAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<\n Result<\n { [K in keyof R]: ValueOf<Awaited<R[K]>> },\n ErrorOf<Awaited<R[number]>> | Error\n >\n> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n type Errors = ErrorOf<Awaited<R[number]>> | Error;\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n return err(normalizeError(s.reason)) as ErrResult<Errors>;\n }\n if (!s.value.ok) {\n return err(s.value.error) as ErrResult<Errors>;\n }\n values.push(s.value.value);\n }\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Like `collect`, but for promises of `Result`s. Resolves all promises\n * via `Promise.allSettled`, then collects all errors. Returns an\n * `AggregateError` containing every error found.\n */\nasync function collectAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<Result<{ [K in keyof R]: ValueOf<Awaited<R[K]>> }, AggregateError>> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n errors.push(normalizeError(s.reason));\n } else if (!s.value.ok) {\n errors.push(s.value.error);\n } else {\n values.push(s.value.value);\n }\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Combine multiple `Result`s, collecting **all** errors instead of\n * short-circuiting on the first one. Returns an `AggregateError` whose\n * `.errors` array contains every individual error.\n */\nfunction collect<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, AggregateError> {\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const result of results) {\n if (result.ok) values.push(result.value);\n else errors.push(result.error);\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n// ===========================================================================\n// Maybe\n// ===========================================================================\n\n/** A `Maybe` that contains a value of type `T`. */\nexport type Some<T> = {\n readonly some: true;\n readonly value: T;\n map<U>(fn: (value: T) => U): Some<U>;\n flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>;\n filter(predicate: (value: T) => boolean): Maybe<T>;\n inspect(fn: (value: T) => void): Some<T>;\n match<R>(handlers: { some: (value: T) => R; none: () => R }): R;\n unwrap(): T;\n expect(message: string): T;\n unwrapOr(fallback: T): T;\n unwrapOrElse(fn: () => T): T;\n};\n\n/** A `Maybe` that contains no value. */\nexport type None = {\n readonly some: false;\n map<U>(fn: (value: never) => U): None;\n flatMap<U>(fn: (value: never) => Maybe<U>): None;\n filter(predicate: (value: never) => boolean): None;\n inspect(fn: (value: never) => void): None;\n match<R>(handlers: { some: (value: never) => R; none: () => R }): R;\n unwrap(): never;\n expect(message: string): never;\n unwrapOr<T>(fallback: T): T;\n unwrapOrElse<T>(fn: () => T): T;\n};\n\n/**\n * A value that is either present (`Some<T>`) or absent (`None`).\n * Use `Maybe.some` / `Maybe.none` to construct, and the companion `Maybe.*`\n * functions or instance methods to transform.\n */\nexport type Maybe<T> = Some<T> | None;\n\ntype AnyMaybe = Maybe<unknown>;\n\ntype MaybeValueOf<M> = M extends Some<infer T> ? T : never;\n\ntype TupleMaybeValues<M extends readonly AnyMaybe[]> = {\n [K in keyof M]: MaybeValueOf<M[K]>;\n};\n\n/** Create a `Maybe` containing `value`. */\nfunction some<T>(value: T): Some<T> {\n const self: Some<T> = Object.freeze({\n some: true as const,\n value,\n map: <U>(fn: (value: T) => U): Some<U> => some(fn(value)),\n flatMap: <U>(fn: (value: T) => Maybe<U>): Maybe<U> => fn(value),\n filter: (predicate: (value: T) => boolean): Maybe<T> =>\n predicate(value) ? self : NONE,\n inspect: (fn: (value: T) => void): Some<T> => {\n fn(value);\n return self;\n },\n match: <R>(handlers: { some: (value: T) => R; none: () => R }): R =>\n handlers.some(value),\n unwrap: (): T => value,\n expect: (_message: string): T => value,\n unwrapOr: (_fallback: T): T => value,\n unwrapOrElse: (_fn: () => T): T => value,\n });\n return self;\n}\n\nconst NONE: None = Object.freeze({\n some: false as const,\n map: <U>(_fn: (value: never) => U): None => NONE,\n flatMap: <U>(_fn: (value: never) => Maybe<U>): None => NONE,\n filter: (_predicate: (value: never) => boolean): None => NONE,\n inspect: (_fn: (value: never) => void): None => NONE,\n match: <R>(handlers: { some: (value: never) => R; none: () => R }): R =>\n handlers.none(),\n unwrap: (): never => {\n throw new Error(\"Called unwrap on None\");\n },\n expect: (message: string): never => {\n throw new Error(message);\n },\n unwrapOr: <T>(fallback: T): T => fallback,\n unwrapOrElse: <T>(fn: () => T): T => fn(),\n});\n\n/** Create an empty `Maybe`. */\nfunction none(): None {\n return NONE;\n}\n\n/** Narrow a `Maybe` to `Some`. */\nfunction isSome<T>(maybe: Maybe<T>): maybe is Some<T> {\n return maybe.some;\n}\n\n/** Narrow a `Maybe` to `None`. */\nfunction isNone<T>(maybe: Maybe<T>): maybe is None {\n return !maybe.some;\n}\n\n/** Transform the value inside a `Some`, leaving `None` unchanged. */\nfunction maybeMap<T, U>(maybe: Some<T>, fn: (value: T) => U): Some<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U> {\n return maybe.some ? some(fn(maybe.value)) : NONE;\n}\n\n/** Chain a `Maybe`-returning function on the `Some` value. */\nfunction maybeFlatMap<T, U>(\n maybe: Maybe<T>,\n fn: (value: T) => Maybe<U>\n): Maybe<U> {\n return maybe.some ? fn(maybe.value) : NONE;\n}\n\n/** Flatten a nested `Maybe<Maybe<T>>` into `Maybe<T>`. */\nfunction maybeFlatten<T>(maybe: Maybe<Maybe<T>>): Maybe<T> {\n return maybe.some ? maybe.value : NONE;\n}\n\n/** Keep the `Some` value only if `predicate` returns true. */\nfunction maybeFilter<T, S extends T>(\n maybe: Maybe<T>,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return maybe.some && predicate(maybe.value) ? maybe : NONE;\n}\n\n/** Run a side-effect on the `Some` value without transforming the maybe. */\nfunction maybeInspect<T>(maybe: Some<T>, fn: (value: T) => void): Some<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T> {\n if (maybe.some) fn(maybe.value);\n return maybe;\n}\n\n/** Exhaustively handle both `Some` and `None` branches, returning `R`. */\nfunction maybeMatch<T, R>(\n maybe: Maybe<T>,\n handlers: { some: (value: T) => R; none: () => R }\n): R {\n return maybe.some ? handlers.some(maybe.value) : handlers.none();\n}\n\n/** Return the `Some` value or throw. */\nfunction maybeUnwrap<T>(maybe: Maybe<T>): T {\n if (maybe.some) return maybe.value;\n throw new Error(\"Called unwrap on None\");\n}\n\n/**\n * Return the `Some` value or `fallback`.\n *\n * The fallback must be the same type `T` as the contained value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction maybeUnwrapOr<T>(maybe: Maybe<T>, fallback: T): T {\n return maybe.some ? maybe.value : fallback;\n}\n\n/** Return the `Some` value, or compute a fallback from `fn`. */\nfunction maybeUnwrapOrElse<T>(maybe: Maybe<T>, fn: () => T): T {\n return maybe.some ? maybe.value : fn();\n}\n\n/** Return the `Some` value or throw with a custom `message`. */\nfunction maybeExpect<T>(maybe: Maybe<T>, message: string): T {\n if (maybe.some) return maybe.value;\n throw new Error(message);\n}\n\n/** Convert a nullable value to a `Maybe`. */\nfunction maybeFromNullable<T>(\n value: T | null | undefined\n): Maybe<NonNullable<T>> {\n return value != null ? some(value as NonNullable<T>) : NONE;\n}\n\n/** Convert a predicate check to a `Maybe`. Supports type-guard predicates. */\nfunction maybeFromPredicate<T, S extends T>(\n value: T,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return predicate(value) ? some(value) : NONE;\n}\n\n/**\n * Combine multiple `Maybe`s into a single `Maybe` containing a tuple of\n * values. Returns `None` if any input is `None` (fail-fast).\n *\n * Pass maybes as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction maybeAll<const M extends readonly AnyMaybe[]>(\n ...maybes: M\n): Maybe<TupleMaybeValues<M>> {\n const values: unknown[] = [];\n for (const m of maybes) {\n if (!m.some) return NONE;\n values.push(m.value);\n }\n return some(values) as Some<TupleMaybeValues<M>>;\n}\n\n/** Return the first `Some` found, or `None` if all are `None`. */\nfunction maybeFirstSome<T>(...maybes: Maybe<T>[]): Maybe<T> {\n for (const m of maybes) {\n if (m.some) return m;\n }\n return NONE;\n}\n\n/** Like `all`, but for promises of `Maybe`s. Resolves all promises\n * concurrently via `Promise.allSettled`. */\nasync function maybeAllAsync<const M extends readonly Promise<AnyMaybe>[]>(\n ...promises: M\n): Promise<Maybe<{ [K in keyof M]: MaybeValueOf<Awaited<M[K]>> }>> {\n type Values = { [K in keyof M]: MaybeValueOf<Awaited<M[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") return NONE;\n if (!s.value.some) return NONE;\n values.push(s.value.value);\n }\n return some(values) as Some<Values>;\n}\n\n/** Combine multiple `Maybe's, returning `None` if any is `None`.\n * Same as `all` — `None` carries no error data to collect,\n * unlike `Result.collect` which gathers all errors.\n */\nconst maybeCollect = maybeAll;\n\n// ---------------------------------------------------------------------------\n// Maybe <-> Result interop\n// ---------------------------------------------------------------------------\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`. The factory is only called when the Maybe is\n * None, avoiding unnecessary error construction for Some.\n */\nfunction maybeToResult<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybe.some ? ok(maybe.value) : err(errorFactory());\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction maybeFromResult<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return result.ok ? some(result.value) : NONE;\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction resultToMaybe<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return maybeFromResult(result);\n}\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n * Alias for `maybeToResult`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`.\n */\nfunction resultFromMaybe<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybeToResult(maybe, errorFactory);\n}\n\n/** Convert a `Result<Maybe<T>, E>` to `Maybe<Result<T, E>>`. */\nfunction resultTranspose<T, E extends Error>(\n result: Result<Maybe<T>, E>\n): Maybe<Result<T, E>> {\n if (!result.ok) return some(result as ErrResult<E>);\n if (result.value.some) return some(ok(result.value.value));\n return NONE;\n}\n\n/** Convert a `Maybe<Result<T, E>>` to `Result<Maybe<T>, E>`. */\nfunction maybeTranspose<T, E extends Error>(\n maybe: Maybe<Result<T, E>>\n): Result<Maybe<T>, E> {\n if (!maybe.some) return ok(NONE) as OkResult<Maybe<T>>;\n if (maybe.value.ok) return ok(some(maybe.value.value));\n return err(maybe.value.error) as ErrResult<E>;\n}\n\nexport const Maybe = {\n some,\n none,\n isSome,\n isNone,\n map: maybeMap,\n flatMap: maybeFlatMap,\n flatten: maybeFlatten,\n filter: maybeFilter,\n inspect: maybeInspect,\n match: maybeMatch,\n unwrap: maybeUnwrap,\n unwrapOr: maybeUnwrapOr,\n unwrapOrElse: maybeUnwrapOrElse,\n expect: maybeExpect,\n fromNullable: maybeFromNullable,\n fromPredicate: maybeFromPredicate,\n all: maybeAll,\n allAsync: maybeAllAsync,\n collect: maybeCollect,\n firstSome: maybeFirstSome,\n toResult: maybeToResult,\n fromResult: maybeFromResult,\n transpose: maybeTranspose,\n} as const satisfies Record<string, (...args: never[]) => unknown>;\n\n// Add interop to Result namespace\nexport const Result = {\n ok,\n err,\n isOk,\n isErr,\n map,\n mapError,\n inspect,\n inspectError,\n flatMap,\n flatMapErr,\n orElse,\n flatten,\n match,\n exhaustive,\n unwrap,\n unwrapOr,\n unwrapOrElse,\n expect,\n fromNullable,\n fromPredicate,\n normalizeError,\n tryCatch,\n tryCatchAsync,\n fromPromise,\n all,\n allAsync,\n collect,\n collectAsync,\n toMaybe: resultToMaybe,\n fromMaybe: resultFromMaybe,\n transpose: resultTranspose,\n} as const satisfies Record<string, (...args: never[]) => unknown>;\n\nexport { err, isErr, isNone, isOk, isSome, none, normalizeError, ok, some };\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** A successful result containing a value of type `T`. */\nexport type OkResult<T> = {\n readonly ok: true;\n readonly value: T;\n};\n\n/** A failed result containing an error of type `E`. */\nexport type ErrResult<E extends Error = Error> = {\n readonly ok: false;\n readonly error: E;\n};\n\n/**\n * A value that is either a success (`OkResult<T>`) or a failure\n * (`ErrResult<E>`). Use `Result.ok` / `Result.err` to construct, and the\n * companion `Result.*` functions to transform.\n */\nexport type Result<T, E extends Error = Error> = OkResult<T> | ErrResult<E>;\n\ntype AnyResult = Result<unknown, Error>;\n\ntype ValueOf<R> = R extends OkResult<infer T> ? T : never;\ntype ErrorOf<R> = R extends ErrResult<infer E> ? E : never;\n\ntype TupleValues<R extends readonly AnyResult[]> = {\n [K in keyof R]: ValueOf<R[K]>;\n};\ntype TupleErrors<R extends readonly AnyResult[]> = ErrorOf<R[number]>;\n\nfunction createOk<T>(value: T): OkResult<T> {\n return Object.freeze({\n ok: true as const,\n value,\n });\n}\n\nfunction ok(): OkResult<undefined>;\nfunction ok<T>(value: T): OkResult<T>;\nfunction ok<T>(...args: [] | [value: T]): OkResult<undefined> | OkResult<T> {\n return args.length === 0 ? createOk(undefined) : createOk(args[0]);\n}\n\n/** Create a failed `Result` containing `error`. */\nfunction err<E extends Error>(error: E): ErrResult<E> {\n return Object.freeze({\n ok: false as const,\n error,\n });\n}\n\n/** Narrow a `Result` to `OkResult`. */\nfunction isOk<T, E extends Error>(result: Result<T, E>): result is OkResult<T> {\n return result.ok;\n}\n\n/** Narrow a `Result` to `ErrResult`. */\nfunction isErr<T, E extends Error>(\n result: Result<T, E>\n): result is ErrResult<E> {\n return !result.ok;\n}\n\n/** Transform the value inside an `Ok`, leaving `Err` unchanged. */\nfunction map<T, U>(result: OkResult<T>, fn: (value: T) => U): OkResult<U>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E>;\nfunction map<T, U, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => U\n): Result<U, E> {\n return result.ok ? ok(fn(result.value)) : result;\n}\n\n/** Transform the error inside an `Err`, leaving `Ok` unchanged. */\nfunction mapError<T>(\n result: OkResult<T>,\n fn: (error: never) => Error\n): OkResult<T>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => F\n): Result<T, F>;\nfunction mapError<T, E extends Error, F extends Error>(\n result: OkResult<T> | Result<T, E>,\n fn: ((error: never) => Error) | ((error: E) => F)\n): OkResult<T> | Result<T, F> {\n return result.ok ? result : err((fn as (error: E) => F)(result.error));\n}\n\n/** Run a side-effect on the `Ok` value without transforming the result. */\nfunction inspect<T>(result: OkResult<T>, fn: (value: T) => void): OkResult<T>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E>;\nfunction inspect<T, E extends Error>(\n result: Result<T, E>,\n fn: (value: T) => void\n): Result<T, E> {\n if (result.ok) fn(result.value);\n return result;\n}\n\n/** Run a side-effect on the `Err` error without transforming the result. */\nfunction inspectError<E extends Error>(\n result: ErrResult<E>,\n fn: (error: E) => void\n): ErrResult<E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E>;\nfunction inspectError<T, E extends Error>(\n result: Result<T, E>,\n fn: (error: E) => void\n): Result<T, E> {\n if (!result.ok) fn(result.error);\n return result;\n}\n\n/** Chain a `Result`-returning function on the `Ok` value. */\nfunction flatMap<T, U, E extends Error, F extends Error = never>(\n result: Result<T, E>,\n fn: (value: T) => Result<U, F>\n): Result<U, E | F> {\n if (result.ok) return fn(result.value);\n return result;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias: `flatMapErr`.\n */\nfunction orElse<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n if (!result.ok) return fn(result.error);\n return result;\n}\n\n/**\n * Recover from an error by applying `fn` to produce a new `Result`.\n * Alias for `orElse`.\n */\nfunction flatMapErr<T, E extends Error, F extends Error>(\n result: Result<T, E>,\n fn: (error: E) => Result<T, F>\n): Result<T, F> {\n return orElse(result, fn);\n}\n\n/** Flatten a nested `Result<Result<T, E>, F>` into `Result<T, E | F>`. */\nfunction flatten<T, E extends Error, F extends Error>(\n result: Result<Result<T, E>, F>\n): Result<T, E | F> {\n return result.ok ? result.value : result;\n}\n\n/** Exhaustively handle both `Ok` and `Err` branches, returning `R`. */\nfunction match<T, E extends Error, R>(\n result: Result<T, E>,\n handlers: { ok: (value: T) => R; err: (error: E) => R }\n): R {\n return result.ok ? handlers.ok(result.value) : handlers.err(result.error);\n}\n\n/** Compile-time exhaustiveness guard — only accepts `never`. */\nfunction exhaustive(value: never): never {\n let detail: string;\n try {\n detail = JSON.stringify(value);\n } catch {\n detail = String(value);\n }\n throw new Error(`Unhandled result case: ${detail}`);\n}\n\n/** Return the `Ok` value or throw the contained error. */\nfunction unwrap<T, E extends Error>(result: Result<T, E>): T {\n if (result.ok) return result.value;\n throw result.error;\n}\n\n/**\n * Return the `Ok` value or `fallback`.\n *\n * The fallback must be the same type `T` as the success value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T {\n return result.ok ? result.value : fallback;\n}\n\n/** Return the `Ok` value, or compute a fallback from `fn`. */\nfunction unwrapOrElse<T, E extends Error>(\n result: Result<T, E>,\n fn: () => T\n): T {\n return result.ok ? result.value : fn();\n}\n\n/** Convert a nullable value to a `Result`. */\nfunction fromNullable<T, E extends Error>(\n value: T | null | undefined,\n errorFactory: () => E\n): Result<NonNullable<T>, E> {\n return value != null ? ok(value) : err(errorFactory());\n}\n\n/** Convert a predicate check to a `Result`. Supports type-guard predicates. */\nfunction fromPredicate<T, S extends T, E extends Error>(\n value: T,\n predicate: (value: T) => value is S,\n errorFactory: () => E\n): Result<S, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E>;\nfunction fromPredicate<T, E extends Error>(\n value: T,\n predicate: (value: T) => boolean,\n errorFactory: () => E\n): Result<T, E> {\n return predicate(value) ? ok(value) : err(errorFactory());\n}\n\n/** Convert an unknown thrown value to an `Error` instance. */\nfunction normalizeError(error: unknown): Error {\n if (error instanceof Error) return error;\n if (error === null || error === undefined) return new Error(String(error));\n if (typeof error === \"object\") {\n try {\n const json = JSON.stringify(error);\n if (json !== \"{}\") return new Error(json);\n // JSON.stringify produced '{}' — likely RegExp or similar with no\n // enumerable own properties. Fall through to String().\n } catch {\n // JSON.stringify throws on BigInt and circular references\n }\n }\n try {\n return new Error(String(error));\n } catch {\n return new Error(\"Non-stringifiable thrown value\");\n }\n}\n\n/** Wrap a synchronous function that may throw into a `Result`. */\nfunction tryCatch<T>(fn: () => T): Result<T, Error>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError: (error: unknown) => E\n): Result<T, E>;\nfunction tryCatch<T, E extends Error>(\n fn: () => T,\n onError?: (error: unknown) => E\n): Result<T, E | Error> {\n try {\n return ok(fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap an asynchronous function that may reject into a `Result`. */\nfunction tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;\nfunction tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function tryCatchAsync<T, E extends Error>(\n fn: () => Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await fn());\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/** Wrap a `Promise` that may reject into a `Result`. */\nfunction fromPromise<T>(promise: Promise<T>): Promise<Result<T, Error>>;\nfunction fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError: (error: unknown) => E\n): Promise<Result<T, E>>;\nasync function fromPromise<T, E extends Error>(\n promise: Promise<T>,\n onError?: (error: unknown) => E\n): Promise<Result<T, E | Error>> {\n try {\n return ok(await promise);\n } catch (error) {\n try {\n return err(onError ? onError(error) : normalizeError(error));\n } catch (mapperError) {\n return err(new Error(\"Error mapper threw\", { cause: mapperError }));\n }\n }\n}\n\n/**\n * Combine multiple `Result`s into a single `Result` containing a tuple of\n * values. Returns the first `Err` encountered (fail-fast).\n *\n * Pass results as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction all<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, TupleErrors<R>> {\n const values: unknown[] = [];\n for (const result of results) {\n if (!result.ok) return err(result.error) as ErrResult<TupleErrors<R>>;\n values.push(result.value);\n }\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n/**\n * Like `all`, but accepts promises of `Result`s. All promises are resolved\n * concurrently via `Promise.allSettled` before checking for errors.\n *\n * Promises are expected to resolve to `Result`s — not reject. If a promise\n * does reject, the rejection is caught and wrapped as an `Err`.\n *\n * @breaking v0.2 — Uses `Promise.allSettled` instead of `Promise.all`. All\n * promises are now always awaited to completion; the first error found during\n * iteration is returned.\n */\nasync function allAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<\n Result<\n { [K in keyof R]: ValueOf<Awaited<R[K]>> },\n ErrorOf<Awaited<R[number]>> | Error\n >\n> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n type Errors = ErrorOf<Awaited<R[number]>> | Error;\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n return err(normalizeError(s.reason)) as ErrResult<Errors>;\n }\n if (!s.value.ok) {\n return err(s.value.error) as ErrResult<Errors>;\n }\n values.push(s.value.value);\n }\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Like `collect`, but for promises of `Result`s. Resolves all promises\n * via `Promise.allSettled`, then collects all errors. Returns an\n * `AggregateError` containing every error found.\n */\nasync function collectAsync<const R extends readonly Promise<AnyResult>[]>(\n ...promises: R\n): Promise<Result<{ [K in keyof R]: ValueOf<Awaited<R[K]>> }, AggregateError>> {\n type Values = { [K in keyof R]: ValueOf<Awaited<R[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") {\n errors.push(normalizeError(s.reason));\n } else if (!s.value.ok) {\n errors.push(s.value.error);\n } else {\n values.push(s.value.value);\n }\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<Values>;\n}\n\n/**\n * Combine multiple `Result`s, collecting **all** errors instead of\n * short-circuiting on the first one. Returns an `AggregateError` whose\n * `.errors` array contains every individual error.\n */\nfunction collect<const R extends readonly AnyResult[]>(\n ...results: R\n): Result<TupleValues<R>, AggregateError> {\n const values: unknown[] = [];\n const errors: Error[] = [];\n for (const result of results) {\n if (result.ok) values.push(result.value);\n else errors.push(result.error);\n }\n if (errors.length > 0)\n return err(new AggregateError(errors)) as ErrResult<AggregateError>;\n return ok(values) as OkResult<TupleValues<R>>;\n}\n\n// ===========================================================================\n// Maybe\n// ===========================================================================\n\n/** A `Maybe` that contains a value of type `T`. */\nexport type Some<T> = {\n readonly some: true;\n readonly value: T;\n};\n\n/** A `Maybe` that contains no value. */\nexport type None = {\n readonly some: false;\n};\n\n/**\n * A value that is either present (`Some<T>`) or absent (`None`).\n * Use `Maybe.some` / `Maybe.none` to construct, and the companion `Maybe.*`\n * functions to transform.\n */\nexport type Maybe<T> = Some<T> | None;\n\ntype AnyMaybe = Maybe<unknown>;\n\ntype MaybeValueOf<M> = M extends Some<infer T> ? T : never;\n\ntype TupleMaybeValues<M extends readonly AnyMaybe[]> = {\n [K in keyof M]: MaybeValueOf<M[K]>;\n};\n\n/** Create a `Maybe` containing `value`. */\nfunction some<T>(value: T): Some<T> {\n return Object.freeze({\n some: true as const,\n value,\n });\n}\n\nconst NONE: None = Object.freeze({\n some: false as const,\n});\n\n/** Create an empty `Maybe`. */\nfunction none(): None {\n return NONE;\n}\n\n/** Narrow a `Maybe` to `Some`. */\nfunction isSome<T>(maybe: Maybe<T>): maybe is Some<T> {\n return maybe.some;\n}\n\n/** Narrow a `Maybe` to `None`. */\nfunction isNone<T>(maybe: Maybe<T>): maybe is None {\n return !maybe.some;\n}\n\n/** Transform the value inside a `Some`, leaving `None` unchanged. */\nfunction maybeMap<T, U>(maybe: Some<T>, fn: (value: T) => U): Some<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U>;\nfunction maybeMap<T, U>(maybe: Maybe<T>, fn: (value: T) => U): Maybe<U> {\n return maybe.some ? some(fn(maybe.value)) : NONE;\n}\n\n/** Chain a `Maybe`-returning function on the `Some` value. */\nfunction maybeFlatMap<T, U>(\n maybe: Maybe<T>,\n fn: (value: T) => Maybe<U>\n): Maybe<U> {\n return maybe.some ? fn(maybe.value) : NONE;\n}\n\n/** Flatten a nested `Maybe<Maybe<T>>` into `Maybe<T>`. */\nfunction maybeFlatten<T>(maybe: Maybe<Maybe<T>>): Maybe<T> {\n return maybe.some ? maybe.value : NONE;\n}\n\n/** Keep the `Some` value only if `predicate` returns true. */\nfunction maybeFilter<T, S extends T>(\n maybe: Maybe<T>,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFilter<T>(\n maybe: Maybe<T>,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return maybe.some && predicate(maybe.value) ? maybe : NONE;\n}\n\n/** Run a side-effect on the `Some` value without transforming the maybe. */\nfunction maybeInspect<T>(maybe: Some<T>, fn: (value: T) => void): Some<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T>;\nfunction maybeInspect<T>(maybe: Maybe<T>, fn: (value: T) => void): Maybe<T> {\n if (maybe.some) fn(maybe.value);\n return maybe;\n}\n\n/** Exhaustively handle both `Some` and `None` branches, returning `R`. */\nfunction maybeMatch<T, R>(\n maybe: Maybe<T>,\n handlers: { some: (value: T) => R; none: () => R }\n): R {\n return maybe.some ? handlers.some(maybe.value) : handlers.none();\n}\n\n/** Return the `Some` value or throw. */\nfunction maybeUnwrap<T>(maybe: Maybe<T>): T {\n if (maybe.some) return maybe.value;\n throw new Error(\"Called unwrap on None\");\n}\n\n/**\n * Return the `Some` value or `fallback`.\n *\n * The fallback must be the same type `T` as the contained value. This is\n * intentional — use `match` when you need a different return type.\n */\nfunction maybeUnwrapOr<T>(maybe: Maybe<T>, fallback: T): T {\n return maybe.some ? maybe.value : fallback;\n}\n\n/** Return the `Some` value, or compute a fallback from `fn`. */\nfunction maybeUnwrapOrElse<T>(maybe: Maybe<T>, fn: () => T): T {\n return maybe.some ? maybe.value : fn();\n}\n\n/** Convert a nullable value to a `Maybe`. */\nfunction maybeFromNullable<T>(\n value: T | null | undefined\n): Maybe<NonNullable<T>> {\n return value != null ? some(value) : NONE;\n}\n\n/** Convert a predicate check to a `Maybe`. Supports type-guard predicates. */\nfunction maybeFromPredicate<T, S extends T>(\n value: T,\n predicate: (value: T) => value is S\n): Maybe<S>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T>;\nfunction maybeFromPredicate<T>(\n value: T,\n predicate: (value: T) => boolean\n): Maybe<T> {\n return predicate(value) ? some(value) : NONE;\n}\n\n/**\n * Combine multiple `Maybe`s into a single `Maybe` containing a tuple of\n * values. Returns `None` if any input is `None` (fail-fast).\n *\n * Pass maybes as individual arguments — spreading an array loses tuple\n * inference and degrades value types to `unknown[]`.\n */\nfunction maybeAll<const M extends readonly AnyMaybe[]>(\n ...maybes: M\n): Maybe<TupleMaybeValues<M>> {\n const values: unknown[] = [];\n for (const m of maybes) {\n if (!m.some) return NONE;\n values.push(m.value);\n }\n return some(values) as Some<TupleMaybeValues<M>>;\n}\n\n/** Return the first `Some` found, or `None` if all are `None`. */\nfunction maybeFirstSome<T>(...maybes: Maybe<T>[]): Maybe<T> {\n for (const m of maybes) {\n if (m.some) return m;\n }\n return NONE;\n}\n\n/** Like `all`, but for promises of `Maybe`s. Resolves all promises\n * concurrently via `Promise.allSettled`. */\nasync function maybeAllAsync<const M extends readonly Promise<AnyMaybe>[]>(\n ...promises: M\n): Promise<Maybe<{ [K in keyof M]: MaybeValueOf<Awaited<M[K]>> }>> {\n type Values = { [K in keyof M]: MaybeValueOf<Awaited<M[K]>> };\n\n const settled = await Promise.allSettled(promises);\n const values: unknown[] = [];\n for (const s of settled) {\n if (s.status === \"rejected\") return NONE;\n if (!s.value.some) return NONE;\n values.push(s.value.value);\n }\n return some(values) as Some<Values>;\n}\n\n/** Combine multiple `Maybe's, returning `None` if any is `None`.\n * Same as `all` — `None` carries no error data to collect,\n * unlike `Result.collect` which gathers all errors.\n */\nconst maybeCollect = maybeAll;\n\n// ---------------------------------------------------------------------------\n// Maybe <-> Result interop\n// ---------------------------------------------------------------------------\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`. The factory is only called when the Maybe is\n * None, avoiding unnecessary error construction for Some.\n */\nfunction maybeToResult<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybe.some ? ok(maybe.value) : err(errorFactory());\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction maybeFromResult<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return result.ok ? some(result.value) : NONE;\n}\n\n/** Convert a `Result` to a `Maybe`, discarding the error. */\nfunction resultToMaybe<T, E extends Error>(result: Result<T, E>): Maybe<T> {\n return maybeFromResult(result);\n}\n\n/** Convert a `Maybe` to a `Result`, calling `errorFactory` only when `None`.\n * Alias for `maybeToResult`.\n *\n * @breaking v0.2 — The second argument changed from `error: E` to\n * `errorFactory: () => E`.\n */\nfunction resultFromMaybe<T, E extends Error>(\n maybe: Maybe<T>,\n errorFactory: () => E\n): Result<T, E> {\n return maybeToResult(maybe, errorFactory);\n}\n\n/** Convert a `Result<Maybe<T>, E>` to `Maybe<Result<T, E>>`. */\nfunction resultTranspose<T, E extends Error>(\n result: Result<Maybe<T>, E>\n): Maybe<Result<T, E>> {\n if (!result.ok) return some(result);\n if (result.value.some) return some(ok(result.value.value));\n return NONE;\n}\n\n/** Convert a `Maybe<Result<T, E>>` to `Result<Maybe<T>, E>`. */\nfunction maybeTranspose<T, E extends Error>(\n maybe: Maybe<Result<T, E>>\n): Result<Maybe<T>, E> {\n if (!maybe.some) return ok(NONE);\n if (maybe.value.ok) return ok(some(maybe.value.value));\n return err(maybe.value.error);\n}\n\nexport const Maybe = {\n some,\n none,\n isSome,\n isNone,\n map: maybeMap,\n flatMap: maybeFlatMap,\n flatten: maybeFlatten,\n filter: maybeFilter,\n inspect: maybeInspect,\n match: maybeMatch,\n unwrap: maybeUnwrap,\n unwrapOr: maybeUnwrapOr,\n unwrapOrElse: maybeUnwrapOrElse,\n fromNullable: maybeFromNullable,\n fromPredicate: maybeFromPredicate,\n all: maybeAll,\n allAsync: maybeAllAsync,\n collect: maybeCollect,\n firstSome: maybeFirstSome,\n toResult: maybeToResult,\n fromResult: maybeFromResult,\n transpose: maybeTranspose,\n} as const;\n\n// Add interop to Result namespace\nexport const Result = {\n ok,\n err,\n isOk,\n isErr,\n map,\n mapError,\n inspect,\n inspectError,\n flatMap,\n flatMapErr,\n orElse,\n flatten,\n match,\n exhaustive,\n unwrap,\n unwrapOr,\n unwrapOrElse,\n fromNullable,\n fromPredicate,\n normalizeError,\n tryCatch,\n tryCatchAsync,\n fromPromise,\n all,\n allAsync,\n collect,\n collectAsync,\n toMaybe: resultToMaybe,\n fromMaybe: resultFromMaybe,\n transpose: resultTranspose,\n} as const;\n\nexport { err, isErr, isNone, isOk, isSome, none, normalizeError, ok, some };\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@semyonf/kamchazky",
3
- "version": "0.3.0",
3
+ "version": "1.0.0",
4
4
  "author": "Semyón <taxnuke@gmail.com>",
5
5
  "homepage": "https://github.com/semyonf/kamchazky#readme",
6
6
  "bugs": {