@l3dev/result 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Leon Semmens
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/build/all.d.ts

@@ -0,0 +1,8 @@
+import type { Err } from "./err.js";
+import { type Ok } from "./ok.js";
+import type { ReturnResult } from "./result.types.js";
+export declare function all<TResults extends ReturnResult<any, any>[]>(...results: TResults): Extract<TResults[number], Err<any, any>> | Ok<Extract<TResults[number], Ok<any>>["value"][]>;
+export declare function allAsync<TResults extends (ReturnResult<any, any> | Promise<ReturnResult<any, any>>)[]>(...results: TResults): Promise<Extract<Awaited<TResults[number]>, Err<any, any>> | Ok<Extract<Awaited<TResults[number]>, Ok<any>>["value"][]>>;
+export declare function allSettledAsync<TResults extends (ReturnResult<any, any> | Promise<ReturnResult<any, any>>)[]>(...results: TResults): Promise<Awaited<TResults[number]>[]>;
+export declare function allValues<TResults extends ReturnResult<any, any>[]>(...results: TResults): Extract<TResults[number], Ok<any>>["value"][];
+export declare function allErrors<TResults extends ReturnResult<any, any>[]>(...results: TResults): Extract<TResults[number], Err<any, any>>[];

package/build/all.js

@@ -0,0 +1,48 @@
+import { ok } from "./ok.js";
+export function all(...results) {
+    const values = [];
+    for (const result of results) {
+        if (!result.ok) {
+            return result;
+        }
+        values.push(result.value);
+    }
+    return ok(values);
+}
+export async function allAsync(...results) {
+    const values = [];
+    for (const asyncResult of results) {
+        const result = await asyncResult;
+        if (!result.ok) {
+            return result;
+        }
+        values.push(result.value);
+    }
+    return ok(values);
+}
+export async function allSettledAsync(...results) {
+    const settled = [];
+    for (const asyncResult of results) {
+        settled.push((await asyncResult));
+    }
+    return settled;
+}
+export function allValues(...results) {
+    const values = [];
+    for (const result of results) {
+        if (result.ok) {
+            values.push(result.value);
+        }
+    }
+    return values;
+}
+export function allErrors(...results) {
+    const errs = [];
+    for (const result of results) {
+        if (!result.ok) {
+            errs.push(result);
+        }
+    }
+    return errs;
+}
+//# sourceMappingURL=all.js.map

package/build/all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.js","sourceRoot":"","sources":["../src/all.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAW,MAAM,SAAS,CAAC;AAGtC,MAAM,UAAU,GAAG,CAClB,GAAG,OAAiB;IAEpB,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,MAAkD,CAAC;QAC3D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAG7B,GAAG,OAAiB;IAKpB,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,MAA2D,CAAC;QACpE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,GAAG,OAAiB;IACrB,MAAM,OAAO,GAAgC,EAAE,CAAC;IAChD,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,WAAW,CAA8B,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS,CACxB,GAAG,OAAiB;IAEpB,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CACxB,GAAG,OAAiB;IAEpB,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;IACF,CAAC;IACD,OAAO,IAAkD,CAAC;AAC3D,CAAC","sourcesContent":["import type { Err } from \"./err.js\";\nimport { ok, type Ok } from \"./ok.js\";\nimport type { ReturnResult } from \"./result.types.js\";\n\nexport function all<TResults extends ReturnResult<any, any>[]>(\n\t...results: TResults\n): Extract<TResults[number], Err<any, any>> | Ok<Extract<TResults[number], Ok<any>>[\"value\"][]> {\n\tconst values = [];\n\tfor (const result of results) {\n\t\tif (!result.ok) {\n\t\t\treturn result as Extract<TResults[number], Err<any, any>>;\n\t\t}\n\t\tvalues.push(result.value);\n\t}\n\treturn ok(values);\n}\n\nexport async function allAsync<\n\tTResults extends (ReturnResult<any, any> | Promise<ReturnResult<any, any>>)[]\n>(\n\t...results: TResults\n): Promise<\n\t| Extract<Awaited<TResults[number]>, Err<any, any>>\n\t| Ok<Extract<Awaited<TResults[number]>, Ok<any>>[\"value\"][]>\n> {\n\tconst values = [];\n\tfor (const asyncResult of results) {\n\t\tconst result = await asyncResult;\n\t\tif (!result.ok) {\n\t\t\treturn result as Extract<Awaited<TResults[number]>, Err<any, any>>;\n\t\t}\n\t\tvalues.push(result.value);\n\t}\n\treturn ok(values);\n}\n\nexport async function allSettledAsync<\n\tTResults extends (ReturnResult<any, any> | Promise<ReturnResult<any, any>>)[]\n>(...results: TResults): Promise<Awaited<TResults[number]>[]> {\n\tconst settled: Awaited<TResults[number]>[] = [];\n\tfor (const asyncResult of results) {\n\t\tsettled.push((await asyncResult) as Awaited<TResults[number]>);\n\t}\n\treturn settled;\n}\n\nexport function allValues<TResults extends ReturnResult<any, any>[]>(\n\t...results: TResults\n): Extract<TResults[number], Ok<any>>[\"value\"][] {\n\tconst values: any[] = [];\n\tfor (const result of results) {\n\t\tif (result.ok) {\n\t\t\tvalues.push(result.value);\n\t\t}\n\t}\n\treturn values;\n}\n\nexport function allErrors<TResults extends ReturnResult<any, any>[]>(\n\t...results: TResults\n): Extract<TResults[number], Err<any, any>>[] {\n\tconst errs: Err<any, any>[] = [];\n\tfor (const result of results) {\n\t\tif (!result.ok) {\n\t\t\terrs.push(result);\n\t\t}\n\t}\n\treturn errs as Extract<TResults[number], Err<any, any>>[];\n}\n"]}

package/build/err.d.ts

@@ -0,0 +1,7 @@
+export type Err<TType, TContext> = {
+    ok: false;
+    type: TType;
+    context: TContext;
+};
+export declare function err<const TType>(type: TType): Err<TType, null>;
+export declare function err<const TType, TContext>(type: TType, context: TContext): Err<TType, TContext>;

package/build/err.js

@@ -0,0 +1,4 @@
+export function err(type, context) {
+    return { ok: false, type, context: context ?? null };
+}
+//# sourceMappingURL=err.js.map

package/build/err.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"err.js","sourceRoot":"","sources":["../src/err.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,GAAG,CAClB,IAAW,EACX,OAAkB;IAElB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;AACtD,CAAC","sourcesContent":["export type Err<TType, TContext> = {\n\tok: false;\n\ttype: TType;\n\tcontext: TContext;\n};\n\nexport function err<const TType>(type: TType): Err<TType, null>;\nexport function err<const TType, TContext>(type: TType, context: TContext): Err<TType, TContext>;\nexport function err<const TType, TContext>(\n\ttype: TType,\n\tcontext?: TContext\n): Err<TType, TContext | null> {\n\treturn { ok: false, type, context: context ?? null };\n}\n"]}

package/build/fn.d.ts

@@ -0,0 +1,2 @@
+import type { ReturnResult } from "./result.types.js";
+export declare function fn<TResult extends ReturnResult<any, any> | Promise<ReturnResult<any, any>>, TFn extends (...args: any[]) => TResult>(fn: TFn): TFn;

package/build/fn.js

@@ -0,0 +1,29 @@
+const SHOULD_NEVER_THROW_MESSAGE = "A result function should never throw an error";
+export function fn(fn) {
+    return function (...args) {
+        let result;
+        try {
+            result = fn.call(this, ...args);
+        }
+        catch (error) {
+            throw new Error(SHOULD_NEVER_THROW_MESSAGE, {
+                cause: error
+            });
+        }
+        if (result instanceof Promise) {
+            // eslint-disable-next-line no-async-promise-executor
+            return new Promise(async (resolve, reject) => {
+                try {
+                    resolve(await result);
+                }
+                catch (error) {
+                    reject(new Error(SHOULD_NEVER_THROW_MESSAGE, {
+                        cause: error
+                    }));
+                }
+            });
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=fn.js.map

package/build/fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn.js","sourceRoot":"","sources":["../src/fn.ts"],"names":[],"mappings":"AAEA,MAAM,0BAA0B,GAAG,+CAA+C,CAAC;AAEnF,MAAM,UAAU,EAAE,CAGhB,EAAO;IACR,OAAO,UAAwC,GAAG,IAAqB;QACtE,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACJ,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,0BAA0B,EAAE;gBAC3C,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC/B,qDAAqD;YACrD,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC5C,IAAI,CAAC;oBACJ,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;gBACvB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,MAAM,CACL,IAAI,KAAK,CAAC,0BAA0B,EAAE;wBACrC,KAAK,EAAE,KAAK;qBACZ,CAAC,CACF,CAAC;gBACH,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAQ,CAAC;AACV,CAAC","sourcesContent":["import type { ReturnResult } from \"./result.types.js\";\n\nconst SHOULD_NEVER_THROW_MESSAGE = \"A result function should never throw an error\";\n\nexport function fn<\n\tTResult extends ReturnResult<any, any> | Promise<ReturnResult<any, any>>,\n\tTFn extends (...args: any[]) => TResult\n>(fn: TFn): TFn {\n\treturn function (this: ThisParameterType<TFn>, ...args: Parameters<TFn>) {\n\t\tlet result;\n\t\ttry {\n\t\t\tresult = fn.call(this, ...args);\n\t\t} catch (error) {\n\t\t\tthrow new Error(SHOULD_NEVER_THROW_MESSAGE, {\n\t\t\t\tcause: error\n\t\t\t});\n\t\t}\n\n\t\tif (result instanceof Promise) {\n\t\t\t// eslint-disable-next-line no-async-promise-executor\n\t\t\treturn new Promise(async (resolve, reject) => {\n\t\t\t\ttry {\n\t\t\t\t\tresolve(await result);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treject(\n\t\t\t\t\t\tnew Error(SHOULD_NEVER_THROW_MESSAGE, {\n\t\t\t\t\t\t\tcause: error\n\t\t\t\t\t\t})\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\treturn result;\n\t} as TFn;\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,30 @@
+import { all, allAsync, allErrors, allSettledAsync, allValues } from "./all.js";
+import { err, type Err } from "./err.js";
+import { fn } from "./fn.js";
+import { ok, type Ok } from "./ok.js";
+import { pipe } from "./pipe.js";
+import { pipeAsync } from "./pipeAsync.js";
+import { fromPromise } from "./promise.js";
+import type { ReturnResult } from "./result.types.js";
+export * from "./ok.js";
+export * from "./err.js";
+export * from "./result.types.js";
+declare function unwrapOrDefault<TResult extends ReturnResult<any, any>, TValue = TResult extends Ok<infer TValue> ? TValue : never>(result: TResult, defaultValue: NoInfer<TValue>): TValue;
+declare function isOk<TResult extends ReturnResult<any, any>>(result: TResult): result is Extract<TResult, Ok<any>>;
+declare function isErr<TResult extends ReturnResult<any, any>>(result: TResult): result is Extract<TResult, Err<any, any>>;
+export declare const Result: {
+    ok: typeof ok;
+    err: typeof err;
+    pipe: typeof pipe;
+    pipeAsync: typeof pipeAsync;
+    fn: typeof fn;
+    fromPromise: typeof fromPromise;
+    unwrapOrDefault: typeof unwrapOrDefault;
+    all: typeof all;
+    allAsync: typeof allAsync;
+    allSettledAsync: typeof allSettledAsync;
+    allValues: typeof allValues;
+    allErrors: typeof allErrors;
+    isOk: typeof isOk;
+    isErr: typeof isErr;
+};

package/build/index.js

@@ -0,0 +1,36 @@
+import { all, allAsync, allErrors, allSettledAsync, allValues } from "./all.js";
+import { err } from "./err.js";
+import { fn } from "./fn.js";
+import { ok } from "./ok.js";
+import { pipe } from "./pipe.js";
+import { pipeAsync } from "./pipeAsync.js";
+import { fromPromise } from "./promise.js";
+export * from "./ok.js";
+export * from "./err.js";
+export * from "./result.types.js";
+function unwrapOrDefault(result, defaultValue) {
+    return result.ok ? result.value : defaultValue;
+}
+function isOk(result) {
+    return result.ok;
+}
+function isErr(result) {
+    return !result.ok;
+}
+export const Result = {
+    ok,
+    err,
+    pipe,
+    pipeAsync,
+    fn,
+    fromPromise,
+    unwrapOrDefault,
+    all,
+    allAsync,
+    allSettledAsync,
+    allValues,
+    allErrors,
+    isOk,
+    isErr
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,GAAG,EAAY,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,EAAE,EAAW,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAElC,SAAS,eAAe,CAGtB,MAAe,EAAE,YAA6B;IAC/C,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AAChD,CAAC;AAED,SAAS,IAAI,CACZ,MAAe;IAEf,OAAO,MAAM,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,KAAK,CACb,MAAe;IAEf,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,EAAE;IACF,GAAG;IACH,IAAI;IACJ,SAAS;IACT,EAAE;IACF,WAAW;IACX,eAAe;IACf,GAAG;IACH,QAAQ;IACR,eAAe;IACf,SAAS;IACT,SAAS;IACT,IAAI;IACJ,KAAK;CACL,CAAC","sourcesContent":["import { all, allAsync, allErrors, allSettledAsync, allValues } from \"./all.js\";\nimport { err, type Err } from \"./err.js\";\nimport { fn } from \"./fn.js\";\nimport { ok, type Ok } from \"./ok.js\";\nimport { pipe } from \"./pipe.js\";\nimport { pipeAsync } from \"./pipeAsync.js\";\nimport { fromPromise } from \"./promise.js\";\nimport type { ReturnResult } from \"./result.types.js\";\n\nexport * from \"./ok.js\";\nexport * from \"./err.js\";\nexport * from \"./result.types.js\";\n\nfunction unwrapOrDefault<\n\tTResult extends ReturnResult<any, any>,\n\tTValue = TResult extends Ok<infer TValue> ? TValue : never\n>(result: TResult, defaultValue: NoInfer<TValue>): TValue {\n\treturn result.ok ? result.value : defaultValue;\n}\n\nfunction isOk<TResult extends ReturnResult<any, any>>(\n\tresult: TResult\n): result is Extract<TResult, Ok<any>> {\n\treturn result.ok;\n}\n\nfunction isErr<TResult extends ReturnResult<any, any>>(\n\tresult: TResult\n): result is Extract<TResult, Err<any, any>> {\n\treturn !result.ok;\n}\n\nexport const Result = {\n\tok,\n\terr,\n\tpipe,\n\tpipeAsync,\n\tfn,\n\tfromPromise,\n\tunwrapOrDefault,\n\tall,\n\tallAsync,\n\tallSettledAsync,\n\tallValues,\n\tallErrors,\n\tisOk,\n\tisErr\n};\n"]}

package/build/ok.d.ts

@@ -0,0 +1,7 @@
+export type Ok<TValue> = {
+    ok: true;
+    value: TValue;
+};
+export type None = Ok<null>;
+export declare function ok<TValue>(value: TValue): Ok<TValue>;
+export declare const NONE: None;

package/build/ok.js

@@ -0,0 +1,5 @@
+export function ok(value) {
+    return { ok: true, value };
+}
+export const NONE = ok(null);
+//# sourceMappingURL=ok.js.map

package/build/ok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ok.js","sourceRoot":"","sources":["../src/ok.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,EAAE,CAAS,KAAa;IACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAS,CAAC","sourcesContent":["export type Ok<TValue> = {\n\tok: true;\n\tvalue: TValue;\n};\n\nexport type None = Ok<null>;\n\nexport function ok<TValue>(value: TValue): Ok<TValue> {\n\treturn { ok: true, value };\n}\n\nexport const NONE = ok(null) as None;\n"]}

package/build/pipe.d.ts

@@ -0,0 +1,20 @@
+import type { Err } from "./err.js";
+import { type Ok } from "./ok.js";
+import type { ResultFn } from "./result.types.js";
+export type PipelineResult<TFns> = TFns extends [
+    ...infer InterFns extends ResultFn[],
+    infer LastFn extends ResultFn
+] ? Extract<ReturnType<InterFns[number]>, Err<any, any>> | ReturnType<LastFn> : never;
+export type PipelineFn<TFns extends ResultFn[]> = (...input: Parameters<TFns[0]>) => PipelineResult<TFns>;
+export type StepFn<TPreviousFn extends ResultFn> = ResultFn<[
+    Extract<ReturnType<TPreviousFn>, Ok<any>>["value"]
+]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>>(fnA: FnA, fnB: FnB): PipelineFn<[FnA, FnB]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>>(fnA: FnA, fnB: FnB, fnC: FnC): PipelineFn<[FnA, FnB, FnC]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD): PipelineFn<[FnA, FnB, FnC, FnD]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>, FnE extends StepFn<FnD>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE): PipelineFn<[FnA, FnB, FnC, FnD, FnE]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>, FnE extends StepFn<FnD>, FnF extends StepFn<FnE>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>, FnE extends StepFn<FnD>, FnF extends StepFn<FnE>, FnG extends StepFn<FnF>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>, FnE extends StepFn<FnD>, FnF extends StepFn<FnE>, FnG extends StepFn<FnF>, FnH extends StepFn<FnG>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG, fnH: FnH): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>, FnE extends StepFn<FnD>, FnF extends StepFn<FnE>, FnG extends StepFn<FnF>, FnH extends StepFn<FnG>, FnI extends StepFn<FnH>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG, fnH: FnH, fnI: FnI): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI]>;
+export declare function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>, FnD extends StepFn<FnC>, FnE extends StepFn<FnD>, FnF extends StepFn<FnE>, FnG extends StepFn<FnF>, FnH extends StepFn<FnG>, FnI extends StepFn<FnH>, FnJ extends StepFn<FnI>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG, fnH: FnH, fnI: FnI, fnJ: FnJ): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI, FnJ]>;

