feat: add a configurable setting to put the CloudModeProcessor to sleep for a specified interval

[1abhishekpandey]

Description

Added a builder method withEventDispatchSleepInterval(int eventDispatchSleepInterval) that allows users to configure the sleep interval for the CloudModeProcessor when it is idle (i.e., no events to process). The default interval is 1 second, ensuring no change in existing behaviour. This feature enables users to conserve battery by putting the CloudModeProcessor thread to sleep for a specified interval.

Also, note that the value specified in withEventDispatchSleepInterval(...) should not exceed the sleepTimeOut value; otherwise, the default value of 1 second will be used.

NOTE: Currently, the default behaviour dictates that if there are no events to process, the CloudModeProcessor checks every 1 second for new events in the database. This ensures prompt event delivery. Once the user changes this default setting, the thread will sleep for a specified interval before checking the database again for new events.

Fixes # (issue)
#417

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Checklist:

• Version upgraded (project, README, gradle, podspec etc)
• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added unit tests for the code
• I have made corresponding changes to the documentation

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarCloud