spree_api 6.0.0.beta4 → 6.0.0.rc1

data/lib/spree/api/dependencies.rb

@@ -3,288 +3,67 @@ 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].freeze
+
+      ADMIN_SERIALIZERS =
+        %i[country state 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 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].freeze
+
+      SELLER_SERIALIZERS =
+        %i[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].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/openapi/schema_helper.rb

@@ -92,7 +92,7 @@ module Spree
               properties: {
                 allow: { type: :boolean, description: 'true for `can`, false for `cannot`' },
                 actions: { type: :array, items: { type: :string }, description: 'Action names, e.g. ["read", "update"] or ["manage"]' },
-                subjects: { type: :array, items: { type: :string }, description: 'Subject class names, e.g. ["Spree::Product"] or ["all"]' },
+                subjects: { type: :array, items: { type: :string }, description: 'Subject short names, e.g. ["product"] or ["all"]' },
                 has_conditions: { type: :boolean, description: 'True if the server-side rule has per-record conditions. The SPA shows the action optimistically and handles 403 from the API.' }
               },
               required: %w[allow actions subjects has_conditions]

data/lib/spree/api/typelizer_generation.rb

@@ -0,0 +1,35 @@
+module Spree
+  module Api
+    # Generates every SDK's TypeScript types from the serializers, the email
+    # template types included. Runs inside spree_emails' test app, the one
+    # place where the API's and the email serializers are all loaded: running
+    # it with any serializer missing would delete that serializer's types.
+    module TypelizerGeneration
+      # @param serializer_dirs [Array<String, Pathname>] directories to load before generating
+      def self.call(serializer_dirs)
+        serializer_dirs.each { |dir| Rails.autoloaders.main.eager_load_dir(dir.to_s) }
+
+        require 'typelizer/generator'
+        Typelizer::Generator.call(force: true)
+
+        # `interface` rather than `type`, so SDK consumers can extend generated
+        # types through declaration merging.
+        api_root = Spree::Api::Engine.root
+        [api_root.join('../../packages/sdk/src/types/generated'), api_root.join('../../packages/admin-sdk/src/types/generated'),
+         api_root.join('../../packages/admin-sdk/src/types/generated/emails')].each do |dir|
+          Dir[File.join(dir, '*.ts')].each do |file|
+            next if File.basename(file) == 'index.ts'
+
+            content = File.read(file)
+            updated = content.gsub(/^type (\w+) = \{/, 'interface \1 {')
+            File.write(file, updated) if updated != content
+          end
+        end
+
+        # The typed webhook events in @spree/sdk, from the event catalog.
+        require Spree::Api::Engine.root.join('lib/spree/api/webhook_event_types').to_s
+        Spree::Api::WebhookEventTypes.new.write!(api_root.join('../..'))
+      end
+    end
+  end
+end

data/lib/spree/api/webhook_event_types.rb

@@ -0,0 +1,140 @@
+module Spree
+  module Api
+    # Renders the event catalog ({Spree::Events.catalog}) into the typed event
+    # map `@spree/sdk/webhooks` exports and the matching Zod schema map, so a
+    # webhook consumer's `event.name` check narrows `event.data` to the record
+    # the event carries.
+    #
+    # Run by `rake typelizer:generate`; `webhook_event_types_spec.rb` fails when
+    # the committed files no longer match the catalog.
+    class WebhookEventTypes
+      # The payload of an event whose record has no Store serializer.
+      RECORD_REFERENCE = 'WebhookRecordReference'.freeze
+      BACK_OFFICE_SERIALIZER = /\ASpree::Api::V3::\w+::/
+      HEADER = "// This file is auto-generated from Spree's event catalog by `rake typelizer:generate`. Do not edit directly.\n".freeze
+
+      FILES = {
+        types: 'packages/sdk/src/webhooks/generated/events.ts',
+        schemas: 'packages/sdk/src/webhooks/generated/schemas.ts'
+      }.freeze
+
+      # @param catalog [Spree::Events::Catalog]
+      def initialize(catalog = Spree::Events.catalog)
+        @catalog = catalog
+      end
+
+      # @return [Hash{Symbol => String}] file contents keyed like {FILES}
+      def render
+        { types: types_source, schemas: schemas_source }
+      end
+
+      # Writes both files under the monorepo root.
+      #
+      # @param root [Pathname]
+      # @return [void]
+      def write!(root)
+        render.each do |key, source|
+          path = root.join(FILES.fetch(key))
+          FileUtils.mkdir_p(path.dirname)
+          File.write(path, source)
+        end
+      end
+
+      private
+
+      attr_reader :catalog
+
+      def entries
+        @entries ||= catalog.webhook_events
+      end
+
+      def payload_type_names
+        @payload_type_names ||= type_names.values.uniq.sort - [RECORD_REFERENCE]
+      end
+
+      def type_name(entry)
+        type_names.fetch(entry.name)
+      end
+
+      def type_names
+        @type_names ||= entries.to_h { |entry| [entry.name, resolve_type_name(entry)] }
+      end
+
+      # Named the way the Store SDK's type writer names it. A back-office shape
+      # stays behind the Admin API even when a Store-level class inherits it
+      # (docs/plans/6.0-typed-webhook-events.md).
+      def resolve_type_name(entry)
+        serializer = entry.payload_serializer
+        return RECORD_REFERENCE unless serializer
+
+        back_office = serializer.ancestors.grep(Class).any? { |ancestor| ancestor.name.to_s.match?(BACK_OFFICE_SERIALIZER) }
+        if back_office || store_writer.reject_class.call(serializer: serializer)
+          raise ArgumentError, "#{entry.name} is built by #{serializer.name}, which is not a Store API serializer"
+        end
+
+        store_writer.serializer_name_mapper.call(serializer)
+      end
+
+      def store_writer
+        Typelizer.configuration.writers.fetch(:store)
+      end
+
+      def types_source
+        <<~TS
+          #{HEADER}import type {
+          #{payload_type_names.map { |name| "  #{name}," }.join("\n")}
+          } from '../../types/generated'
+
+          /** The payload of an event whose record has no Store API representation. */
+          export interface #{RECORD_REFERENCE} {
+            id: string
+            created_at: string | null
+            updated_at: string | null
+          }
+
+          /**
+           * Every webhook event Spree publishes, mapped to the record its `data`
+           * carries. An interface, so an extension adds its own events by
+           * declaration merging.
+           */
+          export interface WebhookEventMap {
+          #{entries.map { |entry| map_line(entry) }.join("\n")}
+          }
+        TS
+      end
+
+      def map_line(entry)
+        notes = []
+        notes << "@deprecated Use `#{entry.deprecated_alias_of}` instead." if entry.deprecated?
+        notes << 'Carries a live credential: delivered only to endpoints that name this event.' if entry.credential?
+        comment = notes.map { |note| "  /** #{note} */\n" }.join
+        "#{comment}  '#{entry.name}': #{type_name(entry)}"
+      end
+
+      def schemas_source
+        schema_names = payload_type_names.map { |name| "#{name}Schema" }
+
+        <<~TS
+          #{HEADER}import { z } from 'zod'
+          import {
+          #{schema_names.map { |name| "  #{name}," }.join("\n")}
+          } from '../../zod/generated'
+
+          export const #{RECORD_REFERENCE}Schema = z.object({
+            id: z.string(),
+            created_at: z.string().nullable(),
+            updated_at: z.string().nullable(),
+          })
+
+          type WebhookEventName =
+          #{entries.map { |entry| "  | '#{entry.name}'" }.join("\n")}
+
+          /** The Zod schema for each webhook event's `data`, for `constructWebhookEvent`'s `schemas` option. */
+          export const webhookEventSchemas: Readonly<Record<WebhookEventName, z.ZodType>> = {
+          #{entries.map { |entry| "  '#{entry.name}': #{type_name(entry)}Schema," }.join("\n")}
+          }
+        TS
+      end
+    end
+  end
+end

data/lib/spree/api.rb

@@ -1,7 +1,5 @@
 require 'spree/core'
 require 'pagy'
-require 'alba'
-require 'oj'
 require 'typelizer'
 require 'typelizer/proc_resource_resolution'
 require 'typelizer/open_enums'