feat: retain multiple calls per event until consumed

[robingenz]

Feature Request

Description

Currently retainUntilConsumed supports only one call per event. This leads to older calls being dropped when a new call is received, even though both calls may still be relevant.

Example: My Capacitor Firebase Cloud Messaging plugin has a notificationReceived listener, which should return all notifications received while the app was not active and not only the last notification.

Platform(s)

• Android
• iOS

Preferred Solution

The retainUntilConsumed option should save all calls.

Alternatives

Additional Context

[riderx]

@robingenz maybe return array instead of one event could fix your issue no ?

[robingenz]

No, unfortunately not. Since I don't know when the event will be consumed, I also don't know when I have to clear the array again.
Besides, this would only be a workaround with a bad developer experience.

[ionitron-bot]

Thanks for the issue! This issue is being locked to prevent comments that are not relevant to the original issue. If this is still an issue with the latest version of Capacitor, please create a new issue and ensure the template is fully filled out.