@praha/byethrow 0.8.2 → 0.10.0

package/README.md

@@ -46,7 +46,7 @@ const validateId = (id: string) => {
   return Result.succeed();
 };
 
-const findUser = Result.try({
+const findUser = Result.fn({
   try: (id: string) => {
     return { id, name: 'John Doe' };
   },

package/dist/cjs/exports.cjs

@@ -24,6 +24,9 @@ var __webpack_modules__ = {
     "./functions/fail" (module) {
         module.exports = require("./functions/fail.cjs");
     },
+    "./functions/fn" (module) {
+        module.exports = require("./functions/fn.cjs");
+    },
     "./functions/inspect-error" (module) {
         module.exports = require("./functions/inspect-error.cjs");
     },
@@ -48,6 +51,9 @@ var __webpack_modules__ = {
     "./functions/or-else" (module) {
         module.exports = require("./functions/or-else.cjs");
     },
+    "./functions/or-through" (module) {
+        module.exports = require("./functions/or-through.cjs");
+    },
     "./functions/parse" (module) {
         module.exports = require("./functions/parse.cjs");
     },
@@ -105,7 +111,7 @@ function __webpack_require__(moduleId) {
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -152,65 +158,73 @@ var __webpack_exports__ = {};
     var __rspack_reexport = {};
     for(const __rspack_import_key in _functions_fail__rspack_import_8)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_fail__rspack_import_8[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_inspect__rspack_import_9 = __webpack_require__("./functions/inspect");
+    var _functions_fn__rspack_import_9 = __webpack_require__("./functions/fn");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _functions_fn__rspack_import_9)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_fn__rspack_import_9[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _functions_inspect__rspack_import_10 = __webpack_require__("./functions/inspect");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _functions_inspect__rspack_import_10)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_inspect__rspack_import_10[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _functions_inspect_error__rspack_import_11 = __webpack_require__("./functions/inspect-error");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_inspect__rspack_import_9)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_inspect__rspack_import_9[__rspack_import_key];
+    for(const __rspack_import_key in _functions_inspect_error__rspack_import_11)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_inspect_error__rspack_import_11[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_inspect_error__rspack_import_10 = __webpack_require__("./functions/inspect-error");
+    var _functions_is_failure__rspack_import_12 = __webpack_require__("./functions/is-failure");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_inspect_error__rspack_import_10)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_inspect_error__rspack_import_10[__rspack_import_key];
+    for(const __rspack_import_key in _functions_is_failure__rspack_import_12)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_is_failure__rspack_import_12[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_is_failure__rspack_import_11 = __webpack_require__("./functions/is-failure");
+    var _functions_is_result__rspack_import_13 = __webpack_require__("./functions/is-result");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_is_failure__rspack_import_11)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_is_failure__rspack_import_11[__rspack_import_key];
+    for(const __rspack_import_key in _functions_is_result__rspack_import_13)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_is_result__rspack_import_13[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_is_result__rspack_import_12 = __webpack_require__("./functions/is-result");
+    var _functions_is_success__rspack_import_14 = __webpack_require__("./functions/is-success");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_is_result__rspack_import_12)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_is_result__rspack_import_12[__rspack_import_key];
+    for(const __rspack_import_key in _functions_is_success__rspack_import_14)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_is_success__rspack_import_14[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_is_success__rspack_import_13 = __webpack_require__("./functions/is-success");
+    var _functions_map__rspack_import_15 = __webpack_require__("./functions/map");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_is_success__rspack_import_13)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_is_success__rspack_import_13[__rspack_import_key];
+    for(const __rspack_import_key in _functions_map__rspack_import_15)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_map__rspack_import_15[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_map__rspack_import_14 = __webpack_require__("./functions/map");
+    var _functions_map_error__rspack_import_16 = __webpack_require__("./functions/map-error");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_map__rspack_import_14)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_map__rspack_import_14[__rspack_import_key];
+    for(const __rspack_import_key in _functions_map_error__rspack_import_16)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_map_error__rspack_import_16[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_map_error__rspack_import_15 = __webpack_require__("./functions/map-error");
+    var _functions_or_else__rspack_import_17 = __webpack_require__("./functions/or-else");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_map_error__rspack_import_15)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_map_error__rspack_import_15[__rspack_import_key];
+    for(const __rspack_import_key in _functions_or_else__rspack_import_17)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_or_else__rspack_import_17[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_or_else__rspack_import_16 = __webpack_require__("./functions/or-else");
+    var _functions_or_through__rspack_import_18 = __webpack_require__("./functions/or-through");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_or_else__rspack_import_16)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_or_else__rspack_import_16[__rspack_import_key];
+    for(const __rspack_import_key in _functions_or_through__rspack_import_18)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_or_through__rspack_import_18[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_parse__rspack_import_17 = __webpack_require__("./functions/parse");
+    var _functions_parse__rspack_import_19 = __webpack_require__("./functions/parse");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_parse__rspack_import_17)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_parse__rspack_import_17[__rspack_import_key];
+    for(const __rspack_import_key in _functions_parse__rspack_import_19)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_parse__rspack_import_19[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_pipe__rspack_import_18 = __webpack_require__("./functions/pipe");
+    var _functions_pipe__rspack_import_20 = __webpack_require__("./functions/pipe");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_pipe__rspack_import_18)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_pipe__rspack_import_18[__rspack_import_key];
+    for(const __rspack_import_key in _functions_pipe__rspack_import_20)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_pipe__rspack_import_20[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_sequence__rspack_import_19 = __webpack_require__("./functions/sequence");
+    var _functions_sequence__rspack_import_21 = __webpack_require__("./functions/sequence");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_sequence__rspack_import_19)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_sequence__rspack_import_19[__rspack_import_key];
+    for(const __rspack_import_key in _functions_sequence__rspack_import_21)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_sequence__rspack_import_21[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_succeed__rspack_import_20 = __webpack_require__("./functions/succeed");
+    var _functions_succeed__rspack_import_22 = __webpack_require__("./functions/succeed");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_succeed__rspack_import_20)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_succeed__rspack_import_20[__rspack_import_key];
+    for(const __rspack_import_key in _functions_succeed__rspack_import_22)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_succeed__rspack_import_22[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_try__rspack_import_21 = __webpack_require__("./functions/try");
+    var _functions_try__rspack_import_23 = __webpack_require__("./functions/try");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_try__rspack_import_21)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_try__rspack_import_21[__rspack_import_key];
+    for(const __rspack_import_key in _functions_try__rspack_import_23)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_try__rspack_import_23[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_unwrap__rspack_import_22 = __webpack_require__("./functions/unwrap");
+    var _functions_unwrap__rspack_import_24 = __webpack_require__("./functions/unwrap");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_unwrap__rspack_import_22)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_unwrap__rspack_import_22[__rspack_import_key];
+    for(const __rspack_import_key in _functions_unwrap__rspack_import_24)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_unwrap__rspack_import_24[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _functions_unwrap_error__rspack_import_23 = __webpack_require__("./functions/unwrap-error");
+    var _functions_unwrap_error__rspack_import_25 = __webpack_require__("./functions/unwrap-error");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _functions_unwrap_error__rspack_import_23)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_unwrap_error__rspack_import_23[__rspack_import_key];
+    for(const __rspack_import_key in _functions_unwrap_error__rspack_import_25)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_functions_unwrap_error__rspack_import_25[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
 })();
 for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/cjs/exports.d.ts

@@ -7,6 +7,7 @@ export * from './functions/bind.js';
 export * from './functions/collect.js';
 export * from './functions/do.js';
 export * from './functions/fail.js';
+export * from './functions/fn.js';
 export * from './functions/inspect.js';
 export * from './functions/inspect-error.js';
 export * from './functions/is-failure.js';
@@ -15,6 +16,7 @@ export * from './functions/is-success.js';
 export * from './functions/map.js';
 export * from './functions/map-error.js';
 export * from './functions/or-else.js';
+export * from './functions/or-through.js';
 export * from './functions/parse.js';
 export * from './functions/pipe.js';
 export * from './functions/sequence.js';

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

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

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

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/assert-failure.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/assert-failure.d.ts

@@ -1,13 +1,17 @@
-import type { Failure, InferFailure, Result, ResultAsync } from '../result.js';
+import type { HasPromise } from '../internals/types/has-promise.js';
+import type { Failure, InferFailure, ResultMaybeAsync } from '../result.js';
 /**
  * Asserts that a {@link Result} or {@link ResultAsync} is a {@link Failure} and returns it.
- * If the result is a {@link Success}, throws an error.
+ * This function requires that the result's success type is `never`, meaning the result is
+ * guaranteed to be a {@link Failure} at the type level.
+ * If the result is a {@link Success} at runtime, throws an error.
  *
  * @function
- * @typeParam E - The type of the error value.
+ * @typeParam R - The result type that extends {@link ResultMaybeAsync} with `never` as the success type.
  * @param result - The {@link Result} or {@link ResultAsync} to assert as a {@link Failure}.
- * @returns The {@link Failure} result or a Promise of {@link Success} result.
- * @throws {Error} If the result is a {@link Success}.
+ *                 The success type must be `never`.
+ * @returns The {@link Failure} result or a Promise of {@link Failure} result.
+ * @throws {Error} If the result is a {@link Success} at runtime.
  *
  * @example
  * ```ts
@@ -18,24 +22,15 @@ import type { Failure, InferFailure, Result, ResultAsync } from '../result.js';
  * // failure: { type: 'Failure', error: 'error' }
  * ```
  *
- * @example Throws on Success
- * ```ts
- * // @errors: 2769
- * import { Result } from '@praha/byethrow';
- *
- * const result = Result.succeed(42);
- * Result.assertFailure(result); // throws Error
- * ```
- *
- * @example Safe unwrap with assertFailure
+ * @example Type-safe usage after narrowing success type
  * ```ts
  * import { Result } from '@praha/byethrow';
  *
  * const getResult = (): Result.Result<number, string> => Result.fail('error');
  * const value = Result.pipe(
  *   getResult(),
- *   Result.andThen(() => Result.fail('die')),
- *   Result.assertFailure,
+ *   Result.andThen(() => Result.fail('die')), // Success type becomes never
+ *   Result.assertFailure, // Type-safe: success type is now never
  *   Result.unwrapError(), // Safe unwrap after assertion
  * );
  * ```
@@ -44,7 +39,4 @@ import type { Failure, InferFailure, Result, ResultAsync } from '../result.js';
  *
  * @category Assertions
  */
-export declare const assertFailure: {
-    <R extends ResultAsync<never, any>>(result: R): Promise<Failure<InferFailure<R>>>;
-    <R extends Result<never, any>>(result: R): Failure<InferFailure<R>>;
-};
+export declare const assertFailure: <R extends ResultMaybeAsync<never, any>>(result: R) => true extends HasPromise<R> ? Promise<Failure<InferFailure<R>>> : Failure<InferFailure<R>>;

package/dist/cjs/functions/assert-success.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/assert-success.d.ts

@@ -1,13 +1,17 @@
-import type { InferSuccess, Result, ResultAsync, Success } from '../result.js';
+import type { HasPromise } from '../internals/types/has-promise.js';
+import type { InferSuccess, ResultMaybeAsync, Success } from '../result.js';
 /**
  * Asserts that a {@link Result} or {@link ResultAsync} is a {@link Success} and returns it.
- * If the result is a {@link Failure}, throws an error.
+ * This function requires that the result's error type is `never`, meaning the result is
+ * guaranteed to be a {@link Success} at the type level.
+ * If the result is a {@link Failure} at runtime, throws an error.
  *
  * @function
- * @typeParam T - The type of the success value.
+ * @typeParam R - The result type that extends {@link ResultMaybeAsync} with `never` as the error type.
  * @param result - The {@link Result} or {@link ResultAsync} to assert as a {@link Success}.
+ *                 The error type must be `never`.
  * @returns The {@link Success} result or a Promise of {@link Success} result.
- * @throws {Error} If the result is a {@link Failure}.
+ * @throws {Error} If the result is a {@link Failure} at runtime.
  *
  * @example
  * ```ts
@@ -18,24 +22,15 @@ import type { InferSuccess, Result, ResultAsync, Success } from '../result.js';
  * // success: { type: 'Success', value: 42 }
  * ```
  *
- * @example Throws on Failure
- * ```ts
- * // @errors: 2769
- * import { Result } from '@praha/byethrow';
- *
- * const result = Result.fail('error');
- * Result.assertSuccess(result); // throws Error
- * ```
- *
- * @example Safe unwrap with assertSuccess
+ * @example Type-safe usage after narrowing error type
  * ```ts
  * import { Result } from '@praha/byethrow';
  *
  * const getResult = (): Result.Result<number, string> => Result.succeed(42);
  * const value = Result.pipe(
  *   getResult(),
- *   Result.orElse(() => Result.succeed('fallback')),
- *   Result.assertSuccess,
+ *   Result.orElse(() => Result.succeed(0)), // Error type becomes never
+ *   Result.assertSuccess, // Type-safe: error type is now never
  *   Result.unwrap(), // Safe unwrap after assertion
  * );
  * ```
@@ -44,7 +39,4 @@ import type { InferSuccess, Result, ResultAsync, Success } from '../result.js';
  *
  * @category Assertions
  */
-export declare const assertSuccess: {
-    <R extends ResultAsync<any, never>>(result: R): Promise<Success<InferSuccess<R>>>;
-    <R extends Result<any, never>>(result: R): Success<InferSuccess<R>>;
-};
+export declare const assertSuccess: <R extends ResultMaybeAsync<any, never>>(result: R) => true extends HasPromise<R> ? Promise<Success<InferSuccess<R>>> : Success<InferSuccess<R>>;

package/dist/cjs/functions/bind.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/collect.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/do.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/fail.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/fn.cjs

@@ -0,0 +1,55 @@
+"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 ("u" > 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__, {
+    fn: ()=>fn_fn
+});
+const external_fail_cjs_namespaceObject = require("./fail.cjs");
+const external_succeed_cjs_namespaceObject = require("./succeed.cjs");
+const is_promise_cjs_namespaceObject = require("../internals/helpers/is-promise.cjs");
+const fn_fn = (options)=>{
+    const fn = (...args)=>{
+        try {
+            const output = options.try(...args);
+            if ((0, is_promise_cjs_namespaceObject.isPromise)(output)) {
+                const promise = (0, external_succeed_cjs_namespaceObject.succeed)(output);
+                if ('safe' in options && options.safe) return promise;
+                return promise.catch((error)=>(0, external_fail_cjs_namespaceObject.fail)(options.catch(error)));
+            }
+            return (0, external_succeed_cjs_namespaceObject.succeed)(output);
+        } catch (error) {
+            if ('safe' in options && options.safe) throw error;
+            return (0, external_fail_cjs_namespaceObject.fail)(options.catch(error));
+        }
+    };
+    return fn;
+};
+exports.fn = __webpack_exports__.fn;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "fn"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -0,0 +1,84 @@
+import type { Result, ResultAsync } from '../result.js';
+/**
+ * Wraps a function that may throw and returns a new function that returns a {@link Result} or {@link ResultAsync}.
+ *
+ * You can use either a custom `catch` handler or rely on the `safe: true` option
+ * to assume the function cannot throw.
+ *
+ * @function
+ * @typeParam T - The function type to execute (sync or async) or a Promise type.
+ * @typeParam E - The error type to return if `catch` is used.
+ * @returns A new function that returns a {@link Result} or {@link ResultAsync} wrapping the original function's return value or the caught error.
+ *
+ * @example Sync try-catch
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const fn = Result.fn({
+ *   try: (x: number) => {
+ *     if (x < 0) throw new Error('Negative!');
+ *     return x * 2;
+ *   },
+ *   catch: (error) => new Error('Oops!', { cause: error }),
+ * });
+ *
+ * const result = fn(5); // Result.Result<number, Error>
+ * ```
+ *
+ * @example Sync safe
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const fn = Result.fn({
+ *   safe: true,
+ *   try: (x: number) => x + 1,
+ * });
+ *
+ * const result = fn(1); // Result.Result<number, never>
+ * ```
+ *
+ * @example Async try-catch
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const fn = Result.fn({
+ *   try: async (id: string) => await fetch(`/api/data/${id}`),
+ *   catch: (error) => new Error('Oops!', { cause: error }),
+ * });
+ *
+ * const result = await fn('abc'); // Result.ResultAsync<Response, Error>
+ * ```
+ *
+ * @example Async safe
+ * ```ts
+ * import { Result } from '@praha/byethrow';
+ *
+ * const fn = Result.fn({
+ *   safe: true,
+ *   try: async () => await Promise.resolve('ok'),
+ * });
+ *
+ * const result = await fn(); // Result.ResultAsync<string, never>
+ * ```
+ *
+ * @category Creators
+ */
+declare const fn: {
+    <T extends (...args: readonly any[]) => Promise<any>, E>(options: {
+        try: T;
+        catch: (error: unknown) => E;
+    }): (...args: Parameters<T>) => ResultAsync<Awaited<ReturnType<T>>, E>;
+    <T extends (...args: readonly any[]) => Promise<any>>(options: {
+        safe: true;
+        try: T;
+    }): (...args: Parameters<T>) => ResultAsync<Awaited<ReturnType<T>>, never>;
+    <T extends (...args: readonly any[]) => any, E>(options: {
+        try: T;
+        catch: (error: unknown) => E;
+    }): (...args: Parameters<T>) => Result<ReturnType<T>, E>;
+    <T extends (...args: readonly any[]) => any>(options: {
+        safe: true;
+        try: T;
+    }): (...args: Parameters<T>) => Result<ReturnType<T>, never>;
+};
+export { fn };

package/dist/cjs/functions/inspect-error.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/inspect.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/is-failure.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/is-result.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/is-success.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

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

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/map.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {

package/dist/cjs/functions/or-else.cjs

@@ -13,7 +13,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {