feat: automatic push click handling

[levibostian]

iOS part of ticket: https://github.com/customerio/issues/issues/11289

I suggest starting here in your PR review.

[github-actions]

Sample app builds 📱

Below you will find the list of the latest versions of the sample apps. It's recommended to always download the latest builds of the sample apps to accurately test the pull request.

---

• CocoaPods-FCM: levi/reliable-open-metrics (1707748160)
• APN-UIKit: levi/reliable-open-metrics (1707748099)

[Ahmed-CIO]

the scope of these changes is massive, let's break it down and describe each change in its own right

[Ahmed-CIO]

Had a chat with Levi about this one. Given this was something took place a while ago and was already reviewed, I won't block it farther.
Moving forward though:

• When we stack PRs and we are not using any tools that helps keep each PR in the stack reflecting its own change, then we start merge from the bottom to make sure the rest of the PRs don't end up looking like they changed the entire world.
• Let's also avoid a situation where approved work hangs for too long, as this can cause two issues:
  • Might need to rebase on main that has conflicting changes, then resolving the conflicts with a stale PR can introduce unwanted behavior and there would be either no review, or a need to a second review that could have been avoided
  • It is better to keep the list of PRs tidy. If there is something there then it is either a draft, or something need an action.

[Ahmed-CIO]

Please also double check any existing new comments that took place after putting it all together and address them before landing

P.s looks like I did a review with my personal account, which definitely did not do much other than a comment :D