package/build/pipe.js

@@ -0,0 +1,23 @@
+import { ok } from "./ok.js";
+export function pipe(...fns) {
+    return ((...input) => {
+        let value;
+        {
+            const result = fns[0](...input);
+            if (!result.ok) {
+                return result;
+            }
+            value = result.value;
+        }
+        for (let i = 1; i < fns.length; i++) {
+            const fn = fns[i];
+            const result = fn(value);
+            if (!result.ok) {
+                return result;
+            }
+            value = result.value;
+        }
+        return ok(value);
+    });
+}
+//# sourceMappingURL=pipe.js.map

package/build/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../src/pipe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAW,MAAM,SAAS,CAAC;AAuItC,MAAM,UAAU,IAAI,CAAgC,GAAG,GAAS;IAC/D,OAAO,CAAC,CAAC,GAAG,KAA0B,EAAE,EAAE;QACzC,IAAI,KAAK,CAAC;QACV,CAAC;YACA,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,MAAM,CAAC;YACf,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,MAAM,CAAC;YACf,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAqB,CAAC;AACxB,CAAC","sourcesContent":["import type { Err } from \"./err.js\";\nimport { ok, type Ok } from \"./ok.js\";\nimport type { ResultFn } from \"./result.types.js\";\n\nexport type PipelineResult<TFns> = TFns extends [\n\t...infer InterFns extends ResultFn[],\n\tinfer LastFn extends ResultFn\n]\n\t? Extract<ReturnType<InterFns[number]>, Err<any, any>> | ReturnType<LastFn>\n\t: never;\n\nexport type PipelineFn<TFns extends ResultFn[]> = (\n\t...input: Parameters<TFns[0]>\n) => PipelineResult<TFns>;\n\nexport type StepFn<TPreviousFn extends ResultFn> = ResultFn<\n\t[Extract<ReturnType<TPreviousFn>, Ok<any>>[\"value\"]]\n>;\n\nexport function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>>(\n\tfnA: FnA,\n\tfnB: FnB\n): PipelineFn<[FnA, FnB]>;\nexport function pipe<FnA extends ResultFn, FnB extends StepFn<FnA>, FnC extends StepFn<FnB>>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC\n): PipelineFn<[FnA, FnB, FnC]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>\n>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD): PipelineFn<[FnA, FnB, FnC, FnD]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>,\n\tFnE extends StepFn<FnD>\n>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE): PipelineFn<[FnA, FnB, FnC, FnD, FnE]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>,\n\tFnE extends StepFn<FnD>,\n\tFnF extends StepFn<FnE>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF\n): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>,\n\tFnE extends StepFn<FnD>,\n\tFnF extends StepFn<FnE>,\n\tFnG extends StepFn<FnF>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG\n): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>,\n\tFnE extends StepFn<FnD>,\n\tFnF extends StepFn<FnE>,\n\tFnG extends StepFn<FnF>,\n\tFnH extends StepFn<FnG>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG,\n\tfnH: FnH\n): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>,\n\tFnE extends StepFn<FnD>,\n\tFnF extends StepFn<FnE>,\n\tFnG extends StepFn<FnF>,\n\tFnH extends StepFn<FnG>,\n\tFnI extends StepFn<FnH>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG,\n\tfnH: FnH,\n\tfnI: FnI\n): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI]>;\nexport function pipe<\n\tFnA extends ResultFn,\n\tFnB extends StepFn<FnA>,\n\tFnC extends StepFn<FnB>,\n\tFnD extends StepFn<FnC>,\n\tFnE extends StepFn<FnD>,\n\tFnF extends StepFn<FnE>,\n\tFnG extends StepFn<FnF>,\n\tFnH extends StepFn<FnG>,\n\tFnI extends StepFn<FnH>,\n\tFnJ extends StepFn<FnI>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG,\n\tfnH: FnH,\n\tfnI: FnI,\n\tfnJ: FnJ\n): PipelineFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI, FnJ]>;\nexport function pipe<const TFns extends ResultFn[]>(...fns: TFns): PipelineFn<TFns> {\n\treturn ((...input: Parameters<TFns[0]>) => {\n\t\tlet value;\n\t\t{\n\t\t\tconst result = fns[0](...input);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tvalue = result.value;\n\t\t}\n\t\tfor (let i = 1; i < fns.length; i++) {\n\t\t\tconst fn = fns[i];\n\t\t\tconst result = fn(value);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tvalue = result.value;\n\t\t}\n\t\treturn ok(value);\n\t}) as PipelineFn<TFns>;\n}\n"]}

