spree_api 5.1.8 → 5.2.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f723f66d6c9523d36a04ee306b01672613993c9872321fcc79d55af925bf263
-  data.tar.gz: fc41bec9b0023f8d3b9a8d33bcf9c8dbf1e769f6ec6edc23cb387245b73c7e01
+  metadata.gz: e19f525a706c6e563c811fabc0b5651ea2e9c52b35b146b9722874dec3190f25
+  data.tar.gz: cccf27bf698f5f1b1566309f44e7b219a316611752c0089d582fa0fcbbe7fb67
 SHA512:
-  metadata.gz: f785cccca5707294385ac9c0bef3410a5afd5dbc2dc254a2b188c0822ca0af976d9ceffe00267a82f83ace044c1e265fc3b6c8386a4b858b65ad667d30eeeb1d
-  data.tar.gz: 6a1fe5046e8a1fc71aa964066b9074d305e976a47483d6f7ded2af42ec9f8bb70f48312f8dfbf1e838fc24e601e40408b64844e4278c6eca4fba0bd27886f6fa
+  metadata.gz: 581570627fa3b3d808127d66c2cdbe7d2fd7fedda9b1be6dc01a7f7db8c31b2c96507181220c395cb338561c14e1f3894be00b7ba06a82a6bdae7289ef8f0e78
+  data.tar.gz: 56612e608b806be5f50f645365b26a710e045f7e2fe508f68106eb04a0d5f34d7a0e53fa326aa95aec7371a4886c85e4058f5457483ceb308cd7230add0fd5de

data/app/controllers/concerns/spree/api/v2/storefront/order_concern.rb

@@ -18,7 +18,7 @@ module Spree
           end
 
           def order_token
-            request.headers['X-Vendo-Order-Token'] || request.headers['X-Spree-Order-Token'] || params[:order_token]
+            request.headers['X-Spree-Order-Token'] || params[:order_token]
           end
 
           def spree_current_order

data/app/controllers/spree/api/v2/platform/resource_controller.rb

@@ -117,7 +117,7 @@ module Spree
                           []
                         end
 
-            model_class.json_api_permitted_attributes + store_ids + metadata_params
+            model_class.json_api_permitted_attributes + store_ids + metadata_params + metafields_params
           end
 
           def metadata_params
@@ -128,6 +128,14 @@ module Spree
             end
           end
 
+          def metafields_params
+            if Spree::MetafieldDefinition.available_resources.map(&:name).include?(model_class.name) && model_class.method_defined?(:metafields)
+              [{ metafields_attributes: Spree::PermittedAttributes.metafield_attributes }]
+            else
+              []
+            end
+          end
+
           def permitted_resource_params
             params.require(model_param_name).permit(spree_permitted_attributes)
           end

data/app/controllers/spree/api/v2/storefront/policies_controller.rb

@@ -0,0 +1,31 @@
+module Spree
+  module Api
+    module V2
+      module Storefront
+        class PoliciesController < ::Spree::Api::V2::ResourceController
+          private
+
+          def collection_serializer
+            Spree::Api::Dependencies.storefront_policy_serializer.constantize
+          end
+
+          def resource_serializer
+            Spree::Api::Dependencies.storefront_policy_serializer.constantize
+          end
+
+          def resource
+            @resource ||= find_with_fallback_default_locale { scope.find_by(slug: params[:id]) } || scope.find(params[:id])
+          end
+
+          def model_class
+            Spree::Policy
+          end
+
+          def scope_includes
+            [:rich_text_translations]
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/storefront/post_categories_controller.rb

@@ -0,0 +1,35 @@
+module Spree
+  module Api
+    module V2
+      module Storefront
+        class PostCategoriesController < ::Spree::Api::V2::ResourceController
+          protected
+
+          def collection
+            @collection ||= scope
+          end
+
+          def resource
+            @resource ||= find_with_fallback_default_locale { scope.friendly.find(params[:id]) } || scope.friendly.find(params[:id])
+          end
+
+          def collection_serializer
+            Spree::V2::Storefront::PostCategorySerializer
+          end
+
+          def resource_serializer
+            Spree::V2::Storefront::PostCategorySerializer
+          end
+
+          def model_class
+            Spree::PostCategory
+          end
+
+          def serializer_params
+            super.merge(include_posts: action_name == 'show')
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/storefront/posts_controller.rb

