📄 Documentation Update #

• Added full SDK documentation across:

  • All V1 & V2 models
  • Enums
  • Services
  • Checkout view
  • Barrel exports

• Improved inline DartDoc everywhere for:

  • Better IDE autocomplete
  • Cleaner pub.dev documentation
  • Easier onboarding for developers

• Ensured consistent formatting and explanations across all classes.

🛠 Refactor & Stability Improvements #

• Removed all part / part of files across V1 and V2 to make the package fully modular and public-API friendly.
• Replaced parts with standard imports, fixing issues where models were not accessible when importing the package.
• Properly exported all V1 & V2 models, enums, and services from the main library file.
• Improved package structure to follow pub.dev best practices for public packages.
• Stability improvements for IDE code completion, analyzer warnings, and pub.dev scoring.
• No breaking API changes — all models remain the same, just now properly exposed.

• Added Tharwat to the contributors.

• Added a donation link.

PayPal: https://paypal.me/mazenelgayar

InstaPay: https://ipn.eg/S/mazenel-gayarcib/instapay/0ecfXw Tag: mazenel-gayarcib@instapay

🧩 Unified V1 + V2 API with shared models and services

This release builds on top of the V2 Orders support and introduces a unified, version-aware API that can handle both PayPal Payments API V1 and Orders API V2 from a single, clean interface.

✨ New Features #

• Added shared abstract base types:

  • PaypalServicesBase
  • PayPalOrderRequestBase

• New unified checkout widget:

  • PaypalCheckoutView
  • Explicit version: PayPalApiVersion.v1 | PayPalApiVersion.v2

• Shared payment result model:

  • PaypalPaymentModel (used for both V1 & V2 flows)

• Version-aware order models:

  • PayPalOrderRequestV1 (Payments API v1)
  • PayPalOrderRequestV2 (Orders API v2)

• Clear client-side handling of:

  • V1 → Execute via PayerID
  • V2 → Capture via orderId

🧪 New Example Screen #

• Demo screen with two buttons:

  • “Pay with PayPal (V2 – Orders API)”
  • “Pay with PayPal (V1 – Payments API)”

• Documentation explaining secure vs insecure workflows.

🔒 Safety & Validation #

• Added runtime validation for mismatched order/service versions.
• Centralized checks for empty orders, null payloads, and invalid states.

⚠️ Deprecated / Breaking Notes #

• PaypalCheckoutViewV1 / V2 now replaced by unified widget.

🚀 Major rewrite introducing full PayPal Orders API V2 support.

Highlights #

• V2 Orders API: create + capture flow
• Strongly typed models
• New enums for shipping, payment preference, landing page, etc.
• Secure custom URL schemes
• Safer credential validation
• Cleaner webview flow

Initial package features.