nalloc 0.1.0 → 0.2.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/build/iter.cjs +6 -8
- package/build/iter.cjs.map +1 -1
- package/build/iter.js +6 -8
- package/build/iter.js.map +1 -1
- package/build/option.cjs +14 -4
- package/build/option.cjs.map +1 -1
- package/build/option.d.ts +11 -0
- package/build/option.js +11 -4
- package/build/option.js.map +1 -1
- package/build/result.cjs +107 -39
- package/build/result.cjs.map +1 -1
- package/build/result.d.ts +95 -12
- package/build/result.js +92 -36
- package/build/result.js.map +1 -1
- package/build/safe.cjs +16 -0
- package/build/safe.cjs.map +1 -1
- package/build/safe.d.ts +22 -1
- package/build/safe.js +8 -1
- package/build/safe.js.map +1 -1
- package/package.json +2 -2
- package/src/__tests__/index.ts +34 -0
- package/src/__tests__/option.ts +23 -1
- package/src/__tests__/option.types.ts +2 -1
- package/src/__tests__/result.ts +194 -1
- package/src/__tests__/result.types.ts +17 -4
- package/src/iter.ts +4 -2
- package/src/option.ts +21 -1
- package/src/result.ts +192 -52
- package/src/safe.ts +49 -1
package/build/result.cjs
CHANGED
|
@@ -57,6 +57,15 @@ _export(exports, {
|
|
|
57
57
|
get fromPromise () {
|
|
58
58
|
return fromPromise;
|
|
59
59
|
},
|
|
60
|
+
get fromSchema () {
|
|
61
|
+
return fromSchema;
|
|
62
|
+
},
|
|
63
|
+
get gen () {
|
|
64
|
+
return gen;
|
|
65
|
+
},
|
|
66
|
+
get genAsync () {
|
|
67
|
+
return genAsync;
|
|
68
|
+
},
|
|
60
69
|
get isErr () {
|
|
61
70
|
return _typescjs.isErr;
|
|
62
71
|
},
|
|
@@ -117,9 +126,6 @@ _export(exports, {
|
|
|
117
126
|
get settleMaybePromise () {
|
|
118
127
|
return settleMaybePromise;
|
|
119
128
|
},
|
|
120
|
-
get settledToResult () {
|
|
121
|
-
return settledToResult;
|
|
122
|
-
},
|
|
123
129
|
get tap () {
|
|
124
130
|
return tap;
|
|
125
131
|
},
|
|
@@ -132,6 +138,9 @@ _export(exports, {
|
|
|
132
138
|
get toOption () {
|
|
133
139
|
return toOption;
|
|
134
140
|
},
|
|
141
|
+
get toThrowable () {
|
|
142
|
+
return toThrowable;
|
|
143
|
+
},
|
|
135
144
|
get transpose () {
|
|
136
145
|
return transpose;
|
|
137
146
|
},
|
|
@@ -156,6 +165,9 @@ _export(exports, {
|
|
|
156
165
|
get unwrapOrReturn () {
|
|
157
166
|
return unwrapOrReturn;
|
|
158
167
|
},
|
|
168
|
+
get wrap () {
|
|
169
|
+
return wrap;
|
|
170
|
+
},
|
|
159
171
|
get zip () {
|
|
160
172
|
return zip;
|
|
161
173
|
},
|
|
@@ -164,6 +176,8 @@ _export(exports, {
|
|
|
164
176
|
}
|
|
165
177
|
});
|
|
166
178
|
const _typescjs = require("./types.cjs");
|
|
179
|
+
const identity = (v)=>v;
|
|
180
|
+
const wrapErr = (error)=>(0, _typescjs.err)(error);
|
|
167
181
|
function tryCatch(fn, onError) {
|
|
168
182
|
try {
|
|
169
183
|
return fn();
|
|
@@ -172,7 +186,27 @@ function tryCatch(fn, onError) {
|
|
|
172
186
|
}
|
|
173
187
|
}
|
|
174
188
|
function of(fn) {
|
|
175
|
-
|
|
189
|
+
try {
|
|
190
|
+
return fn();
|
|
191
|
+
} catch (error) {
|
|
192
|
+
return (0, _typescjs.err)(error);
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
function wrap(fn, onError) {
|
|
196
|
+
return (...args)=>{
|
|
197
|
+
try {
|
|
198
|
+
return fn(...args);
|
|
199
|
+
} catch (error) {
|
|
200
|
+
return (0, _typescjs.err)(onError ? onError(error) : error);
|
|
201
|
+
}
|
|
202
|
+
};
|
|
203
|
+
}
|
|
204
|
+
function toThrowable(fn) {
|
|
205
|
+
return (...args)=>{
|
|
206
|
+
const result = fn(...args);
|
|
207
|
+
if ((0, _typescjs.isErr)(result)) throw result.error;
|
|
208
|
+
return result;
|
|
209
|
+
};
|
|
176
210
|
}
|
|
177
211
|
async function fromPromise(promise, onError) {
|
|
178
212
|
try {
|
|
@@ -181,6 +215,14 @@ async function fromPromise(promise, onError) {
|
|
|
181
215
|
return (0, _typescjs.err)(onError ? onError(error) : error);
|
|
182
216
|
}
|
|
183
217
|
}
|
|
218
|
+
function schemaResultToResult(sr) {
|
|
219
|
+
return sr.issues ? (0, _typescjs.err)(sr.issues) : sr.value;
|
|
220
|
+
}
|
|
221
|
+
function fromSchema(schema, value) {
|
|
222
|
+
const sr = schema['~standard'].validate(value);
|
|
223
|
+
if ((0, _typescjs.isThenable)(sr)) return sr.then(schemaResultToResult);
|
|
224
|
+
return schemaResultToResult(sr);
|
|
225
|
+
}
|
|
184
226
|
function tryCatchMaybePromise(fn, onError) {
|
|
185
227
|
try {
|
|
186
228
|
const result = fn();
|
|
@@ -307,7 +349,8 @@ function match(result, onOk, onErr) {
|
|
|
307
349
|
function partition(results) {
|
|
308
350
|
const oks = [];
|
|
309
351
|
const errs = [];
|
|
310
|
-
for
|
|
352
|
+
for(let i = 0; i < results.length; i++){
|
|
353
|
+
const result = results[i];
|
|
311
354
|
if ((0, _typescjs.isOk)(result)) {
|
|
312
355
|
oks.push(result);
|
|
313
356
|
} else {
|
|
@@ -321,32 +364,34 @@ function partition(results) {
|
|
|
321
364
|
}
|
|
322
365
|
function filterOk(results) {
|
|
323
366
|
const oks = [];
|
|
324
|
-
for
|
|
367
|
+
for(let i = 0; i < results.length; i++){
|
|
368
|
+
const result = results[i];
|
|
325
369
|
if ((0, _typescjs.isOk)(result)) oks.push(result);
|
|
326
370
|
}
|
|
327
371
|
return oks;
|
|
328
372
|
}
|
|
329
373
|
function filterErr(results) {
|
|
330
374
|
const errs = [];
|
|
331
|
-
for
|
|
375
|
+
for(let i = 0; i < results.length; i++){
|
|
376
|
+
const result = results[i];
|
|
332
377
|
if ((0, _typescjs.isErr)(result)) errs.push(result.error);
|
|
333
378
|
}
|
|
334
379
|
return errs;
|
|
335
380
|
}
|
|
336
381
|
function collect(results) {
|
|
337
|
-
const
|
|
338
|
-
|
|
339
|
-
for(let i = 0; i < len; i++){
|
|
382
|
+
const values = [];
|
|
383
|
+
for(let i = 0; i < results.length; i++){
|
|
340
384
|
const result = results[i];
|
|
341
385
|
if ((0, _typescjs.isErr)(result)) return result;
|
|
342
|
-
values
|
|
386
|
+
values.push(result);
|
|
343
387
|
}
|
|
344
388
|
return values;
|
|
345
389
|
}
|
|
346
390
|
function collectAll(results) {
|
|
347
391
|
const oks = [];
|
|
348
392
|
const errs = [];
|
|
349
|
-
for
|
|
393
|
+
for(let i = 0; i < results.length; i++){
|
|
394
|
+
const result = results[i];
|
|
350
395
|
if ((0, _typescjs.isOk)(result)) {
|
|
351
396
|
oks.push(result);
|
|
352
397
|
} else {
|
|
@@ -380,17 +425,31 @@ function isOkAnd(result, predicate) {
|
|
|
380
425
|
function isErrAnd(result, predicate) {
|
|
381
426
|
return (0, _typescjs.isErr)(result) && predicate(result.error);
|
|
382
427
|
}
|
|
383
|
-
function settledToResult(result) {
|
|
384
|
-
if (result.status === 'fulfilled') return result.value;
|
|
385
|
-
return (0, _typescjs.err)(result.reason);
|
|
386
|
-
}
|
|
387
428
|
async function partitionAsync(promises) {
|
|
388
429
|
const settled = await Promise.allSettled(promises);
|
|
389
|
-
|
|
430
|
+
const oks = [];
|
|
431
|
+
const errs = [];
|
|
432
|
+
for(let i = 0; i < settled.length; i++){
|
|
433
|
+
const entry = settled[i];
|
|
434
|
+
if (entry.status === 'rejected') {
|
|
435
|
+
errs.push(entry.reason);
|
|
436
|
+
continue;
|
|
437
|
+
}
|
|
438
|
+
const result = entry.value;
|
|
439
|
+
if ((0, _typescjs.isOk)(result)) {
|
|
440
|
+
oks.push(result);
|
|
441
|
+
} else {
|
|
442
|
+
errs.push(result.error);
|
|
443
|
+
}
|
|
444
|
+
}
|
|
445
|
+
return [
|
|
446
|
+
oks,
|
|
447
|
+
errs
|
|
448
|
+
];
|
|
390
449
|
}
|
|
391
450
|
function settleMaybePromise(values) {
|
|
392
451
|
const len = values.length;
|
|
393
|
-
const results = new Array(len);
|
|
452
|
+
const results = new Array(len).fill(0);
|
|
394
453
|
let pendingIndices;
|
|
395
454
|
let pendingPromises;
|
|
396
455
|
for(let i = 0; i < len; i++){
|
|
@@ -412,29 +471,19 @@ function settleMaybePromise(values) {
|
|
|
412
471
|
});
|
|
413
472
|
}
|
|
414
473
|
async function partitionMaybePromiseAsync(values, oks, errs, startIndex = 0) {
|
|
415
|
-
const
|
|
416
|
-
const
|
|
417
|
-
for(let i = 0; i <
|
|
474
|
+
const remaining = values.length - startIndex;
|
|
475
|
+
const promises = new Array(remaining).fill(0);
|
|
476
|
+
for(let i = 0; i < remaining; i++){
|
|
418
477
|
const value = values[startIndex + i];
|
|
419
|
-
|
|
420
|
-
pendingPromises.push(Promise.resolve(value).then((result)=>result, (error)=>(0, _typescjs.err)(error)));
|
|
421
|
-
} else {
|
|
422
|
-
if ((0, _typescjs.isOk)(value)) {
|
|
423
|
-
oks.push(value);
|
|
424
|
-
} else {
|
|
425
|
-
errs.push(value.error);
|
|
426
|
-
}
|
|
427
|
-
}
|
|
478
|
+
promises[i] = (0, _typescjs.isThenable)(value) ? Promise.resolve(value).then(identity, wrapErr) : Promise.resolve(value);
|
|
428
479
|
}
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
errs.push(result.error);
|
|
437
|
-
}
|
|
480
|
+
const resolved = await Promise.all(promises);
|
|
481
|
+
for(let i = 0; i < resolved.length; i++){
|
|
482
|
+
const result = resolved[i];
|
|
483
|
+
if ((0, _typescjs.isOk)(result)) {
|
|
484
|
+
oks.push(result);
|
|
485
|
+
} else {
|
|
486
|
+
errs.push(result.error);
|
|
438
487
|
}
|
|
439
488
|
}
|
|
440
489
|
return [
|
|
@@ -476,5 +525,24 @@ async function safeTryAsync(fn) {
|
|
|
476
525
|
return (0, _typescjs.err)(e);
|
|
477
526
|
}
|
|
478
527
|
}
|
|
528
|
+
function* unwrapYield(result) {
|
|
529
|
+
if ((0, _typescjs.isErr)(result)) {
|
|
530
|
+
yield result;
|
|
531
|
+
return undefined;
|
|
532
|
+
}
|
|
533
|
+
return result;
|
|
534
|
+
}
|
|
535
|
+
function gen(fn) {
|
|
536
|
+
const iter = fn(unwrapYield);
|
|
537
|
+
const step = iter.next();
|
|
538
|
+
if (!step.done) return step.value;
|
|
539
|
+
return step.value;
|
|
540
|
+
}
|
|
541
|
+
async function genAsync(fn) {
|
|
542
|
+
const iter = fn(unwrapYield);
|
|
543
|
+
const step = await iter.next();
|
|
544
|
+
if (!step.done) return step.value;
|
|
545
|
+
return step.value;
|
|
546
|
+
}
|
|
479
547
|
|
|
480
548
|
//# sourceMappingURL=result.cjs.map
|
package/build/result.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/result.ts"],"sourcesContent":["import { err as ERR, isOk, isErr, isSome, isNone, NONE, optionOf, isThenable } from './types.js';\nimport type { Ok, Err, Result, Option, Widen, WidenNever, MaybePromise } from './types.js';\n\nexport type { Ok, Err, Result };\nexport { isOk, isErr };\n\n/**\n * Executes a function and captures the result or error.\n * @param fn - Function to execute\n * @param onError - Optional error transformer\n * @returns Ok(result) if successful, Err(error) if thrown\n * @example\n * tryCatch(() => JSON.parse('{\"a\":1}')) // Ok({a: 1})\n * tryCatch(() => JSON.parse('invalid')) // Err(SyntaxError)\n * tryCatch(() => { throw 'oops' }, e => e) // Err('oops')\n */\nexport function tryCatch<T>(fn: () => T): Result<T, unknown>;\nexport function tryCatch<T, E>(fn: () => T, onError: (error: unknown) => E): Result<T, E>;\nexport function tryCatch<T, E = unknown>(fn: () => T, onError?: (error: unknown) => E): Result<T, E> {\n try {\n return fn() as Ok<T>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n}\n\n/**\n * Alias for tryCatch. Executes a function and captures the result or error.\n * @param fn - Function to execute\n * @returns Ok(result) if successful, Err(error) if thrown\n */\nexport function of<T>(fn: () => T): Result<T, unknown> {\n return tryCatch(fn);\n}\n\n/**\n * Converts a Promise to a Result. Resolves to Ok if successful, Err on rejection.\n * @param promise - The promise to convert\n * @param onError - Optional error transformer\n * @returns Promise resolving to Ok(value) or Err(error)\n * @example\n * await fromPromise(fetch('/api')) // Ok(Response) or Err(unknown)\n * await fromPromise(fetch('/api'), e => String(e)) // Ok(Response) or Err(string)\n */\nexport async function fromPromise<T>(promise: Promise<T>): Promise<Result<T, unknown>>;\nexport async function fromPromise<T, E>(promise: Promise<T>, onError: (error: unknown) => E): Promise<Result<T, E>>;\nexport async function fromPromise<T, E = unknown>(promise: Promise<T>, onError?: (error: unknown) => E): Promise<Result<T, E>> {\n try {\n return (await promise) as Ok<T>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n}\n\n/**\n * Executes a function that may return sync or async, preserving sync execution when possible.\n * @param fn - Function that may return T or Promise<T>\n * @param onError - Optional error transformer\n * @returns Result<T, E> if sync, Promise<Result<T, E>> if async\n * @example\n * tryCatchMaybePromise(() => 42) // Ok(42) - sync\n * tryCatchMaybePromise(() => Promise.resolve(42)) // Promise<Ok(42)> - async\n * tryCatchMaybePromise(() => { throw 'err' }) // Err('err') - sync\n */\nexport function tryCatchMaybePromise<T>(fn: () => MaybePromise<T>): Result<T, unknown> | Promise<Result<T, unknown>>;\nexport function tryCatchMaybePromise<T, E>(fn: () => MaybePromise<T>, onError: (error: unknown) => E): Result<T, E> | Promise<Result<T, E>>;\nexport function tryCatchMaybePromise<T, E = unknown>(fn: () => MaybePromise<T>, onError?: (error: unknown) => E): Result<T, E> | Promise<Result<T, E>> {\n try {\n const result = fn();\n if (isThenable(result)) {\n return Promise.resolve(result).then(\n (value) => value as Ok<T>,\n (error) => ERR(onError ? onError(error) : (error as E)),\n );\n }\n return result as Ok<T>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n}\n\n/**\n * Unwraps an Ok value or returns a computed value for Err.\n * @param result - The Result to unwrap\n * @param onErr - Function called with error if Err\n * @returns The Ok value or result of onErr(error)\n * @example\n * unwrapOrReturn(ok(42), e => 0) // 42\n * unwrapOrReturn(err('fail'), e => 0) // 0\n */\nexport function unwrapOrReturn<T, E, const R>(result: Result<T, E>, onErr: (error: E) => R): T | R {\n return isOk(result) ? result : onErr(result.error);\n}\n\n/**\n * Asserts that a Result is Ok, throwing if Err.\n * @param result - The Result to assert\n * @param message - Custom error message\n * @throws Error if result is Err\n * @example\n * assertOk(ok(42)) // passes\n * assertOk(err('failed')) // throws Error\n */\nexport function assertOk<T, E>(result: Result<T, E>, message?: string): asserts result is Ok<T> {\n if (isErr(result)) {\n throw new Error(message ?? `Expected Ok result. Received error: ${String(result.error)}`);\n }\n}\n\n/**\n * Asserts that a Result is Err, throwing if Ok.\n * @param result - The Result to assert\n * @param message - Custom error message\n * @throws Error if result is Ok\n * @example\n * assertErr(err('failed')) // passes\n * assertErr(ok(42)) // throws Error\n */\nexport function assertErr<T, E>(result: Result<T, E>, message?: string): asserts result is Err<E> {\n if (isOk(result)) {\n throw new Error(message ?? `Expected Err result. Received value: ${String(result)}`);\n }\n}\n\n/**\n * Checks if result is Err with a non-null error value.\n * @param result - The Result to check\n * @returns true if Err with Some error value\n */\nexport function isSomeErr<T, E>(result: Result<T, E>): boolean {\n return isErr(result) && isSome(result.error);\n}\n\n/**\n * Transforms the Ok value, leaving Err unchanged.\n * @param result - The Result to map\n * @param fn - Transform function\n * @returns Ok(fn(value)) if Ok, Err unchanged\n * @example\n * map(ok(2), x => x * 2) // Ok(4)\n * map(err('e'), x => x * 2) // Err('e')\n */\nexport function map<T, U, E>(result: Err<E>, fn: (value: T) => U): Err<E>;\nexport function map<T, U>(result: Ok<T>, fn: (value: T) => U): Ok<U>;\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E> {\n if (isErr(result)) return result;\n return fn(result) as Ok<U>;\n}\n\n/**\n * Transforms the Err value, leaving Ok unchanged.\n * @param result - The Result to map\n * @param fn - Error transform function\n * @returns Err(fn(error)) if Err, Ok unchanged\n * @example\n * mapErr(err('e'), e => e.toUpperCase()) // Err('E')\n * mapErr(ok(42), e => e.toUpperCase()) // Ok(42)\n */\nexport function mapErr<T, E, F>(result: Ok<T>, fn: (error: E) => F): Ok<T>;\nexport function mapErr<E, F>(result: Err<E>, fn: (error: E) => F): Err<F>;\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F> {\n if (isOk(result)) return result;\n return ERR(fn(result.error));\n}\n\n/**\n * Chains Result-returning functions. Returns Err if the input is Err.\n * @param result - The Result to chain\n * @param fn - Function returning a Result\n * @returns The result of fn(value) if Ok, Err unchanged\n * @example\n * flatMap(ok(2), x => ok(x * 2)) // Ok(4)\n * flatMap(ok(2), x => err('fail')) // Err('fail')\n * flatMap(err('e'), x => ok(x * 2)) // Err('e')\n */\nexport function flatMap<T, U, E>(result: Err<E>, fn: (value: T) => Result<U, E>): Err<E>;\nexport function flatMap<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;\nexport function flatMap<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E> {\n if (isErr(result)) return result;\n return fn(result);\n}\n\n/**\n * Alias for flatMap. Chains Result-returning functions.\n * @param result - The Result to chain\n * @param fn - Function returning a Result\n * @returns The result of fn(value) if Ok, Err unchanged\n */\nexport const andThen: typeof flatMap = flatMap;\n\n/**\n * Executes a side effect if Ok, then returns the original Result.\n * @param result - The Result to tap\n * @param fn - Side effect function\n * @returns The original Result unchanged\n * @example\n * tap(ok(42), x => console.log(x)) // logs 42, returns Ok(42)\n */\nexport function tap<T, E>(result: Err<E>, fn: (value: T) => void): Err<E>;\nexport function tap<T>(result: Ok<T>, fn: (value: T) => void): Ok<T>;\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E>;\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E> {\n if (isOk(result)) {\n fn(result);\n }\n return result;\n}\n\n/**\n * Executes a side effect if Err, then returns the original Result.\n * @param result - The Result to tap\n * @param fn - Side effect function for error\n * @returns The original Result unchanged\n * @example\n * tapErr(err('fail'), e => console.log(e)) // logs 'fail', returns Err('fail')\n */\nexport function tapErr<T, E>(result: Ok<T>, fn: (error: E) => void): Ok<T>;\nexport function tapErr<E>(result: Err<E>, fn: (error: E) => void): Err<E>;\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E>;\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E> {\n if (isErr(result)) {\n fn(result.error);\n }\n return result;\n}\n\n/**\n * Maps both Ok and Err values simultaneously.\n * @param result - The Result to map\n * @param okFn - Transform for Ok value\n * @param errFn - Transform for Err value\n * @returns Ok(okFn(value)) if Ok, Err(errFn(error)) if Err\n * @example\n * bimap(ok(2), x => x * 2, e => e.toUpperCase()) // Ok(4)\n * bimap(err('e'), x => x * 2, e => e.toUpperCase()) // Err('E')\n */\nexport function bimap<T, U, E, F>(result: Ok<T>, okFn: (value: T) => U, errFn: (error: E) => F): Ok<U>;\nexport function bimap<T, U, E, F>(result: Err<E>, okFn: (value: T) => U, errFn: (error: E) => F): Err<F>;\nexport function bimap<T, U, E, F>(result: Result<T, E>, okFn: (value: T) => U, errFn: (error: E) => F): Result<U, F>;\nexport function bimap<T, U, E, F>(result: Result<T, E>, okFn: (value: T) => U, errFn: (error: E) => F): Result<U, F> {\n return isOk(result) ? (okFn(result) as Ok<U>) : ERR(errFn(result.error));\n}\n\n/**\n * Extracts the Ok value, throws Err if not Ok.\n * Use with safeTry for Rust-like ? operator ergonomics.\n * @param result - The Result to unwrap\n * @returns The contained Ok value\n * @throws The Err object itself\n * @example\n * unwrap(ok(42)) // 42\n * unwrap(err('failed')) // throws Err\n * safeTry(() => {\n * const a = unwrap(getValue());\n * return a + 1;\n * });\n */\nexport function unwrap<T, E>(result: Result<T, E>): T {\n if (isErr(result)) throw result.error;\n return result;\n}\n\n/**\n * Extracts the Err value, throws if Ok.\n * @param result - The Result to unwrap\n * @returns The contained error\n * @throws Error if result is Ok\n * @example\n * unwrapErr(err('failed')) // 'failed'\n * unwrapErr(ok(42)) // throws Error\n */\nexport function unwrapErr<T, E>(result: Result<T, E>): E {\n if (isOk(result)) {\n throw new Error(`Called unwrapErr on Ok: ${String(result)}`);\n }\n return result.error;\n}\n\n/**\n * Extracts the Ok value, or returns a default.\n * @param result - The Result to unwrap\n * @param defaultValue - Value if Err\n * @returns The Ok value or defaultValue\n * @example\n * unwrapOr(ok(42), 0) // 42\n * unwrapOr(err('failed'), 0) // 0\n */\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n return isOk(result) ? result : defaultValue;\n}\n\n/**\n * Extracts the Ok value, or computes a default from the error.\n * @param result - The Result to unwrap\n * @param fn - Function to compute default from error\n * @returns The Ok value or fn(error)\n * @example\n * unwrapOrElse(ok(42), e => 0) // 42\n * unwrapOrElse(err('failed'), e => 0) // 0\n */\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\n return isOk(result) ? result : fn(result.error);\n}\n\n/**\n * Maps the Ok value and returns it, or returns a default.\n * @param result - The Result to map\n * @param defaultValue - Value if Err\n * @param fn - Transform function\n * @returns fn(value) if Ok, defaultValue otherwise\n * @example\n * mapOr(ok(2), 0, x => x * 2) // 4\n * mapOr(err('e'), 0, x => x * 2) // 0\n */\nexport function mapOr<T, E, U>(result: Result<T, E>, defaultValue: U, fn: (value: T) => U): U {\n return isOk(result) ? fn(result) : defaultValue;\n}\n\n/**\n * Maps the Ok value and returns it, or computes a default.\n * @param result - The Result to map\n * @param defaultFn - Function to compute default\n * @param fn - Transform function\n * @returns fn(value) if Ok, defaultFn() otherwise\n * @example\n * mapOrElse(ok(2), () => 0, x => x * 2) // 4\n * mapOrElse(err('e'), () => 0, x => x * 2) // 0\n */\nexport function mapOrElse<T, E, U>(result: Result<T, E>, defaultFn: () => U, fn: (value: T) => U): U {\n return isOk(result) ? fn(result) : defaultFn();\n}\n\n/**\n * Extracts the Ok value, throws with custom message if Err.\n * @param result - The Result to unwrap\n * @param message - Error message prefix if Err\n * @returns The Ok value\n * @throws Error with message if Err\n * @example\n * expect(ok(42), 'missing value') // 42\n * expect(err('fail'), 'missing value') // throws Error('missing value: fail')\n */\nexport function expect<T, E>(result: Result<T, E>, message: string): T {\n if (isErr(result)) {\n throw new Error(`${message}: ${String(result.error)}`);\n }\n return result;\n}\n\n/**\n * Extracts the Err value, throws with custom message if Ok.\n * @param result - The Result to unwrap\n * @param message - Error message prefix if Ok\n * @returns The error value\n * @throws Error with message if Ok\n * @example\n * expectErr(err('fail'), 'expected error') // 'fail'\n * expectErr(ok(42), 'expected error') // throws Error\n */\nexport function expectErr<T, E>(result: Result<T, E>, message: string): E {\n if (isOk(result)) {\n throw new Error(`${message}: ${String(result)}`);\n }\n return result.error;\n}\n\n/**\n * Returns other if result is Ok, otherwise returns the Err.\n * @param result - First Result\n * @param other - Second Result\n * @returns other if result is Ok, result (Err) otherwise\n * @example\n * and(ok(1), ok(2)) // Ok(2)\n * and(err('e'), ok(2)) // Err('e')\n */\nexport function and<T, U, E>(result: Result<T, E>, other: Result<U, E>): Result<U, E> {\n return isOk(result) ? other : result;\n}\n\n/**\n * Returns result if Ok, otherwise returns other.\n * @param result - First Result\n * @param other - Fallback Result\n * @returns result if Ok, other otherwise\n * @example\n * or(ok(1), ok(2)) // Ok(1)\n * or(err('e'), ok(2)) // Ok(2)\n */\nexport function or<T, E, F>(result: Result<T, E>, other: Result<T, F>): Result<T, F> {\n return isOk(result) ? result : other;\n}\n\n/**\n * Returns result if Ok, otherwise computes a fallback from the error.\n * @param result - First Result\n * @param fn - Function to compute fallback\n * @returns result if Ok, fn(error) otherwise\n * @example\n * orElse(ok(1), e => ok(0)) // Ok(1)\n * orElse(err('e'), e => ok(0)) // Ok(0)\n */\nexport function orElse<T, E, F>(result: Result<T, E>, fn: (error: E) => Result<T, F>): Result<T, F> {\n return isOk(result) ? result : fn(result.error);\n}\n\n/**\n * Converts a Result to an Option, discarding the error.\n * @param result - The Result to convert\n * @returns Some(value) if Ok, None if Err\n * @example\n * toOption(ok(42)) // Some(42)\n * toOption(err('failed')) // None\n */\nexport function toOption<T, E>(result: Result<T, E>): Option<T> {\n return isOk(result) ? optionOf(result) : NONE;\n}\n\n/**\n * Converts a Result's error to an Option.\n * @param result - The Result to convert\n * @returns Some(error) if Err, None if Ok\n * @example\n * toErrorOption(err('failed')) // Some('failed')\n * toErrorOption(ok(42)) // None\n */\nexport function toErrorOption<T, E>(result: Result<T, E>): Option<E> {\n return isErr(result) ? optionOf(result.error) : NONE;\n}\n\n/**\n * Combines two Results into a Result of a tuple.\n * @param left - First Result\n * @param right - Second Result\n * @returns Ok([a, b]) if both Ok, first Err otherwise\n * @example\n * zip(ok(1), ok('a')) // Ok([1, 'a'])\n * zip(ok(1), err('e')) // Err('e')\n */\nexport function zip<T, U, E>(left: Result<T, E>, right: Result<U, E>): Result<[T, U], E> {\n if (isErr(left)) return left;\n if (isErr(right)) return right;\n return [left, right] as Ok<[T, U]>;\n}\n\n/**\n * Combines two Results using a function.\n * @param left - First Result\n * @param right - Second Result\n * @param fn - Combining function\n * @returns Ok(fn(a, b)) if both Ok, first Err otherwise\n * @example\n * zipWith(ok(2), ok(3), (a, b) => a + b) // Ok(5)\n */\nexport function zipWith<T, U, V, E>(left: Result<T, E>, right: Result<U, E>, fn: (left: T, right: U) => V): Result<V, E> {\n if (isErr(left)) return left;\n if (isErr(right)) return right;\n return fn(left, right) as Ok<V>;\n}\n\n/**\n * Flattens a nested Result.\n * @param result - Result containing a Result\n * @returns The inner Result\n * @example\n * flatten(ok(ok(42))) // Ok(42)\n * flatten(ok(err('e'))) // Err('e')\n * flatten(err('outer')) // Err('outer')\n */\nexport function flatten<T, E>(result: Result<Result<T, E>, E>): Result<T, E> {\n return isErr(result) ? (result as Err<E>) : (result as Result<T, E>);\n}\n\n/**\n * Pattern matches on a Result, handling both Ok and Err cases.\n * @param result - The Result to match\n * @param onOk - Handler for Ok case\n * @param onErr - Handler for Err case\n * @returns Result of the matching handler\n * @example\n * match(ok(42), x => x * 2, e => 0) // 84\n * match(err('e'), x => x * 2, e => 0) // 0\n */\nexport function match<T, E, U>(result: Result<T, E>, onOk: (value: T) => U, onErr: (error: E) => U): U {\n return isOk(result) ? onOk(result) : onErr(result.error);\n}\n\n/**\n * Separates an array of Results into Ok values and Err values.\n * @param results - Array of Results\n * @returns Tuple of [Ok values, Err values]\n * @example\n * partition([ok(1), err('a'), ok(2)]) // [[1, 2], ['a']]\n */\nexport function partition<T, E>(results: Result<T, E>[]): [T[], E[]] {\n const oks: T[] = [];\n const errs: E[] = [];\n\n for (const result of results) {\n if (isOk(result)) {\n oks.push(result);\n } else {\n errs.push(result.error);\n }\n }\n\n return [oks, errs];\n}\n\n/**\n * Extracts all Ok values from an iterable of Results.\n * @param results - Iterable of Results\n * @returns Array of Ok values\n * @example\n * filterOk([ok(1), err('a'), ok(2)]) // [1, 2]\n */\nexport function filterOk<T, E>(results: Iterable<Result<T, E>>): T[] {\n const oks: T[] = [];\n for (const result of results) {\n if (isOk(result)) oks.push(result);\n }\n return oks;\n}\n\n/**\n * Extracts all Err values from an iterable of Results.\n * @param results - Iterable of Results\n * @returns Array of error values\n * @example\n * filterErr([ok(1), err('a'), ok(2)]) // ['a']\n */\nexport function filterErr<T, E>(results: Iterable<Result<T, E>>): E[] {\n const errs: E[] = [];\n for (const result of results) {\n if (isErr(result)) errs.push(result.error);\n }\n return errs;\n}\n\n/**\n * Collects an array of Results into a Result of an array. Fails on first Err.\n * @param results - Array of Results\n * @returns Ok(values) if all Ok, first Err otherwise\n * @example\n * collect([ok(1), ok(2)]) // Ok([1, 2])\n * collect([ok(1), err('e')]) // Err('e')\n */\nexport function collect<T, E>(results: Result<T, E>[]): Result<T[], E> {\n const len = results.length;\n const values = new Array<T>(len);\n\n for (let i = 0; i < len; i++) {\n const result = results[i];\n if (isErr(result)) return result;\n values[i] = result;\n }\n\n return values as Ok<T[]>;\n}\n\n/**\n * Collects all Results, returning all errors if any exist.\n * @param results - Array of Results\n * @returns Ok(values) if all Ok, Err(allErrors) otherwise\n * @example\n * collectAll([ok(1), ok(2)]) // Ok([1, 2])\n * collectAll([ok(1), err('a'), err('b')]) // Err(['a', 'b'])\n */\nexport function collectAll<T, E>(results: Result<T, E>[]): Result<T[], E[]> {\n const oks: T[] = [];\n const errs: E[] = [];\n for (const result of results) {\n if (isOk(result)) {\n oks.push(result);\n } else {\n errs.push(result.error);\n }\n }\n return errs.length > 0 ? ERR(errs) : (oks as Ok<T[]>);\n}\n\n/**\n * Alias for collect with widened types. Collects Results into a Result of array.\n * @param results - Array of Results\n * @returns Ok(values) if all Ok, first Err otherwise\n */\nexport function all<T, E>(results: Result<T, E>[]): Result<readonly Widen<T>[], WidenNever<E>> {\n return collect(results) as Result<readonly Widen<T>[], WidenNever<E>>;\n}\n\n/**\n * Returns the first Ok, or all errors if none succeed.\n * @param results - Array of Results\n * @returns First Ok found, or Err(allErrors) if all fail\n * @example\n * any([err('a'), ok(1), err('b')]) // Ok(1)\n * any([err('a'), err('b')]) // Err(['a', 'b'])\n */\nexport function any<T, E>(results: Result<T, E>[]): Result<Widen<T>, WidenNever<E>[]> {\n const errors: WidenNever<E>[] = [];\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isOk(result)) return result as Ok<Widen<T>>;\n errors.push((result as Err<WidenNever<E>>).error);\n }\n return ERR(errors);\n}\n\n/**\n * Transposes a Result of Option to an Option of Result.\n * @param result - Result containing an Option\n * @returns Some(Ok(value)) if Ok(Some), None if Ok(None), Some(Err) if Err\n * @example\n * transpose(ok(some(42))) // Some(Ok(42))\n * transpose(ok(none)) // None\n * transpose(err('e')) // Some(Err('e'))\n */\nexport function transpose<T, E>(result: Result<Option<T>, E>): Option<Result<T, E>> {\n if (isErr(result)) {\n return ERR(result.error) as Option<Result<T, E>>;\n }\n const opt = result as Option<T>;\n return isNone(opt) ? NONE : (opt as unknown as Ok<T> as Option<Result<T, E>>);\n}\n\n/**\n * Checks if Ok and the value satisfies a predicate.\n * @param result - The Result to check\n * @param predicate - Test function\n * @returns true if Ok and predicate returns true\n * @example\n * isOkAnd(ok(4), x => x > 2) // true\n * isOkAnd(ok(1), x => x > 2) // false\n * isOkAnd(err('e'), x => x > 2) // false\n */\nexport function isOkAnd<T, E>(result: Result<T, E>, predicate: (value: T) => boolean): boolean {\n return isOk(result) && predicate(result);\n}\n\n/**\n * Checks if Err and the error satisfies a predicate.\n * @param result - The Result to check\n * @param predicate - Test function\n * @returns true if Err and predicate returns true\n * @example\n * isErrAnd(err('fatal'), e => e.includes('fatal')) // true\n * isErrAnd(ok(42), e => true) // false\n */\nexport function isErrAnd<T, E>(result: Result<T, E>, predicate: (error: E) => boolean): boolean {\n return isErr(result) && predicate(result.error);\n}\n\nexport function settledToResult<T, E>(result: PromiseSettledResult<Result<T, E>>): Result<T, E> {\n if (result.status === 'fulfilled') return result.value;\n return ERR(result.reason);\n}\n\n/**\n * Partitions an async iterable of Results.\n * @param results - Iterable of Promise Results\n * @returns Promise of [Ok values, Err values]\n * @example\n * await partitionAsync([Promise.resolve(ok(1)), Promise.resolve(err('a'))])\n * // [[1], ['a']]\n */\nexport async function partitionAsync<T, E>(promises: Iterable<Promise<Result<T, E>>>): Promise<[Widen<T>[], WidenNever<E>[]]> {\n const settled = await Promise.allSettled(promises);\n return partition(settled.map(settledToResult)) as [Widen<T>[], WidenNever<E>[]];\n}\n\n/**\n * Settles an array of MaybePromise values into Results.\n * Returns synchronously if all inputs are sync, avoiding Promise overhead.\n * @param values - Array of values that may or may not be Promises\n * @returns Array of Results (sync) or Promise of Results (if any async)\n * @example\n * settleMaybePromise([1, 2, 3]) // [Ok(1), Ok(2), Ok(3)] - sync\n * settleMaybePromise([1, Promise.resolve(2)]) // Promise<[Ok(1), Ok(2)]>\n * settleMaybePromise([Promise.reject('e')]) // Promise<[Err('e')]>\n */\nexport function settleMaybePromise<T, E = unknown>(values: MaybePromise<T>[]): Result<T, E>[] | Promise<Result<T, E>[]> {\n const len = values.length;\n const results = new Array<Result<T, E>>(len);\n let pendingIndices: number[] | undefined;\n let pendingPromises: Promise<T>[] | undefined;\n\n for (let i = 0; i < len; i++) {\n const v = values[i];\n if (isThenable(v)) {\n (pendingIndices ??= []).push(i);\n (pendingPromises ??= []).push(Promise.resolve(v));\n } else {\n results[i] = v as Ok<T>;\n }\n }\n\n if (!pendingPromises) return results;\n\n return Promise.allSettled(pendingPromises).then((settled) => {\n for (let i = 0; i < settled.length; i++) {\n const s = settled[i];\n results[pendingIndices![i]] = s.status === 'fulfilled' ? (s.value as Ok<T>) : ERR(s.reason as E);\n }\n return results;\n });\n}\n\nexport async function partitionMaybePromiseAsync<T, E>(\n values: MaybePromise<Result<T, E>>[],\n oks: Widen<T>[],\n errs: WidenNever<E>[],\n startIndex: number = 0,\n): Promise<[Widen<T>[], WidenNever<E>[]]> {\n const suffixLength = values.length - startIndex;\n const pendingPromises: Promise<Result<T, E>>[] = [];\n\n for (let i = 0; i < suffixLength; i++) {\n const value = values[startIndex + i];\n if (isThenable(value)) {\n pendingPromises.push(\n Promise.resolve(value).then(\n (result) => result as Result<T, E>,\n (error) => ERR(error as E),\n ),\n );\n } else {\n if (isOk(value)) {\n oks.push(value as Widen<T>);\n } else {\n errs.push((value as Err<WidenNever<E>>).error);\n }\n }\n }\n\n if (pendingPromises.length > 0) {\n const resolved = await Promise.all(pendingPromises);\n for (let i = 0; i < resolved.length; i++) {\n const result = resolved[i];\n if (isOk(result)) {\n oks.push(result as Widen<T>);\n } else {\n errs.push((result as Err<WidenNever<E>>).error);\n }\n }\n }\n\n return [oks, errs] as [Widen<T>[], WidenNever<E>[]];\n}\n\n/**\n * Partitions MaybePromise Results into Ok and Err values.\n * Returns synchronously if all inputs are sync, avoiding Promise overhead.\n * @param values - Array of MaybePromise Results\n * @returns [Ok values, Err values] (sync) or Promise of same (if any async)\n * @example\n * partitionMaybePromise([ok(1), err('a')]) // [[1], ['a']] - sync\n * partitionMaybePromise([ok(1), Promise.resolve(err('a'))]) // Promise<[[1], ['a']]>\n */\nexport function partitionMaybePromise<T, E>(values: MaybePromise<Result<T, E>>[]): [Widen<T>[], WidenNever<E>[]] | Promise<[Widen<T>[], WidenNever<E>[]]> {\n const len = values.length;\n const oks: Widen<T>[] = [];\n const errs: WidenNever<E>[] = [];\n\n for (let i = 0; i < len; i++) {\n const value = values[i];\n if (isThenable(value)) {\n return partitionMaybePromiseAsync(values, oks, errs, i);\n }\n if (isOk(value)) {\n oks.push(value as Widen<T>);\n } else {\n errs.push((value as Err<WidenNever<E>>).error);\n }\n }\n\n return [oks, errs];\n}\n\n/**\n * Executes a function, catching thrown Err values.\n * Use with unwrap for Rust-like ? operator ergonomics.\n * @param fn - Function that may throw Err via unwrap\n * @returns Ok(return value) or the caught Err\n * @example\n * const result = safeTry(() => {\n * const a = unwrap(parseNumber('10'));\n * const b = unwrap(parseNumber('5'));\n * return a + b;\n * }); // Ok(15) or Err(...)\n */\nexport function safeTry<T>(fn: () => T): Result<T, unknown> {\n try {\n return fn() as Ok<T>;\n } catch (e) {\n return ERR(e);\n }\n}\n\n/**\n * Async version of safeTry.\n * @param fn - Async function that may throw Err via unwrap\n * @returns Promise of Ok(return value) or the caught Err\n * @example\n * const result = await safeTryAsync(async () => {\n * const user = unwrap(await fetchUser(id));\n * const posts = unwrap(await fetchPosts(user.id));\n * return { user, posts };\n * });\n */\nexport async function safeTryAsync<T>(fn: () => Promise<T>): Promise<Result<T, unknown>> {\n try {\n return (await fn()) as Ok<T>;\n } catch (e) {\n return ERR(e);\n }\n}\n"],"names":["all","and","andThen","any","assertErr","assertOk","bimap","collect","collectAll","expect","expectErr","filterErr","filterOk","flatMap","flatten","fromPromise","isErr","isErrAnd","isOk","isOkAnd","isSomeErr","map","mapErr","mapOr","mapOrElse","match","of","or","orElse","partition","partitionAsync","partitionMaybePromise","partitionMaybePromiseAsync","safeTry","safeTryAsync","settleMaybePromise","settledToResult","tap","tapErr","toErrorOption","toOption","transpose","tryCatch","tryCatchMaybePromise","unwrap","unwrapErr","unwrapOr","unwrapOrElse","unwrapOrReturn","zip","zipWith","fn","onError","error","ERR","promise","result","isThenable","Promise","resolve","then","value","onErr","message","Error","String","isSome","okFn","errFn","defaultValue","defaultFn","other","optionOf","NONE","left","right","onOk","results","oks","errs","push","len","length","values","Array","i","errors","opt","isNone","predicate","status","reason","promises","settled","allSettled","pendingIndices","pendingPromises","v","s","startIndex","suffixLength","resolved","e"],"mappings":";;;;;;;;;;;QA2kBgBA;eAAAA;;QAlNAC;eAAAA;;QA3LHC;eAAAA;;QAyZGC;eAAAA;;QAjeAC;eAAAA;;QAfAC;eAAAA;;QA0IAC;eAAAA;;QAmTAC;eAAAA;;QAqBAC;eAAAA;;QAjOAC;eAAAA;;QAiBAC;eAAAA;;QA2KAC;eAAAA;;QAfAC;eAAAA;;QAlVAC;eAAAA;;QAmSAC;eAAAA;;QAxaMC;eAAAA;;QA1CPC;eAAAA,eAAK;;QAqoBJC;eAAAA;;QAroBPC;eAAAA,cAAI;;QAwnBGC;eAAAA;;QA3fAC;eAAAA;;QAgBAC;eAAAA;;QAiBAC;eAAAA;;QA0JAC;eAAAA;;QAcAC;eAAAA;;QA0JAC;eAAAA;;QArcAC;eAAAA;;QAuWAC;eAAAA;;QAaAC;eAAAA;;QA4FAC;eAAAA;;QA2KMC;eAAAA;;QA6FNC;eAAAA;;QAnDMC;eAAAA;;QAmFNC;eAAAA;;QAmBMC;eAAAA;;QAjINC;eAAAA;;QA5BAC;eAAAA;;QAlcAC;eAAAA;;QAkBAC;eAAAA;;QA8MAC;eAAAA;;QAZAC;eAAAA;;QA2MAC;eAAAA;;QAxlBAC;eAAAA;;QAgDAC;eAAAA;;QAiMAC;eAAAA;;QAcAC;eAAAA;;QAgBAC;eAAAA;;QAaAC;eAAAA;;QApNAC;eAAAA;;QA8VAC;eAAAA;;QAeAC;eAAAA;;;0BAvcoE;AAkB7E,SAASR,SAAyBS,EAAW,EAAEC,OAA+B;IACnF,IAAI;QACF,OAAOD;IACT,EAAE,OAAOE,OAAO;QACd,OAAOC,IAAAA,aAAG,EAACF,UAAUA,QAAQC,SAAUA;IACzC;AACF;AAOO,SAAS3B,GAAMyB,EAAW;IAC/B,OAAOT,SAASS;AAClB;AAaO,eAAepC,YAA4BwC,OAAmB,EAAEH,OAA+B;IACpG,IAAI;QACF,OAAQ,MAAMG;IAChB,EAAE,OAAOF,OAAO;QACd,OAAOC,IAAAA,aAAG,EAACF,UAAUA,QAAQC,SAAUA;IACzC;AACF;AAcO,SAASV,qBAAqCQ,EAAyB,EAAEC,OAA+B;IAC7G,IAAI;QACF,MAAMI,SAASL;QACf,IAAIM,IAAAA,oBAAU,EAACD,SAAS;YACtB,OAAOE,QAAQC,OAAO,CAACH,QAAQI,IAAI,CACjC,CAACC,QAAUA,OACX,CAACR,QAAUC,IAAAA,aAAG,EAACF,UAAUA,QAAQC,SAAUA;QAE/C;QACA,OAAOG;IACT,EAAE,OAAOH,OAAO;QACd,OAAOC,IAAAA,aAAG,EAACF,UAAUA,QAAQC,SAAUA;IACzC;AACF;AAWO,SAASL,eAA8BQ,MAAoB,EAAEM,KAAsB;IACxF,OAAO5C,IAAAA,cAAI,EAACsC,UAAUA,SAASM,MAAMN,OAAOH,KAAK;AACnD;AAWO,SAAShD,SAAemD,MAAoB,EAAEO,OAAgB;IACnE,IAAI/C,IAAAA,eAAK,EAACwC,SAAS;QACjB,MAAM,IAAIQ,MAAMD,WAAW,CAAC,oCAAoC,EAAEE,OAAOT,OAAOH,KAAK,GAAG;IAC1F;AACF;AAWO,SAASjD,UAAgBoD,MAAoB,EAAEO,OAAgB;IACpE,IAAI7C,IAAAA,cAAI,EAACsC,SAAS;QAChB,MAAM,IAAIQ,MAAMD,WAAW,CAAC,qCAAqC,EAAEE,OAAOT,SAAS;IACrF;AACF;AAOO,SAASpC,UAAgBoC,MAAoB;IAClD,OAAOxC,IAAAA,eAAK,EAACwC,WAAWU,IAAAA,gBAAM,EAACV,OAAOH,KAAK;AAC7C;AAcO,SAAShC,IAAamC,MAAoB,EAAEL,EAAmB;IACpE,IAAInC,IAAAA,eAAK,EAACwC,SAAS,OAAOA;IAC1B,OAAOL,GAAGK;AACZ;AAcO,SAASlC,OAAgBkC,MAAoB,EAAEL,EAAmB;IACvE,IAAIjC,IAAAA,cAAI,EAACsC,SAAS,OAAOA;IACzB,OAAOF,IAAAA,aAAG,EAACH,GAAGK,OAAOH,KAAK;AAC5B;AAcO,SAASxC,QAAiB2C,MAAoB,EAAEL,EAA8B;IACnF,IAAInC,IAAAA,eAAK,EAACwC,SAAS,OAAOA;IAC1B,OAAOL,GAAGK;AACZ;AAQO,MAAMtD,UAA0BW;AAahC,SAASwB,IAAUmB,MAAoB,EAAEL,EAAsB;IACpE,IAAIjC,IAAAA,cAAI,EAACsC,SAAS;QAChBL,GAAGK;IACL;IACA,OAAOA;AACT;AAaO,SAASlB,OAAakB,MAAoB,EAAEL,EAAsB;IACvE,IAAInC,IAAAA,eAAK,EAACwC,SAAS;QACjBL,GAAGK,OAAOH,KAAK;IACjB;IACA,OAAOG;AACT;AAeO,SAASlD,MAAkBkD,MAAoB,EAAEW,IAAqB,EAAEC,KAAsB;IACnG,OAAOlD,IAAAA,cAAI,EAACsC,UAAWW,KAAKX,UAAoBF,IAAAA,aAAG,EAACc,MAAMZ,OAAOH,KAAK;AACxE;AAgBO,SAAST,OAAaY,MAAoB;IAC/C,IAAIxC,IAAAA,eAAK,EAACwC,SAAS,MAAMA,OAAOH,KAAK;IACrC,OAAOG;AACT;AAWO,SAASX,UAAgBW,MAAoB;IAClD,IAAItC,IAAAA,cAAI,EAACsC,SAAS;QAChB,MAAM,IAAIQ,MAAM,CAAC,wBAAwB,EAAEC,OAAOT,SAAS;IAC7D;IACA,OAAOA,OAAOH,KAAK;AACrB;AAWO,SAASP,SAAeU,MAAoB,EAAEa,YAAe;IAClE,OAAOnD,IAAAA,cAAI,EAACsC,UAAUA,SAASa;AACjC;AAWO,SAAStB,aAAmBS,MAAoB,EAAEL,EAAmB;IAC1E,OAAOjC,IAAAA,cAAI,EAACsC,UAAUA,SAASL,GAAGK,OAAOH,KAAK;AAChD;AAYO,SAAS9B,MAAeiC,MAAoB,EAAEa,YAAe,EAAElB,EAAmB;IACvF,OAAOjC,IAAAA,cAAI,EAACsC,UAAUL,GAAGK,UAAUa;AACrC;AAYO,SAAS7C,UAAmBgC,MAAoB,EAAEc,SAAkB,EAAEnB,EAAmB;IAC9F,OAAOjC,IAAAA,cAAI,EAACsC,UAAUL,GAAGK,UAAUc;AACrC;AAYO,SAAS7D,OAAa+C,MAAoB,EAAEO,OAAe;IAChE,IAAI/C,IAAAA,eAAK,EAACwC,SAAS;QACjB,MAAM,IAAIQ,MAAM,GAAGD,QAAQ,EAAE,EAAEE,OAAOT,OAAOH,KAAK,GAAG;IACvD;IACA,OAAOG;AACT;AAYO,SAAS9C,UAAgB8C,MAAoB,EAAEO,OAAe;IACnE,IAAI7C,IAAAA,cAAI,EAACsC,SAAS;QAChB,MAAM,IAAIQ,MAAM,GAAGD,QAAQ,EAAE,EAAEE,OAAOT,SAAS;IACjD;IACA,OAAOA,OAAOH,KAAK;AACrB;AAWO,SAASpD,IAAauD,MAAoB,EAAEe,KAAmB;IACpE,OAAOrD,IAAAA,cAAI,EAACsC,UAAUe,QAAQf;AAChC;AAWO,SAAS7B,GAAY6B,MAAoB,EAAEe,KAAmB;IACnE,OAAOrD,IAAAA,cAAI,EAACsC,UAAUA,SAASe;AACjC;AAWO,SAAS3C,OAAgB4B,MAAoB,EAAEL,EAA8B;IAClF,OAAOjC,IAAAA,cAAI,EAACsC,UAAUA,SAASL,GAAGK,OAAOH,KAAK;AAChD;AAUO,SAASb,SAAegB,MAAoB;IACjD,OAAOtC,IAAAA,cAAI,EAACsC,UAAUgB,IAAAA,kBAAQ,EAAChB,UAAUiB,cAAI;AAC/C;AAUO,SAASlC,cAAoBiB,MAAoB;IACtD,OAAOxC,IAAAA,eAAK,EAACwC,UAAUgB,IAAAA,kBAAQ,EAAChB,OAAOH,KAAK,IAAIoB,cAAI;AACtD;AAWO,SAASxB,IAAayB,IAAkB,EAAEC,KAAmB;IAClE,IAAI3D,IAAAA,eAAK,EAAC0D,OAAO,OAAOA;IACxB,IAAI1D,IAAAA,eAAK,EAAC2D,QAAQ,OAAOA;IACzB,OAAO;QAACD;QAAMC;KAAM;AACtB;AAWO,SAASzB,QAAoBwB,IAAkB,EAAEC,KAAmB,EAAExB,EAA4B;IACvG,IAAInC,IAAAA,eAAK,EAAC0D,OAAO,OAAOA;IACxB,IAAI1D,IAAAA,eAAK,EAAC2D,QAAQ,OAAOA;IACzB,OAAOxB,GAAGuB,MAAMC;AAClB;AAWO,SAAS7D,QAAc0C,MAA+B;IAC3D,OAAOxC,IAAAA,eAAK,EAACwC,UAAWA,SAAqBA;AAC/C;AAYO,SAAS/B,MAAe+B,MAAoB,EAAEoB,IAAqB,EAAEd,KAAsB;IAChG,OAAO5C,IAAAA,cAAI,EAACsC,UAAUoB,KAAKpB,UAAUM,MAAMN,OAAOH,KAAK;AACzD;AASO,SAASxB,UAAgBgD,OAAuB;IACrD,MAAMC,MAAW,EAAE;IACnB,MAAMC,OAAY,EAAE;IAEpB,KAAK,MAAMvB,UAAUqB,QAAS;QAC5B,IAAI3D,IAAAA,cAAI,EAACsC,SAAS;YAChBsB,IAAIE,IAAI,CAACxB;QACX,OAAO;YACLuB,KAAKC,IAAI,CAACxB,OAAOH,KAAK;QACxB;IACF;IAEA,OAAO;QAACyB;QAAKC;KAAK;AACpB;AASO,SAASnE,SAAeiE,OAA+B;IAC5D,MAAMC,MAAW,EAAE;IACnB,KAAK,MAAMtB,UAAUqB,QAAS;QAC5B,IAAI3D,IAAAA,cAAI,EAACsC,SAASsB,IAAIE,IAAI,CAACxB;IAC7B;IACA,OAAOsB;AACT;AASO,SAASnE,UAAgBkE,OAA+B;IAC7D,MAAME,OAAY,EAAE;IACpB,KAAK,MAAMvB,UAAUqB,QAAS;QAC5B,IAAI7D,IAAAA,eAAK,EAACwC,SAASuB,KAAKC,IAAI,CAACxB,OAAOH,KAAK;IAC3C;IACA,OAAO0B;AACT;AAUO,SAASxE,QAAcsE,OAAuB;IACnD,MAAMI,MAAMJ,QAAQK,MAAM;IAC1B,MAAMC,SAAS,IAAIC,MAASH;IAE5B,IAAK,IAAII,IAAI,GAAGA,IAAIJ,KAAKI,IAAK;QAC5B,MAAM7B,SAASqB,OAAO,CAACQ,EAAE;QACzB,IAAIrE,IAAAA,eAAK,EAACwC,SAAS,OAAOA;QAC1B2B,MAAM,CAACE,EAAE,GAAG7B;IACd;IAEA,OAAO2B;AACT;AAUO,SAAS3E,WAAiBqE,OAAuB;IACtD,MAAMC,MAAW,EAAE;IACnB,MAAMC,OAAY,EAAE;IACpB,KAAK,MAAMvB,UAAUqB,QAAS;QAC5B,IAAI3D,IAAAA,cAAI,EAACsC,SAAS;YAChBsB,IAAIE,IAAI,CAACxB;QACX,OAAO;YACLuB,KAAKC,IAAI,CAACxB,OAAOH,KAAK;QACxB;IACF;IACA,OAAO0B,KAAKG,MAAM,GAAG,IAAI5B,IAAAA,aAAG,EAACyB,QAASD;AACxC;AAOO,SAAS9E,IAAU6E,OAAuB;IAC/C,OAAOtE,QAAQsE;AACjB;AAUO,SAAS1E,IAAU0E,OAAuB;IAC/C,MAAMS,SAA0B,EAAE;IAClC,IAAK,IAAID,IAAI,GAAGA,IAAIR,QAAQK,MAAM,EAAEG,IAAK;QACvC,MAAM7B,SAASqB,OAAO,CAACQ,EAAE;QACzB,IAAInE,IAAAA,cAAI,EAACsC,SAAS,OAAOA;QACzB8B,OAAON,IAAI,CAAC,AAACxB,OAA8BH,KAAK;IAClD;IACA,OAAOC,IAAAA,aAAG,EAACgC;AACb;AAWO,SAAS7C,UAAgBe,MAA4B;IAC1D,IAAIxC,IAAAA,eAAK,EAACwC,SAAS;QACjB,OAAOF,IAAAA,aAAG,EAACE,OAAOH,KAAK;IACzB;IACA,MAAMkC,MAAM/B;IACZ,OAAOgC,IAAAA,gBAAM,EAACD,OAAOd,cAAI,GAAIc;AAC/B;AAYO,SAASpE,QAAcqC,MAAoB,EAAEiC,SAAgC;IAClF,OAAOvE,IAAAA,cAAI,EAACsC,WAAWiC,UAAUjC;AACnC;AAWO,SAASvC,SAAeuC,MAAoB,EAAEiC,SAAgC;IACnF,OAAOzE,IAAAA,eAAK,EAACwC,WAAWiC,UAAUjC,OAAOH,KAAK;AAChD;AAEO,SAASjB,gBAAsBoB,MAA0C;IAC9E,IAAIA,OAAOkC,MAAM,KAAK,aAAa,OAAOlC,OAAOK,KAAK;IACtD,OAAOP,IAAAA,aAAG,EAACE,OAAOmC,MAAM;AAC1B;AAUO,eAAe7D,eAAqB8D,QAAyC;IAClF,MAAMC,UAAU,MAAMnC,QAAQoC,UAAU,CAACF;IACzC,OAAO/D,UAAUgE,QAAQxE,GAAG,CAACe;AAC/B;AAYO,SAASD,mBAAmCgD,MAAyB;IAC1E,MAAMF,MAAME,OAAOD,MAAM;IACzB,MAAML,UAAU,IAAIO,MAAoBH;IACxC,IAAIc;IACJ,IAAIC;IAEJ,IAAK,IAAIX,IAAI,GAAGA,IAAIJ,KAAKI,IAAK;QAC5B,MAAMY,IAAId,MAAM,CAACE,EAAE;QACnB,IAAI5B,IAAAA,oBAAU,EAACwC,IAAI;YAChBF,CAAAA,mBAAmB,EAAE,AAAD,EAAGf,IAAI,CAACK;YAC5BW,CAAAA,oBAAoB,EAAE,AAAD,EAAGhB,IAAI,CAACtB,QAAQC,OAAO,CAACsC;QAChD,OAAO;YACLpB,OAAO,CAACQ,EAAE,GAAGY;QACf;IACF;IAEA,IAAI,CAACD,iBAAiB,OAAOnB;IAE7B,OAAOnB,QAAQoC,UAAU,CAACE,iBAAiBpC,IAAI,CAAC,CAACiC;QAC/C,IAAK,IAAIR,IAAI,GAAGA,IAAIQ,QAAQX,MAAM,EAAEG,IAAK;YACvC,MAAMa,IAAIL,OAAO,CAACR,EAAE;YACpBR,OAAO,CAACkB,cAAe,CAACV,EAAE,CAAC,GAAGa,EAAER,MAAM,KAAK,cAAeQ,EAAErC,KAAK,GAAaP,IAAAA,aAAG,EAAC4C,EAAEP,MAAM;QAC5F;QACA,OAAOd;IACT;AACF;AAEO,eAAe7C,2BACpBmD,MAAoC,EACpCL,GAAe,EACfC,IAAqB,EACrBoB,aAAqB,CAAC;IAEtB,MAAMC,eAAejB,OAAOD,MAAM,GAAGiB;IACrC,MAAMH,kBAA2C,EAAE;IAEnD,IAAK,IAAIX,IAAI,GAAGA,IAAIe,cAAcf,IAAK;QACrC,MAAMxB,QAAQsB,MAAM,CAACgB,aAAad,EAAE;QACpC,IAAI5B,IAAAA,oBAAU,EAACI,QAAQ;YACrBmC,gBAAgBhB,IAAI,CAClBtB,QAAQC,OAAO,CAACE,OAAOD,IAAI,CACzB,CAACJ,SAAWA,QACZ,CAACH,QAAUC,IAAAA,aAAG,EAACD;QAGrB,OAAO;YACL,IAAInC,IAAAA,cAAI,EAAC2C,QAAQ;gBACfiB,IAAIE,IAAI,CAACnB;YACX,OAAO;gBACLkB,KAAKC,IAAI,CAAC,AAACnB,MAA6BR,KAAK;YAC/C;QACF;IACF;IAEA,IAAI2C,gBAAgBd,MAAM,GAAG,GAAG;QAC9B,MAAMmB,WAAW,MAAM3C,QAAQ1D,GAAG,CAACgG;QACnC,IAAK,IAAIX,IAAI,GAAGA,IAAIgB,SAASnB,MAAM,EAAEG,IAAK;YACxC,MAAM7B,SAAS6C,QAAQ,CAAChB,EAAE;YAC1B,IAAInE,IAAAA,cAAI,EAACsC,SAAS;gBAChBsB,IAAIE,IAAI,CAACxB;YACX,OAAO;gBACLuB,KAAKC,IAAI,CAAC,AAACxB,OAA8BH,KAAK;YAChD;QACF;IACF;IAEA,OAAO;QAACyB;QAAKC;KAAK;AACpB;AAWO,SAAShD,sBAA4BoD,MAAoC;IAC9E,MAAMF,MAAME,OAAOD,MAAM;IACzB,MAAMJ,MAAkB,EAAE;IAC1B,MAAMC,OAAwB,EAAE;IAEhC,IAAK,IAAIM,IAAI,GAAGA,IAAIJ,KAAKI,IAAK;QAC5B,MAAMxB,QAAQsB,MAAM,CAACE,EAAE;QACvB,IAAI5B,IAAAA,oBAAU,EAACI,QAAQ;YACrB,OAAO7B,2BAA2BmD,QAAQL,KAAKC,MAAMM;QACvD;QACA,IAAInE,IAAAA,cAAI,EAAC2C,QAAQ;YACfiB,IAAIE,IAAI,CAACnB;QACX,OAAO;YACLkB,KAAKC,IAAI,CAAC,AAACnB,MAA6BR,KAAK;QAC/C;IACF;IAEA,OAAO;QAACyB;QAAKC;KAAK;AACpB;AAcO,SAAS9C,QAAWkB,EAAW;IACpC,IAAI;QACF,OAAOA;IACT,EAAE,OAAOmD,GAAG;QACV,OAAOhD,IAAAA,aAAG,EAACgD;IACb;AACF;AAaO,eAAepE,aAAgBiB,EAAoB;IACxD,IAAI;QACF,OAAQ,MAAMA;IAChB,EAAE,OAAOmD,GAAG;QACV,OAAOhD,IAAAA,aAAG,EAACgD;IACb;AACF"}
|
|
1
|
+
{"version":3,"sources":["../src/result.ts"],"sourcesContent":["import { err as ERR, isOk, isErr, isSome, isNone, NONE, optionOf, isThenable } from './types.js';\nimport type { Ok, Err, Result, Option, Widen, WidenNever, MaybePromise } from './types.js';\n\nexport type { Ok, Err, Result };\nexport { isOk, isErr };\n\nconst identity = <T>(v: T): T => v;\nconst wrapErr = (error: unknown): Err<never> => ERR(error) as Err<never>;\n\n/**\n * Executes a function and captures the result or error.\n * @param fn - Function to execute\n * @param onError - Optional error transformer\n * @returns Ok(result) if successful, Err(error) if thrown\n * @example\n * tryCatch(() => JSON.parse('{\"a\":1}')) // Ok({a: 1})\n * tryCatch(() => JSON.parse('invalid')) // Err(SyntaxError)\n * tryCatch(() => { throw 'oops' }, e => e) // Err('oops')\n */\nexport function tryCatch<T>(fn: () => T): T extends Err<any> ? Err<unknown> : T extends Result<infer U, any> ? Result<U, unknown> : Result<T, unknown>;\nexport function tryCatch<T, E>(\n fn: () => T,\n onError: (error: unknown) => E,\n): T extends Err<infer F> ? Err<F | E> : T extends Result<infer U, infer F> ? Result<U, F | E> : Result<T, E>;\nexport function tryCatch<T, E = unknown>(fn: () => T, onError?: (error: unknown) => E): Result<T, E> {\n try {\n return fn() as Ok<T>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n}\n\n/**\n * Alias for tryCatch. Executes a function and captures the result or error.\n * @param fn - Function to execute\n * @returns Ok(result) if successful, Err(error) if thrown\n */\nexport function of<T>(fn: () => T): T extends Err<any> ? Err<unknown> : T extends Result<infer U, any> ? Result<U, unknown> : Result<T, unknown>;\nexport function of<T>(fn: () => T): Result<T, unknown> {\n try {\n return fn() as Ok<T>;\n } catch (error) {\n return ERR(error);\n }\n}\n\n/**\n * Wraps a throwing function so it returns a Result instead.\n * The wrapper is created once and reused, avoiding per-call closure allocation.\n * @param fn - The function to wrap\n * @param onError - Optional error transformer\n * @returns A new function with the same signature that returns Result\n * @example\n * const safeParse = wrap(JSON.parse);\n * safeParse('{\"a\":1}') // Ok({a: 1})\n * safeParse('invalid') // Err(SyntaxError)\n */\nexport function wrap<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => Result<R, unknown>;\nexport function wrap<A extends unknown[], R, E>(fn: (...args: A) => R, onError: (error: unknown) => E): (...args: A) => Result<R, E>;\nexport function wrap<A extends unknown[], R, E = unknown>(fn: (...args: A) => R, onError?: (error: unknown) => E): (...args: A) => Result<R, E> {\n return (...args: A) => {\n try {\n return fn(...args) as Ok<R>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n };\n}\n\n/**\n * Converts a Result-returning function into a throwing function.\n * Inverse of wrap. Use at ecosystem boundaries where libraries expect exceptions\n * (Express error handlers, Drizzle transactions, Passport.js, etc.).\n * @param fn - A function that returns a Result\n * @returns A new function that returns the Ok value or throws the Err error\n * @example\n * const findUser = (id: string): Result<User, NotFoundError> => { ... };\n * const throwingFind = toThrowable(findUser);\n * throwingFind('123') // returns User or throws NotFoundError\n */\nexport function toThrowable<A extends unknown[], R, E>(fn: (...args: A) => Result<R, E>): (...args: A) => R {\n return (...args: A) => {\n const result = fn(...args);\n if (isErr(result)) throw result.error;\n return result;\n };\n}\n\n/**\n * Converts a Promise to a Result. Resolves to Ok if successful, Err on rejection.\n * @param promise - The promise to convert\n * @param onError - Optional error transformer\n * @returns Promise resolving to Ok(value) or Err(error)\n * @example\n * await fromPromise(fetch('/api')) // Ok(Response) or Err(unknown)\n * await fromPromise(fetch('/api'), e => String(e)) // Ok(Response) or Err(string)\n */\nexport async function fromPromise<T>(promise: Promise<Exclude<T, Err<any>>>): Promise<Result<T, unknown>>;\nexport async function fromPromise<T, E>(promise: Promise<Exclude<T, Err<any>>>, onError: (error: unknown) => E): Promise<Result<T, E>>;\nexport async function fromPromise<T, E = unknown>(promise: Promise<T>, onError?: (error: unknown) => E): Promise<Result<T, E>> {\n try {\n return (await promise) as Ok<T>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n}\n\n/** A validation issue from a Standard Schema validator. */\nexport interface SchemaIssue {\n readonly message: string;\n readonly path?: ReadonlyArray<PropertyKey | { readonly key: PropertyKey }>;\n}\n\n/** Minimal Standard Schema v1 interface (duck-typed, no external dependency). */\nexport interface StandardSchema<O = unknown> {\n readonly '~standard': {\n readonly validate: (value: unknown) => StandardSchemaResult<O> | Promise<StandardSchemaResult<O>>;\n };\n}\n\ntype StandardSchemaResult<O> = { readonly value: O; readonly issues?: undefined } | { readonly issues: ReadonlyArray<SchemaIssue> };\n\nfunction schemaResultToResult<O>(sr: StandardSchemaResult<O>): Result<O, readonly SchemaIssue[]> {\n return sr.issues ? ERR(sr.issues) : (sr.value as Ok<O>);\n}\n\n/**\n * Validates a value against a Standard Schema and returns a Result.\n * Works with any Standard Schema v1 compliant library (Zod, Valibot, ArkType, etc.).\n * Returns synchronously if the schema validates synchronously.\n * @param schema - A Standard Schema v1 compliant schema\n * @param value - The value to validate\n * @returns Ok(parsed) if valid, Err(issues) if invalid\n * @example\n * import { z } from 'zod';\n * const result = fromSchema(z.string().email(), input);\n * // Result<string, readonly SchemaIssue[]>\n */\nexport function fromSchema<O>(schema: StandardSchema<O>, value: unknown): Result<O, readonly SchemaIssue[]> | Promise<Result<O, readonly SchemaIssue[]>> {\n const sr = schema['~standard'].validate(value);\n if (isThenable(sr)) return sr.then(schemaResultToResult);\n return schemaResultToResult(sr);\n}\n\n/**\n * Executes a function that may return sync or async, preserving sync execution when possible.\n * @param fn - Function that may return T or Promise<T>\n * @param onError - Optional error transformer\n * @returns Result<T, E> if sync, Promise<Result<T, E>> if async\n * @example\n * tryCatchMaybePromise(() => 42) // Ok(42) - sync\n * tryCatchMaybePromise(() => Promise.resolve(42)) // Promise<Ok(42)> - async\n * tryCatchMaybePromise(() => { throw 'err' }) // Err('err') - sync\n */\nexport function tryCatchMaybePromise<T>(fn: () => MaybePromise<T>): Result<T, unknown> | Promise<Result<T, unknown>>;\nexport function tryCatchMaybePromise<T, E>(fn: () => MaybePromise<T>, onError: (error: unknown) => E): Result<T, E> | Promise<Result<T, E>>;\nexport function tryCatchMaybePromise<T, E = unknown>(fn: () => MaybePromise<T>, onError?: (error: unknown) => E): Result<T, E> | Promise<Result<T, E>> {\n try {\n const result = fn();\n if (isThenable(result)) {\n return Promise.resolve(result).then(\n (value) => value as Ok<T>,\n (error) => ERR(onError ? onError(error) : (error as E)),\n );\n }\n return result as Ok<T>;\n } catch (error) {\n return ERR(onError ? onError(error) : (error as E));\n }\n}\n\n/**\n * Unwraps an Ok value or returns a computed value for Err.\n * @param result - The Result to unwrap\n * @param onErr - Function called with error if Err\n * @returns The Ok value or result of onErr(error)\n * @example\n * unwrapOrReturn(ok(42), e => 0) // 42\n * unwrapOrReturn(err('fail'), e => 0) // 0\n */\nexport function unwrapOrReturn<T, E, const R>(result: Result<T, E>, onErr: (error: E) => R): T | R {\n return isOk(result) ? result : onErr(result.error);\n}\n\n/**\n * Asserts that a Result is Ok, throwing if Err.\n * @param result - The Result to assert\n * @param message - Custom error message\n * @throws Error if result is Err\n * @example\n * assertOk(ok(42)) // passes\n * assertOk(err('failed')) // throws Error\n */\nexport function assertOk<T, E>(result: Result<T, E>, message?: string): asserts result is Ok<T> {\n if (isErr(result)) {\n throw new Error(message ?? `Expected Ok result. Received error: ${String(result.error)}`);\n }\n}\n\n/**\n * Asserts that a Result is Err, throwing if Ok.\n * @param result - The Result to assert\n * @param message - Custom error message\n * @throws Error if result is Ok\n * @example\n * assertErr(err('failed')) // passes\n * assertErr(ok(42)) // throws Error\n */\nexport function assertErr<T, E>(result: Result<T, E>, message?: string): asserts result is Err<E> {\n if (isOk(result)) {\n throw new Error(message ?? `Expected Err result. Received value: ${String(result)}`);\n }\n}\n\n/**\n * Checks if result is Err with a non-null error value.\n * @param result - The Result to check\n * @returns true if Err with Some error value\n */\nexport function isSomeErr<T, E>(result: Result<T, E>): boolean {\n return isErr(result) && isSome(result.error);\n}\n\n/**\n * Transforms the Ok value, leaving Err unchanged.\n * @param result - The Result to map\n * @param fn - Transform function\n * @returns Ok(fn(value)) if Ok, Err unchanged\n * @example\n * map(ok(2), x => x * 2) // Ok(4)\n * map(err('e'), x => x * 2) // Err('e')\n */\nexport function map<T, U, E>(result: Err<E>, fn: (value: T) => U): Err<E>;\nexport function map<T, U>(result: Ok<T>, fn: (value: T) => U): Ok<U>;\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E> {\n if (isErr(result)) return result;\n return fn(result) as Ok<U>;\n}\n\n/**\n * Transforms the Err value, leaving Ok unchanged.\n * @param result - The Result to map\n * @param fn - Error transform function\n * @returns Err(fn(error)) if Err, Ok unchanged\n * @example\n * mapErr(err('e'), e => e.toUpperCase()) // Err('E')\n * mapErr(ok(42), e => e.toUpperCase()) // Ok(42)\n */\nexport function mapErr<T, E, F>(result: Ok<T>, fn: (error: E) => F): Ok<T>;\nexport function mapErr<E, F>(result: Err<E>, fn: (error: E) => F): Err<F>;\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F> {\n if (isOk(result)) return result;\n return ERR(fn(result.error));\n}\n\n/**\n * Chains Result-returning functions. Returns Err if the input is Err.\n * @param result - The Result to chain\n * @param fn - Function returning a Result\n * @returns The result of fn(value) if Ok, Err unchanged\n * @example\n * flatMap(ok(2), x => ok(x * 2)) // Ok(4)\n * flatMap(ok(2), x => err('fail')) // Err('fail')\n * flatMap(err('e'), x => ok(x * 2)) // Err('e')\n */\nexport function flatMap<T, U, E>(result: Err<E>, fn: (value: T) => Result<U, E>): Err<E>;\nexport function flatMap<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;\nexport function flatMap<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E> {\n if (isErr(result)) return result;\n return fn(result);\n}\n\n/**\n * Alias for flatMap. Chains Result-returning functions.\n * @param result - The Result to chain\n * @param fn - Function returning a Result\n * @returns The result of fn(value) if Ok, Err unchanged\n */\nexport const andThen: typeof flatMap = flatMap;\n\n/**\n * Executes a side effect if Ok, then returns the original Result.\n * @param result - The Result to tap\n * @param fn - Side effect function\n * @returns The original Result unchanged\n * @example\n * tap(ok(42), x => console.log(x)) // logs 42, returns Ok(42)\n */\nexport function tap<T, E>(result: Err<E>, fn: (value: T) => void): Err<E>;\nexport function tap<T>(result: Ok<T>, fn: (value: T) => void): Ok<T>;\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E>;\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E> {\n if (isOk(result)) {\n fn(result);\n }\n return result;\n}\n\n/**\n * Executes a side effect if Err, then returns the original Result.\n * @param result - The Result to tap\n * @param fn - Side effect function for error\n * @returns The original Result unchanged\n * @example\n * tapErr(err('fail'), e => console.log(e)) // logs 'fail', returns Err('fail')\n */\nexport function tapErr<T, E>(result: Ok<T>, fn: (error: E) => void): Ok<T>;\nexport function tapErr<E>(result: Err<E>, fn: (error: E) => void): Err<E>;\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E>;\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E> {\n if (isErr(result)) {\n fn(result.error);\n }\n return result;\n}\n\n/**\n * Maps both Ok and Err values simultaneously.\n * @param result - The Result to map\n * @param okFn - Transform for Ok value\n * @param errFn - Transform for Err value\n * @returns Ok(okFn(value)) if Ok, Err(errFn(error)) if Err\n * @example\n * bimap(ok(2), x => x * 2, e => e.toUpperCase()) // Ok(4)\n * bimap(err('e'), x => x * 2, e => e.toUpperCase()) // Err('E')\n */\nexport function bimap<T, U, E, F>(result: Ok<T>, okFn: (value: T) => U, errFn: (error: E) => F): Ok<U>;\nexport function bimap<T, U, E, F>(result: Err<E>, okFn: (value: T) => U, errFn: (error: E) => F): Err<F>;\nexport function bimap<T, U, E, F>(result: Result<T, E>, okFn: (value: T) => U, errFn: (error: E) => F): Result<U, F>;\nexport function bimap<T, U, E, F>(result: Result<T, E>, okFn: (value: T) => U, errFn: (error: E) => F): Result<U, F> {\n return isOk(result) ? (okFn(result) as Ok<U>) : ERR(errFn(result.error));\n}\n\n/**\n * Extracts the Ok value, throws Err if not Ok.\n * Use with safeTry for Rust-like ? operator ergonomics.\n * @param result - The Result to unwrap\n * @returns The contained Ok value\n * @throws The Err object itself\n * @example\n * unwrap(ok(42)) // 42\n * unwrap(err('failed')) // throws Err\n * safeTry(() => {\n * const a = unwrap(getValue());\n * return a + 1;\n * });\n */\nexport function unwrap<T, E>(result: Result<T, E>): T {\n if (isErr(result)) throw result.error;\n return result;\n}\n\n/**\n * Extracts the Err value, throws if Ok.\n * @param result - The Result to unwrap\n * @returns The contained error\n * @throws Error if result is Ok\n * @example\n * unwrapErr(err('failed')) // 'failed'\n * unwrapErr(ok(42)) // throws Error\n */\nexport function unwrapErr<T, E>(result: Result<T, E>): E {\n if (isOk(result)) {\n throw new Error(`Called unwrapErr on Ok: ${String(result)}`);\n }\n return result.error;\n}\n\n/**\n * Extracts the Ok value, or returns a default.\n * @param result - The Result to unwrap\n * @param defaultValue - Value if Err\n * @returns The Ok value or defaultValue\n * @example\n * unwrapOr(ok(42), 0) // 42\n * unwrapOr(err('failed'), 0) // 0\n */\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n return isOk(result) ? result : defaultValue;\n}\n\n/**\n * Extracts the Ok value, or computes a default from the error.\n * @param result - The Result to unwrap\n * @param fn - Function to compute default from error\n * @returns The Ok value or fn(error)\n * @example\n * unwrapOrElse(ok(42), e => 0) // 42\n * unwrapOrElse(err('failed'), e => 0) // 0\n */\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\n return isOk(result) ? result : fn(result.error);\n}\n\n/**\n * Maps the Ok value and returns it, or returns a default.\n * @param result - The Result to map\n * @param defaultValue - Value if Err\n * @param fn - Transform function\n * @returns fn(value) if Ok, defaultValue otherwise\n * @example\n * mapOr(ok(2), 0, x => x * 2) // 4\n * mapOr(err('e'), 0, x => x * 2) // 0\n */\nexport function mapOr<T, E, U>(result: Result<T, E>, defaultValue: U, fn: (value: T) => U): U {\n return isOk(result) ? fn(result) : defaultValue;\n}\n\n/**\n * Maps the Ok value and returns it, or computes a default.\n * @param result - The Result to map\n * @param defaultFn - Function to compute default\n * @param fn - Transform function\n * @returns fn(value) if Ok, defaultFn() otherwise\n * @example\n * mapOrElse(ok(2), () => 0, x => x * 2) // 4\n * mapOrElse(err('e'), () => 0, x => x * 2) // 0\n */\nexport function mapOrElse<T, E, U>(result: Result<T, E>, defaultFn: () => U, fn: (value: T) => U): U {\n return isOk(result) ? fn(result) : defaultFn();\n}\n\n/**\n * Extracts the Ok value, throws with custom message if Err.\n * @param result - The Result to unwrap\n * @param message - Error message prefix if Err\n * @returns The Ok value\n * @throws Error with message if Err\n * @example\n * expect(ok(42), 'missing value') // 42\n * expect(err('fail'), 'missing value') // throws Error('missing value: fail')\n */\nexport function expect<T, E>(result: Result<T, E>, message: string): T {\n if (isErr(result)) {\n throw new Error(`${message}: ${String(result.error)}`);\n }\n return result;\n}\n\n/**\n * Extracts the Err value, throws with custom message if Ok.\n * @param result - The Result to unwrap\n * @param message - Error message prefix if Ok\n * @returns The error value\n * @throws Error with message if Ok\n * @example\n * expectErr(err('fail'), 'expected error') // 'fail'\n * expectErr(ok(42), 'expected error') // throws Error\n */\nexport function expectErr<T, E>(result: Result<T, E>, message: string): E {\n if (isOk(result)) {\n throw new Error(`${message}: ${String(result)}`);\n }\n return result.error;\n}\n\n/**\n * Returns other if result is Ok, otherwise returns the Err.\n * @param result - First Result\n * @param other - Second Result\n * @returns other if result is Ok, result (Err) otherwise\n * @example\n * and(ok(1), ok(2)) // Ok(2)\n * and(err('e'), ok(2)) // Err('e')\n */\nexport function and<T, U, E>(result: Result<T, E>, other: Result<U, E>): Result<U, E> {\n return isOk(result) ? other : result;\n}\n\n/**\n * Returns result if Ok, otherwise returns other.\n * @param result - First Result\n * @param other - Fallback Result\n * @returns result if Ok, other otherwise\n * @example\n * or(ok(1), ok(2)) // Ok(1)\n * or(err('e'), ok(2)) // Ok(2)\n */\nexport function or<T, E, F>(result: Result<T, E>, other: Result<T, F>): Result<T, F> {\n return isOk(result) ? result : other;\n}\n\n/**\n * Returns result if Ok, otherwise computes a fallback from the error.\n * @param result - First Result\n * @param fn - Function to compute fallback\n * @returns result if Ok, fn(error) otherwise\n * @example\n * orElse(ok(1), e => ok(0)) // Ok(1)\n * orElse(err('e'), e => ok(0)) // Ok(0)\n */\nexport function orElse<T, E, F>(result: Result<T, E>, fn: (error: E) => Result<T, F>): Result<T, F> {\n return isOk(result) ? result : fn(result.error);\n}\n\n/**\n * Converts a Result to an Option, discarding the error.\n * @param result - The Result to convert\n * @returns Some(value) if Ok, None if Err\n * @example\n * toOption(ok(42)) // Some(42)\n * toOption(err('failed')) // None\n */\nexport function toOption<T, E>(result: Result<T, E>): Option<T> {\n return isOk(result) ? optionOf(result) : NONE;\n}\n\n/**\n * Converts a Result's error to an Option.\n * @param result - The Result to convert\n * @returns Some(error) if Err, None if Ok\n * @example\n * toErrorOption(err('failed')) // Some('failed')\n * toErrorOption(ok(42)) // None\n */\nexport function toErrorOption<T, E>(result: Result<T, E>): Option<E> {\n return isErr(result) ? optionOf(result.error) : NONE;\n}\n\n/**\n * Combines two Results into a Result of a tuple.\n * @param left - First Result\n * @param right - Second Result\n * @returns Ok([a, b]) if both Ok, first Err otherwise\n * @example\n * zip(ok(1), ok('a')) // Ok([1, 'a'])\n * zip(ok(1), err('e')) // Err('e')\n */\nexport function zip<T, U, E>(left: Result<T, E>, right: Result<U, E>): Result<[T, U], E> {\n if (isErr(left)) return left;\n if (isErr(right)) return right;\n return [left, right] as Ok<[T, U]>;\n}\n\n/**\n * Combines two Results using a function.\n * @param left - First Result\n * @param right - Second Result\n * @param fn - Combining function\n * @returns Ok(fn(a, b)) if both Ok, first Err otherwise\n * @example\n * zipWith(ok(2), ok(3), (a, b) => a + b) // Ok(5)\n */\nexport function zipWith<T, U, V, E>(left: Result<T, E>, right: Result<U, E>, fn: (left: T, right: U) => V): Result<V, E> {\n if (isErr(left)) return left;\n if (isErr(right)) return right;\n return fn(left, right) as Ok<V>;\n}\n\n/**\n * Flattens a nested Result.\n * @param result - Result containing a Result\n * @returns The inner Result\n * @example\n * flatten(ok(ok(42))) // Ok(42)\n * flatten(ok(err('e'))) // Err('e')\n * flatten(err('outer')) // Err('outer')\n */\nexport function flatten<T, E>(result: Result<Result<T, E>, E>): Result<T, E> {\n return isErr(result) ? (result as Err<E>) : (result as Result<T, E>);\n}\n\n/**\n * Pattern matches on a Result, handling both Ok and Err cases.\n * @param result - The Result to match\n * @param onOk - Handler for Ok case\n * @param onErr - Handler for Err case\n * @returns Result of the matching handler\n * @example\n * match(ok(42), x => x * 2, e => 0) // 84\n * match(err('e'), x => x * 2, e => 0) // 0\n */\nexport function match<T, E, U>(result: Result<T, E>, onOk: (value: T) => U, onErr: (error: E) => U): U {\n return isOk(result) ? onOk(result) : onErr(result.error);\n}\n\n/**\n * Separates an array of Results into Ok values and Err values.\n * @param results - Array of Results\n * @returns Tuple of [Ok values, Err values]\n * @example\n * partition([ok(1), err('a'), ok(2)]) // [[1, 2], ['a']]\n */\nexport function partition<T, E>(results: Result<T, E>[]): [T[], E[]] {\n const oks: T[] = [];\n const errs: E[] = [];\n\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isOk(result)) {\n oks.push(result);\n } else {\n errs.push(result.error);\n }\n }\n\n return [oks, errs];\n}\n\n/**\n * Extracts all Ok values from an array of Results.\n * @param results - Array of Results\n * @returns Array of Ok values\n * @example\n * filterOk([ok(1), err('a'), ok(2)]) // [1, 2]\n */\nexport function filterOk<T, E>(results: Result<T, E>[]): T[] {\n const oks: T[] = [];\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isOk(result)) oks.push(result);\n }\n return oks;\n}\n\n/**\n * Extracts all Err values from an array of Results.\n * @param results - Array of Results\n * @returns Array of error values\n * @example\n * filterErr([ok(1), err('a'), ok(2)]) // ['a']\n */\nexport function filterErr<T, E>(results: Result<T, E>[]): E[] {\n const errs: E[] = [];\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isErr(result)) errs.push(result.error);\n }\n return errs;\n}\n\n/**\n * Collects an array of Results into a Result of an array. Fails on first Err.\n * @param results - Array of Results\n * @returns Ok(values) if all Ok, first Err otherwise\n * @example\n * collect([ok(1), ok(2)]) // Ok([1, 2])\n * collect([ok(1), err('e')]) // Err('e')\n */\nexport function collect<T, E>(results: Result<T, E>[]): Result<T[], E> {\n const values: T[] = [];\n\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isErr(result)) return result;\n values.push(result);\n }\n\n return values as Ok<T[]>;\n}\n\n/**\n * Collects all Results, returning all errors if any exist.\n * @param results - Array of Results\n * @returns Ok(values) if all Ok, Err(allErrors) otherwise\n * @example\n * collectAll([ok(1), ok(2)]) // Ok([1, 2])\n * collectAll([ok(1), err('a'), err('b')]) // Err(['a', 'b'])\n */\nexport function collectAll<T, E>(results: Result<T, E>[]): Result<T[], E[]> {\n const oks: T[] = [];\n const errs: E[] = [];\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isOk(result)) {\n oks.push(result);\n } else {\n errs.push(result.error);\n }\n }\n return errs.length > 0 ? ERR(errs) : (oks as Ok<T[]>);\n}\n\n/**\n * Alias for collect with widened types. Collects Results into a Result of array.\n * @param results - Array of Results\n * @returns Ok(values) if all Ok, first Err otherwise\n */\nexport function all<T, E>(results: Result<T, E>[]): Result<readonly Widen<T>[], WidenNever<E>> {\n return collect(results) as Result<readonly Widen<T>[], WidenNever<E>>;\n}\n\n/**\n * Returns the first Ok, or all errors if none succeed.\n * @param results - Array of Results\n * @returns First Ok found, or Err(allErrors) if all fail\n * @example\n * any([err('a'), ok(1), err('b')]) // Ok(1)\n * any([err('a'), err('b')]) // Err(['a', 'b'])\n */\nexport function any<T, E>(results: Result<T, E>[]): Result<Widen<T>, WidenNever<E>[]> {\n const errors: WidenNever<E>[] = [];\n for (let i = 0; i < results.length; i++) {\n const result = results[i];\n if (isOk(result)) return result as Ok<Widen<T>>;\n errors.push((result as Err<WidenNever<E>>).error);\n }\n return ERR(errors);\n}\n\n/**\n * Transposes a Result of Option to an Option of Result.\n * @param result - Result containing an Option\n * @returns Some(Ok(value)) if Ok(Some), None if Ok(None), Some(Err) if Err\n * @example\n * transpose(ok(some(42))) // Some(Ok(42))\n * transpose(ok(none)) // None\n * transpose(err('e')) // Some(Err('e'))\n */\nexport function transpose<T, E>(result: Result<Option<T>, E>): Option<Result<T, E>> {\n if (isErr(result)) {\n return ERR(result.error) as Option<Result<T, E>>;\n }\n const opt = result as Option<T>;\n return isNone(opt) ? NONE : (opt as unknown as Ok<T> as Option<Result<T, E>>);\n}\n\n/**\n * Checks if Ok and the value satisfies a predicate.\n * @param result - The Result to check\n * @param predicate - Test function\n * @returns true if Ok and predicate returns true\n * @example\n * isOkAnd(ok(4), x => x > 2) // true\n * isOkAnd(ok(1), x => x > 2) // false\n * isOkAnd(err('e'), x => x > 2) // false\n */\nexport function isOkAnd<T, E>(result: Result<T, E>, predicate: (value: T) => boolean): boolean {\n return isOk(result) && predicate(result);\n}\n\n/**\n * Checks if Err and the error satisfies a predicate.\n * @param result - The Result to check\n * @param predicate - Test function\n * @returns true if Err and predicate returns true\n * @example\n * isErrAnd(err('fatal'), e => e.includes('fatal')) // true\n * isErrAnd(ok(42), e => true) // false\n */\nexport function isErrAnd<T, E>(result: Result<T, E>, predicate: (error: E) => boolean): boolean {\n return isErr(result) && predicate(result.error);\n}\n\n/**\n * Partitions an async iterable of Results.\n * @param results - Iterable of Promise Results\n * @returns Promise of [Ok values, Err values]\n * @example\n * await partitionAsync([Promise.resolve(ok(1)), Promise.resolve(err('a'))])\n * // [[1], ['a']]\n */\nexport async function partitionAsync<T, E>(promises: Iterable<Promise<Result<T, E>>>): Promise<[Widen<T>[], WidenNever<E>[]]> {\n const settled = await Promise.allSettled(promises);\n const oks: Widen<T>[] = [];\n const errs: WidenNever<E>[] = [];\n\n for (let i = 0; i < settled.length; i++) {\n const entry = settled[i];\n\n if (entry.status === 'rejected') {\n errs.push(entry.reason as WidenNever<E>);\n continue;\n }\n\n const result = entry.value;\n if (isOk(result)) {\n oks.push(result as Widen<T>);\n } else {\n errs.push(result.error as WidenNever<E>);\n }\n }\n\n return [oks, errs];\n}\n\n/**\n * Settles an array of MaybePromise values into Results.\n * Returns synchronously if all inputs are sync, avoiding Promise overhead.\n * @param values - Array of values that may or may not be Promises\n * @returns Array of Results (sync) or Promise of Results (if any async)\n * @example\n * settleMaybePromise([1, 2, 3]) // [Ok(1), Ok(2), Ok(3)] - sync\n * settleMaybePromise([1, Promise.resolve(2)]) // Promise<[Ok(1), Ok(2)]>\n * settleMaybePromise([Promise.reject('e')]) // Promise<[Err('e')]>\n */\nexport function settleMaybePromise<T, E = unknown>(values: MaybePromise<T>[]): Result<T, E>[] | Promise<Result<T, E>[]> {\n const len = values.length;\n const results = new Array<Result<T, E>>(len).fill(0 as never);\n let pendingIndices: number[] | undefined;\n let pendingPromises: Promise<T>[] | undefined;\n\n for (let i = 0; i < len; i++) {\n const v = values[i];\n if (isThenable(v)) {\n (pendingIndices ??= []).push(i);\n (pendingPromises ??= []).push(Promise.resolve(v));\n } else {\n results[i] = v as Ok<T>;\n }\n }\n\n if (!pendingPromises) return results;\n\n return Promise.allSettled(pendingPromises).then((settled) => {\n for (let i = 0; i < settled.length; i++) {\n const s = settled[i];\n results[pendingIndices![i]] = s.status === 'fulfilled' ? (s.value as Ok<T>) : ERR(s.reason as E);\n }\n return results;\n });\n}\n\nexport async function partitionMaybePromiseAsync<T, E>(\n values: MaybePromise<Result<T, E>>[],\n oks: Widen<T>[],\n errs: WidenNever<E>[],\n startIndex: number = 0,\n): Promise<[Widen<T>[], WidenNever<E>[]]> {\n const remaining = values.length - startIndex;\n const promises = new Array<Promise<Result<T, E>>>(remaining).fill(0 as never);\n\n for (let i = 0; i < remaining; i++) {\n const value = values[startIndex + i];\n promises[i] = isThenable(value) ? Promise.resolve(value).then(identity, wrapErr) : Promise.resolve(value);\n }\n\n const resolved = await Promise.all(promises);\n for (let i = 0; i < resolved.length; i++) {\n const result = resolved[i];\n if (isOk(result)) {\n oks.push(result as Widen<T>);\n } else {\n errs.push((result as Err<WidenNever<E>>).error);\n }\n }\n\n return [oks, errs] as [Widen<T>[], WidenNever<E>[]];\n}\n\n/**\n * Partitions MaybePromise Results into Ok and Err values.\n * Returns synchronously if all inputs are sync, avoiding Promise overhead.\n * @param values - Array of MaybePromise Results\n * @returns [Ok values, Err values] (sync) or Promise of same (if any async)\n * @example\n * partitionMaybePromise([ok(1), err('a')]) // [[1], ['a']] - sync\n * partitionMaybePromise([ok(1), Promise.resolve(err('a'))]) // Promise<[[1], ['a']]>\n */\nexport function partitionMaybePromise<T, E>(values: MaybePromise<Result<T, E>>[]): [Widen<T>[], WidenNever<E>[]] | Promise<[Widen<T>[], WidenNever<E>[]]> {\n const len = values.length;\n const oks: Widen<T>[] = [];\n const errs: WidenNever<E>[] = [];\n\n for (let i = 0; i < len; i++) {\n const value = values[i];\n if (isThenable(value)) {\n return partitionMaybePromiseAsync(values, oks, errs, i);\n }\n if (isOk(value)) {\n oks.push(value as Widen<T>);\n } else {\n errs.push((value as Err<WidenNever<E>>).error);\n }\n }\n\n return [oks, errs];\n}\n\n/**\n * Executes a function, catching thrown Err values.\n * Use with unwrap for Rust-like ? operator ergonomics.\n * @param fn - Function that may throw Err via unwrap\n * @returns Ok(return value) or the caught Err\n * @example\n * const result = safeTry(() => {\n * const a = unwrap(parseNumber('10'));\n * const b = unwrap(parseNumber('5'));\n * return a + b;\n * }); // Ok(15) or Err(...)\n */\nexport function safeTry<T>(fn: () => T): Result<T, unknown> {\n try {\n return fn() as Ok<T>;\n } catch (e) {\n return ERR(e);\n }\n}\n\n/**\n * Async version of safeTry.\n * @param fn - Async function that may throw Err via unwrap\n * @returns Promise of Ok(return value) or the caught Err\n * @example\n * const result = await safeTryAsync(async () => {\n * const user = unwrap(await fetchUser(id));\n * const posts = unwrap(await fetchPosts(user.id));\n * return { user, posts };\n * });\n */\nexport async function safeTryAsync<T>(fn: () => Promise<T>): Promise<Result<T, unknown>> {\n try {\n return (await fn()) as Ok<T>;\n } catch (e) {\n return ERR(e);\n }\n}\n\nfunction* unwrapYield<T, E>(result: Result<T, E>): Generator<Err<E>, T> {\n if (isErr(result)) {\n yield result;\n return undefined as never;\n }\n return result;\n}\n\ntype Unwrapper = <T, E>(result: Result<T, E>) => Generator<Err<E>, T>;\n\n/**\n * Generator-based do-notation for Result. Provides a `$` function that unwraps\n * Results inside a generator, short-circuiting on the first Err.\n * Preserves error types (unlike safeTry which erases to unknown).\n * @param fn - Generator function receiving `$` unwrapper\n * @returns Ok(return value) or the first Err encountered\n * @example\n * const result = gen(function*($) {\n * const a = yield* $(parseNumber('10'));\n * const b = yield* $(parseNumber('5'));\n * return a + b;\n * }); // Result<number, ParseError>\n */\nexport function gen<E, T>(fn: ($: Unwrapper) => Generator<Err<E>, T>): Result<T, E> {\n const iter = fn(unwrapYield);\n const step = iter.next();\n if (!step.done) return step.value;\n return step.value as Ok<T>;\n}\n\n/**\n * Async generator-based do-notation for Result. Like gen, but for async operations.\n * @param fn - Async generator function receiving `$` unwrapper\n * @returns Promise of Ok(return value) or the first Err encountered\n * @example\n * const result = await genAsync(async function*($) {\n * const user = yield* $(await fetchUser(id));\n * const posts = yield* $(await fetchPosts(user.id));\n * return { user, posts };\n * }); // Promise<Result<{user, posts}, FetchError>>\n */\nexport async function genAsync<E, T>(fn: ($: Unwrapper) => AsyncGenerator<Err<E>, T>): Promise<Result<T, E>> {\n const iter = fn(unwrapYield);\n const step = await iter.next();\n if (!step.done) return step.value;\n return step.value as Ok<T>;\n}\n"],"names":["all","and","andThen","any","assertErr","assertOk","bimap","collect","collectAll","expect","expectErr","filterErr","filterOk","flatMap","flatten","fromPromise","fromSchema","gen","genAsync","isErr","isErrAnd","isOk","isOkAnd","isSomeErr","map","mapErr","mapOr","mapOrElse","match","of","or","orElse","partition","partitionAsync","partitionMaybePromise","partitionMaybePromiseAsync","safeTry","safeTryAsync","settleMaybePromise","tap","tapErr","toErrorOption","toOption","toThrowable","transpose","tryCatch","tryCatchMaybePromise","unwrap","unwrapErr","unwrapOr","unwrapOrElse","unwrapOrReturn","wrap","zip","zipWith","identity","v","wrapErr","error","ERR","fn","onError","args","result","promise","schemaResultToResult","sr","issues","value","schema","validate","isThenable","then","Promise","resolve","onErr","message","Error","String","isSome","okFn","errFn","defaultValue","defaultFn","other","optionOf","NONE","left","right","onOk","results","oks","errs","i","length","push","values","errors","opt","isNone","predicate","promises","settled","allSettled","entry","status","reason","len","Array","fill","pendingIndices","pendingPromises","s","startIndex","remaining","resolved","e","unwrapYield","undefined","iter","step","next","done"],"mappings":"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"}
|
package/build/result.d.ts
CHANGED
|
@@ -12,14 +12,39 @@ export { isOk, isErr };
|
|
|
12
12
|
* tryCatch(() => JSON.parse('invalid')) // Err(SyntaxError)
|
|
13
13
|
* tryCatch(() => { throw 'oops' }, e => e) // Err('oops')
|
|
14
14
|
*/
|
|
15
|
-
export declare function tryCatch<T>(fn: () => T): Result<T, unknown>;
|
|
16
|
-
export declare function tryCatch<T, E>(fn: () => T, onError: (error: unknown) => E): Result<T, E>;
|
|
15
|
+
export declare function tryCatch<T>(fn: () => T): T extends Err<any> ? Err<unknown> : T extends Result<infer U, any> ? Result<U, unknown> : Result<T, unknown>;
|
|
16
|
+
export declare function tryCatch<T, E>(fn: () => T, onError: (error: unknown) => E): T extends Err<infer F> ? Err<F | E> : T extends Result<infer U, infer F> ? Result<U, F | E> : Result<T, E>;
|
|
17
17
|
/**
|
|
18
18
|
* Alias for tryCatch. Executes a function and captures the result or error.
|
|
19
19
|
* @param fn - Function to execute
|
|
20
20
|
* @returns Ok(result) if successful, Err(error) if thrown
|
|
21
21
|
*/
|
|
22
|
-
export declare function of<T>(fn: () => T): Result<T, unknown>;
|
|
22
|
+
export declare function of<T>(fn: () => T): T extends Err<any> ? Err<unknown> : T extends Result<infer U, any> ? Result<U, unknown> : Result<T, unknown>;
|
|
23
|
+
/**
|
|
24
|
+
* Wraps a throwing function so it returns a Result instead.
|
|
25
|
+
* The wrapper is created once and reused, avoiding per-call closure allocation.
|
|
26
|
+
* @param fn - The function to wrap
|
|
27
|
+
* @param onError - Optional error transformer
|
|
28
|
+
* @returns A new function with the same signature that returns Result
|
|
29
|
+
* @example
|
|
30
|
+
* const safeParse = wrap(JSON.parse);
|
|
31
|
+
* safeParse('{"a":1}') // Ok({a: 1})
|
|
32
|
+
* safeParse('invalid') // Err(SyntaxError)
|
|
33
|
+
*/
|
|
34
|
+
export declare function wrap<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => Result<R, unknown>;
|
|
35
|
+
export declare function wrap<A extends unknown[], R, E>(fn: (...args: A) => R, onError: (error: unknown) => E): (...args: A) => Result<R, E>;
|
|
36
|
+
/**
|
|
37
|
+
* Converts a Result-returning function into a throwing function.
|
|
38
|
+
* Inverse of wrap. Use at ecosystem boundaries where libraries expect exceptions
|
|
39
|
+
* (Express error handlers, Drizzle transactions, Passport.js, etc.).
|
|
40
|
+
* @param fn - A function that returns a Result
|
|
41
|
+
* @returns A new function that returns the Ok value or throws the Err error
|
|
42
|
+
* @example
|
|
43
|
+
* const findUser = (id: string): Result<User, NotFoundError> => { ... };
|
|
44
|
+
* const throwingFind = toThrowable(findUser);
|
|
45
|
+
* throwingFind('123') // returns User or throws NotFoundError
|
|
46
|
+
*/
|
|
47
|
+
export declare function toThrowable<A extends unknown[], R, E>(fn: (...args: A) => Result<R, E>): (...args: A) => R;
|
|
23
48
|
/**
|
|
24
49
|
* Converts a Promise to a Result. Resolves to Ok if successful, Err on rejection.
|
|
25
50
|
* @param promise - The promise to convert
|
|
@@ -29,8 +54,40 @@ export declare function of<T>(fn: () => T): Result<T, unknown>;
|
|
|
29
54
|
* await fromPromise(fetch('/api')) // Ok(Response) or Err(unknown)
|
|
30
55
|
* await fromPromise(fetch('/api'), e => String(e)) // Ok(Response) or Err(string)
|
|
31
56
|
*/
|
|
32
|
-
export declare function fromPromise<T>(promise: Promise<T
|
|
33
|
-
export declare function fromPromise<T, E>(promise: Promise<T
|
|
57
|
+
export declare function fromPromise<T>(promise: Promise<Exclude<T, Err<any>>>): Promise<Result<T, unknown>>;
|
|
58
|
+
export declare function fromPromise<T, E>(promise: Promise<Exclude<T, Err<any>>>, onError: (error: unknown) => E): Promise<Result<T, E>>;
|
|
59
|
+
/** A validation issue from a Standard Schema validator. */
|
|
60
|
+
export interface SchemaIssue {
|
|
61
|
+
readonly message: string;
|
|
62
|
+
readonly path?: ReadonlyArray<PropertyKey | {
|
|
63
|
+
readonly key: PropertyKey;
|
|
64
|
+
}>;
|
|
65
|
+
}
|
|
66
|
+
/** Minimal Standard Schema v1 interface (duck-typed, no external dependency). */
|
|
67
|
+
export interface StandardSchema<O = unknown> {
|
|
68
|
+
readonly '~standard': {
|
|
69
|
+
readonly validate: (value: unknown) => StandardSchemaResult<O> | Promise<StandardSchemaResult<O>>;
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
type StandardSchemaResult<O> = {
|
|
73
|
+
readonly value: O;
|
|
74
|
+
readonly issues?: undefined;
|
|
75
|
+
} | {
|
|
76
|
+
readonly issues: ReadonlyArray<SchemaIssue>;
|
|
77
|
+
};
|
|
78
|
+
/**
|
|
79
|
+
* Validates a value against a Standard Schema and returns a Result.
|
|
80
|
+
* Works with any Standard Schema v1 compliant library (Zod, Valibot, ArkType, etc.).
|
|
81
|
+
* Returns synchronously if the schema validates synchronously.
|
|
82
|
+
* @param schema - A Standard Schema v1 compliant schema
|
|
83
|
+
* @param value - The value to validate
|
|
84
|
+
* @returns Ok(parsed) if valid, Err(issues) if invalid
|
|
85
|
+
* @example
|
|
86
|
+
* import { z } from 'zod';
|
|
87
|
+
* const result = fromSchema(z.string().email(), input);
|
|
88
|
+
* // Result<string, readonly SchemaIssue[]>
|
|
89
|
+
*/
|
|
90
|
+
export declare function fromSchema<O>(schema: StandardSchema<O>, value: unknown): Result<O, readonly SchemaIssue[]> | Promise<Result<O, readonly SchemaIssue[]>>;
|
|
34
91
|
/**
|
|
35
92
|
* Executes a function that may return sync or async, preserving sync execution when possible.
|
|
36
93
|
* @param fn - Function that may return T or Promise<T>
|
|
@@ -344,21 +401,21 @@ export declare function match<T, E, U>(result: Result<T, E>, onOk: (value: T) =>
|
|
|
344
401
|
*/
|
|
345
402
|
export declare function partition<T, E>(results: Result<T, E>[]): [T[], E[]];
|
|
346
403
|
/**
|
|
347
|
-
* Extracts all Ok values from an
|
|
348
|
-
* @param results -
|
|
404
|
+
* Extracts all Ok values from an array of Results.
|
|
405
|
+
* @param results - Array of Results
|
|
349
406
|
* @returns Array of Ok values
|
|
350
407
|
* @example
|
|
351
408
|
* filterOk([ok(1), err('a'), ok(2)]) // [1, 2]
|
|
352
409
|
*/
|
|
353
|
-
export declare function filterOk<T, E>(results:
|
|
410
|
+
export declare function filterOk<T, E>(results: Result<T, E>[]): T[];
|
|
354
411
|
/**
|
|
355
|
-
* Extracts all Err values from an
|
|
356
|
-
* @param results -
|
|
412
|
+
* Extracts all Err values from an array of Results.
|
|
413
|
+
* @param results - Array of Results
|
|
357
414
|
* @returns Array of error values
|
|
358
415
|
* @example
|
|
359
416
|
* filterErr([ok(1), err('a'), ok(2)]) // ['a']
|
|
360
417
|
*/
|
|
361
|
-
export declare function filterErr<T, E>(results:
|
|
418
|
+
export declare function filterErr<T, E>(results: Result<T, E>[]): E[];
|
|
362
419
|
/**
|
|
363
420
|
* Collects an array of Results into a Result of an array. Fails on first Err.
|
|
364
421
|
* @param results - Array of Results
|
|
@@ -423,7 +480,6 @@ export declare function isOkAnd<T, E>(result: Result<T, E>, predicate: (value: T
|
|
|
423
480
|
* isErrAnd(ok(42), e => true) // false
|
|
424
481
|
*/
|
|
425
482
|
export declare function isErrAnd<T, E>(result: Result<T, E>, predicate: (error: E) => boolean): boolean;
|
|
426
|
-
export declare function settledToResult<T, E>(result: PromiseSettledResult<Result<T, E>>): Result<T, E>;
|
|
427
483
|
/**
|
|
428
484
|
* Partitions an async iterable of Results.
|
|
429
485
|
* @param results - Iterable of Promise Results
|
|
@@ -480,3 +536,30 @@ export declare function safeTry<T>(fn: () => T): Result<T, unknown>;
|
|
|
480
536
|
* });
|
|
481
537
|
*/
|
|
482
538
|
export declare function safeTryAsync<T>(fn: () => Promise<T>): Promise<Result<T, unknown>>;
|
|
539
|
+
type Unwrapper = <T, E>(result: Result<T, E>) => Generator<Err<E>, T>;
|
|
540
|
+
/**
|
|
541
|
+
* Generator-based do-notation for Result. Provides a `$` function that unwraps
|
|
542
|
+
* Results inside a generator, short-circuiting on the first Err.
|
|
543
|
+
* Preserves error types (unlike safeTry which erases to unknown).
|
|
544
|
+
* @param fn - Generator function receiving `$` unwrapper
|
|
545
|
+
* @returns Ok(return value) or the first Err encountered
|
|
546
|
+
* @example
|
|
547
|
+
* const result = gen(function*($) {
|
|
548
|
+
* const a = yield* $(parseNumber('10'));
|
|
549
|
+
* const b = yield* $(parseNumber('5'));
|
|
550
|
+
* return a + b;
|
|
551
|
+
* }); // Result<number, ParseError>
|
|
552
|
+
*/
|
|
553
|
+
export declare function gen<E, T>(fn: ($: Unwrapper) => Generator<Err<E>, T>): Result<T, E>;
|
|
554
|
+
/**
|
|
555
|
+
* Async generator-based do-notation for Result. Like gen, but for async operations.
|
|
556
|
+
* @param fn - Async generator function receiving `$` unwrapper
|
|
557
|
+
* @returns Promise of Ok(return value) or the first Err encountered
|
|
558
|
+
* @example
|
|
559
|
+
* const result = await genAsync(async function*($) {
|
|
560
|
+
* const user = yield* $(await fetchUser(id));
|
|
561
|
+
* const posts = yield* $(await fetchPosts(user.id));
|
|
562
|
+
* return { user, posts };
|
|
563
|
+
* }); // Promise<Result<{user, posts}, FetchError>>
|
|
564
|
+
*/
|
|
565
|
+
export declare function genAsync<E, T>(fn: ($: Unwrapper) => AsyncGenerator<Err<E>, T>): Promise<Result<T, E>>;
|