basedone_core

Fixed

• Comprehensive null safety improvements across all model files to handle unexpected null values from API responses
• entities.dart: Fixed null handling in Order, OrderEvent, Product, ProductVariant, ProductReview, Coupon, CouponUsage, Banner, BannerMerchant, Message, ShippingRate, ShippingZone, ShippingOption, MediaAsset, FlashSale, FlashSaleItem, FlashSaleItemProduct, ReviewUser
• responses.dart: Fixed null handling in CreateOrderSummary, EscrowInfo, ConfirmEscrowDepositResponse, AppliedDiscount, ValidatedDiscount, TaxBreakdownItem, PublicMerchantProfile, MerchantInfo, FollowStatusResponse, FollowActionResponse, FollowedMerchantSummary, FollowedMerchantInfo, FlashSaleTimeRemaining, ActiveFlashSalesResponse, FlashSaleAllowanceInfo, PaymentMethodInfo, GetPaymentMethodsResponse, CustomerConversation, ConversationMerchant, MessageStats, GetGemBalanceResponse, GemHistoryItem, GemHistoryPagination, ExpiringGemBatch, BrowsingLocation, DeleteBrowsingLocationResponse, CashAccountBalanceResponse, DeliveryAddressInfo, DeliveryAddressResponse, CustomerSummary, OrderEvent, ShippingMethod, ReturnRequest, AnalyticsOverview, AnalyticsChartDataPoint, ProductMetric, InventoryAuditEntry, InventoryAuditProduct, TaxSettings, TaxRule, TaxNexus, TaxReport, TaxReportRecord, MerchantConversation, MerchantConversationCustomer
• dropshipping.dart: Fixed null handling in DropshipSupplier, DropshipSupplierInfo, SupplierProduct, SupplierProductVariant, SupplierCategory, DropshipProduct, DropshipLocalProduct, DropshipOrderLink, DropshipOrderInfo, DropshipOrderItemInfo, DropshipSupplierBrief, DropshipMerchantSettings, DropshipForwardingDetails
• All non-nullable String, int, bool, and num fields now have safe default values when API returns null

Fixed

• Fixed Merchant.name field to handle null values from API (defaults to empty string)

Fixed

• Improved robustness of JSON parsing across all entity models to handle null values from API responses
• Made ProductVariant fields nullable: createdAt, updatedAt, with defaults for isActive (true), sortOrder (0), and attributes (empty map)
• Made ProductReview fields nullable: createdAt, updatedAt, status, with defaults for isVerifiedPurchase (false), isVisible (true), helpfulCount (0)
• Fixed list casting to handle null values with empty list defaults in:
  • FlashSaleItemProduct.images
  • FlashSale.items
  • ShippingZone.countries
  • Coupon.applicableProducts and applicableCategories
  • CreateOrderSummary.merchantNames
  • PublicMerchantProfile.categories
  • All dropshipping entities with list fields
• Added default values for boolean and integer fields that could be null in various entities
• Fixed rating field parsing in ProductReview to use safe integer parsing

Fixed

• Made Merchant entity fields nullable (createdAt, updatedAt, ownerUserId, payoutAddress, status) to handle simplified merchant objects returned in product listings

Added

• getDeliveryAddress() method to CustomerEcommerceClient for BasedPay delivery address

Fixed

• Fixed JSON parsing for averageRating and reviewCount fields to handle both string and numeric values from API responses

Added

• Initial release of BasedOne Core Dart SDK
• CustomerEcommerceClient for customer-facing operations:
  • Product browsing, search, and filtering
  • Shopping cart management
  • Multi-merchant checkout with USDC escrow payments
  • Order tracking and history
  • Reviews and ratings
  • Wishlists
  • Gems (loyalty points) system
  • Flash sales support
• MerchantEcommerceClient for merchant dashboard operations:
  • Store profile management
  • Product catalog CRUD with variants
  • Order management and fulfillment
  • Customer management
  • Coupons and discounts
  • Shipping configuration (methods, zones, rates)
  • Returns and refunds processing
  • Review management
  • Customer messaging
  • Media library
  • Promotional banners
  • Analytics and reporting
  • Inventory management with audit logs
  • Tax configuration (rules, nexus, reports)
  • Dropshipping integration
• Type-safe models for all API entities
• Built-in retry logic with exponential backoff
• Comprehensive enum definitions for all status types