@@ -0,0 +1,51 @@
+module Spree
+  module Api
+    module V2
+      module Storefront
+        class PostsController < ::Spree::Api::V2::ResourceController
+          protected
+
+          def sorted_collection
+            collection_sorter.new(collection, params, allowed_sort_attributes).call
+          end
+
+          def collection
+            @collection ||= collection_finder.new(scope: scope, params: finder_params).execute
+          end
+
+          def resource
+            @resource ||= find_with_fallback_default_locale { scope.friendly.find(params[:id]) } || scope.friendly.find(params[:id])
+          end
+
+          def collection_finder
+            Spree::Api::Dependencies.storefront_posts_finder.constantize
+          end
+
+          def collection_sorter
+            Spree::Api::Dependencies.storefront_posts_sorter.constantize
+          end
+
+          def collection_serializer
+            Spree::V2::Storefront::PostSerializer
+          end
+
+          def resource_serializer
+            Spree::V2::Storefront::PostSerializer
+          end
+
+          def model_class
+            Spree::Post
+          end
+
+          def scope
+            super.published.includes(:post_category, image_attachment: :blob)
+          end
+
+          def allowed_sort_attributes
+            super << :published_at << :title
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/storefront/products_controller.rb

@@ -16,14 +16,15 @@ module Spree
           end
 
           def resource
