feat!: 6.0.0 Major Refactoring - Complete Breaking Changes (#510)

## 🚀 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
```dart
// 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
```dart
// Android-specific
import 'package:flutter_inapp_purchase/modules/android.dart';

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

## 🧪 Test Plan

- [x] All existing tests pass
- [x] Type checking passes without warnings
- [x] 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

Author: hyochan

.claude/settings.local.json

@@ -6,8 +6,8 @@
 pubspec.lock
 
 build/
+.claude/
 
-# dooboolab
 .idea/
 flutter_inapp.iml
 flutter_inapp_android.iml

.gitignore

@@ -0,0 +1,20 @@
+# Documentation site (not needed for pub.dev)
+
+docs/
+
+# Development files
+
+.vscode/
+.claude/
+
+# CI/CD files
+
+.github/
+
+# Example app
+
+example/
+
+# Test files
+
+test/

.pubignore

@@ -2,7 +2,7 @@
   // Editor settings
   "editor.formatOnSave": true,
   "editor.codeActionsOnSave": {
-    "source.fixAll": true
+    "source.fixAll": "explicit"
   },
 
   // Dart & Flutter settings
@@ -13,7 +13,7 @@
     "editor.suggest.snippetsPreventQuickSuggestions": false,
     "editor.suggestSelection": "first",
     "editor.tabCompletion": "onlySnippets",
-    "editor.wordBasedSuggestions": false
+    "editor.wordBasedSuggestions": "off"
   },
 
   // Files to exclude from explorer
@@ -62,5 +62,5 @@
   // Docusaurus specific
   "typescript.tsdk": "docs/node_modules/typescript/lib",
   "npm.packageManager": "npm",
-  "cSpell.words": ["inapp"]
+  "cSpell.words": ["inapp", "Inapp"]
 }

.vscode/settings.json

@@ -1,3 +1,103 @@
+## 6.0.0-rc.1
+
+### Release Candidate
+
+This is a release candidate for v6.0.0 with significant breaking changes. Please test thoroughly before using in production.
+
+### Package Changes
+
+- **Package**: Changed package name from `dev.hyochan.flutterinapppurchase` to `dev.hyo.flutterinapppurchase`
+- **Documentation**: Moved from `docs/` to `doc/` directory for pub.dev convention
+- **Version**: First release candidate for v6.0.0 major version
+
+### Breaking Changes
+
+- **iOS**: Now requires iOS 11.0+ (previously 8.0+)
+- **iOS**: StoreKit 2 is now used by default on iOS 15.0+ devices
+- **Android**: Updated to Billing Client v8.0.0 (from v6.0.1)
+- **API**: Complete refactoring of class structure and enum naming conventions
+  - `ErrorCode` enum values changed from `E_UNKNOWN` to `eUnknown` (lowerCamelCase)
+  - `PeriodUnitIOS` enum values changed from `DAY` to `day` (lowerCamelCase)
+  - Platform-specific classes moved to mixins (`FlutterInappPurchaseIOS`, `FlutterInappPurchaseAndroid`)
+  - Channel access changed from static to instance member
+
+### New Features
+
+- **iOS**: Full StoreKit 2 support for iOS 15.0+
+  - Automatic transaction verification
+  - Better subscription management
+  - Improved error handling
+  - No receipt validation needed for StoreKit 2
+- **iOS**: Automatic fallback to StoreKit 1 for iOS 11.0-14.x
+- **Android**: Support for all Billing Client v8 features
+- **Architecture**: New mixin-based architecture for better code organization
+  - Platform-specific code separated into `modules/ios.dart` and `modules/android.dart`
+  - Improved testability and maintainability
+
+### Migration Guide
+
+- Update all `ErrorCode` references:
+  ```dart
+  // Before
+  ErrorCode.E_USER_CANCELLED
+  // After
+  ErrorCode.eUserCancelled
+  ```
+- Update channel access in tests:
+  ```dart
+  // Before
+  FlutterInappPurchase.channel
+  // After
+  FlutterInappPurchase.instance.channel
+  ```
+- StoreKit 2 will be used automatically on supported devices
+- StoreKit Configuration files (.storekit) work with StoreKit 2 on iOS 15+
+
+## 6.0.0
+
+### Breaking Changes
+
+- **iOS**: Now requires iOS 11.0+ (previously 8.0+)
+- **iOS**: StoreKit 2 is now used by default on iOS 15.0+ devices
+- **Android**: Updated to Billing Client v8.0.0 (from v6.0.1)
+- **API**: Complete refactoring of class structure and enum naming conventions
+  - `ErrorCode` enum values changed from `E_UNKNOWN` to `eUnknown` (lowerCamelCase)
+  - `PeriodUnitIOS` enum values changed from `DAY` to `day` (lowerCamelCase)
+  - Platform-specific classes moved to mixins (`FlutterInappPurchaseIOS`, `FlutterInappPurchaseAndroid`)
+  - Channel access changed from static to instance member
+
+### New Features
+
+- **iOS**: Full StoreKit 2 support for iOS 15.0+
+  - Automatic transaction verification
+  - Better subscription management
+  - Improved error handling
+  - No receipt validation needed for StoreKit 2
+- **iOS**: Automatic fallback to StoreKit 1 for iOS 11.0-14.x
+- **Android**: Support for all Billing Client v8 features
+- **Architecture**: New mixin-based architecture for better code organization
+  - Platform-specific code separated into `modules/ios.dart` and `modules/android.dart`
+  - Improved testability and maintainability
+
+### Migration Guide
+
+- Update all `ErrorCode` references:
+  ```dart
+  // Before
+  ErrorCode.E_USER_CANCELLED
+  // After
+  ErrorCode.eUserCancelled
+  ```
+- Update channel access in tests:
+  ```dart
+  // Before
+  FlutterInappPurchase.channel
+  // After
+  FlutterInappPurchase.instance.channel
+  ```
+- StoreKit 2 will be used automatically on supported devices
+- StoreKit Configuration files (.storekit) work with StoreKit 2 on iOS 15+
+
 ## 5.6.2
 
 - fix: removed references to deprecated v1 Android embedding by @moodstubos in https://github.com/hyochan/flutter_inapp_purchase/pull/497
@@ -438,4 +538,4 @@ Republishing since sourcode seems not merged correctly.
 ## 0.1.0
 
 - Initial release of beta
-- Moved code from [react-native-iap](https://github.com/dooboolab/react-native-iap)
+- Moved code from [react-native-iap](https://github.com/hyochan/react-native-iap)

CHANGELOG.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 dooboolab
+Copyright (c) 2025 hyochan
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSE

@@ -0,0 +1,30 @@
+// swift-tools-version: 5.9
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "flutter_inapp_purchase",
+    platforms: [
+        .iOS("12.0")
+    ],
+    products: [
+        .library(name: "flutter-inapp-purchase", targets: ["flutter_inapp_purchase"])
+    ],
+    dependencies: [],
+    targets: [
+        .target(
+            name: "flutter_inapp_purchase",
+            dependencies: [],
+            path: "ios/Classes",
+            resources: [
+                .process("../Assets")
+            ],
+            publicHeadersPath: "",
+            cSettings: [
+                .headerSearchPath("../Flutter"),
+                .headerSearchPath("../../../Flutter/Export")
+            ]
+        )
+    ]
+)