@praha/byethrow 0.9.0 → 0.10.1

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

@@ -1,7 +1,6 @@
 import type { Result, ResultAsync } from '../result.js';
 /**
- * Wraps a function execution (sync or async) or a Promise in a {@link Result} or {@link ResultAsync} type,
- * capturing errors and returning them in a structured way.
+ * Executes a function that may throw and wraps the result in 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.
@@ -9,28 +8,13 @@ import type { Result, ResultAsync } from '../result.js';
  * @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 {@link Result} or {@link ResultAsync} wrapping the function's return value or the caught error.
  *
  * @example Sync try-catch
  * ```ts
  * import { Result } from '@praha/byethrow';
  *
- * const fn = Result.try({
- *   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 try-catch with immediate execution
- * ```ts
- * import { Result } from '@praha/byethrow';
- *
  * const result = Result.try({
- *   immediate: true,
  *   try: () => {
  *     const x = Math.random() * 10 - 5;
  *     if (x < 0) throw new Error('Negative!');
@@ -46,21 +30,8 @@ import type { Result, ResultAsync } from '../result.js';
  * ```ts
  * import { Result } from '@praha/byethrow';
  *
- * const fn = Result.try({
- *   safe: true,
- *   try: (x: number) => x + 1,
- * });
- *
- * const result = fn(1); // Result.Result<number, never>
- * ```
- *
- * @example Sync safe with immediate execution
- * ```ts
- * import { Result } from '@praha/byethrow';
- *
  * const result = Result.try({
  *   safe: true,
- *   immediate: true,
  *   try: () => Math.random() + 1,
  * });
  *
@@ -71,20 +42,7 @@ import type { Result, ResultAsync } from '../result.js';
  * ```ts
  * import { Result } from '@praha/byethrow';
  *
- * const fn = Result.try({
- *   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 try-catch with immediate execution
- * ```ts
- * import { Result } from '@praha/byethrow';
- *
  * const result = Result.try({
- *   immediate: true,
  *   try: () => fetch('/api/data'),
  *   catch: (error) => new Error('Fetch failed', { cause: error }),
  * });
@@ -96,21 +54,8 @@ import type { Result, ResultAsync } from '../result.js';
  * ```ts
  * import { Result } from '@praha/byethrow';
  *
- * const fn = Result.try({
- *   safe: true,
- *   try: async () => await Promise.resolve('ok'),
- * });
- *
- * const result = await fn(); // Result.ResultAsync<string, never>
- * ```
- *
- * @example Async safe with immediate execution
- * ```ts
- * import { Result } from '@praha/byethrow';
- *
  * const result = Result.try({
  *   safe: true,
- *   immediate: true,
  *   try: () => Promise.resolve('ok'),
  * });
  *
@@ -120,40 +65,20 @@ import type { Result, ResultAsync } from '../result.js';
  * @category Creators
  */
 declare const try_: {
-    <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 () => Promise<any>, E>(options: {
-        immediate: true;
         try: T;
         catch: (error: unknown) => E;
     }): 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 () => Promise<any>>(options: {
         safe: true;
-        immediate: true;
         try: 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 () => any, E>(options: {
-        immediate: true;
         try: T;
         catch: (error: unknown) => E;
     }): Result<ReturnType<T>, E>;
-    <T extends (...args: readonly any[]) => any>(options: {
-        safe: true;
-        try: T;
-    }): (...args: Parameters<T>) => Result<ReturnType<T>, never>;
     <T extends () => any>(options: {
         safe: true;
-        immediate: true;
         try: T;
     }): Result<ReturnType<T>, never>;
 };

package/dist/esm/functions/try.js

@@ -2,9 +2,9 @@ import { fail } from "./fail.js";
 import { succeed } from "./succeed.js";
 import { isPromise } from "../internals/helpers/is-promise.js";
 const try_ = (options)=>{
-    const fn = (...args)=>{
+    const fn = ()=>{
         try {
-            const output = options.try(...args);
+            const output = options.try();
             if (isPromise(output)) {
                 const promise = succeed(output);
                 if ('safe' in options && options.safe) return promise;
@@ -16,7 +16,6 @@ const try_ = (options)=>{
             return fail(options.catch(error));
         }
     };
-    if ('immediate' in options && options.immediate) return fn();
-    return fn;
+    return fn();
 };
 export { try_ as try };

package/dist/esm/index.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praha/byethrow",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "description": "A lightweight, tree-shakable Result type package with a simple, consistent API designed",
   "keywords": [
     "javascript",
@@ -44,12 +44,12 @@
     "@standard-schema/spec": "^1.0.0"
   },
   "devDependencies": {
-    "@rslib/core": "0.18.5",
-    "eslint": "9.39.2",
-    "typedoc": "0.28.15",
-    "typedoc-plugin-markdown": "4.9.0",
+    "@rslib/core": "0.20.0",
+    "eslint": "9.39.4",
+    "typedoc": "0.28.17",
+    "typedoc-plugin-markdown": "4.11.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.16"
+    "vitest": "4.1.0"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"