-            # fixed N+1 queries issue
-            variant_includes = [
+            # using FriendlyId so old slugs still work
+            @resource ||= find_with_fallback_default_locale { scope.includes(variants: variant_includes, master: variant_includes).friendly.find(params[:id]) } || scope.includes(variants: variant_includes, master: variant_includes).friendly.find(params[:id])
+          end
+
+          def variant_includes
+            [
               :prices,
               { option_values: [:option_type] }
             ]
-
-            # using FriendlyId so old slugs still work
-            @resource ||= find_with_fallback_default_locale { scope.includes(variants: variant_includes, master: variant_includes).friendly.find(params[:id]) } || scope.includes(variants: variant_includes, master: variant_includes).friendly.find(params[:id])
           end
 
           def collection_sorter

data/app/models/concerns/spree/webhooks/has_webhooks.rb

@@ -82,7 +82,9 @@ module Spree
       end
 
       def no_webhooks_subscribers?(event_name)
-        !Spree::Webhooks::Subscriber.active.with_urls_for(event_name).exists?
+        Spree::Current.webhooks_subscribers.none? do |subscriber|
+          subscriber.supports_event?(event_name)
+        end
       end
 
       def webhooks_request_options

data/app/models/spree/webhooks/subscriber.rb

@@ -11,7 +11,6 @@ module Spree
         has_secure_token :secret_key
       end
 
-
       has_many :events, inverse_of: :subscriber
 
       validates :url, 'spree/url': true, presence: true
@@ -29,6 +28,14 @@ module Spree
         events.order(:created_at).last&.created_at
       end
 
+      # Returns true if the subscriber supports the given event
+      #
+      # @param event [String] The event to check, e.g. 'product.create'
+      # @return [Boolean]
+      def supports_event?(event)
+        subscriptions.include?(event) || subscriptions.include?('*')
+      end
+
       def self.with_urls_for(event)
         where(
           case ActiveRecord::Base.connection.adapter_name
@@ -55,6 +62,10 @@ module Spree
         end
       end
 
+      def name
+        url
+      end
+
       private
 
       def check_uri_path

data/app/serializers/concerns/spree/api/v2/public_metafields_concern.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Api
+    module V2
+      module PublicMetafieldsConcern
+        extend ActiveSupport::Concern
+
+        included do
+          has_many :metafields, serializer: Spree::Api::Dependencies.storefront_metafield_serializer.constantize,
+                                record_type: :metafield,
+                                object_method_name: :public_metafields
+        end
+      end
+    end
+  end
+end

data/app/serializers/concerns/spree/api/v2/resource_serializer_concern.rb

@@ -17,6 +17,13 @@ module Spree
               object.public_send(method_name).to_s
             end
           end
+
+          metafield_enabled_resources = Spree::MetafieldDefinition.available_resources || []
+          if metafield_enabled_resources.map(&:name).include?(model_klazz.name) && model_klazz.method_defined?(:metafields)
+            base.has_many :metafields, serializer: Spree::Api::Dependencies.platform_metafield_serializer.constantize,
+                                       record_type: :metafield,
+                                       object_method_name: :metafields
+          end
         end
 
         def self.display_getter_methods(model_klazz)

data/app/serializers/spree/api/v2/platform/metafield_serializer.rb

@@ -0,0 +1,21 @@
+module Spree
+  module Api
+    module V2
+      module Platform
+        class MetafieldSerializer < BaseSerializer
+          set_type :metafield
+
+          attributes :name, :type, :display_on
+
+          attribute :key do |metafield|
+            metafield.full_key
+          end
+
+          attribute :value do |metafield|
+            metafield.serialize_value
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/v2/storefront/address_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class AddressSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :address
 
         attributes :firstname, :lastname, :address1, :address2, :city, :zipcode, :phone, :state_name,

data/app/serializers/spree/v2/storefront/cart_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class CartSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :cart
 
         attributes :number, :item_total, :total, :ship_total, :adjustment_total, :created_at,
@@ -40,25 +42,25 @@ module Spree
           cart.display_total_minus_store_credits.amount_in_cents
         end
 
-        has_many   :line_items
-        has_many   :variants
-        has_many   :promotions, object_method_name: :valid_promotions, id_method_name: :valid_promotion_ids
-        has_many   :payments do |cart|
+        has_many   :line_items, serializer: Spree::Api::Dependencies.storefront_line_item_serializer.constantize
+        has_many   :variants, serializer: Spree::Api::Dependencies.storefront_variant_serializer.constantize
+        has_many   :promotions, serializer: Spree::Api::Dependencies.storefront_order_promotion_serializer.constantize, object_method_name: :valid_promotions, id_method_name: :valid_promotion_ids
+        has_many   :payments, serializer: Spree::Api::Dependencies.storefront_payment_serializer.constantize do |cart|
           cart.payments.valid
         end
-        has_many   :shipments
+        has_many   :shipments, serializer: Spree::Api::Dependencies.storefront_shipment_serializer.constantize
 
-        belongs_to :user
+        belongs_to :user, serializer: Spree::Api::Dependencies.storefront_user_serializer.constantize
         belongs_to :billing_address,
                    id_method_name: :bill_address_id,
-                   serializer: :address,
+                   serializer: Spree::Api::Dependencies.storefront_address_serializer.constantize,
                    record_type: :address
 
         belongs_to :shipping_address,
                    id_method_name: :ship_address_id,
-                   serializer: :address,
+                   serializer: Spree::Api::Dependencies.storefront_address_serializer.constantize,
                    record_type: :address
-        belongs_to :gift_card, serializer: :gift_card
+        belongs_to :gift_card, serializer: Spree::Api::Dependencies.storefront_gift_card_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/credit_card_serializer.rb

@@ -2,11 +2,13 @@ module Spree
   module V2
     module Storefront
       class CreditCardSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :credit_card
 
         attributes :cc_type, :last_digits, :month, :year, :name, :default, :gateway_payment_profile_id, :public_metadata
 
-        belongs_to :payment_method
+        belongs_to :payment_method, serializer: Spree::Api::Dependencies.storefront_payment_method_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/estimated_shipping_rate_serializer.rb

@@ -12,7 +12,7 @@ module Spree
           shipping_rate.shipping_method_id.to_s
         end
 
-        belongs_to :shipping_method
+        belongs_to :shipping_method, serializer: Spree::Api::Dependencies.storefront_shipping_method_serializer.constantize
 
         attribute :final_price do |shipping_rate|
           shipping_rate.cost

data/app/serializers/spree/v2/storefront/gift_card_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class GiftCardSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type   :gift_card
 
         attributes :amount, :amount_used, :amount_remaining, :display_amount, :display_amount_used,

data/app/serializers/spree/v2/storefront/line_item_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class LineItemSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type   :line_item
 
         attributes :name, :quantity, :price, :slug, :options_text, :currency,
@@ -13,8 +15,8 @@ module Spree
                    :pre_tax_amount, :display_pre_tax_amount, :compare_at_amount, :display_compare_at_amount,
                    :public_metadata
 
-        belongs_to :variant
-        has_many :digital_links
+        belongs_to :variant, serializer: Spree::Api::Dependencies.storefront_variant_serializer.constantize
+        has_many :digital_links, serializer: Spree::Api::Dependencies.storefront_digital_link_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/metafield_serializer.rb

@@ -0,0 +1,19 @@
+module Spree
+  module V2
+    module Storefront
+      class MetafieldSerializer < BaseSerializer
+        set_type :metafield
+
+        attributes :name, :type
+
+        attribute :key do |metafield|
+          metafield.full_key
+        end
+
+        attribute :value do |metafield|
+          metafield.serialize_value
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/v2/storefront/option_type_serializer.rb

@@ -2,11 +2,13 @@ module Spree
   module V2
     module Storefront
       class OptionTypeSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type   :option_type
 
         attributes :name, :presentation, :position, :public_metadata
 
-        has_many   :option_values
+        has_many   :option_values, serializer: Spree::Api::Dependencies.storefront_option_value_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/option_value_serializer.rb

@@ -6,7 +6,7 @@ module Spree
 
         attributes :name, :presentation, :position, :public_metadata
 
-        belongs_to :option_type
+        belongs_to :option_type, serializer: Spree::Api::Dependencies.storefront_option_type_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/{promotion_serializer.rb → order_promotion_serializer.rb}

@@ -1,7 +1,9 @@
+# this is actually a serializer for Spree::OrderPromotion, not Spree::Promotion
+# we should fix this in the future
 module Spree
   module V2
     module Storefront
-      class PromotionSerializer < BaseSerializer
+      class OrderPromotionSerializer < BaseSerializer
         set_id     :promotion_id
         set_type   :promotion
 

data/app/serializers/spree/v2/storefront/order_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class OrderSerializer < CartSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :order
       end
     end

data/app/serializers/spree/v2/storefront/payment_method_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class PaymentMethodSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :payment_method
 
         attributes :type, :name, :description, :public_metadata

data/app/serializers/spree/v2/storefront/payment_serializer.rb

@@ -2,15 +2,17 @@ module Spree
   module V2
     module Storefront
       class PaymentSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :payment
 
         has_one :source, polymorphic: true
-        has_one :payment_method
+        has_one :payment_method, serializer: Spree::Api::Dependencies.storefront_payment_method_serializer.constantize
 
         attributes :amount, :response_code, :number, :cvv_response_code, :cvv_response_message, :payment_method_name, :state, :public_metadata
 
         attribute :payment_method_id do |payment|
-          payment.payment_method_id.to_s
+          payment.payment_method_id&.to_s
         end
       end
     end

data/app/serializers/spree/v2/storefront/payment_source_serializer.rb

@@ -2,8 +2,10 @@ module Spree
   module V2
     module Storefront
       class PaymentSourceSerializer < BaseSerializer
-        belongs_to :payment_method
-        belongs_to :user
+        include Spree::Api::V2::PublicMetafieldsConcern
+
+        belongs_to :payment_method, serializer: Spree::Api::Dependencies.storefront_payment_method_serializer.constantize
+        belongs_to :user, serializer: Spree::Api::Dependencies.storefront_user_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/policy_serializer.rb

@@ -0,0 +1,19 @@
+module Spree
+  module V2
+    module Storefront
+      class PolicySerializer < BaseSerializer
+        set_type :policy
+
+        attributes :name, :slug, :created_at, :updated_at
+
+        attribute :body do |object|
+          object.body.to_plain_text
+        end
+
+        attribute :body_html do |object|
+          object.body.to_s
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/v2/storefront/post_category_serializer.rb

@@ -0,0 +1,23 @@
+module Spree
+  module V2
+    module Storefront
+      class PostCategorySerializer < ::Spree::Api::V2::BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
+        set_type :post_category
+
+        attributes :title, :slug, :created_at, :updated_at
+
+        attribute :description do |category|
+          category.description.to_plain_text if category.description.present?
+        end
+
+        has_many :posts, serializer: Spree::Api::Dependencies.storefront_post_serializer.constantize, record_type: :post, if: proc { |_record, params|
+          params[:include_posts] == true
+        } do |category|
+          category.posts.published.by_newest
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/v2/storefront/post_serializer.rb

@@ -0,0 +1,51 @@
+module Spree
+  module V2
+    module Storefront
+      class PostSerializer < ::Spree::Api::V2::BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
+        set_type :post
+
+        attributes :title, :slug, :published_at, :meta_title, :meta_description, :created_at, :updated_at
+
+        attribute :excerpt do |post|
+          post.excerpt.to_plain_text if post.excerpt.present?
+        end
+
+        attribute :content do |post|
+          post.content.to_plain_text if post.content.present?
+        end
+
+        attribute :content_html do |post|
+          post.content.to_s if post.content.present?
+        end
+
+        attribute :description do |post|
+          post.description
+        end
+
+        attribute :shortened_description do |post|
+          post.shortened_description
+        end
+
+        attribute :author_name do |post|
+          post.author_name
+        end
+
+        attribute :post_category_title do |post|
+          post.post_category_title
+        end
+
+        attribute :tags do |post|
+          post.tag_list
+        end
+
+        attribute :image_url do |post, params|
+          url_helpers.cdn_image_url(post.image.attachment) if post.image.present? && post.image.attached?
+        end
+
+        belongs_to :post_category, serializer: Spree::Api::Dependencies.storefront_post_category_serializer.constantize, record_type: :post_category
+      end
+    end
+  end
+end

data/app/serializers/spree/v2/storefront/product_serializer.rb

@@ -3,6 +3,7 @@ module Spree
     module Storefront
       class ProductSerializer < BaseSerializer
         include ::Spree::Api::V2::DisplayMoneyHelper
+        include Spree::Api::V2::PublicMetafieldsConcern
 
         set_type :product
 
@@ -51,11 +52,11 @@ module Spree
         attribute :tags, &:tag_list
         attribute :labels, &:label_list
 
-        has_many :variants
-        has_many :option_types
-        has_many :product_properties
+        has_many :variants, serializer: Spree::Api::Dependencies.storefront_variant_serializer.constantize
+        has_many :option_types, serializer: Spree::Api::Dependencies.storefront_option_type_serializer.constantize
+        has_many :product_properties, serializer: Spree::Api::Dependencies.storefront_product_property_serializer.constantize
 
-        has_many :taxons, serializer: :taxon, record_type: :taxon do |object, params|
+        has_many :taxons, serializer: Spree::Api::Dependencies.storefront_taxon_serializer.constantize, record_type: :taxon do |object, params|
           object.taxons_for_store(params[:store]).order(:id)
         end
 
@@ -64,19 +65,19 @@ module Spree
                  object_method_name: :variant_images,
                  id_method_name: :variant_image_ids,
                  record_type: :image,
-                 serializer: :image
+                 serializer: Spree::Api::Dependencies.storefront_image_serializer.constantize
 
         has_one :default_variant,
                 object_method_name: :default_variant,
                 id_method_name: :default_variant_id,
                 record_type: :variant,
-                serializer: :variant
+                serializer: Spree::Api::Dependencies.storefront_variant_serializer.constantize
 
         has_one :primary_variant,
                 object_method_name: :master,
                 id_method_name: :master_id,
                 record_type: :variant,
-                serializer: :variant
+                serializer: Spree::Api::Dependencies.storefront_variant_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/shipment_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class ShipmentSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :shipment
 
         attributes :number, :final_price, :display_final_price,
@@ -11,11 +13,11 @@ module Spree
           shipment.free?
         end
 
-        has_many :shipping_rates
-        has_one :selected_shipping_rate, serializer: :shipping_rate
+        has_many :shipping_rates, serializer: Spree::Api::Dependencies.storefront_shipping_rate_serializer.constantize
+        has_one :selected_shipping_rate, serializer: Spree::Api::Dependencies.storefront_shipping_rate_serializer.constantize
 
-        belongs_to :stock_location
-        has_many :line_items do |shipment|
+        belongs_to :stock_location, serializer: Spree::Api::Dependencies.storefront_stock_location_serializer.constantize
+        has_many :line_items, serializer: Spree::Api::Dependencies.storefront_line_item_serializer.constantize do |shipment|
           shipment.line_items
         end
       end

data/app/serializers/spree/v2/storefront/shipping_method_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class ShippingMethodSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type   :shipping_method
         attributes :name, :public_metadata
       end

data/app/serializers/spree/v2/storefront/shipping_rate_serializer.rb

@@ -11,7 +11,7 @@ module Spree
           shipping_rate.shipping_method_id.to_s
         end
 
-        belongs_to :shipping_method
+        belongs_to :shipping_method, serializer: Spree::Api::Dependencies.storefront_shipping_method_serializer.constantize
 
         attribute :free do |shipping_rate|
           shipping_rate.free?

data/app/serializers/spree/v2/storefront/store_credit_serializer.rb

@@ -2,13 +2,15 @@ module Spree
   module V2
     module Storefront
       class StoreCreditSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type :store_credit
 
-        belongs_to :category, serializer: :store_credit_category
-        has_many :store_credit_events
+        belongs_to :category, serializer: Spree::Api::Dependencies.storefront_store_credit_category_serializer.constantize
+        has_many :store_credit_events, serializer: Spree::Api::Dependencies.storefront_store_credit_event_serializer.constantize
         belongs_to :credit_type,
                    id_method_name: :type_id,
-                   serializer: :store_credit_type
+                   serializer: Spree::Api::Dependencies.storefront_store_credit_type_serializer.constantize
 
         attributes :amount, :amount_used, :created_at, :public_metadata
       end

data/app/serializers/spree/v2/storefront/store_serializer.rb

@@ -3,6 +3,7 @@ module Spree
     module Storefront
       class StoreSerializer < BaseSerializer
         include Spree::Api::V2::StoreMediaSerializerImagesConcern
+        include Spree::Api::V2::PublicMetafieldsConcern
 
         set_type :store
 
@@ -10,7 +11,7 @@ module Spree
                    :default, :supported_currencies, :facebook, :twitter, :instagram, :default_locale,
                    :customer_support_email, :description, :address, :contact_phone, :supported_locales
 
-        has_one :default_country, serializer: :country, record_type: :country, id_method_name: :default_country_id
+        has_one :default_country, serializer: Spree::Api::Dependencies.storefront_country_serializer.constantize, record_type: :country, id_method_name: :default_country_id
       end
     end
   end

data/app/serializers/spree/v2/storefront/taxon_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class TaxonSerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type   :taxon
 
         attributes :name, :pretty_name, :permalink, :seo_title, :meta_title, :meta_description,
@@ -35,18 +37,18 @@ module Spree
           taxon.localized_slugs_for_store(params[:store])
         end
 
-        belongs_to :parent,   record_type: :taxon, serializer: :taxon
-        belongs_to :taxonomy, record_type: :taxonomy
+        belongs_to :parent,   record_type: :taxon, serializer: Spree::Api::Dependencies.storefront_taxon_serializer.constantize
+        belongs_to :taxonomy, record_type: :taxonomy, serializer: Spree::Api::Dependencies.storefront_taxonomy_serializer.constantize
 
-        has_many   :children, record_type: :taxon, serializer: :taxon
-        has_many   :products, record_type: :product,
+        has_many   :children, record_type: :taxon, serializer: Spree::Api::Dependencies.storefront_taxon_serializer.constantize
+        has_many   :products, record_type: :product, serializer: Spree::Api::Dependencies.storefront_product_serializer.constantize,
                               if: proc { |_taxon, params| params && params[:include_products] == true }
 
         has_one    :image,
                    object_method_name: :icon,
                    id_method_name: :icon_id,
                    record_type: :taxon_image,
-                   serializer: :taxon_image
+                   serializer: Spree::Api::Dependencies.storefront_taxon_image_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/taxonomy_serializer.rb

@@ -2,6 +2,8 @@ module Spree
   module V2
     module Storefront
       class TaxonomySerializer < BaseSerializer
+        include Spree::Api::V2::PublicMetafieldsConcern
+
         set_type   :taxonomy
 
         attributes :name, :position, :public_metadata

data/app/serializers/spree/v2/storefront/user_serializer.rb

@@ -20,13 +20,13 @@ module Spree
                 id_method_name: :bill_address_id,
                 object_method_name: :bill_address,
                 record_type: :address,
-                serializer: :address
+                serializer: Spree::Api::Dependencies.storefront_address_serializer.constantize
 
         has_one :default_shipping_address,
                 id_method_name: :ship_address_id,
                 object_method_name: :ship_address,
                 record_type: :address,
-                serializer: :address
+                serializer: Spree::Api::Dependencies.storefront_address_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/variant_serializer.rb

@@ -3,6 +3,7 @@ module Spree
     module Storefront
       class VariantSerializer < BaseSerializer
         include ::Spree::Api::V2::DisplayMoneyHelper
+        include Spree::Api::V2::PublicMetafieldsConcern
 
         set_type :variant
 
@@ -40,9 +41,9 @@ module Spree
           display_compare_at_price(product, params[:currency])
         end
 
-        belongs_to :product
-        has_many :images
-        has_many :option_values
+        belongs_to :product, serializer: Spree::Api::Dependencies.storefront_product_serializer.constantize
+        has_many :images, serializer: Spree::Api::Dependencies.storefront_image_serializer.constantize
+        has_many :option_values, serializer: Spree::Api::Dependencies.storefront_option_value_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/wished_item_serializer.rb

@@ -22,7 +22,7 @@ module Spree
           wished_item.display_total(currency: params[:currency]).to_s
         end
 
-        belongs_to :variant
+        belongs_to :variant, serializer: Spree::Api::Dependencies.storefront_variant_serializer.constantize
       end
     end
   end

data/app/serializers/spree/v2/storefront/wishlist_serializer.rb

@@ -10,7 +10,7 @@ module Spree
           wishlist.include?(params[:is_variant_included])
         end
 
-        has_many :wished_items
+        has_many :wished_items, serializer: Spree::Api::Dependencies.storefront_wished_item_serializer.constantize
       end
     end
   end

data/app/services/spree/webhooks/subscribers/queue_requests.rb

@@ -15,7 +15,11 @@ module Spree
         private
 
         def filtered_subscribers(event_name, webhook_payload_body, record, options)
-          Spree::Webhooks::Subscriber.active.with_urls_for(event_name)
+          Spree::Current.webhooks_subscribers.map do |subscriber|
+            if subscriber.supports_event?(event_name)
+              subscriber
+            end
+          end.compact
         end
       end
     end

data/config/routes.rb

@@ -53,6 +53,7 @@ Spree::Core::Engine.add_routes do
 
         resources :menus, only: %i[index show]
         resources :cms_pages, only: %i[index show]
+        resources :policies, only: %i[index show]
 
         resources :wishlists do
           get :default, on: :collection
@@ -66,6 +67,9 @@ Spree::Core::Engine.add_routes do
           end
         end
 
+        resources :posts, only: %i[index show]
+        resources :post_categories, only: %i[index show]
+
         get '/digitals/:token', to: 'digitals#download', as: 'digital'
       end
 

data/lib/spree/api/dependencies.rb

@@ -65,14 +65,40 @@ module Spree
         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_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_post_category_serializer: 'Spree::V2::Storefront::PostCategorySerializer',
+        storefront_post_serializer: 'Spree::V2::Storefront::PostSerializer',
+        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',
+
+        # 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_products_sorter: -> { Spree::Dependencies.products_sorter },
         platform_products_sorter: -> { Spree::Dependencies.products_sorter },
+        storefront_posts_sorter: -> { Spree::Dependencies.posts_sorter },
 
         # paginators
         storefront_collection_paginator: -> { Spree::Dependencies.collection_paginator },
@@ -87,6 +113,7 @@ module Spree
         storefront_credit_card_finder: -> { Spree::Dependencies.credit_card_finder },
         storefront_find_by_variant_finder: -> { Spree::Dependencies.line_item_by_variant_finder },
         storefront_products_finder: -> { Spree::Dependencies.products_finder },
+        storefront_posts_finder: -> { Spree::Dependencies.posts_finder },
         storefront_taxon_finder: -> { Spree::Dependencies.taxon_finder },
         storefront_variant_finder: -> { Spree::Dependencies.variant_finder },
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spree_api
 version: !ruby/object:Gem::Version
-  version: 5.1.8
+  version: 5.2.0.rc1
 platform: ruby
 authors:
 - Ryan Bigg
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-30 00:00:00.000000000 Z
+date: 2025-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jsonapi-rspec
@@ -102,14 +102,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.1.8
+        version: 5.2.0.rc1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.1.8
+        version: 5.2.0.rc1
 description: Spree's API
 email:
 - hello@spreecommerce.org
@@ -181,6 +181,9 @@ files:
 - app/controllers/spree/api/v2/storefront/countries_controller.rb
 - app/controllers/spree/api/v2/storefront/digitals_controller.rb
 - app/controllers/spree/api/v2/storefront/order_status_controller.rb
+- app/controllers/spree/api/v2/storefront/policies_controller.rb
+- app/controllers/spree/api/v2/storefront/post_categories_controller.rb
+- app/controllers/spree/api/v2/storefront/posts_controller.rb
 - app/controllers/spree/api/v2/storefront/products_controller.rb
 - app/controllers/spree/api/v2/storefront/stores_controller.rb
 - app/controllers/spree/api/v2/storefront/taxons_controller.rb
@@ -210,6 +213,7 @@ files:
 - app/models/spree/webhooks/subscriber.rb
 - app/presenters/spree/api/products/filters_presenter.rb
 - app/serializers/concerns/spree/api/v2/image_transformation_concern.rb
+- app/serializers/concerns/spree/api/v2/public_metafields_concern.rb
 - app/serializers/concerns/spree/api/v2/resource_serializer_concern.rb
 - app/serializers/concerns/spree/api/v2/taxon_image_transformation_concern.rb
 - app/serializers/spree/api/v2/base_serializer.rb
@@ -231,6 +235,7 @@ files:
 - app/serializers/spree/api/v2/platform/inventory_unit_serializer.rb
 - app/serializers/spree/api/v2/platform/line_item_serializer.rb
 - app/serializers/spree/api/v2/platform/log_entry_serializer.rb
+- app/serializers/spree/api/v2/platform/metafield_serializer.rb
 - app/serializers/spree/api/v2/platform/option_type_serializer.rb
 - app/serializers/spree/api/v2/platform/option_value_serializer.rb
 - app/serializers/spree/api/v2/platform/order_promotion_serializer.rb
@@ -296,15 +301,19 @@ files:
 - app/serializers/spree/v2/storefront/gift_card_serializer.rb
 - app/serializers/spree/v2/storefront/image_serializer.rb
 - app/serializers/spree/v2/storefront/line_item_serializer.rb
+- app/serializers/spree/v2/storefront/metafield_serializer.rb
 - app/serializers/spree/v2/storefront/option_type_serializer.rb
 - app/serializers/spree/v2/storefront/option_value_serializer.rb
+- app/serializers/spree/v2/storefront/order_promotion_serializer.rb
 - app/serializers/spree/v2/storefront/order_serializer.rb
 - app/serializers/spree/v2/storefront/payment_method_serializer.rb
 - app/serializers/spree/v2/storefront/payment_serializer.rb
 - app/serializers/spree/v2/storefront/payment_source_serializer.rb
+- app/serializers/spree/v2/storefront/policy_serializer.rb
+- app/serializers/spree/v2/storefront/post_category_serializer.rb
+- app/serializers/spree/v2/storefront/post_serializer.rb
 - app/serializers/spree/v2/storefront/product_property_serializer.rb
 - app/serializers/spree/v2/storefront/product_serializer.rb
-- app/serializers/spree/v2/storefront/promotion_serializer.rb
 - app/serializers/spree/v2/storefront/shipment_serializer.rb
 - app/serializers/spree/v2/storefront/shipping_category_serializer.rb
 - app/serializers/spree/v2/storefront/shipping_method_serializer.rb
@@ -369,9 +378,9 @@ licenses:
 - BSD-3-Clause
 metadata:
   bug_tracker_uri: https://github.com/spree/spree/issues
-  changelog_uri: https://github.com/spree/spree/releases/tag/v5.1.8
+  changelog_uri: https://github.com/spree/spree/releases/tag/v5.2.0.rc1
   documentation_uri: https://docs.spreecommerce.org/
-  source_code_uri: https://github.com/spree/spree/tree/v5.1.8
+  source_code_uri: https://github.com/spree/spree/tree/v5.2.0.rc1
 post_install_message:
 rdoc_options: []
 require_paths: