[in_app_purchase_storekit] Add support for purchase and transactions #7574

[LouiseHsu]

This PR contains the preliminary implementations for handling purchases and transactions

Of note, as of StoreKit 2, the result of a call to a purchase will only return a Transaction when the purchase is successful. If the status of purchase is pending, or cancelled, nothing will be returned.

This is in contrast to StoreKit 1, where developers could check the state of a Transaction with TransactionState. This means that migrating to StoreKit 2 will require developers to update their handling of transactions accordingly.

Relands #7574

Pre-launch Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
• I read the Tree Hygiene page, which explains my responsibilities.
• I read and followed the relevant style guides and ran the auto-formatter. (Unlike the flutter/flutter repo, the flutter/packages repo does use dart format.)
• I signed the CLA.
• The title of the PR starts with the name of the package surrounded by square brackets, e.g. [shared_preferences]
• I linked to at least one issue that this PR fixes in the description above.
• I updated pubspec.yaml with an appropriate new version according to the pub versioning philosophy, or this PR is exempt from version changes.
• I updated CHANGELOG.md to add a description of the change, following repository CHANGELOG style, or this PR is exempt from CHANGELOG changes.
• I updated/added relevant documentation (doc comments with ///).
• I added new tests to check the change I am making, or this PR is test-exempt.
• All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.

[LouiseHsu]

Relands #7574

For future reference, what were the changes to resolve the issue that led to the revert?

Oops, I accidentally updated your comment when I meant to quote it.

Even thought storekittest is technically a mac 11 framework, the bulk of the testing features, such simulating network errors and things like that are mac 14 only. The presubmits passed because it ran on a Mac 14 bot, but the post submit failed because it ran on a Mac 13 bot. :( I've removed the reference to the tests in the mac project in the mean time, since I'm not sure when we'll fully upgrade our fleet. The tests are shared between mac and ios, so the code coverage should be the same.

[stuartmorgan-g]

This failed stable post-submit again: https://github.com/flutter/packages/runs/31667628631

2024-10-17 03:21:48.496039-0700 example[4996:54001] [loading] Error loading /Users/chrome-bot/Library/Developer/Xcode/DerivedData/Runner-cqhwqvjiontyvddtpbfbwdhoqskw/Build/Products/Debug/example.app/Contents/PlugIns/RunnerTests.xctest/Contents/MacOS/RunnerTests (185):  dlopen(/Users/chrome-bot/Library/Developer/Xcode/DerivedData/Runner-cqhwqvjiontyvddtpbfbwdhoqskw/Build/Products/Debug/example.app/Contents/PlugIns/RunnerTests.xctest/Contents/MacOS/RunnerTests, 0x0109): Symbol not found: _$s8StoreKit10parseErrorys0D0_psAC_pF
  Referenced from: <83F64577-ACD3-37DA-BE65-D2B3EFEAF66A> /Volumes/Work/s/w/ir/cache/osx_sdk/xcode_15a240d/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Frameworks/StoreKitTest.framework/Versions/A/StoreKitTest
  Expected in:     <B587D69F-36D8-3163-B1C2-C93FB07648A8> /System/Library/Frameworks/StoreKit.framework/Versions/A/StoreKit
2024-10-17 03:21:48.496159-0700 example[4996:54001] [Default] The bundle “RunnerTests” couldn’t be loaded. Try reinstalling the bundle.
2024-10-17 03:21:48.496177-0700 example[4996:54001] [Default] (dlopen(/Users/chrome-bot/Library/Developer/Xcode/DerivedData/Runner-cqhwqvjiontyvddtpbfbwdhoqskw/Build/Products/Debug/example.app/Contents/PlugIns/RunnerTests.xctest/Contents/MacOS/RunnerTests, 0x0109): Symbol not found: _$s8StoreKit10parseErrorys0D0_psAC_pF
  Referenced from: <83F64577-ACD3-37DA-BE65-D2B3EFEAF66A> /Volumes/Work/s/w/ir/cache/osx_sdk/xcode_15a240d/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Frameworks/StoreKitTest.framework/Versions/A/StoreKitTest
  Expected in:     <B587D69F-36D8-3163-B1C2-C93FB07648A8> /System/Library/Frameworks/StoreKit.framework/Versions/A/StoreKit)
2024-10-17 03:21:48.497216-0700 example[4996:54389] [client] No error handler for XPC error: Connection invalid


*** If you believe this error represents a bug, please attach the result bundle at /Users/chrome-bot/Library/Developer/Xcode/DerivedData/Runner-cqhwqvjiontyvddtpbfbwdhoqskw/Logs/Test/Run-Runner-2024.10.17_03-21-28--0700.xcresult

2024-10-17 03:21:51.278 xcodebuild[4770:53111] [MT] IDETestOperationsObserverDebug: 5.931 elapsed -- Testing started completed.
2024-10-17 03:21:51.278 xcodebuild[4770:53111] [MT] IDETestOperationsObserverDebug: 0.000 sec, +0.000 sec -- start
2024-10-17 03:21:51.278 xcodebuild[4770:53111] [MT] IDETestOperationsObserverDebug: 5.931 sec, +5.931 sec -- end

Test session results, code coverage, and logs:
	/Users/chrome-bot/Library/Developer/Xcode/DerivedData/Runner-cqhwqvjiontyvddtpbfbwdhoqskw/Logs/Test/Run-Runner-2024.10.17_03-21-28--0700.xcresult

Testing failed:
	example (4996) encountered an error (Failed to load the test bundle. (Underlying Error: The bundle “RunnerTests” couldn’t be loaded. The bundle couldn’t be loaded. Try reinstalling the bundle. dlopen(/Users/chrome-bot/Library/Developer/Xcode/DerivedData/Runner-cqhwqvjiontyvddtpbfbwdhoqskw/Build/Products/Debug/example.app/Contents/PlugIns/RunnerTests.xctest/Contents/MacOS/RunnerTests, 0x0109): Symbol not found: _$s8StoreKit10parseErrorys0D0_psAC_pF
  Referenced from: <83F64577-ACD3-37DA-BE65-D2B3EFEAF66A> /Volumes/Work/s/w/ir/cache/osx_sdk/xcode_15a240d/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Frameworks/StoreKitTest.framework/Versions/A/StoreKitTest
  Expected in:     <B587D69F-36D8-3163-B1C2-C93FB07648A8> /System/Library/Frameworks/StoreKit.framework/Versions/A/StoreKit))

** TEST FAILED **

[stuartmorgan-g]

Even thought storekittest is technically a mac 11 framework, the bulk of the testing features, such simulating network errors and things like that are mac 14 only. The presubmits passed because it ran on a Mac 14 bot, but the post submit failed because it ran on a Mac 13 bot. :(

I think that if in your next version of this you temporarily, in your PR, change the .ci.yaml to only allow Mac 13 hosts, you might be able to get presubmit testing to make sure everything is good. (I'm not 100% sure that change takes effect in presubmit though.)

[LouiseHsu]

Even thought storekittest is technically a mac 11 framework, the bulk of the testing features, such simulating network errors and things like that are mac 14 only. The presubmits passed because it ran on a Mac 14 bot, but the post submit failed because it ran on a Mac 13 bot. :(

I think that if in your next version of this you temporarily, in your PR, change the .ci.yaml to only allow Mac 13 hosts, you might be able to get presubmit testing to make sure everything is good. (I'm not 100% sure that change takes effect in presubmit though.)

Oh, thats a good idea. Im really struggling with testing this properly cuz I have to keep restarting and trying to get specific bots.