Overall confusion with APIs and documentation

[rodperottoni]

Description

This module used to be quite easy to use prior to version 11.x. I have been trying to migrate my app to 12.x and realised a lot of the technical decisions made for the Android update add a lot of friction and aren't properly documented. For example, why does the requestPurchase function now accepts both sku (for iOS) and skus (Android) ?

Adding to that, it doesn't seem like this is documented anywhere at all. Overall it seems like the APIs for both iOS and Android have deviated drastically from one another in the last updated and this was not even part of the list of breaking changes.

I'm by no means complaining or meaning to shame the wonderful work of the maintainers, but just think some changes have made into the public versions without updates to the docs or changelogs.

Expected Behavior

• API changes should have been listed in the Breaking Changes of 12.x
• The documentation doesn't mention the difference between requestPurchase on both platforms
• The documentation doesn't mention the new Product object shapes since the May 2022 Play Store changes. Things like localizedPrice are simply not there anymore.