spree_api 5.6.1 → 6.0.0.beta1

data/lib/spree/api/configuration.rb

@@ -3,19 +3,14 @@ require 'spree/core/preferences/runtime_configuration'
 module Spree
   module Api
     class Configuration < Spree::Preferences::RuntimeConfiguration
-      preference :api_v2_serializers_cache_ttl, :integer, default: 3600 # 1 hour in seconds
-      preference :api_v2_collection_cache_ttl, :integer, default: 3600 # 1 hour in seconds
-      preference :api_v2_collection_cache_namespace, :string, default: 'api_v2_collection_cache'
-      preference :api_v2_content_type, :string, default: 'application/vnd.api+json'
-      preference :api_v2_per_page_limit, :integer, default: 500
-
       preference :jwt_expiration, :integer, default: 3600 # 1 hour in seconds (customer/store JWT default)
       preference :admin_jwt_expiration, :integer, default: 300 # 5 minutes — admin tokens have higher blast radius
       preference :jwt_secret_key, :string, default: nil
       preference :refresh_token_expiry, :integer, default: 2_592_000 # 30 days in seconds
 
       # Rate limiting
-      preference :rate_limit_per_key, :integer, default: 300 # per publishable API key
+      preference :rate_limit_per_key, :integer, default: 300 # per publishable API key + client IP (per visitor)
+      preference :rate_limit_per_secret_key, :integer, default: 600 # per secret API key, across the whole API
       preference :rate_limit_window, :integer, default: 60 # window in seconds
       preference :rate_limit_login, :integer, default: 5 # per IP
       preference :rate_limit_register, :integer, default: 3 # per IP

data/lib/spree/api/dependencies.rb

@@ -4,104 +4,19 @@ module Spree
   module Api
     class ApiDependencies
       INJECTION_POINTS_WITH_DEFAULTS = {
-        # Legacy API v2 dependencies - will be removed in Spree 6
-        # cart services
-        storefront_cart_create_service: -> { Spree::Dependencies.cart_create_service },
-        storefront_cart_add_item_service: -> { Spree::Dependencies.cart_add_item_service },
-        storefront_cart_compare_line_items_service: -> { Spree::Dependencies.cart_compare_line_items_service },
-        storefront_cart_update_service: -> { Spree::Dependencies.cart_update_service },
-        storefront_cart_remove_line_item_service: -> { Spree::Dependencies.cart_remove_line_item_service },
-        storefront_cart_remove_item_service: -> { Spree::Dependencies.cart_remove_item_service },
-        storefront_cart_set_item_quantity_service: -> { Spree::Dependencies.cart_set_item_quantity_service },
-        storefront_cart_recalculate_service: -> { Spree::Dependencies.cart_recalculate_service },
-        storefront_cart_estimate_shipping_rates_service: -> { Spree::Dependencies.cart_estimate_shipping_rates_service },
-        storefront_cart_empty_service: -> { Spree::Dependencies.cart_empty_service },
-        storefront_cart_destroy_service: -> { Spree::Dependencies.cart_destroy_service },
-        storefront_cart_associate_service: -> { Spree::Dependencies.cart_associate_service },
-        storefront_cart_change_currency_service: -> { Spree::Dependencies.cart_change_currency_service },
-
-        # coupon code handler
-        storefront_coupon_handler: -> { Spree::Dependencies.coupon_handler },
-
-        # checkout services
-        storefront_checkout_next_service: -> { Spree::Dependencies.checkout_next_service },
-        storefront_checkout_advance_service: -> { Spree::Dependencies.checkout_advance_service },
-        storefront_checkout_update_service: -> { Spree::Dependencies.checkout_update_service },
-        storefront_checkout_complete_service: -> { Spree::Dependencies.checkout_complete_service },
-        storefront_checkout_add_store_credit_service: -> { Spree::Dependencies.checkout_add_store_credit_service },
-        storefront_checkout_remove_store_credit_service: -> { Spree::Dependencies.checkout_remove_store_credit_service },
-        storefront_checkout_get_shipping_rates_service: -> { Spree::Dependencies.checkout_get_shipping_rates_service },
-        storefront_checkout_select_shipping_method_service: -> { Spree::Dependencies.checkout_select_shipping_method_service },
-
-        # gift cards
-        storefront_gift_card_apply_service: -> { Spree::Dependencies.gift_card_apply_service },
-        storefront_gift_card_remove_service: -> { Spree::Dependencies.gift_card_remove_service },
-
-        # account services
-        storefront_account_create_service: -> { Spree::Dependencies.account_create_service },
-        storefront_account_update_service: -> { Spree::Dependencies.account_update_service },
-
-        # address services
-        storefront_address_create_service: -> { Spree::Dependencies.address_create_service },
-        storefront_address_update_service: -> { Spree::Dependencies.address_update_service },
-
-        # credit card services
-        storefront_credit_cards_destroy_service: -> { Spree::Dependencies.credit_cards_destroy_service },
-
-        # payment services
-        storefront_payment_create_service: -> { Spree::Dependencies.payment_create_service },
-
-        # serializers
-        storefront_address_serializer: 'Spree::V2::Storefront::AddressSerializer',
-        storefront_cart_serializer: 'Spree::V2::Storefront::CartSerializer',
-        storefront_cms_page_serializer: nil, # LEGACY
-        storefront_credit_card_serializer: 'Spree::V2::Storefront::CreditCardSerializer',
-        storefront_country_serializer: 'Spree::V2::Storefront::CountrySerializer',
-        storefront_menu_serializer: nil, # LEGACY
-        storefront_user_serializer: 'Spree::V2::Storefront::UserSerializer',
-        storefront_shipment_serializer: 'Spree::V2::Storefront::ShipmentSerializer',
-        storefront_taxon_serializer: 'Spree::V2::Storefront::TaxonSerializer',
-        storefront_payment_method_serializer: 'Spree::V2::Storefront::PaymentMethodSerializer',
-        storefront_payment_serializer: 'Spree::V2::Storefront::PaymentSerializer',
-        storefront_product_serializer: 'Spree::V2::Storefront::ProductSerializer',
-        storefront_estimated_shipment_serializer: 'Spree::V2::Storefront::EstimatedShippingRateSerializer',
-        storefront_store_serializer: 'Spree::V2::Storefront::StoreSerializer',
-        storefront_policy_serializer: 'Spree::V2::Storefront::PolicySerializer',
-        storefront_post_category_serializer: 'Spree::V2::Storefront::PostCategorySerializer',
-        storefront_post_serializer: 'Spree::V2::Storefront::PostSerializer',
-        storefront_order_serializer: 'Spree::V2::Storefront::OrderSerializer',
-        storefront_variant_serializer: 'Spree::V2::Storefront::VariantSerializer',
-        storefront_image_serializer: 'Spree::V2::Storefront::ImageSerializer',
-        storefront_line_item_serializer: 'Spree::V2::Storefront::LineItemSerializer',
-        storefront_option_type_serializer: 'Spree::V2::Storefront::OptionTypeSerializer',
-        storefront_option_value_serializer: 'Spree::V2::Storefront::OptionValueSerializer',
-        storefront_product_property_serializer: 'Spree::V2::Storefront::ProductPropertySerializer',
-        storefront_order_promotion_serializer: 'Spree::V2::Storefront::OrderPromotionSerializer',
-        storefront_shipping_method_serializer: 'Spree::V2::Storefront::ShippingMethodSerializer',
-        storefront_shipping_rate_serializer: 'Spree::V2::Storefront::ShippingRateSerializer',
-        storefront_stock_location_serializer: 'Spree::V2::Storefront::StockLocationSerializer',
-        storefront_store_credit_category_serializer: 'Spree::V2::Storefront::StoreCreditCategorySerializer',
-        storefront_store_credit_event_serializer: 'Spree::V2::Storefront::StoreCreditEventSerializer',
-        storefront_store_credit_type_serializer: 'Spree::V2::Storefront::StoreCreditTypeSerializer',
-        storefront_digital_link_serializer: 'Spree::V2::Storefront::DigitalLinkSerializer',
-        storefront_gift_card_serializer: 'Spree::V2::Storefront::GiftCardSerializer',
-        storefront_taxonomy_serializer: 'Spree::V2::Storefront::TaxonomySerializer',
-        storefront_taxon_image_serializer: 'Spree::V2::Storefront::TaxonImageSerializer',
-        storefront_wishlist_serializer: 'Spree::V2::Storefront::WishlistSerializer',
-        storefront_wished_item_serializer: 'Spree::V2::Storefront::WishedItemSerializer',
-        storefront_metafield_serializer: 'Spree::V2::Storefront::MetafieldSerializer',
-
         # v3 serializers (API v3)
         credit_card_serializer: 'Spree::Api::V3::CreditCardSerializer',
         price_serializer: 'Spree::Api::V3::PriceSerializer',
         price_history_serializer: 'Spree::Api::V3::PriceHistorySerializer',
         product_serializer: 'Spree::Api::V3::ProductSerializer',
+        product_type_serializer: 'Spree::Api::V3::ProductTypeSerializer',
         variant_serializer: 'Spree::Api::V3::VariantSerializer',
         media_serializer: 'Spree::Api::V3::MediaSerializer',
         option_type_serializer: 'Spree::Api::V3::OptionTypeSerializer',
         option_value_serializer: 'Spree::Api::V3::OptionValueSerializer',
         cart_serializer: 'Spree::Api::V3::CartSerializer',
         order_serializer: 'Spree::Api::V3::OrderSerializer',
+        order_group_serializer: 'Spree::Api::V3::OrderGroupSerializer',
         line_item_serializer: 'Spree::Api::V3::LineItemSerializer',
         payment_serializer: 'Spree::Api::V3::PaymentSerializer',
         payment_session_serializer: 'Spree::Api::V3::PaymentSessionSerializer',
@@ -110,8 +25,10 @@ module Spree
         store_credit_serializer: 'Spree::Api::V3::StoreCreditSerializer',
         shipment_serializer: 'Spree::Api::V3::FulfillmentSerializer',
         fulfillment_serializer: 'Spree::Api::V3::FulfillmentSerializer',
+        delivery_serializer: 'Spree::Api::V3::DeliverySerializer',
         address_serializer: 'Spree::Api::V3::AddressSerializer',
         customer_serializer: 'Spree::Api::V3::CustomerSerializer',
+        data_request_serializer: 'Spree::Api::V3::DataRequestSerializer',
         customer_group_serializer: 'Spree::Api::V3::CustomerGroupSerializer',
         country_serializer: 'Spree::Api::V3::CountrySerializer',
         channel_serializer: 'Spree::Api::V3::ChannelSerializer',
@@ -126,17 +43,24 @@ module Spree
         shipping_rate_serializer: 'Spree::Api::V3::DeliveryRateSerializer',
         delivery_method_serializer: 'Spree::Api::V3::DeliveryMethodSerializer',
         delivery_rate_serializer: 'Spree::Api::V3::DeliveryRateSerializer',
+        freight_summary_serializer: 'Spree::Api::V3::FreightSummarySerializer',
         stock_location_serializer: 'Spree::Api::V3::StockLocationSerializer',
         category_serializer: 'Spree::Api::V3::CategorySerializer',
+        collection_serializer: 'Spree::Api::V3::CollectionSerializer',
+        applied_promotion_serializer: 'Spree::Api::V3::AppliedPromotionSerializer',
         discount_serializer: 'Spree::Api::V3::DiscountSerializer',
+        tax_line_serializer: 'Spree::Api::V3::TaxLineSerializer',
+        delivery_zone_serializer: 'Spree::Api::V3::DeliveryZoneSerializer',
+        delivery_zone_member_serializer: 'Spree::Api::V3::DeliveryZoneMemberSerializer',
+        fee_serializer: 'Spree::Api::V3::FeeSerializer',
         digital_link_serializer: 'Spree::Api::V3::DigitalLinkSerializer',
         gift_card_serializer: 'Spree::Api::V3::GiftCardSerializer',
         currency_serializer: 'Spree::Api::V3::CurrencySerializer',
         locale_serializer: 'Spree::Api::V3::LocaleSerializer',
         policy_serializer: 'Spree::Api::V3::PolicySerializer',
         custom_field_serializer: 'Spree::Api::V3::CustomFieldSerializer',
-        shipping_category_serializer: 'Spree::Api::V3::ShippingCategorySerializer',
         tax_category_serializer: 'Spree::Api::V3::TaxCategorySerializer',
+        tax_identifier_serializer: 'Spree::Api::V3::TaxIdentifierSerializer',
         product_filters_serializer: 'Spree::Api::V3::ProductFiltersSerializer',
         product_filter_price_range_serializer: 'Spree::Api::V3::ProductFilterPriceRangeSerializer',
         product_filter_availability_serializer: 'Spree::Api::V3::ProductFilterAvailabilitySerializer',
@@ -148,9 +72,16 @@ module Spree
         product_filter_sort_option_serializer: 'Spree::Api::V3::ProductFilterSortOptionSerializer',
 
         # v3 event serializers (for models without Store API endpoints yet)
-        asset_serializer: 'Spree::Api::V3::AssetSerializer',
-        customer_return_serializer: 'Spree::Api::V3::CustomerReturnSerializer',
-        digital_serializer: 'Spree::Api::V3::DigitalSerializer',
+        media_event_serializer: 'Spree::Api::V3::MediaEventSerializer',
+        return_serializer: 'Spree::Api::V3::ReturnSerializer',
+        return_line_item_serializer: 'Spree::Api::V3::ReturnLineItemSerializer',
+        exchange_serializer: 'Spree::Api::V3::ExchangeSerializer',
+        exchange_line_item_serializer: 'Spree::Api::V3::ExchangeLineItemSerializer',
+        claim_serializer: 'Spree::Api::V3::ClaimSerializer',
+        claim_line_item_serializer: 'Spree::Api::V3::ClaimLineItemSerializer',
+        return_reason_serializer: 'Spree::Api::V3::ReturnReasonSerializer',
+        claim_reason_serializer: 'Spree::Api::V3::ClaimReasonSerializer',
+        digital_asset_serializer: 'Spree::Api::V3::DigitalAssetSerializer',
         export_serializer: 'Spree::Api::V3::ExportSerializer',
         gift_card_batch_serializer: 'Spree::Api::V3::GiftCardBatchSerializer',
         import_serializer: 'Spree::Api::V3::ImportSerializer',
@@ -159,11 +90,7 @@ module Spree
         newsletter_subscriber_serializer: 'Spree::Api::V3::NewsletterSubscriberSerializer',
         promotion_serializer: 'Spree::Api::V3::PromotionSerializer',
         refund_serializer: 'Spree::Api::V3::RefundSerializer',
-        reimbursement_serializer: 'Spree::Api::V3::ReimbursementSerializer',
-        report_serializer: 'Spree::Api::V3::ReportSerializer',
-        return_authorization_serializer: 'Spree::Api::V3::ReturnAuthorizationSerializer',
-        return_item_serializer: 'Spree::Api::V3::ReturnItemSerializer',
-        stock_item_serializer: 'Spree::Api::V3::StockItemSerializer',
+        stock_level_serializer: 'Spree::Api::V3::StockLevelSerializer',
         stock_movement_serializer: 'Spree::Api::V3::StockMovementSerializer',
         stock_reservation_serializer: 'Spree::Api::V3::StockReservationSerializer',
         stock_transfer_serializer: 'Spree::Api::V3::StockTransferSerializer',
@@ -171,35 +98,145 @@ module Spree
         # v3 admin serializers (API v3 Admin)
         admin_country_serializer: 'Spree::Api::V3::Admin::CountrySerializer',
         admin_state_serializer: 'Spree::Api::V3::Admin::StateSerializer',
+        admin_applied_promotion_serializer: 'Spree::Api::V3::Admin::AppliedPromotionSerializer',
         admin_discount_serializer: 'Spree::Api::V3::Admin::DiscountSerializer',
+        admin_tax_line_serializer: 'Spree::Api::V3::Admin::TaxLineSerializer',
+        admin_cart_serializer: 'Spree::Api::V3::Admin::CartSerializer',
+        admin_delivery_zone_serializer: 'Spree::Api::V3::Admin::DeliveryZoneSerializer',
+        admin_delivery_profile_serializer: 'Spree::Api::V3::Admin::DeliveryProfileSerializer',
+        admin_delivery_origin_group_serializer: 'Spree::Api::V3::Admin::DeliveryOriginGroupSerializer',
+        admin_integration_serializer: 'Spree::Api::V3::Admin::IntegrationSerializer',
+        admin_delivery_method_rule_serializer: 'Spree::Api::V3::Admin::DeliveryMethodRuleSerializer',
+        admin_delivery_zone_member_serializer: 'Spree::Api::V3::Admin::DeliveryZoneMemberSerializer',
+        admin_fee_serializer: 'Spree::Api::V3::Admin::FeeSerializer',
+        admin_consent_record_serializer: 'Spree::Api::V3::Admin::ConsentRecordSerializer',
         admin_customer_serializer: 'Spree::Api::V3::Admin::CustomerSerializer',
+        admin_data_request_serializer: 'Spree::Api::V3::Admin::DataRequestSerializer',
         admin_newsletter_subscriber_serializer: 'Spree::Api::V3::Admin::NewsletterSubscriberSerializer',
         admin_order_serializer: 'Spree::Api::V3::Admin::OrderSerializer',
+        admin_order_group_serializer: 'Spree::Api::V3::Admin::OrderGroupSerializer',
         admin_product_serializer: 'Spree::Api::V3::Admin::ProductSerializer',
+        admin_product_type_serializer: 'Spree::Api::V3::Admin::ProductTypeSerializer',
+        admin_product_type_custom_field_definition_serializer: 'Spree::Api::V3::Admin::ProductTypeCustomFieldDefinitionSerializer',
         admin_variant_serializer: 'Spree::Api::V3::Admin::VariantSerializer',
         admin_price_serializer: 'Spree::Api::V3::Admin::PriceSerializer',
         admin_price_history_serializer: 'Spree::Api::V3::Admin::PriceHistorySerializer',
         admin_custom_field_serializer: 'Spree::Api::V3::Admin::CustomFieldSerializer',
         admin_custom_field_definition_serializer: 'Spree::Api::V3::Admin::CustomFieldDefinitionSerializer',
         admin_category_serializer: 'Spree::Api::V3::Admin::CategorySerializer',
+        admin_collection_serializer: 'Spree::Api::V3::Admin::CollectionSerializer',
+        admin_collection_rule_serializer: 'Spree::Api::V3::Admin::CollectionRuleSerializer',
         admin_line_item_serializer: 'Spree::Api::V3::Admin::LineItemSerializer',
         admin_option_type_serializer: 'Spree::Api::V3::Admin::OptionTypeSerializer',
         admin_option_value_serializer: 'Spree::Api::V3::Admin::OptionValueSerializer',
         admin_media_serializer: 'Spree::Api::V3::Admin::MediaSerializer',
-        admin_stock_item_serializer: 'Spree::Api::V3::Admin::StockItemSerializer',
+        admin_stock_level_serializer: 'Spree::Api::V3::Admin::StockLevelSerializer',
+        admin_stock_movement_serializer: 'Spree::Api::V3::Admin::StockMovementSerializer',
         admin_stock_transfer_serializer: 'Spree::Api::V3::Admin::StockTransferSerializer',
+        admin_stock_transfer_item_serializer: 'Spree::Api::V3::Admin::StockTransferItemSerializer',
+        admin_supplier_serializer: 'Spree::Api::V3::Admin::SupplierSerializer',
+        admin_purchase_order_serializer: 'Spree::Api::V3::Admin::PurchaseOrderSerializer',
+        admin_purchase_order_item_serializer: 'Spree::Api::V3::Admin::PurchaseOrderItemSerializer',
+        admin_stock_receipt_serializer: 'Spree::Api::V3::Admin::StockReceiptSerializer',
+        admin_stock_receipt_item_serializer: 'Spree::Api::V3::Admin::StockReceiptItemSerializer',
         admin_shipment_serializer: 'Spree::Api::V3::Admin::FulfillmentSerializer',
         admin_fulfillment_serializer: 'Spree::Api::V3::Admin::FulfillmentSerializer',
+        admin_fulfillment_item_serializer: 'Spree::Api::V3::Admin::FulfillmentItemSerializer',
+        admin_delivery_serializer: 'Spree::Api::V3::Admin::DeliverySerializer',
+        admin_shipping_label_serializer: 'Spree::Api::V3::Admin::ShippingLabelSerializer',
         admin_gift_card_serializer: 'Spree::Api::V3::Admin::GiftCardSerializer',
         admin_gift_card_batch_serializer: 'Spree::Api::V3::Admin::GiftCardBatchSerializer',
         admin_payment_serializer: 'Spree::Api::V3::Admin::PaymentSerializer',
         admin_refund_serializer: 'Spree::Api::V3::Admin::RefundSerializer',
-        admin_adjustment_serializer: 'Spree::Api::V3::Admin::AdjustmentSerializer',
-        admin_shipping_category_serializer: 'Spree::Api::V3::Admin::ShippingCategorySerializer',
+        admin_return_reason_serializer: 'Spree::Api::V3::Admin::ReturnReasonSerializer',
+        admin_claim_reason_serializer: 'Spree::Api::V3::Admin::ClaimReasonSerializer',
+        admin_refund_reason_serializer: 'Spree::Api::V3::Admin::RefundReasonSerializer',
+        admin_order_cancellation_reason_serializer: 'Spree::Api::V3::Admin::OrderCancellationReasonSerializer',
+        admin_return_serializer: 'Spree::Api::V3::Admin::ReturnSerializer',
+        admin_return_line_item_serializer: 'Spree::Api::V3::Admin::ReturnLineItemSerializer',
+        admin_exchange_serializer: 'Spree::Api::V3::Admin::ExchangeSerializer',
+        admin_exchange_line_item_serializer: 'Spree::Api::V3::Admin::ExchangeLineItemSerializer',
+        admin_claim_serializer: 'Spree::Api::V3::Admin::ClaimSerializer',
+        admin_claim_line_item_serializer: 'Spree::Api::V3::Admin::ClaimLineItemSerializer',
+        admin_package_type_serializer: 'Spree::Api::V3::Admin::PackageTypeSerializer',
+        admin_policy_serializer: 'Spree::Api::V3::Admin::PolicySerializer',
         admin_tax_category_serializer: 'Spree::Api::V3::Admin::TaxCategorySerializer',
-        admin_return_authorization_serializer: 'Spree::Api::V3::Admin::ReturnAuthorizationSerializer',
-        admin_reimbursement_serializer: 'Spree::Api::V3::Admin::ReimbursementSerializer',
+        admin_tax_rate_serializer: 'Spree::Api::V3::Admin::TaxRateSerializer',
+        admin_tax_identifier_serializer: 'Spree::Api::V3::Admin::TaxIdentifierSerializer',
+
+        company_serializer: 'Spree::Api::V3::CompanySerializer',
+        company_membership_serializer: 'Spree::Api::V3::CompanyMembershipSerializer',
+        company_invitation_serializer: 'Spree::Api::V3::CompanyInvitationSerializer',
+        admin_company_serializer: 'Spree::Api::V3::Admin::CompanySerializer',
+        admin_company_membership_serializer: 'Spree::Api::V3::Admin::CompanyMembershipSerializer',
+        admin_company_invitation_serializer: 'Spree::Api::V3::Admin::CompanyInvitationSerializer',
+        admin_catalog_serializer: 'Spree::Api::V3::Admin::CatalogSerializer',
+        admin_catalog_price_serializer: 'Spree::Api::V3::Admin::CatalogPriceSerializer',
+        admin_catalog_price_tier_serializer: 'Spree::Api::V3::Admin::CatalogPriceTierSerializer',
+        admin_catalog_product_serializer: 'Spree::Api::V3::Admin::CatalogProductSerializer',
+        admin_price_list_product_serializer: 'Spree::Api::V3::Admin::PriceListProductSerializer',
+        admin_catalog_assignment_serializer: 'Spree::Api::V3::Admin::CatalogAssignmentSerializer',
+        admin_catalog_quantity_rule_serializer: 'Spree::Api::V3::Admin::CatalogQuantityRuleSerializer',
+        admin_catalog_product_term_serializer: 'Spree::Api::V3::Admin::CatalogProductTermSerializer',
+        admin_catalog_order_minimum_serializer: 'Spree::Api::V3::Admin::CatalogOrderMinimumSerializer',
+        admin_tax_exemption_certificate_serializer: 'Spree::Api::V3::Admin::TaxExemptionCertificateSerializer',
         admin_admin_user_serializer: 'Spree::Api::V3::Admin::AdminUserSerializer',
+        admin_seller_team_member_serializer: 'Spree::Api::V3::Admin::SellerTeamMemberSerializer',
+        seller_serializer: 'Spree::Api::V3::SellerSerializer',
+        seller_profile_serializer: 'Spree::Api::V3::Seller::ProfileSerializer',
+        seller_policy_serializer: 'Spree::Api::V3::Seller::PolicySerializer',
+        seller_team_member_serializer: 'Spree::Api::V3::Seller::TeamMemberSerializer',
+        seller_invitation_serializer: 'Spree::Api::V3::Seller::InvitationSerializer',
+        seller_product_serializer: 'Spree::Api::V3::Seller::ProductSerializer',
+        seller_product_type_serializer: 'Spree::Api::V3::Seller::ProductTypeSerializer',
+        seller_delivery_profile_serializer: 'Spree::Api::V3::Seller::DeliveryProfileSerializer',
+        seller_delivery_method_serializer: 'Spree::Api::V3::Seller::DeliveryMethodSerializer',
+        seller_delivery_method_rule_serializer: 'Spree::Api::V3::Seller::DeliveryMethodRuleSerializer',
+        seller_delivery_zone_serializer: 'Spree::Api::V3::Seller::DeliveryZoneSerializer',
+        seller_variant_serializer: 'Spree::Api::V3::Seller::VariantSerializer',
+        seller_media_serializer: 'Spree::Api::V3::Seller::MediaSerializer',
+        seller_stock_level_serializer: 'Spree::Api::V3::Seller::StockLevelSerializer',
+        seller_order_serializer: 'Spree::Api::V3::Seller::OrderSerializer',
+        seller_order_line_item_serializer: 'Spree::Api::V3::Seller::OrderLineItemSerializer',
+        seller_fulfillment_serializer: 'Spree::Api::V3::Seller::FulfillmentSerializer',
+        seller_fulfillment_item_serializer: 'Spree::Api::V3::Seller::FulfillmentItemSerializer',
+        seller_delivery_serializer: 'Spree::Api::V3::Seller::DeliverySerializer',
+        seller_delivery_rate_serializer: 'Spree::Api::V3::Seller::DeliveryRateSerializer',
+        seller_shipping_label_serializer: 'Spree::Api::V3::Seller::ShippingLabelSerializer',
+        seller_return_serializer: 'Spree::Api::V3::Seller::ReturnSerializer',
+        seller_return_line_item_serializer: 'Spree::Api::V3::Seller::ReturnLineItemSerializer',
+        seller_exchange_serializer: 'Spree::Api::V3::Seller::ExchangeSerializer',
+        seller_exchange_line_item_serializer: 'Spree::Api::V3::Seller::ExchangeLineItemSerializer',
+        seller_claim_serializer: 'Spree::Api::V3::Seller::ClaimSerializer',
+        seller_claim_line_item_serializer: 'Spree::Api::V3::Seller::ClaimLineItemSerializer',
+        seller_reason_serializer: 'Spree::Api::V3::Seller::ReasonSerializer',
+        seller_package_type_serializer: 'Spree::Api::V3::Seller::PackageTypeSerializer',
+        seller_stock_location_serializer: 'Spree::Api::V3::Seller::StockLocationSerializer',
+        seller_requirement_custom_field_serializer: 'Spree::Api::V3::Seller::RequirementCustomFieldSerializer',
+        seller_tax_identifier_serializer: 'Spree::Api::V3::Seller::TaxIdentifierSerializer',
+        seller_requirement_status_serializer: 'Spree::Api::V3::Seller::RequirementStatusSerializer',
+        seller_import_serializer: 'Spree::Api::V3::Seller::ImportSerializer',
+        seller_import_row_serializer: 'Spree::Api::V3::Seller::ImportRowSerializer',
+        seller_import_mapping_serializer: 'Spree::Api::V3::Seller::ImportMappingSerializer',
+        product_submission_serializer: 'Spree::Api::V3::Seller::ProductSubmissionSerializer',
+        admin_product_submission_serializer: 'Spree::Api::V3::Admin::ProductSubmissionSerializer',
+        seller_requirement_submission_serializer: 'Spree::Api::V3::Seller::RequirementSubmissionSerializer',
+        seller_export_serializer: 'Spree::Api::V3::Seller::ExportSerializer',
+        admin_seller_serializer: 'Spree::Api::V3::Admin::SellerSerializer',
+        admin_seller_requirement_serializer: 'Spree::Api::V3::Admin::SellerRequirementSerializer',
+        admin_seller_requirement_submission_serializer: 'Spree::Api::V3::Admin::SellerRequirementSubmissionSerializer',
+        admin_seller_requirement_status_serializer: 'Spree::Api::V3::Admin::SellerRequirementStatusSerializer',
+        admin_commission_rate_serializer: 'Spree::Api::V3::Admin::CommissionRateSerializer',
+        admin_commission_rule_serializer: 'Spree::Api::V3::Admin::CommissionRuleSerializer',
+        admin_commission_line_serializer: 'Spree::Api::V3::Admin::CommissionLineSerializer',
+        admin_seller_transfer_serializer: 'Spree::Api::V3::Admin::SellerTransferSerializer',
+        admin_seller_payout_serializer: 'Spree::Api::V3::Admin::SellerPayoutSerializer',
+        admin_seller_balance_serializer: 'Spree::Api::V3::Admin::SellerBalanceSerializer',
+        admin_payment_split_serializer: 'Spree::Api::V3::Admin::PaymentSplitSerializer',
+        seller_transfer_serializer: 'Spree::Api::V3::Seller::TransferSerializer',
+        seller_payout_serializer: 'Spree::Api::V3::Seller::PayoutSerializer',
+        seller_balance_serializer: 'Spree::Api::V3::Seller::BalanceSerializer',
+        seller_payment_split_serializer: 'Spree::Api::V3::Seller::PaymentSplitSerializer',
         admin_address_serializer: 'Spree::Api::V3::Admin::AddressSerializer',
         admin_channel_serializer: 'Spree::Api::V3::Admin::ChannelSerializer',
         admin_order_routing_rule_serializer: 'Spree::Api::V3::Admin::OrderRoutingRuleSerializer',
@@ -207,16 +244,20 @@ module Spree
         admin_market_serializer: 'Spree::Api::V3::Admin::MarketSerializer',
         admin_shipping_method_serializer: 'Spree::Api::V3::Admin::DeliveryMethodSerializer',
         admin_delivery_method_serializer: 'Spree::Api::V3::Admin::DeliveryMethodSerializer',
+        admin_delivery_method_service_serializer: 'Spree::Api::V3::Admin::DeliveryMethodServiceSerializer',
         admin_stock_location_serializer: 'Spree::Api::V3::Admin::StockLocationSerializer',
         admin_stock_reservation_serializer: 'Spree::Api::V3::Admin::StockReservationSerializer',
         admin_shipping_rate_serializer: 'Spree::Api::V3::Admin::DeliveryRateSerializer',
         admin_delivery_rate_serializer: 'Spree::Api::V3::Admin::DeliveryRateSerializer',
+        admin_freight_summary_serializer: 'Spree::Api::V3::Admin::FreightSummarySerializer',
+        admin_freight_summary_line_serializer: 'Spree::Api::V3::Admin::FreightSummaryLineSerializer',
         admin_payment_method_serializer: 'Spree::Api::V3::Admin::PaymentMethodSerializer',
         admin_credit_card_serializer: 'Spree::Api::V3::Admin::CreditCardSerializer',
         admin_store_credit_serializer: 'Spree::Api::V3::Admin::StoreCreditSerializer',
-        admin_store_credit_category_serializer: 'Spree::Api::V3::Admin::StoreCreditCategorySerializer',
+        admin_store_credit_event_serializer: 'Spree::Api::V3::Admin::StoreCreditEventSerializer',
         admin_customer_group_serializer: 'Spree::Api::V3::Admin::CustomerGroupSerializer',
         admin_payment_source_serializer: 'Spree::Api::V3::Admin::PaymentSourceSerializer',
+        admin_digital_asset_serializer: 'Spree::Api::V3::Admin::DigitalAssetSerializer',
         admin_digital_link_serializer: 'Spree::Api::V3::Admin::DigitalLinkSerializer',
         admin_store_serializer: 'Spree::Api::V3::Admin::StoreSerializer',
         admin_setup_task_serializer: 'Spree::Api::V3::Admin::SetupTaskSerializer',
@@ -226,7 +267,9 @@ module Spree
         admin_webhook_delivery_serializer: 'Spree::Api::V3::Admin::WebhookDeliverySerializer',
         admin_invitation_serializer: 'Spree::Api::V3::Admin::InvitationSerializer',
         admin_role_serializer: 'Spree::Api::V3::Admin::RoleSerializer',
+        admin_permission_serializer: 'Spree::Api::V3::Admin::PermissionSerializer',
         admin_export_serializer: 'Spree::Api::V3::Admin::ExportSerializer',
+        admin_saved_report_serializer: 'Spree::Api::V3::Admin::SavedReportSerializer',
         admin_import_serializer: 'Spree::Api::V3::Admin::ImportSerializer',
         admin_import_row_serializer: 'Spree::Api::V3::Admin::ImportRowSerializer',
         admin_import_mapping_serializer: 'Spree::Api::V3::Admin::ImportMappingSerializer',
@@ -234,139 +277,42 @@ module Spree
         admin_promotion_action_serializer: 'Spree::Api::V3::Admin::PromotionActionSerializer',
         admin_promotion_rule_serializer: 'Spree::Api::V3::Admin::PromotionRuleSerializer',
         admin_coupon_code_serializer: 'Spree::Api::V3::Admin::CouponCodeSerializer',
+        admin_price_adjustment_tier_serializer: 'Spree::Api::V3::Admin::PriceAdjustmentTierSerializer',
         admin_price_list_serializer: 'Spree::Api::V3::Admin::PriceListSerializer',
         admin_price_rule_serializer: 'Spree::Api::V3::Admin::PriceRuleSerializer',
         admin_resource_translations_serializer: 'Spree::Api::V3::Admin::ResourceTranslationsSerializer',
+      }
 
