generic-result-type 2.0.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -17,7 +17,7 @@ This package supports **both ESM and CommonJS** out of the box.
17
17
  ESM:
18
18
 
19
19
  ```ts
20
- import { success, fail } from 'generic-result-type';
20
+ import { success, fail, type Result } from 'generic-result-type';
21
21
  ```
22
22
 
23
23
  CommonJS:
@@ -68,6 +68,21 @@ console.log('Value:', result.value);
68
68
 
69
69
  TypeScript will correctly narrow the type inside each branch without casting.
70
70
 
71
+ ### Mapping
72
+
73
+ You can map the value or the error of a Result with these methods:
74
+
75
+ * map
76
+ * mapErr
77
+ * mapAsync
78
+ * mapErrAsync
79
+
80
+ ```ts
81
+ const numberResult = getSomeNumberResult().map(x => x * 2);
82
+
83
+ const responseResult = await getSomeStringResult().mapAsync(async x => fetch(x));
84
+ ```
85
+
71
86
  ## License
72
87
 
73
88
  ISC
package/dist/index.cjs CHANGED
@@ -22,6 +22,7 @@ var index_exports = {};
22
22
  __export(index_exports, {
23
23
  combine: () => combine,
24
24
  fail: () => fail,
25
+ flatten: () => flatten,
25
26
  isErrorResult: () => isErrorResult,
26
27
  isSuccessResult: () => isSuccessResult,
27
28
  success: () => success
@@ -34,20 +35,42 @@ var ErrorResult = class _ErrorResult {
34
35
  this.error = error;
35
36
  this.success = false;
36
37
  }
38
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters
37
39
  map(mapFunction) {
40
+ return new _ErrorResult(this.error);
41
+ }
42
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async
43
+ mapAsync(mapFunction) {
44
+ return Promise.resolve(new _ErrorResult(this.error));
45
+ }
46
+ mapErr(mapFunction) {
38
47
  return new _ErrorResult(mapFunction(this.error));
39
48
  }
49
+ async mapErrAsync(mapFunction) {
50
+ return new _ErrorResult(await mapFunction(this.error));
51
+ }
40
52
  };
41
53
 
42
54
  // src/successResult.mts
43
55
  var SuccessResult = class _SuccessResult {
44
56
  constructor(value) {
45
- this.value = value;
46
57
  this.success = true;
58
+ this.value = value;
47
59
  }
48
60
  map(mapFunction) {
49
61
  return new _SuccessResult(mapFunction(this.value));
50
62
  }
63
+ async mapAsync(mapFunction) {
64
+ return new _SuccessResult(await mapFunction(this.value));
65
+ }
66
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters
67
+ mapErr(mapFunction) {
68
+ return new _SuccessResult(this.value);
69
+ }
70
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async
71
+ mapErrAsync(mapFunction) {
72
+ return Promise.resolve(new _SuccessResult(this.value));
73
+ }
51
74
  };
52
75
 
53
76
  // src/index.mts
@@ -63,18 +86,54 @@ var isSuccessResult = (result) => {
63
86
  var isErrorResult = (result) => {
64
87
  return !result.success;
65
88
  };
66
- function combine(...results) {
89
+ function combine(results) {
90
+ const values = [];
91
+ const errors = [];
67
92
  for (const r of results) {
68
- if (!r.success) {
69
- return r;
93
+ if (r.success) {
94
+ values.push(r.value);
95
+ } else {
96
+ errors.push(r.error);
70
97
  }
71
98
  }
72
- return new SuccessResult(void 0);
99
+ if (errors.length) {
100
+ return new ErrorResult(errors);
101
+ }
102
+ return new SuccessResult(values);
73
103
  }
104
+ var flatten = (result) => {
105
+ if (isSuccessResult(result)) {
106
+ return getValue(result);
107
+ }
108
+ return getError(result);
109
+ };
110
+ var getValue = (result) => {
111
+ if (result.value instanceof SuccessResult) {
112
+ return getValue(result.value);
113
+ }
114
+ if (result.value instanceof ErrorResult) {
115
+ return getError(result.value);
116
+ }
117
+ return result;
118
+ };
119
+ var getError = (result) => {
120
+ if (result.error instanceof SuccessResult) {
121
+ const value = getValue(result.error);
122
+ if (isSuccessResult(value)) {
123
+ return fail(value);
124
+ }
125
+ return value;
126
+ }
127
+ if (result.error instanceof ErrorResult) {
128
+ return getError(result.error);
129
+ }
130
+ return result;
131
+ };
74
132
  // Annotate the CommonJS export names for ESM import in node:
75
133
  0 && (module.exports = {
76
134
  combine,
77
135
  fail,
136
+ flatten,
78
137
  isErrorResult,
79
138
  isSuccessResult,
80
139
  success
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.mts","../src/errorResult.mts","../src/successResult.mts"],"sourcesContent":["import type { IErrorResult } from './errorResult.mjs';\nimport { ErrorResult } from './errorResult.mjs';\nimport type { ISuccessResult } from './successResult.mjs';\nimport { SuccessResult } from './successResult.mjs';\n\nexport type { ISuccessResult };\nexport type { IErrorResult };\n\nexport type ResultType<T = void, E = Error> = ISuccessResult<T> | IErrorResult<E>;\n\nexport function success(): ISuccessResult;\nexport function success<T>(value: T): ISuccessResult<T>;\nexport function success<T>(value?: T): ISuccessResult<T> {\n return new SuccessResult(value as T);\n};\n\nexport function fail<E>(error: E): IErrorResult<E> {\n return new ErrorResult(error);\n}\n\nexport const isSuccessResult = <T, E = Error>(result: ResultType<T, E>): result is ISuccessResult<T> => {\n return result.success;\n};\n\nexport const isErrorResult = <T, E = Error>(result: ResultType<T, E>): result is IErrorResult<E> => {\n return !result.success;\n};\n\nexport function combine(...results: ResultType[]): ResultType {\n for (const r of results) {\n if (!r.success) {\n return r;\n }\n }\n return new SuccessResult(undefined);\n}\n","export interface IErrorResult<E = Error> {\n readonly success: false;\n readonly error: E;\n readonly map: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;\n}\n\nexport class ErrorResult<E> implements IErrorResult<E> {\n public readonly success = false as const;\n\n public constructor(public readonly error: E) { /* empty */ }\n\n public map<M>(mapFunction: (error: E) => M): ErrorResult<M> {\n return new ErrorResult(mapFunction(this.error));\n }\n}\n","export interface ISuccessResult<T = void> {\n readonly success: true;\n readonly value: T;\n readonly map: <M>(mapFunction: (value: T) => M) => ISuccessResult<M>;\n}\n\nexport class SuccessResult<T = void> implements ISuccessResult<T> {\n public readonly success = true as const;\n\n public constructor(public readonly value: T) { /* empty */ }\n\n public map<M>(mapFunction: (value: T) => M): SuccessResult<M> {\n return new SuccessResult(mapFunction(this.value));\n }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,cAAN,MAAM,aAA0C;AAAA,EAG9C,YAA4B,OAAU;AAAV;AAFnC,SAAgB,UAAU;AAAA,EAEiC;AAAA,EAEpD,IAAO,aAA8C;AAC1D,WAAO,IAAI,aAAY,YAAY,KAAK,KAAK,CAAC;AAAA,EAChD;AACF;;;ACRO,IAAM,gBAAN,MAAM,eAAqD;AAAA,EAGzD,YAA4B,OAAU;AAAV;AAFnC,SAAgB,UAAU;AAAA,EAEiC;AAAA,EAEpD,IAAO,aAAgD;AAC5D,WAAO,IAAI,eAAc,YAAY,KAAK,KAAK,CAAC;AAAA,EAClD;AACF;;;AFFO,SAAS,QAAW,OAA8B;AACvD,SAAO,IAAI,cAAc,KAAU;AACrC;AAEO,SAAS,KAAQ,OAA2B;AACjD,SAAO,IAAI,YAAY,KAAK;AAC9B;AAEO,IAAM,kBAAkB,CAAe,WAA0D;AACtG,SAAO,OAAO;AAChB;AAEO,IAAM,gBAAgB,CAAe,WAAwD;AAClG,SAAO,CAAC,OAAO;AACjB;AAEO,SAAS,WAAW,SAAmC;AAC5D,aAAW,KAAK,SAAS;AACvB,QAAI,CAAC,EAAE,SAAS;AACd,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,IAAI,cAAc,MAAS;AACpC;","names":[]}
1
+ {"version":3,"sources":["../src/index.mts","../src/errorResult.mts","../src/successResult.mts"],"sourcesContent":["import type { IErrorResult } from './errorResult.mjs';\nimport { ErrorResult } from './errorResult.mjs';\nimport type { Result } from './result.mjs';\nimport type { ISuccessResult } from './successResult.mjs';\nimport { SuccessResult } from './successResult.mjs';\n\nexport type { Result, ISuccessResult, IErrorResult };\n\nexport function success(): ISuccessResult;\nexport function success<T>(value: T): ISuccessResult<T>;\nexport function success<T>(value?: T): ISuccessResult<T> {\n return new SuccessResult(value as T);\n};\n\nexport function fail<E>(error: E): IErrorResult<E> {\n return new ErrorResult(error);\n}\n\nexport const isSuccessResult = <T, E = Error>(result: Result<T, E>): result is ISuccessResult<T> => {\n return result.success;\n};\n\nexport const isErrorResult = <T, E = Error>(result: Result<T, E>): result is IErrorResult<E> => {\n return !result.success;\n};\n\nexport function combine(results: Result<unknown, unknown>[]): Result<unknown[], unknown[]> {\n const values: unknown[] = [];\n const errors: unknown[] = [];\n\n for (const r of results) {\n if (r.success) {\n values.push(r.value);\n } else {\n errors.push(r.error);\n }\n }\n\n if (errors.length) {\n return new ErrorResult(errors);\n }\n return new SuccessResult(values);\n}\n\nexport const flatten = (result: Result<unknown, unknown>): Result<unknown, unknown> => {\n if (isSuccessResult(result)) {\n return getValue(result);\n }\n return getError(result);\n};\n\nconst getValue = (result: SuccessResult<unknown>): Result<unknown, unknown> => {\n // value is a SuccessResult, drill down\n if (result.value instanceof SuccessResult) {\n return getValue(result.value);\n }\n\n // value is an ErrorResult, drill down\n if (result.value instanceof ErrorResult) {\n return getError(result.value);\n }\n\n // value is not a Result, return current SuccessResult\n return result;\n};\n\nconst getError = (result: ErrorResult<unknown>): ErrorResult<unknown> => {\n // error is a SuccessResult, consider this SuccessResult's value\n if (result.error instanceof SuccessResult) {\n const value = getValue(result.error);\n\n // if the value is a SuccessResult, swallow it into an error\n if (isSuccessResult(value)) {\n return fail(value);\n }\n\n // otherwise the value is an ErrorResult, return it\n return value;\n }\n\n // error is an ErrorResult, swallow it\n if (result.error instanceof ErrorResult) {\n return getError(result.error);\n }\n\n // error is not a Result, the current ErrorResult\n return result;\n};\n","import type { IResult } from './result.mjs';\n\nexport interface IErrorResult<E = Error> extends IResult<never, E> {\n readonly success: false;\n readonly error: E;\n\n /**\n * Returns a new `ErrorResult` with the same `error` property as this one.\n *\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\n readonly map: <M>(mapFunction: (value: never) => M) => IErrorResult<E>;\n\n /**\n * Asynchronously returns a new `ErrorResult` with the same `error` property as this one.\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n readonly mapAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<IErrorResult<E>>;\n\n /**\n * Calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.\n *\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n readonly mapErr: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;\n\n /**\n * Asynchronously calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.\n *\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n readonly mapErrAsync: <M>(mapFunction: (value: E) => Promise<M>) => Promise<IErrorResult<M>>;\n}\n\nexport class ErrorResult<E> implements IResult<never, E>, IErrorResult<E> {\n public readonly success = false as const;\n\n public constructor(public readonly error: E) { /* empty */ }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters\n public map<M>(mapFunction: (error: never) => M): ErrorResult<E> {\n return new ErrorResult(this.error);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async\n public mapAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<ErrorResult<E>> {\n return Promise.resolve(new ErrorResult(this.error));\n }\n\n public mapErr<M>(mapFunction: (error: E) => M): ErrorResult<M> {\n return new ErrorResult(mapFunction(this.error));\n }\n\n public async mapErrAsync<M>(mapFunction: (value: E) => Promise<M>): Promise<ErrorResult<M>> {\n return new ErrorResult(await mapFunction(this.error));\n }\n}\n","import type { IResult } from './result.mjs';\n\nexport interface ISuccessResult<T = void> {\n readonly success: true;\n readonly value: T;\n\n /**\n * Calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.\n *\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n readonly map: <M>(mapFunction: (value: T) => M) => ISuccessResult<M>;\n\n /**\n * Asynchronously calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n readonly mapAsync: <M>(mapFunction: (value: T) => Promise<M>) => Promise<ISuccessResult<M>>;\n\n /**\n * Returns a new `SuccessResult` with the same `value` property as this one.\n *\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\n readonly mapErr: <M>(mapFunction: (value: never) => M) => ISuccessResult<T>;\n\n /**\n * Asynchronously returns a new `SuccessResult` with the same `value` property as this one.\n *\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n readonly mapErrAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<ISuccessResult<T>>;\n}\n\nexport class SuccessResult<T = void> implements IResult<T, never>, ISuccessResult<T> {\n public readonly success = true as const;\n public readonly value: T;\n\n public constructor(value?: T) {\n this.value = value as T;\n }\n\n public map<M>(mapFunction: (value: T) => M): SuccessResult<M> {\n return new SuccessResult(mapFunction(this.value));\n }\n\n public async mapAsync<M>(mapFunction: (value: T) => Promise<M>): Promise<SuccessResult<M>> {\n return new SuccessResult(await mapFunction(this.value));\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters\n public mapErr<M>(mapFunction: (error: never) => M): SuccessResult<T> {\n return new SuccessResult(this.value);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async\n public mapErrAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<SuccessResult<T>> {\n return Promise.resolve(new SuccessResult(this.value));\n }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuCO,IAAM,cAAN,MAAM,aAA6D;AAAA,EAGjE,YAA4B,OAAU;AAAV;AAFnC,SAAgB,UAAU;AAAA,EAEiC;AAAA;AAAA,EAGpD,IAAO,aAAkD;AAC9D,WAAO,IAAI,aAAY,KAAK,KAAK;AAAA,EACnC;AAAA;AAAA,EAGO,SAAY,aAAoE;AACrF,WAAO,QAAQ,QAAQ,IAAI,aAAY,KAAK,KAAK,CAAC;AAAA,EACpD;AAAA,EAEO,OAAU,aAA8C;AAC7D,WAAO,IAAI,aAAY,YAAY,KAAK,KAAK,CAAC;AAAA,EAChD;AAAA,EAEA,MAAa,YAAe,aAAgE;AAC1F,WAAO,IAAI,aAAY,MAAM,YAAY,KAAK,KAAK,CAAC;AAAA,EACtD;AACF;;;ACtBO,IAAM,gBAAN,MAAM,eAAwE;AAAA,EAI5E,YAAY,OAAW;AAH9B,SAAgB,UAAU;AAIxB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEO,IAAO,aAAgD;AAC5D,WAAO,IAAI,eAAc,YAAY,KAAK,KAAK,CAAC;AAAA,EAClD;AAAA,EAEA,MAAa,SAAY,aAAkE;AACzF,WAAO,IAAI,eAAc,MAAM,YAAY,KAAK,KAAK,CAAC;AAAA,EACxD;AAAA;AAAA,EAGO,OAAU,aAAoD;AACnE,WAAO,IAAI,eAAc,KAAK,KAAK;AAAA,EACrC;AAAA;AAAA,EAGO,YAAe,aAAsE;AAC1F,WAAO,QAAQ,QAAQ,IAAI,eAAc,KAAK,KAAK,CAAC;AAAA,EACtD;AACF;;;AFtDO,SAAS,QAAW,OAA8B;AACvD,SAAO,IAAI,cAAc,KAAU;AACrC;AAEO,SAAS,KAAQ,OAA2B;AACjD,SAAO,IAAI,YAAY,KAAK;AAC9B;AAEO,IAAM,kBAAkB,CAAe,WAAsD;AAClG,SAAO,OAAO;AAChB;AAEO,IAAM,gBAAgB,CAAe,WAAoD;AAC9F,SAAO,CAAC,OAAO;AACjB;AAEO,SAAS,QAAQ,SAAmE;AACzF,QAAM,SAAoB,CAAC;AAC3B,QAAM,SAAoB,CAAC;AAE3B,aAAW,KAAK,SAAS;AACvB,QAAI,EAAE,SAAS;AACb,aAAO,KAAK,EAAE,KAAK;AAAA,IACrB,OAAO;AACL,aAAO,KAAK,EAAE,KAAK;AAAA,IACrB;AAAA,EACF;AAEA,MAAI,OAAO,QAAQ;AACjB,WAAO,IAAI,YAAY,MAAM;AAAA,EAC/B;AACA,SAAO,IAAI,cAAc,MAAM;AACjC;AAEO,IAAM,UAAU,CAAC,WAA+D;AACrF,MAAI,gBAAgB,MAAM,GAAG;AAC3B,WAAO,SAAS,MAAM;AAAA,EACxB;AACA,SAAO,SAAS,MAAM;AACxB;AAEA,IAAM,WAAW,CAAC,WAA6D;AAE7E,MAAI,OAAO,iBAAiB,eAAe;AACzC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AAGA,MAAI,OAAO,iBAAiB,aAAa;AACvC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AAGA,SAAO;AACT;AAEA,IAAM,WAAW,CAAC,WAAuD;AAEvE,MAAI,OAAO,iBAAiB,eAAe;AACzC,UAAM,QAAQ,SAAS,OAAO,KAAK;AAGnC,QAAI,gBAAgB,KAAK,GAAG;AAC1B,aAAO,KAAK,KAAK;AAAA,IACnB;AAGA,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,iBAAiB,aAAa;AACvC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AAGA,SAAO;AACT;","names":[]}
package/dist/index.d.cts CHANGED
@@ -1,21 +1,127 @@
1
- interface IErrorResult<E = Error> {
2
- readonly success: false;
3
- readonly error: E;
4
- readonly map: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;
5
- }
6
-
7
1
  interface ISuccessResult<T = void> {
8
2
  readonly success: true;
9
3
  readonly value: T;
4
+ /**
5
+ * Calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
6
+ *
7
+ * @param mapFunction the mapping function
8
+ * @returns a new `SuccessResult`
9
+ */
10
10
  readonly map: <M>(mapFunction: (value: T) => M) => ISuccessResult<M>;
11
+ /**
12
+ * Asynchronously calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
13
+ * @param mapFunction the mapping function
14
+ * @returns a new `SuccessResult`
15
+ */
16
+ readonly mapAsync: <M>(mapFunction: (value: T) => Promise<M>) => Promise<ISuccessResult<M>>;
17
+ /**
18
+ * Returns a new `SuccessResult` with the same `value` property as this one.
19
+ *
20
+ * @param mapFunction the mapping function
21
+ * @returns a new `SuccessResult`
22
+ */
23
+ readonly mapErr: <M>(mapFunction: (value: never) => M) => ISuccessResult<T>;
24
+ /**
25
+ * Asynchronously returns a new `SuccessResult` with the same `value` property as this one.
26
+ *
27
+ * @param mapFunction the mapping function
28
+ * @returns a new `SuccessResult`
29
+ */
30
+ readonly mapErrAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<ISuccessResult<T>>;
31
+ }
32
+ declare class SuccessResult<T = void> implements IResult<T, never>, ISuccessResult<T> {
33
+ readonly success: true;
34
+ readonly value: T;
35
+ constructor(value?: T);
36
+ map<M>(mapFunction: (value: T) => M): SuccessResult<M>;
37
+ mapAsync<M>(mapFunction: (value: T) => Promise<M>): Promise<SuccessResult<M>>;
38
+ mapErr<M>(mapFunction: (error: never) => M): SuccessResult<T>;
39
+ mapErrAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<SuccessResult<T>>;
40
+ }
41
+
42
+ interface IResult<T, E> {
43
+ readonly success: boolean;
44
+ /**
45
+ * If a `SuccessResult`, calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
46
+ * If an `ErrorResult`, returns a new `ErrorResult` with the same `error` property as this one.
47
+ *
48
+ * @param mapFunction the mapping function
49
+ * @returns a new `Result`
50
+ */
51
+ map: <M>(fn: (value: T) => M) => IResult<M, E>;
52
+ /**
53
+ * If a `SuccessResult`, asynchronously calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
54
+ * If an `ErrorResult`, asynchronously returns a new `ErrorResult` with the same `error` property as this one.
55
+ * @param mapFunction the mapping function
56
+ * @returns a new `Result`
57
+ */
58
+ mapAsync: <M>(fn: (value: T) => Promise<M>) => Promise<IResult<M, E>>;
59
+ /**
60
+ * If a `SuccessResult`, returns a new `SuccessResult` with the same `value` property as this one.
61
+ * If an `ErrorResult`, calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
62
+ *
63
+ * @param mapFunction the mapping function
64
+ * @returns a new `Result`
65
+ */
66
+ mapErr: <M>(fn: (error: E) => M) => IResult<T, M>;
67
+ /**
68
+ * If a `SuccessResult`, asynchronously returns a new `SuccessResult` with the same `value` property as this one.
69
+ * If an `ErrorResult`, asynchronously calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
70
+ *
71
+ * @param mapFunction the mapping function
72
+ * @returns a new `Result`
73
+ */
74
+ mapErrAsync: <M>(fn: (error: E) => Promise<M>) => Promise<IResult<T, M>>;
75
+ }
76
+ type Result<T = void, E = Error> = SuccessResult<T> | ErrorResult<E>;
77
+
78
+ interface IErrorResult<E = Error> extends IResult<never, E> {
79
+ readonly success: false;
80
+ readonly error: E;
81
+ /**
82
+ * Returns a new `ErrorResult` with the same `error` property as this one.
83
+ *
84
+ * @param mapFunction the mapping function
85
+ * @returns a new `ErrorResult`
86
+ */
87
+ readonly map: <M>(mapFunction: (value: never) => M) => IErrorResult<E>;
88
+ /**
89
+ * Asynchronously returns a new `ErrorResult` with the same `error` property as this one.
90
+ * @param mapFunction the mapping function
91
+ * @returns a new `ErrorResult`
92
+ */
93
+ readonly mapAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<IErrorResult<E>>;
94
+ /**
95
+ * Calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
96
+ *
97
+ * @param mapFunction the mapping function
98
+ * @returns a new `ErrorResult`
99
+ */
100
+ readonly mapErr: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;
101
+ /**
102
+ * Asynchronously calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
103
+ *
104
+ * @param mapFunction the mapping function
105
+ * @returns a new `ErrorResult`
106
+ */
107
+ readonly mapErrAsync: <M>(mapFunction: (value: E) => Promise<M>) => Promise<IErrorResult<M>>;
108
+ }
109
+ declare class ErrorResult<E> implements IResult<never, E>, IErrorResult<E> {
110
+ readonly error: E;
111
+ readonly success: false;
112
+ constructor(error: E);
113
+ map<M>(mapFunction: (error: never) => M): ErrorResult<E>;
114
+ mapAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<ErrorResult<E>>;
115
+ mapErr<M>(mapFunction: (error: E) => M): ErrorResult<M>;
116
+ mapErrAsync<M>(mapFunction: (value: E) => Promise<M>): Promise<ErrorResult<M>>;
11
117
  }
12
118
 
13
- type ResultType<T = void, E = Error> = ISuccessResult<T> | IErrorResult<E>;
14
119
  declare function success(): ISuccessResult;
15
120
  declare function success<T>(value: T): ISuccessResult<T>;
16
121
  declare function fail<E>(error: E): IErrorResult<E>;
17
- declare const isSuccessResult: <T, E = Error>(result: ResultType<T, E>) => result is ISuccessResult<T>;
18
- declare const isErrorResult: <T, E = Error>(result: ResultType<T, E>) => result is IErrorResult<E>;
19
- declare function combine(...results: ResultType[]): ResultType;
122
+ declare const isSuccessResult: <T, E = Error>(result: Result<T, E>) => result is ISuccessResult<T>;
123
+ declare const isErrorResult: <T, E = Error>(result: Result<T, E>) => result is IErrorResult<E>;
124
+ declare function combine(results: Result<unknown, unknown>[]): Result<unknown[], unknown[]>;
125
+ declare const flatten: (result: Result<unknown, unknown>) => Result<unknown, unknown>;
20
126
 
21
- export { type IErrorResult, type ISuccessResult, type ResultType, combine, fail, isErrorResult, isSuccessResult, success };
127
+ export { type IErrorResult, type ISuccessResult, type Result, combine, fail, flatten, isErrorResult, isSuccessResult, success };
package/dist/index.d.ts CHANGED
@@ -1,21 +1,127 @@
1
- interface IErrorResult<E = Error> {
2
- readonly success: false;
3
- readonly error: E;
4
- readonly map: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;
5
- }
6
-
7
1
  interface ISuccessResult<T = void> {
8
2
  readonly success: true;
9
3
  readonly value: T;
4
+ /**
5
+ * Calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
6
+ *
7
+ * @param mapFunction the mapping function
8
+ * @returns a new `SuccessResult`
9
+ */
10
10
  readonly map: <M>(mapFunction: (value: T) => M) => ISuccessResult<M>;
11
+ /**
12
+ * Asynchronously calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
13
+ * @param mapFunction the mapping function
14
+ * @returns a new `SuccessResult`
15
+ */
16
+ readonly mapAsync: <M>(mapFunction: (value: T) => Promise<M>) => Promise<ISuccessResult<M>>;
17
+ /**
18
+ * Returns a new `SuccessResult` with the same `value` property as this one.
19
+ *
20
+ * @param mapFunction the mapping function
21
+ * @returns a new `SuccessResult`
22
+ */
23
+ readonly mapErr: <M>(mapFunction: (value: never) => M) => ISuccessResult<T>;
24
+ /**
25
+ * Asynchronously returns a new `SuccessResult` with the same `value` property as this one.
26
+ *
27
+ * @param mapFunction the mapping function
28
+ * @returns a new `SuccessResult`
29
+ */
30
+ readonly mapErrAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<ISuccessResult<T>>;
31
+ }
32
+ declare class SuccessResult<T = void> implements IResult<T, never>, ISuccessResult<T> {
33
+ readonly success: true;
34
+ readonly value: T;
35
+ constructor(value?: T);
36
+ map<M>(mapFunction: (value: T) => M): SuccessResult<M>;
37
+ mapAsync<M>(mapFunction: (value: T) => Promise<M>): Promise<SuccessResult<M>>;
38
+ mapErr<M>(mapFunction: (error: never) => M): SuccessResult<T>;
39
+ mapErrAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<SuccessResult<T>>;
40
+ }
41
+
42
+ interface IResult<T, E> {
43
+ readonly success: boolean;
44
+ /**
45
+ * If a `SuccessResult`, calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
46
+ * If an `ErrorResult`, returns a new `ErrorResult` with the same `error` property as this one.
47
+ *
48
+ * @param mapFunction the mapping function
49
+ * @returns a new `Result`
50
+ */
51
+ map: <M>(fn: (value: T) => M) => IResult<M, E>;
52
+ /**
53
+ * If a `SuccessResult`, asynchronously calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.
54
+ * If an `ErrorResult`, asynchronously returns a new `ErrorResult` with the same `error` property as this one.
55
+ * @param mapFunction the mapping function
56
+ * @returns a new `Result`
57
+ */
58
+ mapAsync: <M>(fn: (value: T) => Promise<M>) => Promise<IResult<M, E>>;
59
+ /**
60
+ * If a `SuccessResult`, returns a new `SuccessResult` with the same `value` property as this one.
61
+ * If an `ErrorResult`, calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
62
+ *
63
+ * @param mapFunction the mapping function
64
+ * @returns a new `Result`
65
+ */
66
+ mapErr: <M>(fn: (error: E) => M) => IResult<T, M>;
67
+ /**
68
+ * If a `SuccessResult`, asynchronously returns a new `SuccessResult` with the same `value` property as this one.
69
+ * If an `ErrorResult`, asynchronously calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
70
+ *
71
+ * @param mapFunction the mapping function
72
+ * @returns a new `Result`
73
+ */
74
+ mapErrAsync: <M>(fn: (error: E) => Promise<M>) => Promise<IResult<T, M>>;
75
+ }
76
+ type Result<T = void, E = Error> = SuccessResult<T> | ErrorResult<E>;
77
+
78
+ interface IErrorResult<E = Error> extends IResult<never, E> {
79
+ readonly success: false;
80
+ readonly error: E;
81
+ /**
82
+ * Returns a new `ErrorResult` with the same `error` property as this one.
83
+ *
84
+ * @param mapFunction the mapping function
85
+ * @returns a new `ErrorResult`
86
+ */
87
+ readonly map: <M>(mapFunction: (value: never) => M) => IErrorResult<E>;
88
+ /**
89
+ * Asynchronously returns a new `ErrorResult` with the same `error` property as this one.
90
+ * @param mapFunction the mapping function
91
+ * @returns a new `ErrorResult`
92
+ */
93
+ readonly mapAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<IErrorResult<E>>;
94
+ /**
95
+ * Calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
96
+ *
97
+ * @param mapFunction the mapping function
98
+ * @returns a new `ErrorResult`
99
+ */
100
+ readonly mapErr: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;
101
+ /**
102
+ * Asynchronously calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.
103
+ *
104
+ * @param mapFunction the mapping function
105
+ * @returns a new `ErrorResult`
106
+ */
107
+ readonly mapErrAsync: <M>(mapFunction: (value: E) => Promise<M>) => Promise<IErrorResult<M>>;
108
+ }
109
+ declare class ErrorResult<E> implements IResult<never, E>, IErrorResult<E> {
110
+ readonly error: E;
111
+ readonly success: false;
112
+ constructor(error: E);
113
+ map<M>(mapFunction: (error: never) => M): ErrorResult<E>;
114
+ mapAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<ErrorResult<E>>;
115
+ mapErr<M>(mapFunction: (error: E) => M): ErrorResult<M>;
116
+ mapErrAsync<M>(mapFunction: (value: E) => Promise<M>): Promise<ErrorResult<M>>;
11
117
  }
12
118
 
13
- type ResultType<T = void, E = Error> = ISuccessResult<T> | IErrorResult<E>;
14
119
  declare function success(): ISuccessResult;
15
120
  declare function success<T>(value: T): ISuccessResult<T>;
16
121
  declare function fail<E>(error: E): IErrorResult<E>;
17
- declare const isSuccessResult: <T, E = Error>(result: ResultType<T, E>) => result is ISuccessResult<T>;
18
- declare const isErrorResult: <T, E = Error>(result: ResultType<T, E>) => result is IErrorResult<E>;
19
- declare function combine(...results: ResultType[]): ResultType;
122
+ declare const isSuccessResult: <T, E = Error>(result: Result<T, E>) => result is ISuccessResult<T>;
123
+ declare const isErrorResult: <T, E = Error>(result: Result<T, E>) => result is IErrorResult<E>;
124
+ declare function combine(results: Result<unknown, unknown>[]): Result<unknown[], unknown[]>;
125
+ declare const flatten: (result: Result<unknown, unknown>) => Result<unknown, unknown>;
20
126
 
21
- export { type IErrorResult, type ISuccessResult, type ResultType, combine, fail, isErrorResult, isSuccessResult, success };
127
+ export { type IErrorResult, type ISuccessResult, type Result, combine, fail, flatten, isErrorResult, isSuccessResult, success };
package/dist/index.js CHANGED
@@ -4,20 +4,42 @@ var ErrorResult = class _ErrorResult {
4
4
  this.error = error;
5
5
  this.success = false;
6
6
  }
7
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters
7
8
  map(mapFunction) {
9
+ return new _ErrorResult(this.error);
10
+ }
11
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async
12
+ mapAsync(mapFunction) {
13
+ return Promise.resolve(new _ErrorResult(this.error));
14
+ }
15
+ mapErr(mapFunction) {
8
16
  return new _ErrorResult(mapFunction(this.error));
9
17
  }
18
+ async mapErrAsync(mapFunction) {
19
+ return new _ErrorResult(await mapFunction(this.error));
20
+ }
10
21
  };
11
22
 
12
23
  // src/successResult.mts
13
24
  var SuccessResult = class _SuccessResult {
14
25
  constructor(value) {
15
- this.value = value;
16
26
  this.success = true;
27
+ this.value = value;
17
28
  }
18
29
  map(mapFunction) {
19
30
  return new _SuccessResult(mapFunction(this.value));
20
31
  }
32
+ async mapAsync(mapFunction) {
33
+ return new _SuccessResult(await mapFunction(this.value));
34
+ }
35
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters
36
+ mapErr(mapFunction) {
37
+ return new _SuccessResult(this.value);
38
+ }
39
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async
40
+ mapErrAsync(mapFunction) {
41
+ return Promise.resolve(new _SuccessResult(this.value));
42
+ }
21
43
  };
22
44
 
23
45
  // src/index.mts
@@ -33,17 +55,53 @@ var isSuccessResult = (result) => {
33
55
  var isErrorResult = (result) => {
34
56
  return !result.success;
35
57
  };
36
- function combine(...results) {
58
+ function combine(results) {
59
+ const values = [];
60
+ const errors = [];
37
61
  for (const r of results) {
38
- if (!r.success) {
39
- return r;
62
+ if (r.success) {
63
+ values.push(r.value);
64
+ } else {
65
+ errors.push(r.error);
40
66
  }
41
67
  }
42
- return new SuccessResult(void 0);
68
+ if (errors.length) {
69
+ return new ErrorResult(errors);
70
+ }
71
+ return new SuccessResult(values);
43
72
  }
73
+ var flatten = (result) => {
74
+ if (isSuccessResult(result)) {
75
+ return getValue(result);
76
+ }
77
+ return getError(result);
78
+ };
79
+ var getValue = (result) => {
80
+ if (result.value instanceof SuccessResult) {
81
+ return getValue(result.value);
82
+ }
83
+ if (result.value instanceof ErrorResult) {
84
+ return getError(result.value);
85
+ }
86
+ return result;
87
+ };
88
+ var getError = (result) => {
89
+ if (result.error instanceof SuccessResult) {
90
+ const value = getValue(result.error);
91
+ if (isSuccessResult(value)) {
92
+ return fail(value);
93
+ }
94
+ return value;
95
+ }
96
+ if (result.error instanceof ErrorResult) {
97
+ return getError(result.error);
98
+ }
99
+ return result;
100
+ };
44
101
  export {
45
102
  combine,
46
103
  fail,
104
+ flatten,
47
105
  isErrorResult,
48
106
  isSuccessResult,
49
107
  success
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errorResult.mts","../src/successResult.mts","../src/index.mts"],"sourcesContent":["export interface IErrorResult<E = Error> {\n readonly success: false;\n readonly error: E;\n readonly map: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;\n}\n\nexport class ErrorResult<E> implements IErrorResult<E> {\n public readonly success = false as const;\n\n public constructor(public readonly error: E) { /* empty */ }\n\n public map<M>(mapFunction: (error: E) => M): ErrorResult<M> {\n return new ErrorResult(mapFunction(this.error));\n }\n}\n","export interface ISuccessResult<T = void> {\n readonly success: true;\n readonly value: T;\n readonly map: <M>(mapFunction: (value: T) => M) => ISuccessResult<M>;\n}\n\nexport class SuccessResult<T = void> implements ISuccessResult<T> {\n public readonly success = true as const;\n\n public constructor(public readonly value: T) { /* empty */ }\n\n public map<M>(mapFunction: (value: T) => M): SuccessResult<M> {\n return new SuccessResult(mapFunction(this.value));\n }\n};\n","import type { IErrorResult } from './errorResult.mjs';\nimport { ErrorResult } from './errorResult.mjs';\nimport type { ISuccessResult } from './successResult.mjs';\nimport { SuccessResult } from './successResult.mjs';\n\nexport type { ISuccessResult };\nexport type { IErrorResult };\n\nexport type ResultType<T = void, E = Error> = ISuccessResult<T> | IErrorResult<E>;\n\nexport function success(): ISuccessResult;\nexport function success<T>(value: T): ISuccessResult<T>;\nexport function success<T>(value?: T): ISuccessResult<T> {\n return new SuccessResult(value as T);\n};\n\nexport function fail<E>(error: E): IErrorResult<E> {\n return new ErrorResult(error);\n}\n\nexport const isSuccessResult = <T, E = Error>(result: ResultType<T, E>): result is ISuccessResult<T> => {\n return result.success;\n};\n\nexport const isErrorResult = <T, E = Error>(result: ResultType<T, E>): result is IErrorResult<E> => {\n return !result.success;\n};\n\nexport function combine(...results: ResultType[]): ResultType {\n for (const r of results) {\n if (!r.success) {\n return r;\n }\n }\n return new SuccessResult(undefined);\n}\n"],"mappings":";AAMO,IAAM,cAAN,MAAM,aAA0C;AAAA,EAG9C,YAA4B,OAAU;AAAV;AAFnC,SAAgB,UAAU;AAAA,EAEiC;AAAA,EAEpD,IAAO,aAA8C;AAC1D,WAAO,IAAI,aAAY,YAAY,KAAK,KAAK,CAAC;AAAA,EAChD;AACF;;;ACRO,IAAM,gBAAN,MAAM,eAAqD;AAAA,EAGzD,YAA4B,OAAU;AAAV;AAFnC,SAAgB,UAAU;AAAA,EAEiC;AAAA,EAEpD,IAAO,aAAgD;AAC5D,WAAO,IAAI,eAAc,YAAY,KAAK,KAAK,CAAC;AAAA,EAClD;AACF;;;ACFO,SAAS,QAAW,OAA8B;AACvD,SAAO,IAAI,cAAc,KAAU;AACrC;AAEO,SAAS,KAAQ,OAA2B;AACjD,SAAO,IAAI,YAAY,KAAK;AAC9B;AAEO,IAAM,kBAAkB,CAAe,WAA0D;AACtG,SAAO,OAAO;AAChB;AAEO,IAAM,gBAAgB,CAAe,WAAwD;AAClG,SAAO,CAAC,OAAO;AACjB;AAEO,SAAS,WAAW,SAAmC;AAC5D,aAAW,KAAK,SAAS;AACvB,QAAI,CAAC,EAAE,SAAS;AACd,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,IAAI,cAAc,MAAS;AACpC;","names":[]}
1
+ {"version":3,"sources":["../src/errorResult.mts","../src/successResult.mts","../src/index.mts"],"sourcesContent":["import type { IResult } from './result.mjs';\n\nexport interface IErrorResult<E = Error> extends IResult<never, E> {\n readonly success: false;\n readonly error: E;\n\n /**\n * Returns a new `ErrorResult` with the same `error` property as this one.\n *\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\n readonly map: <M>(mapFunction: (value: never) => M) => IErrorResult<E>;\n\n /**\n * Asynchronously returns a new `ErrorResult` with the same `error` property as this one.\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n readonly mapAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<IErrorResult<E>>;\n\n /**\n * Calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.\n *\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n readonly mapErr: <M>(mapFunction: (value: E) => M) => IErrorResult<M>;\n\n /**\n * Asynchronously calls a defined callback function on the `error` property, and returns a new `ErrorResult` with the resulting value.\n *\n * @param mapFunction the mapping function\n * @returns a new `ErrorResult`\n */\n readonly mapErrAsync: <M>(mapFunction: (value: E) => Promise<M>) => Promise<IErrorResult<M>>;\n}\n\nexport class ErrorResult<E> implements IResult<never, E>, IErrorResult<E> {\n public readonly success = false as const;\n\n public constructor(public readonly error: E) { /* empty */ }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters\n public map<M>(mapFunction: (error: never) => M): ErrorResult<E> {\n return new ErrorResult(this.error);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async\n public mapAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<ErrorResult<E>> {\n return Promise.resolve(new ErrorResult(this.error));\n }\n\n public mapErr<M>(mapFunction: (error: E) => M): ErrorResult<M> {\n return new ErrorResult(mapFunction(this.error));\n }\n\n public async mapErrAsync<M>(mapFunction: (value: E) => Promise<M>): Promise<ErrorResult<M>> {\n return new ErrorResult(await mapFunction(this.error));\n }\n}\n","import type { IResult } from './result.mjs';\n\nexport interface ISuccessResult<T = void> {\n readonly success: true;\n readonly value: T;\n\n /**\n * Calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.\n *\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n readonly map: <M>(mapFunction: (value: T) => M) => ISuccessResult<M>;\n\n /**\n * Asynchronously calls a defined callback function on the `value` property, and returns a new `SuccessResult` with the resulting value.\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n readonly mapAsync: <M>(mapFunction: (value: T) => Promise<M>) => Promise<ISuccessResult<M>>;\n\n /**\n * Returns a new `SuccessResult` with the same `value` property as this one.\n *\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\n readonly mapErr: <M>(mapFunction: (value: never) => M) => ISuccessResult<T>;\n\n /**\n * Asynchronously returns a new `SuccessResult` with the same `value` property as this one.\n *\n * @param mapFunction the mapping function\n * @returns a new `SuccessResult`\n */\n readonly mapErrAsync: <M>(mapFunction: (value: never) => Promise<M>) => Promise<ISuccessResult<T>>;\n}\n\nexport class SuccessResult<T = void> implements IResult<T, never>, ISuccessResult<T> {\n public readonly success = true as const;\n public readonly value: T;\n\n public constructor(value?: T) {\n this.value = value as T;\n }\n\n public map<M>(mapFunction: (value: T) => M): SuccessResult<M> {\n return new SuccessResult(mapFunction(this.value));\n }\n\n public async mapAsync<M>(mapFunction: (value: T) => Promise<M>): Promise<SuccessResult<M>> {\n return new SuccessResult(await mapFunction(this.value));\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unnecessary-type-parameters\n public mapErr<M>(mapFunction: (error: never) => M): SuccessResult<T> {\n return new SuccessResult(this.value);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/promise-function-async\n public mapErrAsync<M>(mapFunction: (value: never) => Promise<M>): Promise<SuccessResult<T>> {\n return Promise.resolve(new SuccessResult(this.value));\n }\n};\n","import type { IErrorResult } from './errorResult.mjs';\nimport { ErrorResult } from './errorResult.mjs';\nimport type { Result } from './result.mjs';\nimport type { ISuccessResult } from './successResult.mjs';\nimport { SuccessResult } from './successResult.mjs';\n\nexport type { Result, ISuccessResult, IErrorResult };\n\nexport function success(): ISuccessResult;\nexport function success<T>(value: T): ISuccessResult<T>;\nexport function success<T>(value?: T): ISuccessResult<T> {\n return new SuccessResult(value as T);\n};\n\nexport function fail<E>(error: E): IErrorResult<E> {\n return new ErrorResult(error);\n}\n\nexport const isSuccessResult = <T, E = Error>(result: Result<T, E>): result is ISuccessResult<T> => {\n return result.success;\n};\n\nexport const isErrorResult = <T, E = Error>(result: Result<T, E>): result is IErrorResult<E> => {\n return !result.success;\n};\n\nexport function combine(results: Result<unknown, unknown>[]): Result<unknown[], unknown[]> {\n const values: unknown[] = [];\n const errors: unknown[] = [];\n\n for (const r of results) {\n if (r.success) {\n values.push(r.value);\n } else {\n errors.push(r.error);\n }\n }\n\n if (errors.length) {\n return new ErrorResult(errors);\n }\n return new SuccessResult(values);\n}\n\nexport const flatten = (result: Result<unknown, unknown>): Result<unknown, unknown> => {\n if (isSuccessResult(result)) {\n return getValue(result);\n }\n return getError(result);\n};\n\nconst getValue = (result: SuccessResult<unknown>): Result<unknown, unknown> => {\n // value is a SuccessResult, drill down\n if (result.value instanceof SuccessResult) {\n return getValue(result.value);\n }\n\n // value is an ErrorResult, drill down\n if (result.value instanceof ErrorResult) {\n return getError(result.value);\n }\n\n // value is not a Result, return current SuccessResult\n return result;\n};\n\nconst getError = (result: ErrorResult<unknown>): ErrorResult<unknown> => {\n // error is a SuccessResult, consider this SuccessResult's value\n if (result.error instanceof SuccessResult) {\n const value = getValue(result.error);\n\n // if the value is a SuccessResult, swallow it into an error\n if (isSuccessResult(value)) {\n return fail(value);\n }\n\n // otherwise the value is an ErrorResult, return it\n return value;\n }\n\n // error is an ErrorResult, swallow it\n if (result.error instanceof ErrorResult) {\n return getError(result.error);\n }\n\n // error is not a Result, the current ErrorResult\n return result;\n};\n"],"mappings":";AAuCO,IAAM,cAAN,MAAM,aAA6D;AAAA,EAGjE,YAA4B,OAAU;AAAV;AAFnC,SAAgB,UAAU;AAAA,EAEiC;AAAA;AAAA,EAGpD,IAAO,aAAkD;AAC9D,WAAO,IAAI,aAAY,KAAK,KAAK;AAAA,EACnC;AAAA;AAAA,EAGO,SAAY,aAAoE;AACrF,WAAO,QAAQ,QAAQ,IAAI,aAAY,KAAK,KAAK,CAAC;AAAA,EACpD;AAAA,EAEO,OAAU,aAA8C;AAC7D,WAAO,IAAI,aAAY,YAAY,KAAK,KAAK,CAAC;AAAA,EAChD;AAAA,EAEA,MAAa,YAAe,aAAgE;AAC1F,WAAO,IAAI,aAAY,MAAM,YAAY,KAAK,KAAK,CAAC;AAAA,EACtD;AACF;;;ACtBO,IAAM,gBAAN,MAAM,eAAwE;AAAA,EAI5E,YAAY,OAAW;AAH9B,SAAgB,UAAU;AAIxB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEO,IAAO,aAAgD;AAC5D,WAAO,IAAI,eAAc,YAAY,KAAK,KAAK,CAAC;AAAA,EAClD;AAAA,EAEA,MAAa,SAAY,aAAkE;AACzF,WAAO,IAAI,eAAc,MAAM,YAAY,KAAK,KAAK,CAAC;AAAA,EACxD;AAAA;AAAA,EAGO,OAAU,aAAoD;AACnE,WAAO,IAAI,eAAc,KAAK,KAAK;AAAA,EACrC;AAAA;AAAA,EAGO,YAAe,aAAsE;AAC1F,WAAO,QAAQ,QAAQ,IAAI,eAAc,KAAK,KAAK,CAAC;AAAA,EACtD;AACF;;;ACtDO,SAAS,QAAW,OAA8B;AACvD,SAAO,IAAI,cAAc,KAAU;AACrC;AAEO,SAAS,KAAQ,OAA2B;AACjD,SAAO,IAAI,YAAY,KAAK;AAC9B;AAEO,IAAM,kBAAkB,CAAe,WAAsD;AAClG,SAAO,OAAO;AAChB;AAEO,IAAM,gBAAgB,CAAe,WAAoD;AAC9F,SAAO,CAAC,OAAO;AACjB;AAEO,SAAS,QAAQ,SAAmE;AACzF,QAAM,SAAoB,CAAC;AAC3B,QAAM,SAAoB,CAAC;AAE3B,aAAW,KAAK,SAAS;AACvB,QAAI,EAAE,SAAS;AACb,aAAO,KAAK,EAAE,KAAK;AAAA,IACrB,OAAO;AACL,aAAO,KAAK,EAAE,KAAK;AAAA,IACrB;AAAA,EACF;AAEA,MAAI,OAAO,QAAQ;AACjB,WAAO,IAAI,YAAY,MAAM;AAAA,EAC/B;AACA,SAAO,IAAI,cAAc,MAAM;AACjC;AAEO,IAAM,UAAU,CAAC,WAA+D;AACrF,MAAI,gBAAgB,MAAM,GAAG;AAC3B,WAAO,SAAS,MAAM;AAAA,EACxB;AACA,SAAO,SAAS,MAAM;AACxB;AAEA,IAAM,WAAW,CAAC,WAA6D;AAE7E,MAAI,OAAO,iBAAiB,eAAe;AACzC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AAGA,MAAI,OAAO,iBAAiB,aAAa;AACvC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AAGA,SAAO;AACT;AAEA,IAAM,WAAW,CAAC,WAAuD;AAEvE,MAAI,OAAO,iBAAiB,eAAe;AACzC,UAAM,QAAQ,SAAS,OAAO,KAAK;AAGnC,QAAI,gBAAgB,KAAK,GAAG;AAC1B,aAAO,KAAK,KAAK;AAAA,IACnB;AAGA,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,iBAAiB,aAAa;AACvC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AAGA,SAAO;AACT;","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "generic-result-type",
3
- "version": "2.0.0",
3
+ "version": "2.2.1",
4
4
  "description": "A generic result wrapper",
5
5
  "license": "ISC",
6
6
  "author": "Dave Welsh",