effect-errors 1.2.24 → 1.3.1

package/README.md

@@ -137,6 +137,50 @@ Alternatively, you _can_ use a plain object with a `_tag` and `message` attribut
 Effect.fail({ _tag: 'SucksToBeMe', message: 'Yeah...' });
 ```
 
+## ⚡ Capturing errors data
+
+You might want to apply your own logic to reported errors data; for example if you want to display errors in html. You can do so using `captureErrors`. The function has the following signature:
+
+```typescript
+export interface ErrorSpan {
+  name: string;
+  attributes: ReadonlyMap<string, unknown>;
+  status: SpanStatus;
+}
+
+export interface ErrorData {
+  errorType: unknown;
+  message: unknown;
+  stack?: string;
+  spans?: ErrorSpan[];
+  isPlainString: boolean;
+}
+
+export interface CapturedErrors {
+  interrupted: boolean;
+  errors: ErrorData[];
+}
+
+type captureErrorsFunction: <E>(cause: Cause<E>) => CapturedErrors
+```
+
+You can use `captureErrors` like so:
+
+```typescript
+import { captureErrors } from 'effect-errors';
+
+await Effect.runPromise(
+  pipe(
+    effect,
+    Effect.catchAll((e) => {
+      const data = captureErrors(e);
+
+      // ...
+    }),
+  ),
+);
+```
+
 ## ⚡ examples
 
 I wrote some examples for fun and giggles. You can run them using:

package/capture-errors.d.ts

@@ -0,0 +1,19 @@
+import { type Cause } from 'effect/Cause';
+import { type SpanStatus } from 'effect/Tracer';
+export interface ErrorSpan {
+    name: string;
+    attributes: ReadonlyMap<string, unknown>;
+    status: SpanStatus;
+}
+export interface ErrorData {
+    errorType: unknown;
+    message: unknown;
+    stack?: string;
+    spans?: ErrorSpan[];
+    isPlainString: boolean;
+}
+export interface CapturedErrors {
+    interrupted: boolean;
+    errors: ErrorData[];
+}
+export declare const captureErrors: <E>(cause: Cause<E>) => CapturedErrors;

package/capture-errors.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureErrors = void 0;
+var effect_1 = require("effect");
+var Cause_1 = require("effect/Cause");
+var capture_errors_from_cause_1 = require("./logic/errors/capture-errors-from-cause");
+var captureErrors = function (cause) {
+    if ((0, Cause_1.isInterruptedOnly)(cause)) {
+        return {
+            interrupted: true,
+            errors: [],
+        };
+    }
+    var errors = (0, capture_errors_from_cause_1.captureErrorsFrom)(cause).map(function (_a) {
+        var message = _a.message, stack = _a.stack, span = _a.span, errorType = _a.errorType, isPlainString = _a.isPlainString;
+        var spans = [];
+        if (span !== undefined) {
+            var current = span;
+            while (current !== undefined && current._tag === 'Span') {
+                var name_1 = current.name, attributes = current.attributes, status_1 = current.status;
+                spans.push({
+                    name: name_1,
+                    attributes: attributes,
+                    status: status_1,
+                });
+                current = effect_1.Option.getOrUndefined(current.parent);
+            }
+        }
+        return {
+            errorType: errorType,
+            message: message,
+            stack: stack,
+            spans: spans,
+            isPlainString: isPlainString,
+        };
+    });
+    return {
+        interrupted: false,
+        errors: errors,
+    };
+};
+exports.captureErrors = captureErrors;

package/caputre-errors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/caputre-errors.test.js

@@ -0,0 +1,156 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var vitest_1 = require("vitest");
+var capture_errors_1 = require("./capture-errors");
+var from_promise_1 = require("./examples/from-promise");
+var parallel_errors_1 = require("./examples/parallel-errors");
+var console_mock_1 = require("./tests/mocks/console.mock");
+var effect_cause_1 = require("./tests/runners/effect-cause");
+void (0, console_mock_1.mockConsole)({
+    info: vitest_1.vi.fn(),
+});
+(0, vitest_1.describe)('captureErrors function', function () {
+    (0, vitest_1.it)('should capture errors from promises', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var cause, result, _a, errorType, isPlainString, message, spans, stack;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, (0, effect_cause_1.effectCause)(from_promise_1.fromPromiseTask)];
+                case 1:
+                    cause = _b.sent();
+                    result = (0, capture_errors_1.captureErrors)(cause);
+                    (0, vitest_1.expect)(result.interrupted).toBe(false);
+                    (0, vitest_1.expect)(result.errors).toHaveLength(1);
+                    _a = result.errors[0], errorType = _a.errorType, isPlainString = _a.isPlainString, message = _a.message, spans = _a.spans, stack = _a.stack;
+                    (0, vitest_1.expect)(errorType).toBe('FetchError');
+                    (0, vitest_1.expect)(isPlainString).toBe(false);
+                    (0, vitest_1.expect)(message.toString()).toStrictEqual('TypeError: fetch failed');
+                    (0, vitest_1.expect)(spans).toHaveLength(2);
+                    (0, vitest_1.expect)(spans === null || spans === void 0 ? void 0 : spans[0].name).toBe('fetchUser');
+                    (0, vitest_1.expect)(spans === null || spans === void 0 ? void 0 : spans[0].attributes).toHaveAttributes([
+                        {
+                            key: 'userId',
+                            value: '123',
+                        },
+                    ]);
+                    (0, vitest_1.expect)(spans === null || spans === void 0 ? void 0 : spans[1].attributes).toHaveAttributes([]);
+                    (0, vitest_1.expect)(stack).not.toHaveLength(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    // eslint-disable-next-line complexity
+    (0, vitest_1.it)('should capture parallel errors', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var cause, result, firstError, secondError, thirdError;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        return __generator(this, function (_u) {
+            switch (_u.label) {
+                case 0: return [4 /*yield*/, (0, effect_cause_1.effectCause)(parallel_errors_1.withParallelErrorsTask)];
+                case 1:
+                    cause = _u.sent();
+                    result = (0, capture_errors_1.captureErrors)(cause);
+                    (0, vitest_1.expect)(result.interrupted).toBe(false);
+                    (0, vitest_1.expect)(result.errors).toHaveLength(3);
+                    firstError = result.errors[0];
+                    (0, vitest_1.expect)(firstError.errorType).toBe('UserNotFound');
+                    (0, vitest_1.expect)(firstError.isPlainString).toBe(false);
+                    (0, vitest_1.expect)(firstError.message).toStrictEqual('Oh no, this user does no exist!');
+                    (0, vitest_1.expect)(firstError.spans).toHaveLength(3);
+                    (0, vitest_1.expect)((_a = firstError.spans) === null || _a === void 0 ? void 0 : _a[0].name).toBe('readUser');
+                    (0, vitest_1.expect)((_b = firstError.spans) === null || _b === void 0 ? void 0 : _b[0].attributes).toHaveAttributes([
+                        {
+                            key: 'name',
+                            value: 'yolo',
+                        },
+                    ]);
+                    (0, vitest_1.expect)((_c = firstError.spans) === null || _c === void 0 ? void 0 : _c[1].name).toBe('parallelGet');
+                    (0, vitest_1.expect)((_d = firstError.spans) === null || _d === void 0 ? void 0 : _d[1].attributes).toHaveAttributes([
+                        {
+                            key: 'names',
+                            value: ['yolo', 'bro', 'cool'],
+                        },
+                    ]);
+                    (0, vitest_1.expect)((_e = firstError.spans) === null || _e === void 0 ? void 0 : _e[2].name).toBe('withParallelErrorsTask');
+                    (0, vitest_1.expect)((_f = firstError.spans) === null || _f === void 0 ? void 0 : _f[2].attributes).toHaveAttributes([]);
+                    secondError = result.errors[1];
+                    (0, vitest_1.expect)(secondError.errorType).toBe('UserNotFound');
+                    (0, vitest_1.expect)(secondError.isPlainString).toBe(false);
+                    (0, vitest_1.expect)(secondError.message).toStrictEqual('Oh no, this user does no exist!');
+                    (0, vitest_1.expect)(secondError.spans).toHaveLength(3);
+                    (0, vitest_1.expect)((_g = secondError.spans) === null || _g === void 0 ? void 0 : _g[0].name).toBe('readUser');
+                    (0, vitest_1.expect)((_h = secondError.spans) === null || _h === void 0 ? void 0 : _h[0].attributes).toHaveAttributes([
+                        {
+                            key: 'name',
+                            value: 'bro',
+                        },
+                    ]);
+                    (0, vitest_1.expect)((_j = secondError.spans) === null || _j === void 0 ? void 0 : _j[1].name).toBe('parallelGet');
+                    (0, vitest_1.expect)((_k = secondError.spans) === null || _k === void 0 ? void 0 : _k[1].attributes).toHaveAttributes([
+                        {
+                            key: 'names',
+                            value: ['yolo', 'bro', 'cool'],
+                        },
+                    ]);
+                    (0, vitest_1.expect)((_l = secondError.spans) === null || _l === void 0 ? void 0 : _l[2].name).toBe('withParallelErrorsTask');
+                    (0, vitest_1.expect)((_m = secondError.spans) === null || _m === void 0 ? void 0 : _m[2].attributes).toHaveAttributes([]);
+                    thirdError = result.errors[2];
+                    (0, vitest_1.expect)(thirdError.errorType).toBe('UserNotFound');
+                    (0, vitest_1.expect)(thirdError.isPlainString).toBe(false);
+                    (0, vitest_1.expect)(thirdError.message).toStrictEqual('Oh no, this user does no exist!');
+                    (0, vitest_1.expect)(thirdError.spans).toHaveLength(3);
+                    (0, vitest_1.expect)((_o = thirdError.spans) === null || _o === void 0 ? void 0 : _o[0].name).toBe('readUser');
+                    (0, vitest_1.expect)((_p = thirdError.spans) === null || _p === void 0 ? void 0 : _p[0].attributes).toHaveAttributes([
+                        {
+                            key: 'name',
+                            value: 'cool',
+                        },
+                    ]);
+                    (0, vitest_1.expect)((_q = thirdError.spans) === null || _q === void 0 ? void 0 : _q[1].name).toBe('parallelGet');
+                    (0, vitest_1.expect)((_r = thirdError.spans) === null || _r === void 0 ? void 0 : _r[1].attributes).toHaveAttributes([
+                        {
+                            key: 'names',
+                            value: ['yolo', 'bro', 'cool'],
+                        },
+                    ]);
+                    (0, vitest_1.expect)((_s = thirdError.spans) === null || _s === void 0 ? void 0 : _s[2].name).toBe('withParallelErrorsTask');
+                    (0, vitest_1.expect)((_t = thirdError.spans) === null || _t === void 0 ? void 0 : _t[2].attributes).toHaveAttributes([]);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});

package/examples/errors/fetch-error.d.ts

@@ -0,0 +1,9 @@
+declare const FetchError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FetchError";
+} & Readonly<A>;
+export declare class FetchError extends FetchError_base<{
+    cause?: unknown;
+    message?: string;
+}> {
+}
+export {};

package/examples/errors/fetch-error.js

@@ -0,0 +1,27 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchError = void 0;
+var Data_1 = require("effect/Data");
+var FetchError = /** @class */ (function (_super) {
+    __extends(FetchError, _super);
+    function FetchError() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return FetchError;
+}((0, Data_1.TaggedError)('FetchError')));
+exports.FetchError = FetchError;

package/examples/errors/file-error.d.ts

@@ -0,0 +1,9 @@
+declare const FileError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FileError";
+} & Readonly<A>;
+export declare class FileError extends FileError_base<{
+    cause?: unknown;
+    message?: string;
+}> {
+}
+export {};

package/examples/errors/file-error.js

@@ -0,0 +1,27 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileError = void 0;
+var Data_1 = require("effect/Data");
+var FileError = /** @class */ (function (_super) {
+    __extends(FileError, _super);
+    function FileError() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return FileError;
+}((0, Data_1.TaggedError)('FileError')));
+exports.FileError = FileError;

package/examples/errors/user-not-found.error.d.ts

@@ -0,0 +1,9 @@
+declare const UserNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "UserNotFound";
+} & Readonly<A>;
+export declare class UserNotFoundError extends UserNotFoundError_base<{
+    cause?: unknown;
+    message?: string;
+}> {
+}
+export {};

package/examples/errors/user-not-found.error.js

@@ -0,0 +1,27 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserNotFoundError = void 0;
+var Data_1 = require("effect/Data");
+var UserNotFoundError = /** @class */ (function (_super) {
+    __extends(UserNotFoundError, _super);
+    function UserNotFoundError() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return UserNotFoundError;
+}((0, Data_1.TaggedError)('UserNotFound')));
+exports.UserNotFoundError = UserNotFoundError;

package/examples/from-promise.d.ts

@@ -0,0 +1,5 @@
+import { Effect } from 'effect';
+import { FetchError } from './errors/fetch-error';
+import { FileError } from './errors/file-error';
+export declare const fromPromiseTask: Effect.Effect<any, FetchError | FileError, never>;
+export default fromPromiseTask;

package/examples/from-promise.js

@@ -0,0 +1,113 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromPromiseTask = void 0;
+var effect_1 = require("effect");
+var fs_extra_1 = require("fs-extra");
+var fetch_error_1 = require("./errors/fetch-error");
+var file_error_1 = require("./errors/file-error");
+var filename_effect_1 = require("./util/filename.effect");
+var readUser = effect_1.Effect.withSpan('readUser')(effect_1.Effect.tryPromise({
+    try: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, fs_extra_1.readJson)('./src/examples/data/user.json')];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    }); }); },
+    catch: function (e) { return new file_error_1.FileError({ cause: e }); },
+}));
+var fetchTask = function (userId) {
+    return effect_1.Effect.withSpan('fetchUser', {
+        attributes: {
+            userId: userId,
+        },
+    })(effect_1.Effect.tryPromise({
+        try: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, fetch("https://yolo-bro-oh-no.org/users/".concat(userId))];
+                case 1: return [2 /*return*/, _a.sent()];
+            }
+        }); }); },
+        catch: function (e) {
+            return new fetch_error_1.FetchError({
+                cause: e,
+            });
+        },
+    }));
+};
+var unwrapResponseTask = function (response) {
+    return effect_1.Effect.withSpan('unwrapFetchUserResponse')(effect_1.Effect.tryPromise({
+        try: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, response.json()];
+                case 1: return [2 /*return*/, _a.sent()];
+            }
+        }); }); },
+        catch: function (e) { return new fetch_error_1.FetchError({ cause: e }); },
+    }));
+};
+exports.fromPromiseTask = effect_1.Effect.withSpan('fromPromiseTask')(effect_1.Effect.gen(function (_) {
+    var id, response;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [5 /*yield**/, __values(_((0, filename_effect_1.filename)(__filename)))];
+            case 1:
+                _a.sent();
+                return [5 /*yield**/, __values(_(readUser))];
+            case 2:
+                id = (_a.sent()).id;
+                return [5 /*yield**/, __values(_(fetchTask(id)))];
+            case 3:
+                response = _a.sent();
+                return [5 /*yield**/, __values(_(unwrapResponseTask(response)))];
+            case 4: return [2 /*return*/, _a.sent()];
+        }
+    });
+}));
+exports.default = exports.fromPromiseTask;

package/examples/parallel-errors.d.ts

@@ -0,0 +1,4 @@
+import { Effect } from 'effect';
+import { UserNotFoundError } from './errors/user-not-found.error';
+export declare const withParallelErrorsTask: Effect.Effect<[void, never[]], UserNotFoundError, never>;
+export default withParallelErrorsTask;

package/examples/parallel-errors.js

@@ -0,0 +1,69 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withParallelErrorsTask = void 0;
+var effect_1 = require("effect");
+var user_not_found_error_1 = require("./errors/user-not-found.error");
+var filename_effect_1 = require("./util/filename.effect");
+var readUser = function (name) {
+    return effect_1.Effect.withSpan('readUser', {
+        attributes: {
+            name: name,
+        },
+    })(effect_1.Effect.tryPromise({
+        // eslint-disable-next-line prefer-promise-reject-errors
+        try: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.reject('Oh no, this user does no exist!')];
+                case 1: return [2 /*return*/, _a.sent()];
+            }
+        }); }); },
+        catch: function (e) { return new user_not_found_error_1.UserNotFoundError({ cause: e }); },
+    }));
+};
+var parallelGet = function (names) {
+    return effect_1.Effect.withSpan('parallelGet', {
+        attributes: {
+            names: names,
+        },
+    })(effect_1.Effect.all(names.map(readUser), {
+        concurrency: 'unbounded',
+    }));
+};
+exports.withParallelErrorsTask = effect_1.Effect.withSpan('withParallelErrorsTask')(effect_1.Effect.all([(0, filename_effect_1.filename)(__filename), parallelGet(['yolo', 'bro', 'cool'])]));
+exports.default = exports.withParallelErrorsTask;

package/examples/util/filename.effect.d.ts

@@ -0,0 +1,2 @@
+import { Effect } from 'effect';
+export declare const filename: (path: string) => Effect.Effect<void, never, never>;

package/examples/util/filename.effect.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filename = void 0;
+var effect_1 = require("effect");
+var cwdRegex = new RegExp(process.cwd(), 'g');
+var filename = function (path) {
+    return effect_1.Effect.sync(function () {
+        console.info("\r\n\uD83D\uDCC1 ".concat(path.replace(cwdRegex, '.')));
+    });
+};
+exports.filename = filename;

package/index.d.ts

@@ -2,3 +2,4 @@ export * from './pretty-print';
 export * from './runners/run-promise';
 export * from './runners/run-sync';
 export * from './types/pretty-print-options.type';
+export * from './capture-errors';

package/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./pretty-print"), exports);
 __exportStar(require("./runners/run-promise"), exports);
 __exportStar(require("./runners/run-sync"), exports);
 __exportStar(require("./types/pretty-print-options.type"), exports);
+__exportStar(require("./capture-errors"), exports);

package/logic/errors/capture-errors-from-cause.d.ts

@@ -1,3 +1,3 @@
-import { Cause } from 'effect/Cause';
-import { PrettyError } from '../../types/pretty-error.type';
+import { type Cause } from 'effect/Cause';
+import { type PrettyError } from '../../types/pretty-error.type';
 export declare const captureErrorsFrom: <E>(cause: Cause<E>) => readonly PrettyError[];

package/logic/errors/capture-errors-from-cause.js

@@ -29,7 +29,7 @@ exports.captureErrorsFrom = void 0;
 var Cause_1 = require("effect/Cause");
 var parse_error_1 = require("./parse-error");
 var captureErrorsFrom = function (cause) {
-    return (0, Cause_1.reduceWithContext)(cause, void 0, {
+    return (0, Cause_1.reduceWithContext)(cause, undefined, {
         emptyCase: function () { return []; },
         dieCase: function (_, unknownError) { return [(0, parse_error_1.parseError)(unknownError)]; },
         failCase: function (_, error) { return [(0, parse_error_1.parseError)(error)]; },

package/logic/errors/extract-error-details.d.ts

@@ -0,0 +1,7 @@
+interface ErrorDetails {
+    isPlainString: boolean;
+    type?: unknown;
+    message: unknown;
+}
+export declare const extractErrorDetails: (error: unknown) => ErrorDetails;
+export {};