feat: added flushExecutions to clear cached results

[petruki]

This pull request introduces a new feature to flush cached executions for a specific switcher, updates relevant documentation, and includes minor improvements and tests to support this functionality. The main focus is to allow users to clear throttled or cached results for a given switcher key, improving control over feature flag evaluations.

New Feature: Flush Cached Executions

• Added a flushExecutions() method to the Switcher class that clears cached executions for the current switcher key by calling the new ExecutionLogger.clearByKey() utility. [1] [2]
• Documented the new flushExecutions() method in the README.md with usage examples for users.
• Added a functional test to verify that flushExecutions() properly clears cached executions for a specific switcher key.

Minor Improvements

• Improved the isItOn() method in Switcher to always return a resolved promise when called asynchronously, ensuring consistent async behavior.
• Clarified documentation for the execute method parameter to indicate it can accept a switcher key or a forceAsync boolean.
• Updated test setup in tests/playground/index.ts to accurately reflect requirements and usage of async calls.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud