feat: added flushExecutions to clear cached results

[petruki]

This pull request adds a new capability to flush (clear) cached throttling results for a specific switcher, and documents this feature. It also introduces related utility and test code to ensure correct behavior. The most important changes are grouped below:

New Feature: Flush Cached Throttling Results

• Added a flushExecutions() method to the Switcher class, allowing users to clear cached execution results for a specific switcher. (src/switcher.js)
• Implemented the clearByKey() static method in ExecutionLogger to support clearing results by switcher key. (src/lib/utils/executionLogger.js)
• Updated the documentation to describe how to use the new flush functionality. (README.md)

Testing and Validation

• Added a functional test to verify that flushExecutions() removes cached executions for a switcher. (tests/switcher-functional.test.js)
• Minor update to the async call example in the playground test to use the correct method and clarify remote API requirements. (tests/playground/index.js)

[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