package/build/pipeAsync.d.ts

@@ -0,0 +1,20 @@
+import type { Err } from "./err.js";
+import { type Ok } from "./ok.js";
+import type { ResultAsyncFn } from "./result.types.js";
+export type PipelineResultAsync<TFns> = TFns extends [
+    ...infer InterFns extends ResultAsyncFn[],
+    infer LastFn extends ResultAsyncFn
+] ? Promise<Extract<Awaited<ReturnType<InterFns[number]>>, Err<any, any>> | Awaited<ReturnType<LastFn>>> : never;
+export type PipelineAsyncFn<TFns extends ResultAsyncFn[]> = (...input: Parameters<TFns[0]>) => PipelineResultAsync<TFns>;
+export type StepAsyncFn<TPreviousFn extends ResultAsyncFn> = ResultAsyncFn<[
+    Extract<Awaited<ReturnType<TPreviousFn>>, Ok<any>>["value"]
+]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>>(fnA: FnA, fnB: FnB): PipelineAsyncFn<[FnA, FnB]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>>(fnA: FnA, fnB: FnB, fnC: FnC): PipelineAsyncFn<[FnA, FnB, FnC]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD): PipelineAsyncFn<[FnA, FnB, FnC, FnD]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>, FnE extends StepAsyncFn<FnD>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>, FnE extends StepAsyncFn<FnD>, FnF extends StepAsyncFn<FnE>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>, FnE extends StepAsyncFn<FnD>, FnF extends StepAsyncFn<FnE>, FnG extends StepAsyncFn<FnF>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>, FnE extends StepAsyncFn<FnD>, FnF extends StepAsyncFn<FnE>, FnG extends StepAsyncFn<FnF>, FnH extends StepAsyncFn<FnG>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG, fnH: FnH): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>, FnE extends StepAsyncFn<FnD>, FnF extends StepAsyncFn<FnE>, FnG extends StepAsyncFn<FnF>, FnH extends StepAsyncFn<FnG>, FnI extends StepAsyncFn<FnH>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG, fnH: FnH, fnI: FnI): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI]>;
+export declare function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>, FnC extends StepAsyncFn<FnB>, FnD extends StepAsyncFn<FnC>, FnE extends StepAsyncFn<FnD>, FnF extends StepAsyncFn<FnE>, FnG extends StepAsyncFn<FnF>, FnH extends StepAsyncFn<FnG>, FnI extends StepAsyncFn<FnH>, FnJ extends StepAsyncFn<FnI>>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE, fnF: FnF, fnG: FnG, fnH: FnH, fnI: FnI, fnJ: FnJ): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI, FnJ]>;

package/build/pipeAsync.js

@@ -0,0 +1,23 @@
+import { ok } from "./ok.js";
+export function pipeAsync(...fns) {
+    return (async (...input) => {
+        let value;
+        {
+            const result = await fns[0](...input);
+            if (!result.ok) {
+                return result;
+            }
+            value = result.value;
+        }
+        for (let i = 1; i < fns.length; i++) {
+            const fn = fns[i];
+            const result = await fn(value);
+            if (!result.ok) {
+                return result;
+            }
+            value = result.value;
+        }
+        return ok(value);
+    });
+}
+//# sourceMappingURL=pipeAsync.js.map

package/build/pipeAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeAsync.js","sourceRoot":"","sources":["../src/pipeAsync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAW,MAAM,SAAS,CAAC;AAyItC,MAAM,UAAU,SAAS,CAAqC,GAAG,GAAS;IACzE,OAAO,CAAC,KAAK,EAAE,GAAG,KAA0B,EAAE,EAAE;QAC/C,IAAI,KAAK,CAAC;QACV,CAAC;YACA,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,MAAM,CAAC;YACf,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,MAAM,CAAC;YACf,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAA0B,CAAC;AAC7B,CAAC","sourcesContent":["import type { Err } from \"./err.js\";\nimport { ok, type Ok } from \"./ok.js\";\nimport type { ResultAsyncFn } from \"./result.types.js\";\n\nexport type PipelineResultAsync<TFns> = TFns extends [\n\t...infer InterFns extends ResultAsyncFn[],\n\tinfer LastFn extends ResultAsyncFn\n]\n\t? Promise<\n\t\t\tExtract<Awaited<ReturnType<InterFns[number]>>, Err<any, any>> | Awaited<ReturnType<LastFn>>\n\t\t>\n\t: never;\n\nexport type PipelineAsyncFn<TFns extends ResultAsyncFn[]> = (\n\t...input: Parameters<TFns[0]>\n) => PipelineResultAsync<TFns>;\n\nexport type StepAsyncFn<TPreviousFn extends ResultAsyncFn> = ResultAsyncFn<\n\t[Extract<Awaited<ReturnType<TPreviousFn>>, Ok<any>>[\"value\"]]\n>;\n\nexport function pipeAsync<FnA extends ResultAsyncFn, FnB extends StepAsyncFn<FnA>>(\n\tfnA: FnA,\n\tfnB: FnB\n): PipelineAsyncFn<[FnA, FnB]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>\n>(fnA: FnA, fnB: FnB, fnC: FnC): PipelineAsyncFn<[FnA, FnB, FnC]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>\n>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD): PipelineAsyncFn<[FnA, FnB, FnC, FnD]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>,\n\tFnE extends StepAsyncFn<FnD>\n>(fnA: FnA, fnB: FnB, fnC: FnC, fnD: FnD, fnE: FnE): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>,\n\tFnE extends StepAsyncFn<FnD>,\n\tFnF extends StepAsyncFn<FnE>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF\n): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>,\n\tFnE extends StepAsyncFn<FnD>,\n\tFnF extends StepAsyncFn<FnE>,\n\tFnG extends StepAsyncFn<FnF>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG\n): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>,\n\tFnE extends StepAsyncFn<FnD>,\n\tFnF extends StepAsyncFn<FnE>,\n\tFnG extends StepAsyncFn<FnF>,\n\tFnH extends StepAsyncFn<FnG>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG,\n\tfnH: FnH\n): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>,\n\tFnE extends StepAsyncFn<FnD>,\n\tFnF extends StepAsyncFn<FnE>,\n\tFnG extends StepAsyncFn<FnF>,\n\tFnH extends StepAsyncFn<FnG>,\n\tFnI extends StepAsyncFn<FnH>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG,\n\tfnH: FnH,\n\tfnI: FnI\n): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI]>;\nexport function pipeAsync<\n\tFnA extends ResultAsyncFn,\n\tFnB extends StepAsyncFn<FnA>,\n\tFnC extends StepAsyncFn<FnB>,\n\tFnD extends StepAsyncFn<FnC>,\n\tFnE extends StepAsyncFn<FnD>,\n\tFnF extends StepAsyncFn<FnE>,\n\tFnG extends StepAsyncFn<FnF>,\n\tFnH extends StepAsyncFn<FnG>,\n\tFnI extends StepAsyncFn<FnH>,\n\tFnJ extends StepAsyncFn<FnI>\n>(\n\tfnA: FnA,\n\tfnB: FnB,\n\tfnC: FnC,\n\tfnD: FnD,\n\tfnE: FnE,\n\tfnF: FnF,\n\tfnG: FnG,\n\tfnH: FnH,\n\tfnI: FnI,\n\tfnJ: FnJ\n): PipelineAsyncFn<[FnA, FnB, FnC, FnD, FnE, FnF, FnG, FnH, FnI, FnJ]>;\nexport function pipeAsync<const TFns extends ResultAsyncFn[]>(...fns: TFns): PipelineAsyncFn<TFns> {\n\treturn (async (...input: Parameters<TFns[0]>) => {\n\t\tlet value;\n\t\t{\n\t\t\tconst result = await fns[0](...input);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tvalue = result.value;\n\t\t}\n\t\tfor (let i = 1; i < fns.length; i++) {\n\t\t\tconst fn = fns[i];\n\t\t\tconst result = await fn(value);\n\t\t\tif (!result.ok) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tvalue = result.value;\n\t\t}\n\t\treturn ok(value);\n\t}) as PipelineAsyncFn<TFns>;\n}\n"]}

package/build/promise.d.ts

@@ -0,0 +1,12 @@
+import type { ResultErrorDefinition, ReturnResult } from "./result.types.js";
+export declare function fromPromise<TPromise extends Promise<any>, TError = Error>(promise: TPromise): Promise<ReturnResult<Awaited<TPromise>, ResultErrorDefinition<null, {
+    error: TError;
+}>>>;
+export declare function fromPromise<TPromise extends Promise<any>, const TType, TContext extends object, TError = Error>(config: {
+    onError: {
+        type: TType;
+        context?: TContext;
+    };
+}, promise: TPromise): Promise<ReturnResult<Awaited<TPromise>, ResultErrorDefinition<TType, TContext & {
+    error: TError;
+}>>>;

package/build/promise.js

@@ -0,0 +1,22 @@
+import { err } from "./err.js";
+import { ok } from "./ok.js";
+export async function fromPromise(configOrPromise, promise) {
+    let config = null;
+    if (!promise && configOrPromise instanceof Promise) {
+        promise = configOrPromise;
+    }
+    else if (!(configOrPromise instanceof Promise)) {
+        config = configOrPromise;
+    }
+    try {
+        const value = await promise;
+        return ok(value);
+    }
+    catch (error) {
+        return err((config?.onError.type ?? null), {
+            ...config?.onError.context,
+            error: error
+        });
+    }
+}
+//# sourceMappingURL=promise.js.map

package/build/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../src/promise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAiB7B,MAAM,CAAC,KAAK,UAAU,WAAW,CAMhC,eAA4E,EAC5E,OAAkB;IAIlB,IAAI,MAAM,GAA4D,IAAI,CAAC;IAC3E,IAAI,CAAC,OAAO,IAAI,eAAe,YAAY,OAAO,EAAE,CAAC;QACpD,OAAO,GAAG,eAAe,CAAC;IAC3B,CAAC;SAAM,IAAI,CAAC,CAAC,eAAe,YAAY,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,eAAe,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,OAAQ,CAAC;QAC7B,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,CACT,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAU,EACvC;YACC,GAAG,MAAM,EAAE,OAAO,CAAC,OAAO;YAC1B,KAAK,EAAE,KAAe;SACU,CACjC,CAAC;IACH,CAAC;AACF,CAAC","sourcesContent":["import { err } from \"./err.js\";\nimport { ok } from \"./ok.js\";\nimport type { ResultErrorDefinition, ReturnResult } from \"./result.types.js\";\n\nexport async function fromPromise<TPromise extends Promise<any>, TError = Error>(\n\tpromise: TPromise\n): Promise<ReturnResult<Awaited<TPromise>, ResultErrorDefinition<null, { error: TError }>>>;\nexport async function fromPromise<\n\tTPromise extends Promise<any>,\n\tconst TType,\n\tTContext extends object,\n\tTError = Error\n>(\n\tconfig: { onError: { type: TType; context?: TContext } },\n\tpromise: TPromise\n): Promise<\n\tReturnResult<Awaited<TPromise>, ResultErrorDefinition<TType, TContext & { error: TError }>>\n>;\nexport async function fromPromise<\n\tTPromise extends Promise<any>,\n\tconst TType,\n\tTContext extends object,\n\tTError = Error\n>(\n\tconfigOrPromise: { onError: { type: TType; context?: TContext } } | TPromise,\n\tpromise?: TPromise\n): Promise<\n\tReturnResult<Awaited<TPromise>, ResultErrorDefinition<TType, TContext & { error: TError }>>\n> {\n\tlet config: { onError: { type: TType; context?: TContext } } | null = null;\n\tif (!promise && configOrPromise instanceof Promise) {\n\t\tpromise = configOrPromise;\n\t} else if (!(configOrPromise instanceof Promise)) {\n\t\tconfig = configOrPromise;\n\t}\n\n\ttry {\n\t\tconst value = await promise!;\n\t\treturn ok(value);\n\t} catch (error) {\n\t\treturn err(\n\t\t\t(config?.onError.type ?? null) as TType,\n\t\t\t{\n\t\t\t\t...config?.onError.context,\n\t\t\t\terror: error as TError\n\t\t\t} as TContext & { error: TError }\n\t\t);\n\t}\n}\n"]}