-        # platform serializers
-        platform_metafield_serializer: 'Spree::Api::V2::Platform::MetafieldSerializer',
-
-        # sorters
-        storefront_collection_sorter: -> { Spree::Dependencies.collection_sorter },
-        storefront_order_sorter: -> { Spree::Dependencies.collection_sorter },
-        storefront_posts_sorter: nil,
-        storefront_products_sorter: -> { Spree::Dependencies.products_sorter },
-        platform_products_sorter: -> { Spree::Dependencies.products_sorter },
-        # paginators
-        storefront_collection_paginator: 'Spree::Api::Paginate',
-
-        # finders
-        storefront_address_finder: -> { Spree::Dependencies.address_finder },
-        storefront_country_finder: -> { Spree::Dependencies.country_finder },
-        storefront_cms_page_finder: -> { Spree::Dependencies.cms_page_finder },
-        storefront_menu_finder: -> { Spree::Dependencies.menu_finder },
-        storefront_current_order_finder: -> { Spree::Dependencies.current_order_finder },
-        storefront_completed_order_finder: -> { Spree::Dependencies.completed_order_finder },
-        storefront_credit_card_finder: -> { Spree::Dependencies.credit_card_finder },
-        storefront_find_by_variant_finder: -> { Spree::Dependencies.line_item_by_variant_finder },
-        storefront_posts_finder: nil,
-        storefront_products_finder: -> { Spree::Dependencies.products_finder },
-        storefront_taxon_finder: -> { Spree::Dependencies.taxon_finder },
-        storefront_variant_finder: -> { Spree::Dependencies.variant_finder },
-
-        # serializers
-        platform_address_serializer: 'Spree::Api::V2::Platform::AddressSerializer',
-        platform_adjustment_serializer: 'Spree::Api::V2::Platform::AdjustmentSerializer',
-        platform_admin_user_serializer: 'Spree::Api::V2::Platform::AdminUserSerializer',
-        platform_asset_serializer: 'Spree::Api::V2::Platform::AssetSerializer',
-        platform_calculator_serializer: 'Spree::Api::V2::Platform::CalculatorSerializer',
-        platform_classification_serializer: 'Spree::Api::V2::Platform::ClassificationSerializer',
-        platform_country_serializer: 'Spree::Api::V2::Platform::CountrySerializer',
-        platform_credit_card_serializer: 'Spree::Api::V2::Platform::CreditCardSerializer',
-        platform_customer_return_serializer: 'Spree::Api::V2::Platform::CustomerReturnSerializer',
-        platform_digital_link_serializer: 'Spree::Api::V2::Platform::DigitalLinkSerializer',
-        platform_digital_serializer: 'Spree::Api::V2::Platform::DigitalSerializer',
-        platform_gift_card_serializer: 'Spree::Api::V2::Platform::GiftCardSerializer',
-        platform_image_serializer: 'Spree::Api::V2::Platform::ImageSerializer',
-        platform_inventory_unit_serializer: 'Spree::Api::V2::Platform::InventoryUnitSerializer',
-        platform_line_item_serializer: 'Spree::Api::V2::Platform::LineItemSerializer',
-        platform_log_entry_serializer: 'Spree::Api::V2::Platform::LogEntrySerializer',
-        platform_option_type_serializer: 'Spree::Api::V2::Platform::OptionTypeSerializer',
-        platform_option_value_serializer: 'Spree::Api::V2::Platform::OptionValueSerializer',
-        platform_order_promotion_serializer: 'Spree::Api::V2::Platform::OrderPromotionSerializer',
-        platform_order_serializer: 'Spree::Api::V2::Platform::OrderSerializer',
-        platform_payment_capture_event_serializer: 'Spree::Api::V2::Platform::PaymentCaptureEventSerializer',
-        platform_payment_method_serializer: 'Spree::Api::V2::Platform::PaymentMethodSerializer',
-        platform_payment_serializer: 'Spree::Api::V2::Platform::PaymentSerializer',
-        platform_payment_source_serializer: 'Spree::Api::V2::Platform::PaymentSourceSerializer',
-        platform_price_serializer: 'Spree::Api::V2::Platform::PriceSerializer',
-        platform_product_property_serializer: 'Spree::Api::V2::Platform::ProductPropertySerializer',
-        platform_product_serializer: 'Spree::Api::V2::Platform::ProductSerializer',
-        platform_promotion_action_line_item_serializer: 'Spree::Api::V2::Platform::PromotionActionLineItemSerializer',
-        platform_promotion_action_serializer: 'Spree::Api::V2::Platform::PromotionActionSerializer',
-        platform_promotion_category_serializer: 'Spree::Api::V2::Platform::PromotionCategorySerializer',
-        platform_promotion_rule_serializer: 'Spree::Api::V2::Platform::PromotionRuleSerializer',
-        platform_property_serializer: 'Spree::Api::V2::Platform::PropertySerializer',
-        platform_promotion_serializer: 'Spree::Api::V2::Platform::PromotionSerializer',
-        platform_prototype_serializer: 'Spree::Api::V2::Platform::PrototypeSerializer',
-        platform_refund_reason_serializer: 'Spree::Api::V2::Platform::RefundReasonSerializer',
-        platform_refund_serializer: 'Spree::Api::V2::Platform::RefundSerializer',
-        platform_reimbursement_credit_serializer: 'Spree::Api::V2::Platform::ReimbursementCreditSerializer',
-        platform_reimbursement_serializer: 'Spree::Api::V2::Platform::ReimbursementSerializer',
-        platform_reimbursement_type_serializer: 'Spree::Api::V2::Platform::ReimbursementTypeSerializer',
-        platform_return_authorization_reason_serializer: 'Spree::Api::V2::Platform::ReturnAuthorizationReasonSerializer',
-        platform_return_authorization_serializer: 'Spree::Api::V2::Platform::ReturnAuthorizationSerializer',
-        platform_return_item_serializer: 'Spree::Api::V2::Platform::ReturnItemSerializer',
-        platform_role_serializer: 'Spree::Api::V2::Platform::RoleSerializer',
-        platform_shipment_serializer: 'Spree::Api::V2::Platform::ShipmentSerializer',
-        platform_shipping_category_serializer: 'Spree::Api::V2::Platform::ShippingCategorySerializer',
-        platform_shipping_method_serializer: 'Spree::Api::V2::Platform::ShippingMethodSerializer',
-        platform_shipping_rate_serializer: 'Spree::Api::V2::Platform::ShippingRateSerializer',
-        platform_state_change_serializer: 'Spree::Api::V2::Platform::StateChangeSerializer',
-        platform_state_serializer: 'Spree::Api::V2::Platform::StateSerializer',
-        platform_stock_item_serializer: 'Spree::Api::V2::Platform::StockItemSerializer',
-        platform_stock_location_serializer: 'Spree::Api::V2::Platform::StockLocationSerializer',
-        platform_stock_movement_serializer: 'Spree::Api::V2::Platform::StockMovementSerializer',
-        platform_stock_transfer_serializer: 'Spree::Api::V2::Platform::StockTransferSerializer',
-        platform_store_credit_category_serializer: 'Spree::Api::V2::Platform::StoreCreditCategorySerializer',
-        platform_store_credit_event_serializer: 'Spree::Api::V2::Platform::StoreCreditEventSerializer',
-        platform_store_credit_serializer: 'Spree::Api::V2::Platform::StoreCreditSerializer',
-        platform_store_credit_type_serializer: 'Spree::Api::V2::Platform::StoreCreditTypeSerializer',
-        platform_store_serializer: 'Spree::Api::V2::Platform::StoreSerializer',
-        platform_tax_category_serializer: 'Spree::Api::V2::Platform::TaxCategorySerializer',
-        platform_tax_rate_serializer: 'Spree::Api::V2::Platform::TaxRateSerializer',
-        platform_taxon_image_serializer: 'Spree::Api::V2::Platform::TaxonImageSerializer',
-        platform_taxon_serializer: 'Spree::Api::V2::Platform::TaxonSerializer',
-        platform_taxonomy_serializer: 'Spree::Api::V2::Platform::TaxonomySerializer',
-        platform_user_serializer: 'Spree::Api::V2::Platform::UserSerializer',
-        platform_variant_serializer: 'Spree::Api::V2::Platform::VariantSerializer',
-        platform_webhooks_event_serializer: 'Spree::Api::V2::Platform::Webhooks::EventSerializer',
-        platform_webhooks_subscriber_serializer: 'Spree::Api::V2::Platform::Webhooks::SubscriberSerializer',
-        platform_wished_item_serializer: 'Spree::Api::V2::Platform::WishedItemSerializer',
-        platform_wishlist_serializer: 'Spree::Api::V2::Platform::WishlistSerializer',
-        platform_zone_member_serializer: 'Spree::Api::V2::Platform::ZoneMemberSerializer',
-        platform_zone_serializer: 'Spree::Api::V2::Platform::ZoneSerializer',
-
-        # coupon code handler
-        platform_coupon_handler: -> { Spree::Dependencies.coupon_handler },
+      include Spree::DependenciesHelper
 
-        # order services
-        platform_order_recalculate_service: -> { Spree::Dependencies.cart_recalculate_service },
-        platform_order_update_service: -> { Spree::Dependencies.checkout_update_service },
-        platform_order_empty_service: -> { Spree::Dependencies.cart_empty_service },
-        platform_order_destroy_service: -> { Spree::Dependencies.cart_destroy_service },
-        platform_order_next_service: -> { Spree::Dependencies.checkout_next_service },
-        platform_order_advance_service: -> { Spree::Dependencies.checkout_advance_service },
-        platform_order_complete_service: -> { Spree::Dependencies.checkout_complete_service },
-        platform_order_use_store_credit_service: -> { Spree::Dependencies.checkout_add_store_credit_service },
-        platform_order_remove_store_credit_service: -> { Spree::Dependencies.checkout_remove_store_credit_service },
-        platform_order_approve_service: -> { Spree::Dependencies.order_approve_service },
-        platform_order_cancel_service: -> { Spree::Dependencies.order_cancel_service },
+      # Pre-6.0 names for the StockItem → StockLevel serializers. Unlike the
+      # legacy workflow keys in core, these forward instead of stashing: a
+      # serializer renders the same model under a new class name, so an
+      # override written against the old key is still the class the host app
+      # wants used. Removed in 6.1.
+      LEGACY_SERIALIZER_KEYS = {
+        stock_item_serializer: :stock_level_serializer,
+        admin_stock_item_serializer: :admin_stock_level_serializer,
+        digital_serializer: :digital_asset_serializer,
+        admin_digital_serializer: :admin_digital_asset_serializer
+      }.freeze
 
