spree_api 6.0.0.beta4 → 6.0.0.rc2

data/lib/spree/api/dependencies.rb

@@ -3,288 +3,68 @@ require 'spree/core/dependencies_helper'
 module Spree
   module Api
     class ApiDependencies
+      # Serializers named after their key: `product_serializer` is
+      # Spree::Api::V3::ProductSerializer, `admin_product_serializer` its Admin
+      # twin and `seller_product_serializer` its Seller one.
+      STORE_SERIALIZERS =
+        %i[credit_card price price_history product product_type variant media option_type option_value cart order
+           order_group line_item payment payment_session payment_setup_session payment_source store_credit
+           fulfillment delivery address customer data_request customer_group country channel product_publication
+           market state wishlist wishlist_item payment_method delivery_method delivery_rate freight_summary
+           stock_location category collection applied_promotion discount tax_line delivery_zone delivery_zone_member
+           fee digital_link gift_card currency locale policy custom_field tax_category tax_identifier
+           product_filters product_filter_price_range product_filter_availability product_filter_availability_option
+           product_filter_option product_filter_option_value product_filter_category product_filter_category_option
+           product_filter_sort_option media_event return return_line_item exchange exchange_line_item claim
+           claim_line_item return_reason claim_reason digital_asset export gift_card_batch import import_row
+           invitation newsletter_subscriber promotion refund stock_level stock_movement stock_reservation
+           stock_transfer company company_membership company_invitation seller file_upload file_upload_target].freeze
+
+      ADMIN_SERIALIZERS =
+        %i[country state locale applied_promotion discount tax_line cart delivery_zone delivery_profile
+           delivery_origin_group integration delivery_method_rule delivery_zone_member fee consent_record customer
+           data_request newsletter_subscriber order order_group product product_type
+           product_type_custom_field_definition variant price price_history custom_field custom_field_definition
+           category collection collection_rule line_item option_type option_value media stock_level stock_movement
+           stock_transfer stock_transfer_item supplier purchase_order purchase_order_item stock_receipt
+           stock_receipt_item fulfillment fulfillment_item delivery shipping_label gift_card gift_card_batch payment
+           refund return_reason claim_reason refund_reason order_cancellation_reason return return_line_item
+           exchange exchange_line_item claim claim_line_item package_type policy tax_category tax_rate
+           tax_identifier company company_membership company_invitation catalog catalog_price catalog_price_tier
+           catalog_product price_list_product catalog_assignment catalog_quantity_rule catalog_product_term
+           catalog_order_minimum tax_exemption_certificate admin_user actor seller_team_member product_submission
+           seller seller_requirement seller_requirement_submission seller_requirement_status commission_rate
+           commission_rule commission_line seller_transfer seller_payout seller_balance payment_split address
+           channel order_routing_rule product_publication market delivery_method delivery_method_service
+           stock_location stock_reservation delivery_rate freight_summary freight_summary_line payment_method
+           credit_card store_credit store_credit_event customer_group payment_source digital_asset digital_link
+           store setup_task update_status api_key allowed_origin webhook_endpoint webhook_event webhook_delivery invitation
+           invitation_acceptance_link role permission export saved_report import import_row import_mapping promotion
+           promotion_action promotion_rule coupon_code price_adjustment_tier price_list price_rule
+           resource_translations email_template email_template_draft email_template_revision email_template_preview
+           email_template_sample_record file_upload file_upload_target].freeze
+
+      SELLER_SERIALIZERS =
+        %i[address country state profile policy team_member account invitation invitation_acceptance_link product product_type
+           delivery_profile delivery_method delivery_method_rule delivery_zone variant media stock_level order
+           order_line_item fulfillment fulfillment_item delivery delivery_rate shipping_label return
+           return_line_item exchange exchange_line_item claim claim_line_item reason package_type stock_location
+           requirement_custom_field tax_identifier requirement_status import import_row import_mapping
+           requirement_submission export transfer payout balance payment_split price price_history file_upload
+           file_upload_target].freeze
+
       INJECTION_POINTS_WITH_DEFAULTS = {
-        # 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',
-        payment_setup_session_serializer: 'Spree::Api::V3::PaymentSetupSessionSerializer',
-        payment_source_serializer: 'Spree::Api::V3::PaymentSourceSerializer',
-        store_credit_serializer: 'Spree::Api::V3::StoreCreditSerializer',
+        **STORE_SERIALIZERS.to_h { |name| [:"#{name}_serializer", "Spree::Api::V3::#{name.to_s.camelize}Serializer"] },
+        **ADMIN_SERIALIZERS.to_h { |name| [:"admin_#{name}_serializer", "Spree::Api::V3::Admin::#{name.to_s.camelize}Serializer"] },
+        **SELLER_SERIALIZERS.to_h { |name| [:"seller_#{name}_serializer", "Spree::Api::V3::Seller::#{name.to_s.camelize}Serializer"] },
         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',
-        product_publication_serializer: 'Spree::Api::V3::ProductPublicationSerializer',
-        market_serializer: 'Spree::Api::V3::MarketSerializer',
-        state_serializer: 'Spree::Api::V3::StateSerializer',
-        wishlist_serializer: 'Spree::Api::V3::WishlistSerializer',
-        wishlist_item_serializer: 'Spree::Api::V3::WishlistItemSerializer',
         wished_item_serializer: 'Spree::Api::V3::WishlistItemSerializer',
-        payment_method_serializer: 'Spree::Api::V3::PaymentMethodSerializer',
         shipping_method_serializer: 'Spree::Api::V3::DeliveryMethodSerializer',
         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',
-        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',
-        product_filter_availability_option_serializer: 'Spree::Api::V3::ProductFilterAvailabilityOptionSerializer',
-        product_filter_option_serializer: 'Spree::Api::V3::ProductFilterOptionSerializer',
-        product_filter_option_value_serializer: 'Spree::Api::V3::ProductFilterOptionValueSerializer',
-        product_filter_category_serializer: 'Spree::Api::V3::ProductFilterCategorySerializer',
-        product_filter_category_option_serializer: 'Spree::Api::V3::ProductFilterCategoryOptionSerializer',
-        product_filter_sort_option_serializer: 'Spree::Api::V3::ProductFilterSortOptionSerializer',
-
-        # v3 event serializers (for models without Store API endpoints yet)
-        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',
-        import_row_serializer: 'Spree::Api::V3::ImportRowSerializer',
-        invitation_serializer: 'Spree::Api::V3::InvitationSerializer',
-        newsletter_subscriber_serializer: 'Spree::Api::V3::NewsletterSubscriberSerializer',
-        promotion_serializer: 'Spree::Api::V3::PromotionSerializer',
-        refund_serializer: 'Spree::Api::V3::RefundSerializer',
-        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',
-
-        # 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_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_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_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_actor_serializer: 'Spree::Api::V3::Admin::ActorSerializer',
-        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_account_serializer: 'Spree::Api::V3::Seller::AccountSerializer',
-        seller_invitation_serializer: 'Spree::Api::V3::Seller::InvitationSerializer',
-        seller_invitation_acceptance_link_serializer: 'Spree::Api::V3::Seller::InvitationAcceptanceLinkSerializer',
-        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',
-        admin_product_publication_serializer: 'Spree::Api::V3::Admin::ProductPublicationSerializer',
-        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_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',
-        admin_api_key_serializer: 'Spree::Api::V3::Admin::ApiKeySerializer',
-        admin_allowed_origin_serializer: 'Spree::Api::V3::Admin::AllowedOriginSerializer',
-        admin_webhook_endpoint_serializer: 'Spree::Api::V3::Admin::WebhookEndpointSerializer',
-        admin_webhook_delivery_serializer: 'Spree::Api::V3::Admin::WebhookDeliverySerializer',
-        admin_invitation_serializer: 'Spree::Api::V3::Admin::InvitationSerializer',
-        admin_invitation_acceptance_link_serializer: 'Spree::Api::V3::Admin::InvitationAcceptanceLinkSerializer',
-        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',
-        admin_promotion_serializer: 'Spree::Api::V3::Admin::PromotionSerializer',
-        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',
+        admin_shipping_rate_serializer: 'Spree::Api::V3::Admin::DeliveryRateSerializer'
       }
 
       include Spree::DependenciesHelper

data/lib/spree/api/middleware/request_size_limit.rb

@@ -2,13 +2,24 @@ module Spree
   module Api
     module Middleware
       class RequestSizeLimit
+        # `POST /files` takes a file's bytes in the request itself, so it is
+        # held to the multipart upload limit instead, plus room for the other
+        # form fields.
+        FILE_UPLOAD_PATH = %r{\A/api/v3/(admin|seller)/files/?\z}
+        MULTIPART_ENVELOPE = 64.kilobytes
+
         def initialize(app, limit: nil)
           @app = app
           @limit = limit
         end
 
         def call(env)
-          if api_request?(env) && content_length_exceeded?(env)
+          if file_upload?(env) && chunked?(env)
+            # A chunked body has no length to check here, and these bytes pass
+            # through the application.
+            body = { error: { code: 'request_too_large', message: 'Send the file with a Content-Length header' } }
+            [411, { 'Content-Type' => 'application/json' }, [body.to_json]]
+          elsif api_request?(env) && content_length_exceeded?(env)
             body = { error: { code: 'request_too_large', message: 'Request body too large' } }
             [413, { 'Content-Type' => 'application/json' }, [body.to_json]]
           else
@@ -24,12 +35,22 @@ module Spree
 
         def content_length_exceeded?(env)
           content_length = env['CONTENT_LENGTH'].to_i