package/build/result.types.d.ts

@@ -0,0 +1,9 @@
+import type { Err } from "./err.js";
+import type { Ok } from "./ok.js";
+export type ResultErrorDefinition<TType, TContext> = {
+    type: TType;
+    context: TContext;
+};
+export type ReturnResult<TValue, TError extends ResultErrorDefinition<any, any>> = Ok<TValue> | Err<TError["type"], TError["context"]>;
+export type ResultFn<TInput extends any[] = any[], TResult extends ReturnResult<any, any> = ReturnResult<any, any>> = (...args: TInput) => TResult;
+export type ResultAsyncFn<TInput extends any[] = any[], TResult extends Promise<ReturnResult<any, any>> = Promise<ReturnResult<any, any>>> = (...args: TInput) => TResult;

package/build/result.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.types.js.map

package/build/result.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.types.js","sourceRoot":"","sources":["../src/result.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Err } from \"./err.js\";\nimport type { Ok } from \"./ok.js\";\n\nexport type ResultErrorDefinition<TType, TContext> = {\n\ttype: TType;\n\tcontext: TContext;\n};\n\nexport type ReturnResult<TValue, TError extends ResultErrorDefinition<any, any>> =\n\t| Ok<TValue>\n\t| Err<TError[\"type\"], TError[\"context\"]>;\n\nexport type ResultFn<\n\tTInput extends any[] = any[],\n\tTResult extends ReturnResult<any, any> = ReturnResult<any, any>\n> = (...args: TInput) => TResult;\n\nexport type ResultAsyncFn<\n\tTInput extends any[] = any[],\n\tTResult extends Promise<ReturnResult<any, any>> = Promise<ReturnResult<any, any>>\n> = (...args: TInput) => TResult;\n"]}

package/build/zod.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const OkSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    value: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    value?: any;
+}, {
+    ok: true;
+    value?: any;
+}>;
+export declare const ErrSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    type: z.ZodAny;
+    context: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    ok: false;
+    type?: any;
+    context?: any;
+}, {
+    ok: false;
+    type?: any;
+    context?: any;
+}>;
+export declare const ReturnResultSchema: z.ZodUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    value: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    value?: any;
+}, {
+    ok: true;
+    value?: any;
+}>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    type: z.ZodAny;
+    context: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    ok: false;
+    type?: any;
+    context?: any;
+}, {
+    ok: false;
+    type?: any;
+    context?: any;
+}>]>;

package/build/zod.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export const OkSchema = z.object({
+    ok: z.literal(true),
+    value: z.any()
+});
+export const ErrSchema = z.object({
+    ok: z.literal(false),
+    type: z.any(),
+    context: z.any()
+});
+export const ReturnResultSchema = z.union([OkSchema, ErrSchema]);
+//# sourceMappingURL=zod.js.map

package/build/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAmB,MAAM,KAAK,CAAC;AAKzC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;CAC8B,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;CACkC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC","sourcesContent":["import { z, type ZodTypeAny } from \"zod\";\n\nimport type { Err } from \"./err.js\";\nimport type { Ok } from \"./ok.js\";\n\nexport const OkSchema = z.object({\n\tok: z.literal(true),\n\tvalue: z.any()\n} satisfies Record<keyof Ok<any>, ZodTypeAny>);\n\nexport const ErrSchema = z.object({\n\tok: z.literal(false),\n\ttype: z.any(),\n\tcontext: z.any()\n} satisfies Record<keyof Err<any, any>, ZodTypeAny>);\n\nexport const ReturnResultSchema = z.union([OkSchema, ErrSchema]);\n"]}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@l3dev/result",
+  "version": "0.2.1",
+  "description": "Type-safe result-based error handling",
+  "type": "module",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "import": "./build/index.js"
+    },
+    "./zod": {
+      "types": "./build/zod.d.ts",
+      "import": "./build/zod.js"
+    }
+  },
+  "files": [
+    "build"
+  ],
+  "author": "l3dotdev",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.25.56"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "package": "pnpm build"
+  }
+}