try sync returns (#33)

Author: w01fgang

.gitignore

@@ -1,2 +1,3 @@
 node_modules
 dist
+.worktrees

.planning/STATE.md

@@ -12,22 +12,22 @@ See: .planning/PROJECT.md (updated 2026-01-31)
 Phase: 1 of 3 (Core Try Semantics)
 Plan: 0 of TBD in current phase
 Status: Ready to plan
-Last activity: 2026-01-31 - Completed quick task 001: write tests that verify type safety accoriding to the use cases covered in Readme.md
+Last activity: 2026-02-01 - Completed quick task 002: stabilize Try typecheck failures
 
 Progress: [░░░░░░░░░░] 0%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 1
-- Average duration: 2m 41s
-- Total execution time: 2m 41s
+- Total plans completed: 2
+- Average duration: 4m 10s
+- Total execution time: 8m 19s
 
 **By Phase:**
 
 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
-| Quick | 1 | 2m 41s | 2m 41s |
+| Quick | 2 | 8m 19s | 4m 10s |
 
 **Recent Trend:**
 - Last 5 plans: -
@@ -42,7 +42,8 @@ Progress: [░░░░░░░░░░] 0%
 Decisions are logged in PROJECT.md Key Decisions table.
 Recent decisions affecting current work:
 
-- None yet.
+- Use return-type generics to preserve async/sync inference in Try
+- Treat never as non-promise in IfPromise to avoid type collapse
 
 ### Pending Todos
 
@@ -61,9 +62,10 @@ None yet.
 | # | Description | Date | Commit | Directory |
 |---|-------------|------|--------|-----------|
 | 001 | write tests that verify type safety accoriding to the use cases covered in Readme.md | 2026-01-31 | 9595583 | [001-write-tests-that-verify-type-safety-acco](./quick/001-write-tests-that-verify-type-safety-acco/) |
+| 002 | stabilize Try typecheck failures for type-safety tests | 2026-02-01 | 793eed1 | [002-tests-are-failing](./quick/002-tests-are-failing/) |
 
 ## Session Continuity
 
-Last session: 2026-01-31 14:21 UTC
-Stopped at: Completed quick-001 type-safety-tests plan 001
+Last session: 2026-02-01 06:36 UTC
+Stopped at: Completed quick-002 tests-are-failing plan 01
 Resume file: None

CHANGELOG.md

@@ -1,5 +1,11 @@
 # @power-rent/try-catch
 
+## 1.1.0
+
+### Minor Changes
+
+- 97e3047: allow running both sync and async functions
+
 ## 1.0.1
 
 ### Patch Changes

README.md

@@ -105,18 +105,20 @@ The library accepts any parameter types as function arguments:
 
 ```typescript
 // String parameters
-const greeting = await new Try(greet, 'Alice', 'Hi').value();
+const greeting = new Try(greet, 'Alice', 'Hi').value();
 
 // Number parameters
-const sum = await new Try(add, 5, 3).unwrap();
+const sum = new Try(add, 5, 3).unwrap();
 
 // Mixed parameter types
-const message = await new Try(formatMessage, 123, 'Test message', true).value();
+const message = new Try(formatMessage, 123, 'Test message', true).value();
 
 // No parameters
-const timestamp = await new Try(getCurrentTime).value();
+const timestamp = new Try(getCurrentTime).value();
 ```
 
+Sync functions return values immediately; async functions require `await`.
+
 ### Advanced Usage
 
 ```typescript
@@ -233,22 +235,24 @@ Enable debug logging to console. When enabled, errors will be logged to console.
 
 ### Execution Methods
 
-#### `.unwrap(): Promise<Awaited<T>>`
+#### `.unwrap(): T | Promise<Awaited<T>>`
 
 Execute the function and return the result. Throws the original error if one occurred. Will mask the error message if `.report('custom message')` is called in the chain.
 
 #### `.default<Return>(defaultValue: Return): Try<T, TArgs>`
 
 Set a default value that will be returned by `.value()` when an exception occurs.
 
-#### `.value(): Promise<Awaited<T> | Return | undefined>`
+#### `.value(): T | undefined | Promise<Awaited<T> | undefined>`
 
 Execute the function and return the result, the configured default value, or `undefined` if an error occurs.
 
-#### `.error(): Promise<Error | undefined>`
+#### `.error(): Error | undefined | Promise<Error | undefined>`
 
 Execute the function and return the error if one occurred, or `undefined` if successful.
 
+Sync functions return values immediately; async functions return Promises.
+
 ## Examples
 
 ### Different Parameter Types
@@ -258,20 +262,20 @@ Execute the function and return the error if one occurred, or `undefined` if suc
 function greet(name: string, greeting: string = 'Hello'): string {
   return `${greeting}, ${name}!`;
 }
-const greeting = await new Try(greet, 'Alice', 'Hi').value();
+const greeting = new Try(greet, 'Alice', 'Hi').value();
 
 // Number parameters
 function add(a: number, b: number): number {
   return a + b;
 }
-const sum = await new Try(add, 5, 3).value();
+const sum = new Try(add, 5, 3).value();
 
 // Mixed parameter types
 function formatMessage(id: number, message: string, urgent: boolean): string {
   const prefix = urgent ? '[URGENT]' : '[INFO]';
   return `${prefix} #${id}: ${message}`;
 }
-const formatted = await new Try(formatMessage, 123, 'System error', true)
+const formatted = new Try(formatMessage, 123, 'System error', true)
   .report('Message formatting failed')
   .tag('component', 'notification')
   .default('Unexpected error')
@@ -281,7 +285,7 @@ const formatted = await new Try(formatMessage, 123, 'System error', true)
 function getCurrentTime(): number {
   return Date.now();
 }
-const timestamp = await new Try(getCurrentTime).value();
+const timestamp = new Try(getCurrentTime).value();
 
 // Object parameters (key extraction available)
 const user = await new Try(fetchUser, { userId: 123, includeProfile: true })

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@power-rent/try-catch",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A TypeScript utility for simplified async error handling with Sentry integration",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",