nalloc 0.0.3 → 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/README.md +56 -8
- 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 +16 -8
- package/build/option.cjs.map +1 -1
- package/build/option.d.ts +12 -2
- package/build/option.js +13 -8
- package/build/option.js.map +1 -1
- package/build/result.cjs +102 -24
- package/build/result.cjs.map +1 -1
- package/build/result.d.ts +96 -14
- package/build/result.js +87 -21
- 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/build/types.cjs +2 -2
- package/build/types.cjs.map +1 -1
- package/build/types.d.ts +1 -0
- package/build/types.js +2 -2
- package/build/types.js.map +1 -1
- package/package.json +29 -10
- 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 +18 -5
- package/src/iter.ts +4 -2
- package/src/option.ts +23 -7
- package/src/result.ts +188 -37
- package/src/safe.ts +49 -1
- package/src/types.ts +4 -2
package/build/result.js
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { err as ERR, isOk, isErr, isSome, isNone, NONE, optionOf, isThenable } from "./types.js";
|
|
2
2
|
export { isOk, isErr };
|
|
3
|
+
const identity = (v)=>v;
|
|
4
|
+
const wrapErr = (error)=>ERR(error);
|
|
3
5
|
export function tryCatch(fn, onError) {
|
|
4
6
|
try {
|
|
5
7
|
return fn();
|
|
@@ -8,7 +10,27 @@ export function tryCatch(fn, onError) {
|
|
|
8
10
|
}
|
|
9
11
|
}
|
|
10
12
|
export function of(fn) {
|
|
11
|
-
|
|
13
|
+
try {
|
|
14
|
+
return fn();
|
|
15
|
+
} catch (error) {
|
|
16
|
+
return ERR(error);
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
export function wrap(fn, onError) {
|
|
20
|
+
return (...args)=>{
|
|
21
|
+
try {
|
|
22
|
+
return fn(...args);
|
|
23
|
+
} catch (error) {
|
|
24
|
+
return ERR(onError ? onError(error) : error);
|
|
25
|
+
}
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
export function toThrowable(fn) {
|
|
29
|
+
return (...args)=>{
|
|
30
|
+
const result = fn(...args);
|
|
31
|
+
if (isErr(result)) throw result.error;
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
12
34
|
}
|
|
13
35
|
export async function fromPromise(promise, onError) {
|
|
14
36
|
try {
|
|
@@ -17,6 +39,14 @@ export async function fromPromise(promise, onError) {
|
|
|
17
39
|
return ERR(onError ? onError(error) : error);
|
|
18
40
|
}
|
|
19
41
|
}
|
|
42
|
+
function schemaResultToResult(sr) {
|
|
43
|
+
return sr.issues ? ERR(sr.issues) : sr.value;
|
|
44
|
+
}
|
|
45
|
+
export function fromSchema(schema, value) {
|
|
46
|
+
const sr = schema['~standard'].validate(value);
|
|
47
|
+
if (isThenable(sr)) return sr.then(schemaResultToResult);
|
|
48
|
+
return schemaResultToResult(sr);
|
|
49
|
+
}
|
|
20
50
|
export function tryCatchMaybePromise(fn, onError) {
|
|
21
51
|
try {
|
|
22
52
|
const result = fn();
|
|
@@ -38,7 +68,7 @@ export function assertOk(result, message) {
|
|
|
38
68
|
}
|
|
39
69
|
export function assertErr(result, message) {
|
|
40
70
|
if (isOk(result)) {
|
|
41
|
-
throw new Error(message ??
|
|
71
|
+
throw new Error(message ?? `Expected Err result. Received value: ${String(result)}`);
|
|
42
72
|
}
|
|
43
73
|
}
|
|
44
74
|
export function isSomeErr(result) {
|
|
@@ -56,9 +86,7 @@ export function flatMap(result, fn) {
|
|
|
56
86
|
if (isErr(result)) return result;
|
|
57
87
|
return fn(result);
|
|
58
88
|
}
|
|
59
|
-
export
|
|
60
|
-
return isErr(result) ? result : fn(result);
|
|
61
|
-
}
|
|
89
|
+
export const andThen = flatMap;
|
|
62
90
|
export function tap(result, fn) {
|
|
63
91
|
if (isOk(result)) {
|
|
64
92
|
fn(result);
|
|
@@ -145,7 +173,8 @@ export function match(result, onOk, onErr) {
|
|
|
145
173
|
export function partition(results) {
|
|
146
174
|
const oks = [];
|
|
147
175
|
const errs = [];
|
|
148
|
-
for
|
|
176
|
+
for(let i = 0; i < results.length; i++){
|
|
177
|
+
const result = results[i];
|
|
149
178
|
if (isOk(result)) {
|
|
150
179
|
oks.push(result);
|
|
151
180
|
} else {
|
|
@@ -159,21 +188,24 @@ export function partition(results) {
|
|
|
159
188
|
}
|
|
160
189
|
export function filterOk(results) {
|
|
161
190
|
const oks = [];
|
|
162
|
-
for
|
|
191
|
+
for(let i = 0; i < results.length; i++){
|
|
192
|
+
const result = results[i];
|
|
163
193
|
if (isOk(result)) oks.push(result);
|
|
164
194
|
}
|
|
165
195
|
return oks;
|
|
166
196
|
}
|
|
167
197
|
export function filterErr(results) {
|
|
168
198
|
const errs = [];
|
|
169
|
-
for
|
|
199
|
+
for(let i = 0; i < results.length; i++){
|
|
200
|
+
const result = results[i];
|
|
170
201
|
if (isErr(result)) errs.push(result.error);
|
|
171
202
|
}
|
|
172
203
|
return errs;
|
|
173
204
|
}
|
|
174
205
|
export function collect(results) {
|
|
175
206
|
const values = [];
|
|
176
|
-
for
|
|
207
|
+
for(let i = 0; i < results.length; i++){
|
|
208
|
+
const result = results[i];
|
|
177
209
|
if (isErr(result)) return result;
|
|
178
210
|
values.push(result);
|
|
179
211
|
}
|
|
@@ -182,7 +214,8 @@ export function collect(results) {
|
|
|
182
214
|
export function collectAll(results) {
|
|
183
215
|
const oks = [];
|
|
184
216
|
const errs = [];
|
|
185
|
-
for
|
|
217
|
+
for(let i = 0; i < results.length; i++){
|
|
218
|
+
const result = results[i];
|
|
186
219
|
if (isOk(result)) {
|
|
187
220
|
oks.push(result);
|
|
188
221
|
} else {
|
|
@@ -216,17 +249,31 @@ export function isOkAnd(result, predicate) {
|
|
|
216
249
|
export function isErrAnd(result, predicate) {
|
|
217
250
|
return isErr(result) && predicate(result.error);
|
|
218
251
|
}
|
|
219
|
-
export function settledToResult(result) {
|
|
220
|
-
if (result.status === 'fulfilled') return result.value;
|
|
221
|
-
return ERR(result.reason);
|
|
222
|
-
}
|
|
223
252
|
export async function partitionAsync(promises) {
|
|
224
253
|
const settled = await Promise.allSettled(promises);
|
|
225
|
-
|
|
254
|
+
const oks = [];
|
|
255
|
+
const errs = [];
|
|
256
|
+
for(let i = 0; i < settled.length; i++){
|
|
257
|
+
const entry = settled[i];
|
|
258
|
+
if (entry.status === 'rejected') {
|
|
259
|
+
errs.push(entry.reason);
|
|
260
|
+
continue;
|
|
261
|
+
}
|
|
262
|
+
const result = entry.value;
|
|
263
|
+
if (isOk(result)) {
|
|
264
|
+
oks.push(result);
|
|
265
|
+
} else {
|
|
266
|
+
errs.push(result.error);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
return [
|
|
270
|
+
oks,
|
|
271
|
+
errs
|
|
272
|
+
];
|
|
226
273
|
}
|
|
227
274
|
export function settleMaybePromise(values) {
|
|
228
275
|
const len = values.length;
|
|
229
|
-
const results = new Array(len);
|
|
276
|
+
const results = new Array(len).fill(0);
|
|
230
277
|
let pendingIndices;
|
|
231
278
|
let pendingPromises;
|
|
232
279
|
for(let i = 0; i < len; i++){
|
|
@@ -248,13 +295,13 @@ export function settleMaybePromise(values) {
|
|
|
248
295
|
});
|
|
249
296
|
}
|
|
250
297
|
export async function partitionMaybePromiseAsync(values, oks, errs, startIndex = 0) {
|
|
251
|
-
const
|
|
252
|
-
const
|
|
253
|
-
for(let i = 0; i <
|
|
298
|
+
const remaining = values.length - startIndex;
|
|
299
|
+
const promises = new Array(remaining).fill(0);
|
|
300
|
+
for(let i = 0; i < remaining; i++){
|
|
254
301
|
const value = values[startIndex + i];
|
|
255
|
-
|
|
302
|
+
promises[i] = isThenable(value) ? Promise.resolve(value).then(identity, wrapErr) : Promise.resolve(value);
|
|
256
303
|
}
|
|
257
|
-
const resolved = await Promise.all(
|
|
304
|
+
const resolved = await Promise.all(promises);
|
|
258
305
|
for(let i = 0; i < resolved.length; i++){
|
|
259
306
|
const result = resolved[i];
|
|
260
307
|
if (isOk(result)) {
|
|
@@ -302,5 +349,24 @@ export async function safeTryAsync(fn) {
|
|
|
302
349
|
return ERR(e);
|
|
303
350
|
}
|
|
304
351
|
}
|
|
352
|
+
function* unwrapYield(result) {
|
|
353
|
+
if (isErr(result)) {
|
|
354
|
+
yield result;
|
|
355
|
+
return undefined;
|
|
356
|
+
}
|
|
357
|
+
return result;
|
|
358
|
+
}
|
|
359
|
+
export function gen(fn) {
|
|
360
|
+
const iter = fn(unwrapYield);
|
|
361
|
+
const step = iter.next();
|
|
362
|
+
if (!step.done) return step.value;
|
|
363
|
+
return step.value;
|
|
364
|
+
}
|
|
365
|
+
export async function genAsync(fn) {
|
|
366
|
+
const iter = fn(unwrapYield);
|
|
367
|
+
const step = await iter.next();
|
|
368
|
+
if (!step.done) return step.value;
|
|
369
|
+
return step.value;
|
|
370
|
+
}
|
|
305
371
|
|
|
306
372
|
//# sourceMappingURL=result.js.map
|
package/build/result.js.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.');\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 function andThen<T, U, E>(result: Err<E>, fn: (value: T) => Result<U, E>): Err<E>;\nexport function andThen<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;\nexport function andThen<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E> {\n return isErr(result) ? result : fn(result);\n}\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 values: T[] = [];\n\n for (const result of results) {\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 (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 pending = new Array<Promise<Result<T, E>>>(suffixLength);\n\n for (let i = 0; i < suffixLength; i++) {\n const value = values[startIndex + i];\n pending[i] = Promise.resolve(value).then(\n (result) => result as Result<T, E>,\n (error) => ERR(error as E),\n );\n }\n\n const resolved = await Promise.all(pending);\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 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":["err","ERR","isOk","isErr","isSome","isNone","NONE","optionOf","isThenable","tryCatch","fn","onError","error","of","fromPromise","promise","tryCatchMaybePromise","result","Promise","resolve","then","value","unwrapOrReturn","onErr","assertOk","message","Error","String","assertErr","isSomeErr","map","mapErr","flatMap","andThen","tap","tapErr","bimap","okFn","errFn","unwrap","unwrapErr","unwrapOr","defaultValue","unwrapOrElse","mapOr","mapOrElse","defaultFn","expect","expectErr","and","other","or","orElse","toOption","toErrorOption","zip","left","right","zipWith","flatten","match","onOk","partition","results","oks","errs","push","filterOk","filterErr","collect","values","collectAll","length","all","any","errors","i","transpose","opt","isOkAnd","predicate","isErrAnd","settledToResult","status","reason","partitionAsync","promises","settled","allSettled","settleMaybePromise","len","Array","pendingIndices","pendingPromises","v","s","partitionMaybePromiseAsync","startIndex","suffixLength","pending","resolved","partitionMaybePromise","safeTry","e","safeTryAsync"],"mappings":"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"}
|
|
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":["err","ERR","isOk","isErr","isSome","isNone","NONE","optionOf","isThenable","identity","v","wrapErr","error","tryCatch","fn","onError","of","wrap","args","toThrowable","result","fromPromise","promise","schemaResultToResult","sr","issues","value","fromSchema","schema","validate","then","tryCatchMaybePromise","Promise","resolve","unwrapOrReturn","onErr","assertOk","message","Error","String","assertErr","isSomeErr","map","mapErr","flatMap","andThen","tap","tapErr","bimap","okFn","errFn","unwrap","unwrapErr","unwrapOr","defaultValue","unwrapOrElse","mapOr","mapOrElse","defaultFn","expect","expectErr","and","other","or","orElse","toOption","toErrorOption","zip","left","right","zipWith","flatten","match","onOk","partition","results","oks","errs","i","length","push","filterOk","filterErr","collect","values","collectAll","all","any","errors","transpose","opt","isOkAnd","predicate","isErrAnd","partitionAsync","promises","settled","allSettled","entry","status","reason","settleMaybePromise","len","Array","fill","pendingIndices","pendingPromises","s","partitionMaybePromiseAsync","startIndex","remaining","resolved","partitionMaybePromise","safeTry","e","safeTryAsync","unwrapYield","undefined","gen","iter","step","next","done","genAsync"],"mappings":"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"}
|
package/build/safe.cjs
CHANGED
|
@@ -21,6 +21,12 @@ _export(exports, {
|
|
|
21
21
|
get err () {
|
|
22
22
|
return _typescjs.err;
|
|
23
23
|
},
|
|
24
|
+
get gen () {
|
|
25
|
+
return _resultcjs.gen;
|
|
26
|
+
},
|
|
27
|
+
get genAsync () {
|
|
28
|
+
return _resultcjs.genAsync;
|
|
29
|
+
},
|
|
24
30
|
get isErr () {
|
|
25
31
|
return _typescjs.isErr;
|
|
26
32
|
},
|
|
@@ -45,6 +51,9 @@ _export(exports, {
|
|
|
45
51
|
get ok () {
|
|
46
52
|
return _typescjs.ok;
|
|
47
53
|
},
|
|
54
|
+
get pipe () {
|
|
55
|
+
return pipe;
|
|
56
|
+
},
|
|
48
57
|
get safeTry () {
|
|
49
58
|
return _resultcjs.safeTry;
|
|
50
59
|
},
|
|
@@ -103,5 +112,12 @@ function _interop_require_wildcard(obj, nodeInterop) {
|
|
|
103
112
|
}
|
|
104
113
|
return newObj;
|
|
105
114
|
}
|
|
115
|
+
function pipe(a, ...fns) {
|
|
116
|
+
let result = a;
|
|
117
|
+
for(let i = 0; i < fns.length; i++){
|
|
118
|
+
result = fns[i](result);
|
|
119
|
+
}
|
|
120
|
+
return result;
|
|
121
|
+
}
|
|
106
122
|
|
|
107
123
|
//# sourceMappingURL=safe.cjs.map
|
package/build/safe.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/safe.ts"],"sourcesContent":["export { some, none, ok, err, isOk, isErr, isSome, isNone, isThenable, isSync } from './types.js';\nexport type {\n Some,\n None,\n Ok,\n Err,\n Option as OptionType,\n OptionValue,\n IsOption,\n InferSome,\n Result as ResultType,\n ResultValue,\n ResultErrorType,\n IsResult,\n InferErr,\n MaybePromise,\n} from './types.js';\nexport { safeTry, safeTryAsync, unwrap } from './result.js';\nexport * as Option from './option.js';\nexport * as Result from './result.js';\nexport * as Iter from './iter.js';\n"],"names":["Iter","Option","Result","err","isErr","isNone","isOk","isSome","isSync","isThenable","none","ok","safeTry","safeTryAsync","some","unwrap"],"mappings":";;;;;;;;;;;QAoBYA;;;QAFAC;;;QACAC;;;QAnBaC;eAAAA,aAAG;;
|
|
1
|
+
{"version":3,"sources":["../src/safe.ts"],"sourcesContent":["export { some, none, ok, err, isOk, isErr, isSome, isNone, isThenable, isSync } from './types.js';\nexport type {\n Some,\n None,\n Ok,\n Err,\n Option as OptionType,\n OptionValue,\n IsOption,\n InferSome,\n Result as ResultType,\n ResultValue,\n ResultErrorType,\n IsResult,\n InferErr,\n MaybePromise,\n} from './types.js';\nexport { safeTry, safeTryAsync, unwrap, gen, genAsync } from './result.js';\nexport * as Option from './option.js';\nexport * as Result from './result.js';\nexport * as Iter from './iter.js';\n\n/**\n * Threads a value through a sequence of unary functions, left to right.\n * @param value - The initial value\n * @param fns - Functions to apply in order\n * @returns The result of applying all functions\n * @example\n * pipe(\n * Result.tryCatch(() => JSON.parse(input)),\n * r => Result.flatMap(r, validate),\n * r => Result.map(r, transform),\n * )\n */\nexport function pipe<A>(a: A): A;\nexport function pipe<A, B>(a: A, ab: (a: A) => B): B;\nexport function pipe<A, B, C>(a: A, ab: (a: A) => B, bc: (b: B) => C): C;\nexport function pipe<A, B, C, D>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D): D;\nexport function pipe<A, B, C, D, E>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E): E;\nexport function pipe<A, B, C, D, E, F>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F): F;\nexport function pipe<A, B, C, D, E, F, G>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G): G;\nexport function pipe<A, B, C, D, E, F, G, H>(\n a: A,\n ab: (a: A) => B,\n bc: (b: B) => C,\n cd: (c: C) => D,\n de: (d: D) => E,\n ef: (e: E) => F,\n fg: (f: F) => G,\n gh: (g: G) => H,\n): H;\nexport function pipe<A, B, C, D, E, F, G, H, I>(\n a: A,\n ab: (a: A) => B,\n bc: (b: B) => C,\n cd: (c: C) => D,\n de: (d: D) => E,\n ef: (e: E) => F,\n fg: (f: F) => G,\n gh: (g: G) => H,\n hi: (h: H) => I,\n): I;\nexport function pipe(a: unknown, ...fns: ((v: unknown) => unknown)[]): unknown {\n let result = a;\n for (let i = 0; i < fns.length; i++) {\n result = fns[i](result);\n }\n return result;\n}\n"],"names":["Iter","Option","Result","err","gen","genAsync","isErr","isNone","isOk","isSome","isSync","isThenable","none","ok","pipe","safeTry","safeTryAsync","some","unwrap","a","fns","result","i","length"],"mappings":";;;;;;;;;;;QAoBYA;;;QAFAC;;;QACAC;;;QAnBaC;eAAAA,aAAG;;QAiBYC;eAAAA,cAAG;;QAAEC;eAAAA,mBAAQ;;QAjBjBC;eAAAA,eAAK;;QAAUC;eAAAA,gBAAM;;QAA3BC;eAAAA,cAAI;;QAASC;eAAAA,gBAAM;;QAAsBC;eAAAA,gBAAM;;QAAlBC;eAAAA,oBAAU;;QAAtDC;eAAAA,cAAI;;QAAEC;eAAAA,YAAE;;QA8DPC;eAAAA;;QA7CPC;eAAAA,kBAAO;;QAAEC;eAAAA,uBAAY;;QAjBrBC;eAAAA,cAAI;;QAiBmBC;eAAAA,iBAAM;;;0BAjB+C;mEAiBxB;mEACrC;iEAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0Cf,SAASJ,KAAKK,CAAU,EAAE,GAAGC,GAAgC;IAClE,IAAIC,SAASF;IACb,IAAK,IAAIG,IAAI,GAAGA,IAAIF,IAAIG,MAAM,EAAED,IAAK;QACnCD,SAASD,GAAG,CAACE,EAAE,CAACD;IAClB;IACA,OAAOA;AACT"}
|
package/build/safe.d.ts
CHANGED
|
@@ -1,6 +1,27 @@
|
|
|
1
1
|
export { some, none, ok, err, isOk, isErr, isSome, isNone, isThenable, isSync } from './types.js';
|
|
2
2
|
export type { Some, None, Ok, Err, Option as OptionType, OptionValue, IsOption, InferSome, Result as ResultType, ResultValue, ResultErrorType, IsResult, InferErr, MaybePromise, } from './types.js';
|
|
3
|
-
export { safeTry, safeTryAsync, unwrap } from './result.js';
|
|
3
|
+
export { safeTry, safeTryAsync, unwrap, gen, genAsync } from './result.js';
|
|
4
4
|
export * as Option from './option.js';
|
|
5
5
|
export * as Result from './result.js';
|
|
6
6
|
export * as Iter from './iter.js';
|
|
7
|
+
/**
|
|
8
|
+
* Threads a value through a sequence of unary functions, left to right.
|
|
9
|
+
* @param value - The initial value
|
|
10
|
+
* @param fns - Functions to apply in order
|
|
11
|
+
* @returns The result of applying all functions
|
|
12
|
+
* @example
|
|
13
|
+
* pipe(
|
|
14
|
+
* Result.tryCatch(() => JSON.parse(input)),
|
|
15
|
+
* r => Result.flatMap(r, validate),
|
|
16
|
+
* r => Result.map(r, transform),
|
|
17
|
+
* )
|
|
18
|
+
*/
|
|
19
|
+
export declare function pipe<A>(a: A): A;
|
|
20
|
+
export declare function pipe<A, B>(a: A, ab: (a: A) => B): B;
|
|
21
|
+
export declare function pipe<A, B, C>(a: A, ab: (a: A) => B, bc: (b: B) => C): C;
|
|
22
|
+
export declare function pipe<A, B, C, D>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D): D;
|
|
23
|
+
export declare function pipe<A, B, C, D, E>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E): E;
|
|
24
|
+
export declare function pipe<A, B, C, D, E, F>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F): F;
|
|
25
|
+
export declare function pipe<A, B, C, D, E, F, G>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G): G;
|
|
26
|
+
export declare function pipe<A, B, C, D, E, F, G, H>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H): H;
|
|
27
|
+
export declare function pipe<A, B, C, D, E, F, G, H, I>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I): I;
|
package/build/safe.js
CHANGED
|
@@ -1,7 +1,14 @@
|
|
|
1
1
|
export { some, none, ok, err, isOk, isErr, isSome, isNone, isThenable, isSync } from "./types.js";
|
|
2
|
-
export { safeTry, safeTryAsync, unwrap } from "./result.js";
|
|
2
|
+
export { safeTry, safeTryAsync, unwrap, gen, genAsync } from "./result.js";
|
|
3
3
|
export * as Option from "./option.js";
|
|
4
4
|
export * as Result from "./result.js";
|
|
5
5
|
export * as Iter from "./iter.js";
|
|
6
|
+
export function pipe(a, ...fns) {
|
|
7
|
+
let result = a;
|
|
8
|
+
for(let i = 0; i < fns.length; i++){
|
|
9
|
+
result = fns[i](result);
|
|
10
|
+
}
|
|
11
|
+
return result;
|
|
12
|
+
}
|
|
6
13
|
|
|
7
14
|
//# sourceMappingURL=safe.js.map
|
package/build/safe.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/safe.ts"],"sourcesContent":["export { some, none, ok, err, isOk, isErr, isSome, isNone, isThenable, isSync } from './types.js';\nexport type {\n Some,\n None,\n Ok,\n Err,\n Option as OptionType,\n OptionValue,\n IsOption,\n InferSome,\n Result as ResultType,\n ResultValue,\n ResultErrorType,\n IsResult,\n InferErr,\n MaybePromise,\n} from './types.js';\nexport { safeTry, safeTryAsync, unwrap } from './result.js';\nexport * as Option from './option.js';\nexport * as Result from './result.js';\nexport * as Iter from './iter.js';\n"],"names":["some","none","ok","err","isOk","isErr","isSome","isNone","isThenable","isSync","safeTry","safeTryAsync","unwrap","Option","Result","Iter"],"mappings":"AAAA,SAASA,IAAI,EAAEC,IAAI,EAAEC,EAAE,EAAEC,GAAG,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAEC,MAAM,EAAEC,UAAU,EAAEC,MAAM,QAAQ,aAAa;AAiBlG,SAASC,OAAO,EAAEC,YAAY,EAAEC,MAAM,QAAQ,cAAc;
|
|
1
|
+
{"version":3,"sources":["../src/safe.ts"],"sourcesContent":["export { some, none, ok, err, isOk, isErr, isSome, isNone, isThenable, isSync } from './types.js';\nexport type {\n Some,\n None,\n Ok,\n Err,\n Option as OptionType,\n OptionValue,\n IsOption,\n InferSome,\n Result as ResultType,\n ResultValue,\n ResultErrorType,\n IsResult,\n InferErr,\n MaybePromise,\n} from './types.js';\nexport { safeTry, safeTryAsync, unwrap, gen, genAsync } from './result.js';\nexport * as Option from './option.js';\nexport * as Result from './result.js';\nexport * as Iter from './iter.js';\n\n/**\n * Threads a value through a sequence of unary functions, left to right.\n * @param value - The initial value\n * @param fns - Functions to apply in order\n * @returns The result of applying all functions\n * @example\n * pipe(\n * Result.tryCatch(() => JSON.parse(input)),\n * r => Result.flatMap(r, validate),\n * r => Result.map(r, transform),\n * )\n */\nexport function pipe<A>(a: A): A;\nexport function pipe<A, B>(a: A, ab: (a: A) => B): B;\nexport function pipe<A, B, C>(a: A, ab: (a: A) => B, bc: (b: B) => C): C;\nexport function pipe<A, B, C, D>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D): D;\nexport function pipe<A, B, C, D, E>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E): E;\nexport function pipe<A, B, C, D, E, F>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F): F;\nexport function pipe<A, B, C, D, E, F, G>(a: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G): G;\nexport function pipe<A, B, C, D, E, F, G, H>(\n a: A,\n ab: (a: A) => B,\n bc: (b: B) => C,\n cd: (c: C) => D,\n de: (d: D) => E,\n ef: (e: E) => F,\n fg: (f: F) => G,\n gh: (g: G) => H,\n): H;\nexport function pipe<A, B, C, D, E, F, G, H, I>(\n a: A,\n ab: (a: A) => B,\n bc: (b: B) => C,\n cd: (c: C) => D,\n de: (d: D) => E,\n ef: (e: E) => F,\n fg: (f: F) => G,\n gh: (g: G) => H,\n hi: (h: H) => I,\n): I;\nexport function pipe(a: unknown, ...fns: ((v: unknown) => unknown)[]): unknown {\n let result = a;\n for (let i = 0; i < fns.length; i++) {\n result = fns[i](result);\n }\n return result;\n}\n"],"names":["some","none","ok","err","isOk","isErr","isSome","isNone","isThenable","isSync","safeTry","safeTryAsync","unwrap","gen","genAsync","Option","Result","Iter","pipe","a","fns","result","i","length"],"mappings":"AAAA,SAASA,IAAI,EAAEC,IAAI,EAAEC,EAAE,EAAEC,GAAG,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAEC,MAAM,EAAEC,UAAU,EAAEC,MAAM,QAAQ,aAAa;AAiBlG,SAASC,OAAO,EAAEC,YAAY,EAAEC,MAAM,EAAEC,GAAG,EAAEC,QAAQ,QAAQ,cAAc;AAC3E,OAAO,KAAKC,MAAM,MAAM,cAAc;AACtC,OAAO,KAAKC,MAAM,MAAM,cAAc;AACtC,OAAO,KAAKC,IAAI,MAAM,YAAY;AA0ClC,OAAO,SAASC,KAAKC,CAAU,EAAE,GAAGC,GAAgC;IAClE,IAAIC,SAASF;IACb,IAAK,IAAIG,IAAI,GAAGA,IAAIF,IAAIG,MAAM,EAAED,IAAK;QACnCD,SAASD,GAAG,CAACE,EAAE,CAACD;IAClB;IACA,OAAOA;AACT"}
|
package/build/types.cjs
CHANGED
|
@@ -100,10 +100,10 @@ function err(error) {
|
|
|
100
100
|
return new ResultErrorCtor(error);
|
|
101
101
|
}
|
|
102
102
|
function isThenable(value) {
|
|
103
|
-
return typeof value
|
|
103
|
+
return (typeof value === 'object' || typeof value === 'function') && value !== null && typeof value.then === 'function';
|
|
104
104
|
}
|
|
105
105
|
function isSync(value) {
|
|
106
|
-
return typeof value
|
|
106
|
+
return !(typeof value === 'object' || typeof value === 'function') || value === null || typeof value.then !== 'function';
|
|
107
107
|
}
|
|
108
108
|
|
|
109
109
|
//# sourceMappingURL=types.cjs.map
|
package/build/types.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/** Values that represent None (absence of a value). */\nexport type NoneValueType = null | undefined | void;\n\n/** Widens literal types to their base types for better type inference. */\nexport type Widen<T> = T extends string\n ? string\n : T extends number\n ? number\n : T extends boolean\n ? boolean\n : T extends bigint\n ? bigint\n : T extends symbol\n ? symbol\n : T;\n\n/** Widens never to unknown, otherwise preserves the type. */\nexport type WidenNever<T> = [T] extends [never] ? unknown : T;\n\n/** Excludes None values from a type, leaving only valid Some values. */\nexport type ValueType<T> = Exclude<T, NoneValueType>;\n\nexport declare const SOME_BRAND: unique symbol;\n\n/** Represents a value that is present. The value itself is the Some - no wrapper object. */\nexport type Some<T> = ValueType<T> & { readonly [SOME_BRAND]: true };\n\n/** Represents the absence of a value (null or undefined). */\nexport type None = NoneValueType & { readonly [SOME_BRAND]: false };\n\n/** Constant representing None. Use this instead of null/undefined for clarity. */\nexport const NONE = undefined as None;\n\n/** Shared frozen empty array to avoid allocations. */\nexport const EMPTY: readonly unknown[] = Object.freeze([]);\n\n/** A value that may or may not be present. Some(T) is the value itself; None is null/undefined. */\nexport type Option<T> = Some<ValueType<T>> | None;\n\n/** Extracts the value type from an Option type. */\nexport type OptionValue<TOption> = TOption extends Option<infer TValue> ? TValue : never;\n\n/** Type predicate: true if T is an Option type. */\nexport type IsOption<T> = T extends Option<any> ? true : false;\n\n/** Infers the Some type from a value, preserving the inner type. */\nexport type InferSome<T> = T extends Some<infer TValue> ? Some<ValueType<TValue>> : never;\n\n/**\n * Checks if an Option contains a value (is Some).\n * @param opt - The Option to check\n * @returns true if the Option is Some, false if None\n * @example\n * isSome(42) // true\n * isSome(null) // false\n * isSome(undefined) // false\n */\nexport function isSome<T>(opt: Some<T>): true;\nexport function isSome(opt: None): false;\nexport function isSome<T>(opt: unknown): opt is Some<T>;\nexport function isSome(opt: unknown): boolean {\n return opt !== null && opt !== undefined;\n}\n\n/**\n * Checks if an Option is None (absent).\n * @param opt - The Option to check\n * @returns true if the Option is None, false if Some\n * @example\n * isNone(null) // true\n * isNone(undefined) // true\n * isNone(42) // false\n */\nexport function isNone<T>(opt: Some<T>): false;\nexport function isNone(opt: None): true;\nexport function isNone(opt: unknown): opt is None;\nexport function isNone(opt: unknown): boolean {\n return opt === null || opt === undefined;\n}\n\n/**\n * Creates an Option from a nullable value. Returns None for null/undefined, Some otherwise.\n * @param value - The value to wrap\n * @returns Some(value) if value is non-null, None otherwise\n * @example\n * optionOf(42) // Some(42)\n * optionOf(null) // None\n * optionOf(undefined) // None\n */\nexport function optionOf(value: null): None;\nexport function optionOf(value: undefined): None;\nexport function optionOf<T>(value: T): T extends NoneValueType ? None : Some<T>;\nexport function optionOf<T>(value: T): Option<T> {\n return isNone(value as Option<T>) ? NONE : (value as Some<T>);\n}\n\nexport function someUnchecked<T>(value: T): Some<ValueType<T>> {\n return value as Some<ValueType<T>>;\n}\n\n/**\n * Creates a Some value with runtime validation.\n * @param value - The value to wrap\n * @returns The value typed as Some\n * @throws TypeError if value is null or undefined\n * @example\n * some(42) // Some(42)\n */\nexport function some<T>(value: ValueType<T>): Some<ValueType<T>> {\n if (value === null || value === undefined) {\n throw new TypeError('some() requires a non-nullable value');\n }\n return someUnchecked(value);\n}\n\n/** Constant representing None. Alias for NONE. */\nexport const none: None = NONE;\n\ndeclare const OK_BRAND: unique symbol;\n\n/** Represents a successful Result value. The value itself is the Ok - no wrapper object. */\nexport type Ok<T> = T & { readonly [OK_BRAND]: true };\n\nconst ERR_BRAND = Symbol.for('nalloc.ResultError');\n\ninterface ResultErrorShape<E> {\n readonly error: E;\n readonly [ERR_BRAND]: true;\n}\n\nfunction ResultErrorCtor<E>(this: ResultErrorShape<E>, error: E): void {\n (this as { error: E }).error = error;\n}\n(ResultErrorCtor.prototype as { [ERR_BRAND]: true })[ERR_BRAND] = true;\n\n/** The error wrapper type used internally. */\nexport type ResultError<E> = ResultErrorShape<E>;\n\n/** Represents a failed Result containing an error. */\nexport type Err<E> = ResultError<E>;\n\n/** A value that is either successful (Ok) or failed (Err). Ok is the value itself; Err wraps the error. */\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/** Extracts the success value type from a Result type. */\nexport type ResultValue<TResult> = TResult extends Result<infer TValue, any> ? TValue : never;\n\n/** Extracts the error type from a Result type. */\nexport type ResultErrorType<TResult> = TResult extends Result<any, infer TError> ? TError : never;\n\n/** Type predicate: true if T is a Result type. */\nexport type IsResult<T> = T extends Result<any, any> ? true : false;\n\n/** Infers the Err type from a value, preserving the error type. */\nexport type InferErr<T> = T extends Err<infer TError> ? Err<TError> : never;\n\n/**\n * Checks if a Result is Ok (successful).\n * @param result - The Result to check\n * @returns true if the Result is Ok, false if Err\n * @example\n * isOk(42) // true (Ok value)\n * isOk(err('fail')) // false\n */\nexport function isOk<T>(result: Ok<T>): true;\nexport function isOk<E>(result: Err<E>): false;\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T>;\nexport function isOk(result: unknown): boolean;\nexport function isOk(result: unknown): boolean {\n return typeof result !== 'object' || result === null || !(result as Record<symbol, boolean>)[ERR_BRAND];\n}\n\n/**\n * Checks if a Result is Err (failed).\n * @param result - The Result to check\n * @returns true if the Result is Err, false if Ok\n * @example\n * isErr(err('fail')) // true\n * isErr(42) // false (Ok value)\n */\nexport function isErr<E>(result: Err<E>): true;\nexport function isErr(result: Ok<unknown>): false;\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E>;\nexport function isErr(result: unknown): result is Err<unknown>;\nexport function isErr(result: unknown): boolean {\n return typeof result === 'object' && result !== null && (result as Record<symbol, boolean>)[ERR_BRAND] === true;\n}\n\nexport function okUnchecked<T>(value: T): Ok<T> {\n return value as Ok<T>;\n}\n\n/**\n * Creates an Ok value with runtime validation.\n * @param value - The success value\n * @returns The value typed as Ok\n * @throws TypeError if value is an Err\n * @example\n * ok(42) // Ok(42)\n */\nexport function ok<T>(value: T): Ok<T> {\n if (isErr(value)) {\n throw new TypeError('ok() cannot wrap an Err value');\n }\n return okUnchecked(value);\n}\n\n/**\n * Creates an Err value wrapping an error.\n * @param error - The error value\n * @returns An Err containing the error\n * @example\n * err('something went wrong') // Err('something went wrong')\n * err(new Error('failed')) // Err(Error)\n */\nexport function err<E>(error: E): Err<E> {\n return new (ResultErrorCtor as unknown as new (error: E) => Err<E>)(error);\n}\n\n/** A value that may or may not be a Promise. */\nexport type MaybePromise<T> = T | Promise<T> | PromiseLike<T>;\n\n/**\n * Checks if a value is a thenable (has a .then method).\n * @param value - The value to check\n * @returns true if value is a PromiseLike\n */\nexport function isThenable<T>(value: MaybePromise<T>): value is PromiseLike<T> {\n return typeof (value as PromiseLike<T>)?.then === 'function';\n}\n\n/**\n * Checks if a value is synchronous (not a thenable).\n * @param value - The value to check\n * @returns true if value is not a PromiseLike\n */\nexport function isSync<T>(value: MaybePromise<T>): value is T {\n return typeof (value as PromiseLike<T>)?.then !== 'function';\n}\n"],"names":["EMPTY","NONE","err","isErr","isNone","isOk","isSome","isSync","isThenable","none","ok","okUnchecked","optionOf","some","someUnchecked","undefined","Object","freeze","opt","value","TypeError","ERR_BRAND","Symbol","for","ResultErrorCtor","error","prototype","result","then"],"mappings":";;;;;;;;;;;QAkCaA;eAAAA;;QAHAC;eAAAA;;QAwLGC;eAAAA;;QA/BAC;eAAAA;;QA5GAC;eAAAA;;QA4FAC;eAAAA;;QA5GAC;eAAAA;;QAgLAC;eAAAA;;QATAC;eAAAA;;QA/GHC;eAAAA;;QAoFGC;eAAAA;;QAZAC;eAAAA;;QAhGAC;eAAAA;;QAgBAC;eAAAA;;QAZAC;eAAAA;;;AAjET,MAAMb,OAAOc;AAGb,MAAMf,QAA4BgB,OAAOC,MAAM,CAAC,EAAE;AA0BlD,SAASX,OAAOY,GAAY;IACjC,OAAOA,QAAQ,QAAQA,QAAQH;AACjC;AAcO,SAASX,OAAOc,GAAY;IACjC,OAAOA,QAAQ,QAAQA,QAAQH;AACjC;AAcO,SAASH,SAAYO,KAAQ;IAClC,OAAOf,OAAOe,SAAsBlB,OAAQkB;AAC9C;AAEO,SAASL,cAAiBK,KAAQ;IACvC,OAAOA;AACT;AAUO,SAASN,KAAQM,KAAmB;IACzC,IAAIA,UAAU,QAAQA,UAAUJ,WAAW;QACzC,MAAM,IAAIK,UAAU;IACtB;IACA,OAAON,cAAcK;AACvB;AAGO,MAAMV,OAAaR;AAO1B,MAAMoB,YAAYC,OAAOC,GAAG,CAAC;AAO7B,SAASC,gBAA8CC,KAAQ;IAC7D,AAAC,IAAI,CAAkBA,KAAK,GAAGA;AACjC;AACCD,gBAAgBE,SAAS,AAA0B,CAACL,UAAU,GAAG;AAmC3D,SAAShB,KAAKsB,MAAe;IAClC,OAAO,OAAOA,WAAW,YAAYA,WAAW,QAAQ,CAAC,AAACA,MAAkC,CAACN,UAAU;AACzG;AAcO,SAASlB,MAAMwB,MAAe;IACnC,OAAO,OAAOA,WAAW,YAAYA,WAAW,QAAQ,AAACA,MAAkC,CAACN,UAAU,KAAK;AAC7G;AAEO,SAASV,YAAeQ,KAAQ;IACrC,OAAOA;AACT;AAUO,SAAST,GAAMS,KAAQ;IAC5B,IAAIhB,MAAMgB,QAAQ;QAChB,MAAM,IAAIC,UAAU;IACtB;IACA,OAAOT,YAAYQ;AACrB;AAUO,SAASjB,IAAOuB,KAAQ;IAC7B,OAAO,IAAKD,gBAAwDC;AACtE;AAUO,SAASjB,WAAcW,KAAsB;IAClD,OAAO,OAAQA,OAA0BS,SAAS;AACpD;AAOO,SAASrB,OAAUY,KAAsB;IAC9C,OAAO,OAAQA,OAA0BS,SAAS;AACpD"}
|
|
1
|
+
{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/** Values that represent None (absence of a value). */\nexport type NoneValueType = null | undefined | void;\n\n/** Widens literal types to their base types for better type inference. */\nexport type Widen<T> = T extends string\n ? string\n : T extends number\n ? number\n : T extends boolean\n ? boolean\n : T extends bigint\n ? bigint\n : T extends symbol\n ? symbol\n : T;\n\n/** Widens never to unknown, otherwise preserves the type. */\nexport type WidenNever<T> = [T] extends [never] ? unknown : T;\n\n/** Excludes None values from a type, leaving only valid Some values. */\nexport type ValueType<T> = Exclude<T, NoneValueType>;\n\nexport declare const SOME_BRAND: unique symbol;\n\n/** Represents a value that is present. The value itself is the Some - no wrapper object. */\nexport type Some<T> = ValueType<T> & { readonly [SOME_BRAND]: true };\n\n/** Represents the absence of a value (null or undefined). */\nexport type None = NoneValueType & { readonly [SOME_BRAND]: false };\n\nexport type UnOption<V, T extends Option<V>> = T extends Some<V> ? V : None;\n\n/** Constant representing None. Use this instead of null/undefined for clarity. */\nexport const NONE = undefined as None;\n\n/** Shared frozen empty array to avoid allocations. */\nexport const EMPTY: readonly unknown[] = Object.freeze([]);\n\n/** A value that may or may not be present. Some(T) is the value itself; None is null/undefined. */\nexport type Option<T> = Some<ValueType<T>> | None;\n\n/** Extracts the value type from an Option type. */\nexport type OptionValue<TOption> = TOption extends Option<infer TValue> ? TValue : never;\n\n/** Type predicate: true if T is an Option type. */\nexport type IsOption<T> = T extends Option<any> ? true : false;\n\n/** Infers the Some type from a value, preserving the inner type. */\nexport type InferSome<T> = T extends Some<infer TValue> ? Some<ValueType<TValue>> : never;\n\n/**\n * Checks if an Option contains a value (is Some).\n * @param opt - The Option to check\n * @returns true if the Option is Some, false if None\n * @example\n * isSome(42) // true\n * isSome(null) // false\n * isSome(undefined) // false\n */\nexport function isSome<T>(opt: Some<T>): true;\nexport function isSome(opt: None): false;\nexport function isSome<T>(opt: unknown): opt is Some<T>;\nexport function isSome(opt: unknown): boolean {\n return opt !== null && opt !== undefined;\n}\n\n/**\n * Checks if an Option is None (absent).\n * @param opt - The Option to check\n * @returns true if the Option is None, false if Some\n * @example\n * isNone(null) // true\n * isNone(undefined) // true\n * isNone(42) // false\n */\nexport function isNone<T>(opt: Some<T>): false;\nexport function isNone(opt: None): true;\nexport function isNone(opt: unknown): opt is None;\nexport function isNone(opt: unknown): boolean {\n return opt === null || opt === undefined;\n}\n\n/**\n * Creates an Option from a nullable value. Returns None for null/undefined, Some otherwise.\n * @param value - The value to wrap\n * @returns Some(value) if value is non-null, None otherwise\n * @example\n * optionOf(42) // Some(42)\n * optionOf(null) // None\n * optionOf(undefined) // None\n */\nexport function optionOf(value: null): None;\nexport function optionOf(value: undefined): None;\nexport function optionOf<T>(value: T): T extends NoneValueType ? None : Some<T>;\nexport function optionOf<T>(value: T): Option<T> {\n return isNone(value as Option<T>) ? NONE : (value as Some<T>);\n}\n\nexport function someUnchecked<T>(value: T): Some<ValueType<T>> {\n return value as Some<ValueType<T>>;\n}\n\n/**\n * Creates a Some value with runtime validation.\n * @param value - The value to wrap\n * @returns The value typed as Some\n * @throws TypeError if value is null or undefined\n * @example\n * some(42) // Some(42)\n */\nexport function some<T>(value: ValueType<T>): Some<ValueType<T>> {\n if (value === null || value === undefined) {\n throw new TypeError('some() requires a non-nullable value');\n }\n return someUnchecked(value);\n}\n\n/** Constant representing None. Alias for NONE. */\nexport const none: None = NONE;\n\ndeclare const OK_BRAND: unique symbol;\n\n/** Represents a successful Result value. The value itself is the Ok - no wrapper object. */\nexport type Ok<T> = T & { readonly [OK_BRAND]: true };\n\nconst ERR_BRAND = Symbol.for('nalloc.ResultError');\n\ninterface ResultErrorShape<E> {\n readonly error: E;\n readonly [ERR_BRAND]: true;\n}\n\nfunction ResultErrorCtor<E>(this: ResultErrorShape<E>, error: E): void {\n (this as { error: E }).error = error;\n}\n(ResultErrorCtor.prototype as { [ERR_BRAND]: true })[ERR_BRAND] = true;\n\n/** The error wrapper type used internally. */\nexport type ResultError<E> = ResultErrorShape<E>;\n\n/** Represents a failed Result containing an error. */\nexport type Err<E> = ResultError<E>;\n\n/** A value that is either successful (Ok) or failed (Err). Ok is the value itself; Err wraps the error. */\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/** Extracts the success value type from a Result type. */\nexport type ResultValue<TResult> = TResult extends Result<infer TValue, any> ? TValue : never;\n\n/** Extracts the error type from a Result type. */\nexport type ResultErrorType<TResult> = TResult extends Result<any, infer TError> ? TError : never;\n\n/** Type predicate: true if T is a Result type. */\nexport type IsResult<T> = T extends Result<any, any> ? true : false;\n\n/** Infers the Err type from a value, preserving the error type. */\nexport type InferErr<T> = T extends Err<infer TError> ? Err<TError> : never;\n\n/**\n * Checks if a Result is Ok (successful).\n * @param result - The Result to check\n * @returns true if the Result is Ok, false if Err\n * @example\n * isOk(42) // true (Ok value)\n * isOk(err('fail')) // false\n */\nexport function isOk<T>(result: Ok<T>): true;\nexport function isOk<E>(result: Err<E>): false;\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T>;\nexport function isOk(result: unknown): boolean;\nexport function isOk(result: unknown): boolean {\n return typeof result !== 'object' || result === null || !(result as Record<symbol, boolean>)[ERR_BRAND];\n}\n\n/**\n * Checks if a Result is Err (failed).\n * @param result - The Result to check\n * @returns true if the Result is Err, false if Ok\n * @example\n * isErr(err('fail')) // true\n * isErr(42) // false (Ok value)\n */\nexport function isErr<E>(result: Err<E>): true;\nexport function isErr(result: Ok<unknown>): false;\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E>;\nexport function isErr(result: unknown): result is Err<unknown>;\nexport function isErr(result: unknown): boolean {\n return typeof result === 'object' && result !== null && (result as Record<symbol, boolean>)[ERR_BRAND] === true;\n}\n\nexport function okUnchecked<T>(value: T): Ok<T> {\n return value as Ok<T>;\n}\n\n/**\n * Creates an Ok value with runtime validation.\n * @param value - The success value\n * @returns The value typed as Ok\n * @throws TypeError if value is an Err\n * @example\n * ok(42) // Ok(42)\n */\nexport function ok<T>(value: T): Ok<T> {\n if (isErr(value)) {\n throw new TypeError('ok() cannot wrap an Err value');\n }\n return okUnchecked(value);\n}\n\n/**\n * Creates an Err value wrapping an error.\n * @param error - The error value\n * @returns An Err containing the error\n * @example\n * err('something went wrong') // Err('something went wrong')\n * err(new Error('failed')) // Err(Error)\n */\nexport function err<E>(error: E): Err<E> {\n return new (ResultErrorCtor as unknown as new (error: E) => Err<E>)(error);\n}\n\n/** A value that may or may not be a Promise. */\nexport type MaybePromise<T> = T | Promise<T> | PromiseLike<T>;\n\n/**\n * Checks if a value is a thenable (has a .then method).\n * @param value - The value to check\n * @returns true if value is a PromiseLike\n */\nexport function isThenable<T>(value: MaybePromise<T>): value is PromiseLike<T> {\n return (typeof value === 'object' || typeof value === 'function') && value !== null && typeof (value as PromiseLike<T>).then === 'function';\n}\n\n/**\n * Checks if a value is synchronous (not a thenable).\n * @param value - The value to check\n * @returns true if value is not a PromiseLike\n */\nexport function isSync<T>(value: MaybePromise<T>): value is T {\n return !(typeof value === 'object' || typeof value === 'function') || value === null || typeof (value as PromiseLike<T>).then !== 'function';\n}\n"],"names":["EMPTY","NONE","err","isErr","isNone","isOk","isSome","isSync","isThenable","none","ok","okUnchecked","optionOf","some","someUnchecked","undefined","Object","freeze","opt","value","TypeError","ERR_BRAND","Symbol","for","ResultErrorCtor","error","prototype","result","then"],"mappings":";;;;;;;;;;;QAoCaA;eAAAA;;QAHAC;eAAAA;;QAwLGC;eAAAA;;QA/BAC;eAAAA;;QA5GAC;eAAAA;;QA4FAC;eAAAA;;QA5GAC;eAAAA;;QAgLAC;eAAAA;;QATAC;eAAAA;;QA/GHC;eAAAA;;QAoFGC;eAAAA;;QAZAC;eAAAA;;QAhGAC;eAAAA;;QAgBAC;eAAAA;;QAZAC;eAAAA;;;AAjET,MAAMb,OAAOc;AAGb,MAAMf,QAA4BgB,OAAOC,MAAM,CAAC,EAAE;AA0BlD,SAASX,OAAOY,GAAY;IACjC,OAAOA,QAAQ,QAAQA,QAAQH;AACjC;AAcO,SAASX,OAAOc,GAAY;IACjC,OAAOA,QAAQ,QAAQA,QAAQH;AACjC;AAcO,SAASH,SAAYO,KAAQ;IAClC,OAAOf,OAAOe,SAAsBlB,OAAQkB;AAC9C;AAEO,SAASL,cAAiBK,KAAQ;IACvC,OAAOA;AACT;AAUO,SAASN,KAAQM,KAAmB;IACzC,IAAIA,UAAU,QAAQA,UAAUJ,WAAW;QACzC,MAAM,IAAIK,UAAU;IACtB;IACA,OAAON,cAAcK;AACvB;AAGO,MAAMV,OAAaR;AAO1B,MAAMoB,YAAYC,OAAOC,GAAG,CAAC;AAO7B,SAASC,gBAA8CC,KAAQ;IAC7D,AAAC,IAAI,CAAkBA,KAAK,GAAGA;AACjC;AACCD,gBAAgBE,SAAS,AAA0B,CAACL,UAAU,GAAG;AAmC3D,SAAShB,KAAKsB,MAAe;IAClC,OAAO,OAAOA,WAAW,YAAYA,WAAW,QAAQ,CAAC,AAACA,MAAkC,CAACN,UAAU;AACzG;AAcO,SAASlB,MAAMwB,MAAe;IACnC,OAAO,OAAOA,WAAW,YAAYA,WAAW,QAAQ,AAACA,MAAkC,CAACN,UAAU,KAAK;AAC7G;AAEO,SAASV,YAAeQ,KAAQ;IACrC,OAAOA;AACT;AAUO,SAAST,GAAMS,KAAQ;IAC5B,IAAIhB,MAAMgB,QAAQ;QAChB,MAAM,IAAIC,UAAU;IACtB;IACA,OAAOT,YAAYQ;AACrB;AAUO,SAASjB,IAAOuB,KAAQ;IAC7B,OAAO,IAAKD,gBAAwDC;AACtE;AAUO,SAASjB,WAAcW,KAAsB;IAClD,OAAO,AAAC,CAAA,OAAOA,UAAU,YAAY,OAAOA,UAAU,UAAS,KAAMA,UAAU,QAAQ,OAAO,AAACA,MAAyBS,IAAI,KAAK;AACnI;AAOO,SAASrB,OAAUY,KAAsB;IAC9C,OAAO,CAAE,CAAA,OAAOA,UAAU,YAAY,OAAOA,UAAU,UAAS,KAAMA,UAAU,QAAQ,OAAO,AAACA,MAAyBS,IAAI,KAAK;AACpI"}
|
package/build/types.d.ts
CHANGED
|
@@ -15,6 +15,7 @@ export type Some<T> = ValueType<T> & {
|
|
|
15
15
|
export type None = NoneValueType & {
|
|
16
16
|
readonly [SOME_BRAND]: false;
|
|
17
17
|
};
|
|
18
|
+
export type UnOption<V, T extends Option<V>> = T extends Some<V> ? V : None;
|
|
18
19
|
/** Constant representing None. Use this instead of null/undefined for clarity. */
|
|
19
20
|
export declare const NONE: None;
|
|
20
21
|
/** Shared frozen empty array to avoid allocations. */
|
package/build/types.js
CHANGED
|
@@ -43,10 +43,10 @@ export function err(error) {
|
|
|
43
43
|
return new ResultErrorCtor(error);
|
|
44
44
|
}
|
|
45
45
|
export function isThenable(value) {
|
|
46
|
-
return typeof value
|
|
46
|
+
return (typeof value === 'object' || typeof value === 'function') && value !== null && typeof value.then === 'function';
|
|
47
47
|
}
|
|
48
48
|
export function isSync(value) {
|
|
49
|
-
return typeof value
|
|
49
|
+
return !(typeof value === 'object' || typeof value === 'function') || value === null || typeof value.then !== 'function';
|
|
50
50
|
}
|
|
51
51
|
|
|
52
52
|
//# sourceMappingURL=types.js.map
|