fix(execution): multi-decorator support with @trace() and handle hidden returned promises

[tabkram]

PR Summary

Enhancements & Fixes

✅ Added support for multiple decorators, including @trace(), ensuring they work together seamlessly.
✅ Fixed issues with hidden returned promises in async functions, improving execution consistency.
✅ Updated tests to validate new functionality and ensure correctness.
✅ Simplified examples for better readability and ease of understanding.
✅ Refactored the execute() function to improve clarity and maintainability.

---

Main Fix Example

// Fixed example:
class TestClass {
  @trace()
  @say() // Another external decorator that overrides method but still executes it inside a Promise
  someMethod(a: number, b: number) {
    console.log("Original method execution");
    return a + b;
  }
}

---

⚠️ Compatibility Notice

🔹 The execute() function now passes two arguments to the callback instead of one.
🔹 The execute() function no longer includes the options argument and does not update the context when bound.
✅ Except for these minor changes, this PR maintains full backward compatibility (NO BREAKING CHANGES).

Let me know if you'd like further refinements! 🚀

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟢	Statements	96.04% (+0.02% 🔼)	315/328
🟢	Branches	88.38% (-0.32% 🔻)	213/241
🟢	Functions	94.51% (+0.12% 🔼)	86/91
🟢	Lines	96.78% (+0.01% 🔼)	301/311

Show files with reduced coverage 🔻

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / traceDecorator.ts	100%	90% (-10% 🔻)	100%	100%
🟢	... / execute.ts	100%	85% (-1.96% 🔻)	100%	100%

Test suite run success

78 tests passing in 9 suites.

Report generated by 🧪jest coverage report action from 9fbf1b5

[github-actions]

🚫 Unpublished versions: ∅
✅ Created Version: 3.0.0-canary.57.cedcd40
📦 Published on NPM: View on NPM

⚠️ Note: This version is temporary and will be unpublished on the next PR update or merge.

[github-actions]

🚫 Unpublished versions: 3.0.0-canary.57.cedcd40