-          content_length > max_body_size
+          content_length > max_body_size(env)
         end
 
-        def max_body_size
+        def max_body_size(env)
+          return Spree::Config[:max_multipart_upload_size] + MULTIPART_ENVELOPE if file_upload?(env)
+
           @limit || Spree::Api::Config[:max_request_body_size]
         end
+
+        def chunked?(env)
+          env['CONTENT_LENGTH'].nil? && env['HTTP_TRANSFER_ENCODING'].to_s.include?('chunked')
+        end
+
+        def file_upload?(env)
+          env['REQUEST_METHOD'] == 'POST' && FILE_UPLOAD_PATH.match?(env['PATH_INFO'])
+        end
       end
     end
   end

data/lib/spree/api/openapi/filter_documentation.rb

@@ -0,0 +1,136 @@
+module Spree
+  module Api
+    module OpenAPI
+      # Turns one list endpoint's filter table into what a reader of the API
+      # reference sees: `q[search]` and the other scopes as named query
+      # parameters, and the attribute filters as a table rendered above the
+      # endpoint (Mintlify's `x-mint.content`).
+      class FilterDocumentation
+        KIND_LABELS = {
+          'text' => 'Text', 'decimal' => 'Amount', 'integer' => 'Number', 'date' => 'Date',
+          'datetime' => 'Date and time', 'id' => 'Prefixed ID', 'type' => 'Type', 'boolean' => 'True or false'
+        }.freeze
+
+        SCOPE_SCHEMAS = {
+          'boolean' => { type: :boolean }, 'integer' => { type: :integer }, 'decimal' => { type: :number }
+        }.freeze
+
+        # Raised when an endpoint offers `q[search]` and nothing says what it matches.
+        class MissingSearchDescription < StandardError; end
+
+        # @param endpoint [Spree::Api::V3::FilterTable::Endpoint]
+        # @param querying_path [String] the docs page explaining predicates
+        # @param search [String, nil] what `q[search]` matches, for a model
+        #   whose search is not declared with `search_by`
+        # @param scopes [Hash{String => String}] descriptions for other scopes
+        def initialize(endpoint, querying_path:, search: nil, scopes: {})
+          @endpoint = endpoint
+          @table = endpoint.table
+          @querying_path = querying_path
+          @search = search
+          @scopes = scopes.stringify_keys
+        end
+
+        # @return [Array<Hash>] rswag parameter definitions, `q[search]` first
+        def parameters
+          names = @table.scopes.keys.sort_by { |scope| scope == 'search' ? '' : scope }
+          names.map { |scope| scope_parameter(scope, @table.scopes[scope]) }
+        end
+
+        # @return [String] MDX for the endpoint page
+        def content
+          lines = ['## Filters', '']
+          lines << "Filter with `q[<attribute>_<predicate>]=value`, for example `#{example_key}`. Send a list as " \
+                   "`q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](#{@querying_path})."
+          lines << ''
+          lines.concat(attribute_rows(@table))
+
+          associations = association_rows
+          if associations.any?
+            lines << '' << '<Accordion title="Filters through associations">' << ''
+            lines << 'Prefix an associated record\'s attribute with the association, as in ' \
+                     "`q[#{associations.first[0]}id_eq]`. The same predicates apply." << ''
+            lines << '| Prefix | Attributes |' << '|---|---|'
+            associations.each { |prefix, attributes| lines << "| `#{prefix}` | #{attributes.map { |name| "`#{name}`" }.join(', ')} |" }
+            lines << '' << '</Accordion>'
+          end
+
+          if @endpoint.to_h['custom_fields']
+            lines << '' << "Also filters and sorts on the store's searchable custom fields, as " \
+                           '`q[cf_<namespace>_<key>_<predicate>]` and `sort=cf_<namespace>_<key>`.'
+          end
+
+          sortable = @endpoint.sortable - @table.aliased_attributes
+          if sortable.any?
+            lines << '' << "**Sort by:** #{sortable.map { |field| "`#{field}`" }.join(', ')}. " \
+                           'Prefix a field with `-` to sort descending.'
+          end
+
+          lines.join("\n")
+        end
+
+        private
+
+        def scope_parameter(scope, type)
+          list = type.is_a?(Hash) || type.is_a?(Array)
+          {
+            name: list ? "q[#{scope}][]" : "q[#{scope}]",
+            in: :query,
+            required: false,
+            schema: scope_schema(type),
+            description: scope == 'search' ? search_description : @scopes.fetch(scope) { default_scope_description(scope, type) }
+          }
+        end
+
+        def scope_schema(type)
+          case type
+          when Hash then { type: :array, items: scope_schema(type['list']) }
+          when Array then { type: :array, items: scope_schema(type.first), minItems: type.size, maxItems: type.size }
+          else SCOPE_SCHEMAS.fetch(type, { type: :string })
+          end
+        end
+
+        def search_description
+          return @search if @search
+
+          attributes = @table.model.search_attributes
+          raise MissingSearchDescription, "#{@table.model.name}.search has no description; pass `search:` to filter_parameters_for" if attributes.empty?
+
+          "Matches any of #{attributes.map { |path| path.tr('_', ' ') }.to_sentence} (partial, case-insensitive)."
+        end
+
+        def default_scope_description(scope, type)
+          type == 'boolean' ? "Set to `true` to apply `#{scope}`." : "Applies `#{scope}` to the given value."
+        end
+
+        def attribute_rows(table)
+          rows = ['| Attribute | Kind | Predicates |', '|---|---|---|']
+          table.attributes.except(*table.aliased_attributes).each do |attribute, kind|
+            label = kind.is_a?(Hash) ? "One of #{kind['enum'].map { |value| "`#{value}`" }.join(', ')}" : KIND_LABELS.fetch(kind)
+            predicates = Spree::Api::V3::FilterPredicates::BY_KIND.fetch(kind.is_a?(Hash) ? 'enum' : kind)
+            rows << "| `#{attribute}` | #{label} | #{predicates.map { |predicate| "`#{predicate}`" }.join(' ')} |"
+          end
+          rows
+        end
+
+        def association_rows
+          visible = ->(table) { table.attributes.keys - table.aliased_attributes }
+          @table.associations.flat_map do |name, associated|
+            nested = associated.associations.reject { |_, table| table.model == @table.model }
+            [["#{name}_", visible.(associated)]] + nested.map { |hop, table| ["#{name}_#{hop}_", visible.(table)] }
+          end
+        end
+
+        def example_key
+          texts = @table.attributes.select { |_, value| value == 'text' }
+          attribute = (%w[number name code email] & texts.keys).first || texts.keys.first
+          kind = 'text' if attribute
+          attribute, kind = @table.attributes.first if attribute.nil?
+          return 'q[id_eq]=…' if attribute.nil?
+
+          kind == 'text' ? "q[#{attribute}_cont]=…" : "q[#{attribute}_eq]=…"
+        end
+      end
+    end
+  end
+end