feat!: 6.0.0 Major Refactoring - Complete Breaking Changes

[hyochan]

🚀 Summary

Major refactoring for flutter_inapp_purchase v6.0.0 with complete breaking changes to improve type safety, code organization, and developer experience.

💥 BREAKING CHANGES

File Structure

• Moved all enums from types.dart to new enums.dart file
• Renamed Store.dart to enums.dart for consistency
• Split module-specific code into separate files:
  • modules/android.dart for Android-specific functionality
  • modules/ios.dart for iOS-specific functionality
• Created dedicated type files:
  • types/iap_android_types.dart
  • types/iap_ios_types.dart

Type Safety Improvements

• Fixed all List<dynamic>? warnings with explicit type annotations
• Added explicit Future<dynamic> return types where applicable
• Fixed all type inference issues with explicit parameter types
• Improved null safety throughout the codebase

Removed Deprecated APIs

• Removed unused _finishTransactionIOSOld method
• Cleaned up deprecated methods scheduled for removal in v6.0.0

Error Handling

• Created new utils/error_mapping.dart for centralized error handling
• Improved error type definitions and mapping

✨ New Features

• Added use_iap.dart hook for Flutter Hooks integration
• Better separation of concerns with module-specific files
• Improved type definitions for Android and iOS platforms

📝 Migration Guide

Import Changes

// Before
import 'package:flutter_inapp_purchase/Store.dart';
import 'package:flutter_inapp_purchase/types.dart';

// After
import 'package:flutter_inapp_purchase/enums.dart';
import 'package:flutter_inapp_purchase/types.dart';

Enum Usage

All enums are now imported from enums.dart. The types.dart file exports enums.dart for backward compatibility, but direct imports are recommended.

Platform-Specific Code

// Android-specific
import 'package:flutter_inapp_purchase/modules/android.dart';

// iOS-specific
import 'package:flutter_inapp_purchase/modules/ios.dart';

🧪 Test Plan

• All existing tests pass
• Type checking passes without warnings
• Example app runs correctly on both platforms
• Migration from v5.x works as documented

📊 Impact

This is a major version bump (v6.0.0) with extensive breaking changes. All users will need to update their code when upgrading.

Closes #505 #507 #503 #501 #500 #496 #495 #494 #491 #482

[FelixYew]

This version 6.0.0 purchaseUpdatedListener for iOS doesn't work. When requestPurchase on iOS the result doesn't call purchaseUpdatedListener.

[FelixYew]

Another error for finishTransaction on Android calling 'consumeProduct' and 'acknowledgePurchase' passing token key should be 'purchaseToken' instead of 'token'.

[hyochan]

@FelixYew Thanks for testing 6.0.0-rc.1 and sharing the report! Could you please try 6.0.0-rc.2? I’ve just published the fixes.

[FelixYew]

@hyochan Thanks for the fixes. Is working now.

[doublev2906]

Hi @hyochan, i have just updated to version [6.0.0-rc.3] and i take this eror when run flutter run:
Swift Compiler Error (Xcode): Value of type 'AppTransaction' has no member 'appTransactionID' /Users/pancake/.pub-cache/hosted/pub.dev/flutter_inapp_purchase-6.0.0-rc.3/darwin/Classes/FlutterInappPurchasePlugin.swift:618:72
Can you help me fix this. If you need more information to check it please inform me.

[hyochan]

@doublev2906 Could you kindly share your Xcode version and also check the doc in expo-iap? It isn't in flutter doc but this is same issue as in https://expo-iap.hyo.dev/docs/guides/faq#build-error-apptransactionid-property-not-found.

[doublev2906]

@hyochan I am used xcode version 16.2. Sorry about a mistake. Thank you so much.