@praha/byethrow 0.0.1 → 0.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://badge.fury.io/js/@praha%2Fbyethrow.svg)](https://www.npmjs.com/package/@praha/byethrow)
 [![npm download](https://img.shields.io/npm/dm/@praha/byethrow.svg)](https://www.npmjs.com/package/@praha/byethrow)
-[![license](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/praha-inc/byethrow/blob/main/LICENSE)
+[![license](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/praha-inc/byethrow/blob/main/packages/byethrow/LICENSE)
 [![Github](https://img.shields.io/github/followers/praha-inc?label=Follow&logo=github&style=social)](https://github.com/orgs/praha-inc/followers)
 
 A lightweight, tree-shakable Result type package with a simple, consistent API designed.

package/dist/cjs/exports.cjs

@@ -9,6 +9,9 @@ var __webpack_modules__ = {
     "./functions/bind": function(module) {
         module.exports = require("./functions/bind.cjs");
     },
+    "./functions/combine": function(module) {
+        module.exports = require("./functions/combine.cjs");
+    },
     "./functions/do": function(module) {
         module.exports = require("./functions/do.cjs");
     },
@@ -113,70 +116,76 @@ var __webpack_exports__ = {};
         return _functions_bind__WEBPACK_IMPORTED_MODULE_3__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_do__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__("./functions/do");
+    var _functions_combine__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__("./functions/combine");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_combine__WEBPACK_IMPORTED_MODULE_4__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_combine__WEBPACK_IMPORTED_MODULE_4__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _functions_do__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__("./functions/do");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_do__WEBPACK_IMPORTED_MODULE_4__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_do__WEBPACK_IMPORTED_MODULE_4__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_do__WEBPACK_IMPORTED_MODULE_5__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_do__WEBPACK_IMPORTED_MODULE_5__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_fail__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__("./functions/fail");
+    var _functions_fail__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__("./functions/fail");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_fail__WEBPACK_IMPORTED_MODULE_5__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_fail__WEBPACK_IMPORTED_MODULE_5__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_fail__WEBPACK_IMPORTED_MODULE_6__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_fail__WEBPACK_IMPORTED_MODULE_6__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_is_failure__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__("./functions/is-failure");
+    var _functions_is_failure__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__("./functions/is-failure");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_is_failure__WEBPACK_IMPORTED_MODULE_6__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_is_failure__WEBPACK_IMPORTED_MODULE_6__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_is_failure__WEBPACK_IMPORTED_MODULE_7__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_is_failure__WEBPACK_IMPORTED_MODULE_7__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_is_success__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__("./functions/is-success");
+    var _functions_is_success__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__("./functions/is-success");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_is_success__WEBPACK_IMPORTED_MODULE_7__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_is_success__WEBPACK_IMPORTED_MODULE_7__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_is_success__WEBPACK_IMPORTED_MODULE_8__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_is_success__WEBPACK_IMPORTED_MODULE_8__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_map__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__("./functions/map");
+    var _functions_map__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__("./functions/map");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_map__WEBPACK_IMPORTED_MODULE_8__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_map__WEBPACK_IMPORTED_MODULE_8__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_map__WEBPACK_IMPORTED_MODULE_9__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_map__WEBPACK_IMPORTED_MODULE_9__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_map_error__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__("./functions/map-error");
+    var _functions_map_error__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__("./functions/map-error");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_map_error__WEBPACK_IMPORTED_MODULE_9__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_map_error__WEBPACK_IMPORTED_MODULE_9__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_map_error__WEBPACK_IMPORTED_MODULE_10__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_map_error__WEBPACK_IMPORTED_MODULE_10__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_pipe__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__("./functions/pipe");
+    var _functions_pipe__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__("./functions/pipe");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_pipe__WEBPACK_IMPORTED_MODULE_10__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_pipe__WEBPACK_IMPORTED_MODULE_10__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_pipe__WEBPACK_IMPORTED_MODULE_11__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_pipe__WEBPACK_IMPORTED_MODULE_11__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_succeed__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__("./functions/succeed");
+    var _functions_succeed__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__("./functions/succeed");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_succeed__WEBPACK_IMPORTED_MODULE_11__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_succeed__WEBPACK_IMPORTED_MODULE_11__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_succeed__WEBPACK_IMPORTED_MODULE_12__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_succeed__WEBPACK_IMPORTED_MODULE_12__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_try__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__("./functions/try");
+    var _functions_try__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__("./functions/try");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_try__WEBPACK_IMPORTED_MODULE_12__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_try__WEBPACK_IMPORTED_MODULE_12__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_try__WEBPACK_IMPORTED_MODULE_13__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_try__WEBPACK_IMPORTED_MODULE_13__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_unwrap__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__("./functions/unwrap");
+    var _functions_unwrap__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__("./functions/unwrap");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_unwrap__WEBPACK_IMPORTED_MODULE_13__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_unwrap__WEBPACK_IMPORTED_MODULE_13__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_unwrap__WEBPACK_IMPORTED_MODULE_14__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_unwrap__WEBPACK_IMPORTED_MODULE_14__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
-    var _functions_unwrap_error__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__("./functions/unwrap-error");
+    var _functions_unwrap_error__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__("./functions/unwrap-error");
     var __WEBPACK_REEXPORT_OBJECT__ = {};
-    for(var __WEBPACK_IMPORT_KEY__ in _functions_unwrap_error__WEBPACK_IMPORTED_MODULE_14__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
-        return _functions_unwrap_error__WEBPACK_IMPORTED_MODULE_14__[key];
+    for(var __WEBPACK_IMPORT_KEY__ in _functions_unwrap_error__WEBPACK_IMPORTED_MODULE_15__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _functions_unwrap_error__WEBPACK_IMPORTED_MODULE_15__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
 })();

package/dist/cjs/exports.d.ts

@@ -2,6 +2,7 @@ export * from './result';
 export * from './functions/and-then';
 export * from './functions/and-through';
 export * from './functions/bind';
+export * from './functions/combine';
 export * from './functions/do';
 export * from './functions/fail';
 export * from './functions/is-failure';

package/dist/cjs/functions/and-then.d.ts

@@ -37,6 +37,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // result: { type: 'Failure', error: 'error: 3' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const andThen: {

package/dist/cjs/functions/and-through.d.ts

@@ -49,6 +49,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Failure', error: 'Must be > 0' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const andThrough: {

package/dist/cjs/functions/bind.d.ts

@@ -49,6 +49,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Failure', error: 'error' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const bind: {

package/dist/cjs/functions/combine.cjs

@@ -0,0 +1,89 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    combine: ()=>combine
+});
+const external_fail_cjs_namespaceObject = require("./fail.cjs");
+const external_is_failure_cjs_namespaceObject = require("./is-failure.cjs");
+const external_succeed_cjs_namespaceObject = require("./succeed.cjs");
+const is_promise_cjs_namespaceObject = require("../internals/helpers/is-promise.cjs");
+const combine = (value)=>{
+    if (Array.isArray(value)) {
+        const group = (results)=>{
+            const errors = [];
+            const successes = [];
+            for (const result of results)if ((0, external_is_failure_cjs_namespaceObject.isFailure)(result)) errors.push(result.error);
+            else successes.push(result.value);
+            return {
+                errors,
+                successes
+            };
+        };
+        if (value.some(is_promise_cjs_namespaceObject.isPromise)) {
+            const results = value;
+            return Promise.all(results).then((results)=>{
+                const { successes, errors } = group(results);
+                return errors.length > 0 ? (0, external_fail_cjs_namespaceObject.fail)(errors) : (0, external_succeed_cjs_namespaceObject.succeed)(successes);
+            });
+        }
+        const results = value;
+        const { successes, errors } = group(results);
+        return errors.length > 0 ? (0, external_fail_cjs_namespaceObject.fail)(errors) : (0, external_succeed_cjs_namespaceObject.succeed)(successes);
+    }
+    {
+        const group = (entries)=>{
+            const errors = [];
+            const successes = {};
+            for (const [key, result] of entries)if ((0, external_is_failure_cjs_namespaceObject.isFailure)(result)) errors.push(result.error);
+            else successes[key] = result.value;
+            return {
+                errors,
+                successes
+            };
+        };
+        const entries = Object.entries(value);
+        if (entries.some(([, result])=>(0, is_promise_cjs_namespaceObject.isPromise)(result))) {
+            const results = entries;
+            const promises = results.map(async ([key, result])=>[
+                    key,
+                    await result
+                ]);
+            return Promise.all(promises).then((entries)=>{
+                const { successes, errors } = group(entries);
+                return errors.length > 0 ? (0, external_fail_cjs_namespaceObject.fail)(errors) : (0, external_succeed_cjs_namespaceObject.succeed)(successes);
+            });
+        }
+        const { successes, errors } = group(entries);
+        return errors.length > 0 ? (0, external_fail_cjs_namespaceObject.fail)(errors) : (0, external_succeed_cjs_namespaceObject.succeed)(successes);
+    }
+};
+exports.combine = __webpack_exports__.combine;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "combine"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/functions/combine.d.ts

@@ -0,0 +1,54 @@
+import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '../result';
+/**
+ * Combines multiple {@link Result} or {@link ResultAsync} values into a single result.
+ * If all inputs are {@link Success}, returns a {@link Success} with combined values.
+ * If any input is a {@link Failure}, returns a {@link Failure} with an array of all errors.
+ *
+ * @function
+ * @typeParam X - The input type (object or array of Results).
+ *
+ * @example Object Input
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const result = Result.combine({
+ *   a: Result.succeed(1),
+ *   b: Result.succeed('hello'),
+ * });
+ * // { type: 'Success', value: { a: 1, b: 'hello' } }
+ * ```
+ *
+ * @example Array Input
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const result = Result.combine([
+ *   Result.succeed(1),
+ *   Result.succeed(2),
+ *   Result.succeed(3),
+ * ]);
+ * // { type: 'Success', value: [1, 2, 3] }
+ * ```
+ *
+ * @example With Failures
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const result = Result.combine([
+ *   Result.succeed(1),
+ *   Result.fail('error1'),
+ *   Result.fail('error2'),
+ * ]);
+ * // { type: 'Failure', error: ['error1', 'error2'] }
+ * ```
+ *
+ * @category Utilities
+ */
+export declare const combine: {
+    <X extends Record<string, ResultMaybeAsync<any, any>>>(x: X): ResultFor<X[keyof X], {
+        [K in keyof X]: InferSuccess<X[K]>;
+    }, InferFailure<X[keyof X]>[]>;
+    <const X extends Array<ResultMaybeAsync<any, any>>>(x: X): ResultFor<X[number], {
+        [K in keyof X]: InferSuccess<X[K]>;
+    }, InferFailure<X[number]>[]>;
+};

package/dist/cjs/functions/fail.d.ts

@@ -30,6 +30,9 @@ import type { ResultFor } from '../result';
  * const result = Result.fail();
  * // Result.Result<never, void>
  * ```
+ *
+ * @see {@link combine} - For combining multiple Results into a single Result.
+ *
  * @category Creators
  */
 export declare const fail: {

package/dist/cjs/functions/map-error.d.ts

@@ -29,6 +29,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Success', value: 123 }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const mapError: {

package/dist/cjs/functions/map.d.ts

@@ -29,6 +29,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Failure', error: 'error' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const map: {

package/dist/cjs/functions/succeed.d.ts

@@ -31,6 +31,8 @@ import type { ResultFor } from '../result';
  * // Result.Result<void, never>
  * ```
  *
+ * @see {@link combine} - For combining multiple Results into a single Result.
+ *
  * @category Creators
  */
 export declare const succeed: {

package/dist/esm/exports.d.ts

@@ -2,6 +2,7 @@ export * from './result';
 export * from './functions/and-then';
 export * from './functions/and-through';
 export * from './functions/bind';
+export * from './functions/combine';
 export * from './functions/do';
 export * from './functions/fail';
 export * from './functions/is-failure';

package/dist/esm/exports.js

@@ -2,6 +2,7 @@ export * from "./result.js";
 export * from "./functions/and-then.js";
 export * from "./functions/and-through.js";
 export * from "./functions/bind.js";
+export * from "./functions/combine.js";
 export * from "./functions/do.js";
 export * from "./functions/fail.js";
 export * from "./functions/is-failure.js";

package/dist/esm/functions/and-then.d.ts

@@ -37,6 +37,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // result: { type: 'Failure', error: 'error: 3' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const andThen: {

package/dist/esm/functions/and-through.d.ts

@@ -49,6 +49,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Failure', error: 'Must be > 0' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const andThrough: {

package/dist/esm/functions/bind.d.ts

@@ -49,6 +49,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Failure', error: 'error' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const bind: {

package/dist/esm/functions/combine.d.ts

@@ -0,0 +1,54 @@
+import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '../result';
+/**
+ * Combines multiple {@link Result} or {@link ResultAsync} values into a single result.
+ * If all inputs are {@link Success}, returns a {@link Success} with combined values.
+ * If any input is a {@link Failure}, returns a {@link Failure} with an array of all errors.
+ *
+ * @function
+ * @typeParam X - The input type (object or array of Results).
+ *
+ * @example Object Input
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const result = Result.combine({
+ *   a: Result.succeed(1),
+ *   b: Result.succeed('hello'),
+ * });
+ * // { type: 'Success', value: { a: 1, b: 'hello' } }
+ * ```
+ *
+ * @example Array Input
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const result = Result.combine([
+ *   Result.succeed(1),
+ *   Result.succeed(2),
+ *   Result.succeed(3),
+ * ]);
+ * // { type: 'Success', value: [1, 2, 3] }
+ * ```
+ *
+ * @example With Failures
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const result = Result.combine([
+ *   Result.succeed(1),
+ *   Result.fail('error1'),
+ *   Result.fail('error2'),
+ * ]);
+ * // { type: 'Failure', error: ['error1', 'error2'] }
+ * ```
+ *
+ * @category Utilities
+ */
+export declare const combine: {
+    <X extends Record<string, ResultMaybeAsync<any, any>>>(x: X): ResultFor<X[keyof X], {
+        [K in keyof X]: InferSuccess<X[K]>;
+    }, InferFailure<X[keyof X]>[]>;
+    <const X extends Array<ResultMaybeAsync<any, any>>>(x: X): ResultFor<X[number], {
+        [K in keyof X]: InferSuccess<X[K]>;
+    }, InferFailure<X[number]>[]>;
+};

package/dist/esm/functions/combine.js

@@ -0,0 +1,55 @@
+import { fail } from "./fail.js";
+import { isFailure } from "./is-failure.js";
+import { succeed } from "./succeed.js";
+import { isPromise } from "../internals/helpers/is-promise.js";
+const combine = (value)=>{
+    if (Array.isArray(value)) {
+        const group = (results)=>{
+            const errors = [];
+            const successes = [];
+            for (const result of results)if (isFailure(result)) errors.push(result.error);
+            else successes.push(result.value);
+            return {
+                errors,
+                successes
+            };
+        };
+        if (value.some(isPromise)) {
+            const results = value;
+            return Promise.all(results).then((results)=>{
+                const { successes, errors } = group(results);
+                return errors.length > 0 ? fail(errors) : succeed(successes);
+            });
+        }
+        const results = value;
+        const { successes, errors } = group(results);
+        return errors.length > 0 ? fail(errors) : succeed(successes);
+    }
+    {
+        const group = (entries)=>{
+            const errors = [];
+            const successes = {};
+            for (const [key, result] of entries)if (isFailure(result)) errors.push(result.error);
+            else successes[key] = result.value;
+            return {
+                errors,
+                successes
+            };
+        };
+        const entries = Object.entries(value);
+        if (entries.some(([, result])=>isPromise(result))) {
+            const results = entries;
+            const promises = results.map(async ([key, result])=>[
+                    key,
+                    await result
+                ]);
+            return Promise.all(promises).then((entries)=>{
+                const { successes, errors } = group(entries);
+                return errors.length > 0 ? fail(errors) : succeed(successes);
+            });
+        }
+        const { successes, errors } = group(entries);
+        return errors.length > 0 ? fail(errors) : succeed(successes);
+    }
+};
+export { combine };

package/dist/esm/functions/fail.d.ts

@@ -30,6 +30,9 @@ import type { ResultFor } from '../result';
  * const result = Result.fail();
  * // Result.Result<never, void>
  * ```
+ *
+ * @see {@link combine} - For combining multiple Results into a single Result.
+ *
  * @category Creators
  */
 export declare const fail: {

package/dist/esm/functions/map-error.d.ts

@@ -29,6 +29,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Success', value: 123 }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const mapError: {

package/dist/esm/functions/map.d.ts

@@ -29,6 +29,8 @@ import type { InferFailure, InferSuccess, ResultFor, ResultMaybeAsync } from '..
  * // { type: 'Failure', error: 'error' }
  * ```
  *
+ * @see {@link pipe} - It is recommended to use this function with the {@link pipe} function for better readability and composability.
+ *
  * @category Combinators
  */
 export declare const map: {

package/dist/esm/functions/succeed.d.ts

@@ -31,6 +31,8 @@ import type { ResultFor } from '../result';
  * // Result.Result<void, never>
  * ```
  *
+ * @see {@link combine} - For combining multiple Results into a single Result.
+ *
  * @category Creators
  */
 export declare const succeed: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praha/byethrow",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "A lightweight, tree-shakable Result type package with a simple, consistent API designed",
   "keywords": [
     "javascript",
@@ -41,11 +41,11 @@
     "README.md"
   ],
   "devDependencies": {
-    "@rslib/core": "0.10.0",
+    "@rslib/core": "0.10.1",
     "eslint": "9.29.0",
     "typedoc": "0.28.5",
     "typescript": "5.8.3",
-    "vitest": "3.2.3"
+    "vitest": "3.2.4"
   },
   "publishConfig": {
     "provenance": true