-        # line item services
-        platform_line_item_create_service: -> { Spree::Dependencies.line_item_create_service },
-        platform_line_item_update_service: -> { Spree::Dependencies.line_item_update_service },
-        platform_line_item_destroy_service: -> { Spree::Dependencies.line_item_destroy_service },
+      LEGACY_SERIALIZER_KEYS.each do |legacy, current|
+        define_method("#{legacy}=") do |value|
+          Spree::Deprecation.warn("Spree.api.#{legacy}= is deprecated and will be removed in Spree 6.1. Use #{current}= instead.")
+          send("#{current}=", value)
+        end
 
-        # shipment services
-        platform_shipment_create_service: -> { Spree::Dependencies.shipment_create_service },
-        platform_shipment_update_service: -> { Spree::Dependencies.shipment_update_service },
-        platform_shipment_change_state_service: -> { Spree::Dependencies.shipment_change_state_service },
-        platform_shipment_add_item_service: -> { Spree::Dependencies.shipment_add_item_service },
-        platform_shipment_remove_item_service: -> { Spree::Dependencies.shipment_remove_item_service },
-      }
+        define_method(legacy) do
+          Spree::Deprecation.warn("Spree.api.#{legacy} is deprecated and will be removed in Spree 6.1. Use #{current} instead.")
+          send(current)
+        end
 
-      include Spree::DependenciesHelper
+        define_method("#{legacy}_class") do
+          Spree::Deprecation.warn("Spree.api.#{legacy}_class is deprecated and will be removed in Spree 6.1. Use #{current}_class instead.")
+          send("#{current}_class")
+        end
+      end
     end
   end
 end