spree_api 5.4.3 → 5.5.0.rc2

data/app/serializers/spree/api/v3/admin/product_publication_serializer.rb

@@ -0,0 +1,11 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class ProductPublicationSerializer < V3::ProductPublicationSerializer
+          attributes created_at: :iso8601, updated_at: :iso8601
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/product_serializer.rb

@@ -7,21 +7,33 @@ module Spree
         # Extends the store serializer with additional attributes
         class ProductSerializer < V3::ProductSerializer
 
-          # Additional type hints for admin-only computed attributes
-          typelize status: :string, make_active_at: [:string, nullable: true], discontinue_on: [:string, nullable: true],
-                   cost_price: [:string, nullable: true], cost_currency: [:string, nullable: true],
-                   deleted_at: [:string, nullable: true]
+          typelize status: :string,
+                   tax_category_id: [:string, nullable: true],
+                   price: ['Price', nullable: true],
+                   deleted_at: [:string, nullable: true],
+                   metadata: 'Record<string, unknown>'
 
-          # Admin-only attributes
-          attributes :status, :make_active_at, :discontinue_on, deleted_at: :iso8601,
+          attributes :status,
+                     :metadata, deleted_at: :iso8601,
                      created_at: :iso8601, updated_at: :iso8601
 
-          attribute :cost_price do |product|
-            product.master&.cost_price
+          attribute :tax_category_id do |product|
+            product.tax_category&.prefixed_id
           end
 
-          attribute :cost_currency do |product|
-            product.master&.cost_currency
+          attribute :price do |product|
+            price = price_for(product.default_variant)
+            Spree.api.admin_price_serializer.new(price, params: params).to_h if price&.persisted?
+          end
+
+          attribute :original_price do |product|
+            variant = product.default_variant
+            calculated = price_for(variant)
+            base = price_in(variant)
+
+            if calculated.present? && base.present? && calculated.id != base.id
+              Spree.api.admin_price_serializer.new(base, params: params).to_h
+            end
           end
 
           # Admin uses admin variant serializer
@@ -46,6 +58,10 @@ module Spree
                resource: Spree.api.admin_option_type_serializer,
                if: proc { expand?('option_types') }
 
+          many :option_values,
+               resource: Spree.api.admin_option_value_serializer,
+               if: proc { expand?('option_values') }
+
           many :taxons,
                proc { |taxons, params|
                  taxons.select { |t| t.taxonomy.store_id == params[:store].id }
@@ -58,6 +74,14 @@ module Spree
                key: :custom_fields,
                resource: Spree.api.admin_custom_field_serializer,
                if: proc { expand?('custom_fields') }
+
+          many :product_publications,
+               resource: Spree.api.admin_product_publication_serializer,
+               if: proc { expand?('product_publications') }
+
+          many :channels,
+               resource: Spree.api.admin_channel_serializer,
+               if: proc { expand?('channels') }
         end
       end
     end

data/app/serializers/spree/api/v3/admin/promotion_action_serializer.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Serializes Spree::PromotionAction (and its STI subclasses) for the
+        # admin promotion editor. The shape is intentionally generic so a
+        # single component can render any subclass — `preferences` is the
+        # current value hash, `preference_schema` describes its fields.
+        class PromotionActionSerializer < BaseSerializer
+          typelize type: :string,
+                   promotion_id: :string,
+                   preferences: 'Record<string, unknown>',
+                   preference_schema: "Array<{ key: string; type: string; default: unknown }>",
+                   label: :string,
+                   calculator: "{ type: string; label: string; preferences: Record<string, unknown>; preference_schema: Array<{ key: string; type: string; default: unknown }> } | null",
+                   line_items: 'Array<{ variant_id: string; quantity: number }> | null'
+
+          attributes created_at: :iso8601, updated_at: :iso8601
+
+          attribute :type do |action|
+            action.class.api_type
+          end
+
+          attribute :promotion_id do |action|
+            action.promotion&.prefixed_id
+          end
+
+          attribute :preferences, &:serialized_preferences
+          attribute :preference_schema, &:serialized_preference_schema
+
+          attribute :label do |action|
+            action.respond_to?(:human_name) ? action.human_name : action.type.to_s.demodulize
+          end
+
+          # Calculator is exposed as a nested object so the SPA can render
+          # the calculator picker + its own preference fields. Null for
+          # actions that don't include CalculatedAdjustments. The SPA
+          # formats the row summary itself off `label` + `preferences` —
+          # see the action-summary helper in the admin promotion editor.
+          attribute :calculator do |action|
+            next nil unless action.respond_to?(:calculator) && action.calculator
+
+            calc = action.calculator
+            {
+              type: calc.class.api_type,
+              label: calc.class.respond_to?(:description) ? calc.class.description : calc.class.to_s.demodulize.titleize,
+              preferences: calc.serialized_preferences,
+              preference_schema: calc.serialized_preference_schema
+            }
+          end
+
+          # Line items the action will add for CreateLineItems. variant_id
+          # is prefixed for consistency with the rest of the API. Null on
+          # actions that don't have the association.
+          attribute :line_items do |action|
+            next nil unless action.respond_to?(:promotion_action_line_items)
+
+            action.promotion_action_line_items.map do |item|
+              {
+                variant_id: item.variant&.prefixed_id,
+                quantity: item.quantity
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/promotion_rule_serializer.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Serializes Spree::PromotionRule (and its STI subclasses) for the
+        # admin promotion editor. Same shape as PromotionAction so the
+        # frontend renders both with the same generic component.
+        class PromotionRuleSerializer < BaseSerializer
+          typelize type: :string,
+                   promotion_id: :string,
+                   preferences: 'Record<string, unknown>',
+                   preference_schema: "Array<{ key: string; type: string; default: unknown }>",
+                   label: :string,
+                   product_ids: 'Array<string> | null',
+                   category_ids: 'Array<string> | null',
+                   customer_ids: 'Array<string> | null'
+
+          attributes created_at: :iso8601, updated_at: :iso8601
+
+          attribute :type do |rule|
+            rule.class.api_type
+          end
+
+          attribute :promotion_id do |rule|
+            rule.promotion&.prefixed_id
+          end
+
+          attribute :preferences, &:serialized_preferences
+          attribute :preference_schema, &:serialized_preference_schema
+
+          attribute :label do |rule|
+            rule.respond_to?(:human_name) ? rule.human_name : rule.class.to_s.demodulize
+          end
+
+          # Association IDs for rules that wire products/taxons/users through
+          # join tables. Returned as prefixed IDs to match the rest of the
+          # API; null on rules that don't have the association. The matching
+          # `products`/`categories`/`customers` collections below embed the
+          # full records via their admin serializers so the SPA can render
+          # names + extra info without an extra round-trip.
+          attribute :product_ids do |rule|
+            rule.products.map(&:prefixed_id) if rule.respond_to?(:products)
+          end
+
+          attribute :category_ids do |rule|
+            rule.taxons.map(&:prefixed_id) if rule.respond_to?(:taxons)
+          end
+
+          attribute :customer_ids do |rule|
+            rule.users.map(&:prefixed_id) if rule.respond_to?(:users)
+          end
+
+          # Embed the related records so promotion-row summaries can render
+          # names + extra info without a separate fetch. Rules that don't
+          # carry a given collection (e.g. an ItemTotal rule has no
+          # products) skip via `if:` and the key is omitted from the
+          # payload.
+          many :products,
+               resource: Spree.api.admin_product_serializer,
+               if: proc { |rule| rule.respond_to?(:products) }
+
+          many :taxons,
+               key: :categories,
+               resource: Spree.api.admin_category_serializer,
+               if: proc { |rule| rule.respond_to?(:taxons) }
+
+          many :users,
+               key: :customers,
+               resource: Spree.api.admin_customer_serializer,
+               if: proc { |rule| rule.respond_to?(:users) }
+
+          many :customer_groups,
+               resource: Spree.api.admin_customer_group_serializer,
+               if: proc { |rule| rule.respond_to?(:customer_groups) }
+
+          many :countries,
+               resource: Spree.api.admin_country_serializer,
+               if: proc { |rule| rule.respond_to?(:countries) }
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/promotion_serializer.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Admin Promotion serializer — adds operational fields the Store API
+        # never exposes (multi-codes counts, usage stats, internal promotion
+        # category, store assignments, timestamps).
+        class PromotionSerializer < V3::PromotionSerializer
+          typelize starts_at: [:string, nullable: true],
+                   expires_at: [:string, nullable: true],
+                   usage_limit: [:number, nullable: true],
+                   match_policy: "'all' | 'any'",
+                   path: [:string, nullable: true],
+                   kind: "'coupon_code' | 'automatic'",
+                   multi_codes: :boolean,
+                   number_of_codes: [:number, nullable: true],
+                   code_prefix: [:string, nullable: true],
+                   promotion_category_id: [:string, nullable: true],
+                   metadata: 'Record<string, unknown>',
+                   action_ids: 'string[]',
+                   rule_ids: 'string[]'
+
+          attributes :starts_at, :expires_at, :usage_limit, :match_policy,
+                     :path, :kind, :multi_codes, :number_of_codes, :code_prefix,
+                     :promotion_category_id, :metadata,
+                     created_at: :iso8601, updated_at: :iso8601
+
+          attribute :action_ids do |promotion|
+            promotion.promotion_actions.map(&:prefixed_id)
+          end
+
+          attribute :rule_ids do |promotion|
+            promotion.promotion_rules.map(&:prefixed_id)
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/refund_serializer.rb

@@ -5,9 +5,11 @@ module Spree
         class RefundSerializer < V3::RefundSerializer
           typelize payment_id: [:string, nullable: true],
                    refund_reason_id: [:string, nullable: true],
-                   reimbursement_id: [:string, nullable: true]
+                   reimbursement_id: [:string, nullable: true],
+                   metadata: 'Record<string, unknown>'
 
-          attributes created_at: :iso8601, updated_at: :iso8601
+          attributes :metadata,
+                     created_at: :iso8601, updated_at: :iso8601
 
           one :payment,
               resource: Spree.api.admin_payment_serializer,

data/app/serializers/spree/api/v3/admin/role_serializer.rb

@@ -0,0 +1,17 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Admin API serializer for {Spree::Role}. Read-only — used to populate
+        # the role picker on the staff invite/edit forms. Spree core ships
+        # with a single `admin` role today; richer role/permission management
+        # is on the roadmap.
+        class RoleSerializer < V3::BaseSerializer
+          typelize name: :string
+
+          attributes :name, created_at: :iso8601, updated_at: :iso8601
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/stock_item_serializer.rb

@@ -3,7 +3,22 @@ module Spree
     module V3
       module Admin
         class StockItemSerializer < V3::StockItemSerializer
-          attributes created_at: :iso8601, updated_at: :iso8601
+          typelize metadata: 'Record<string, unknown>',
+                   allocated_count: :number, available_count: :number
+
+          attributes :metadata,
+                     created_at: :iso8601, updated_at: :iso8601
+
+          # Units already allocated to pending shipments. Always 0 in 5.5;
+          # 6.0 Typed Stock Movements wires it up.
+          attribute :allocated_count do |stock_item|
+            stock_item.allocated_count.to_i
+          end
+
+          # Physical stock minus allocated units (per stock_item).
+          attribute :available_count do |stock_item|
+            stock_item.available_count.to_i
+          end
 
           one :stock_location,
               resource: Spree.api.admin_stock_location_serializer,

data/app/serializers/spree/api/v3/admin/stock_location_serializer.rb

@@ -4,9 +4,18 @@ module Spree
       module Admin
         class StockLocationSerializer < V3::StockLocationSerializer
           typelize active: :boolean, default: :boolean, backorderable_default: :boolean,
-                   propagate_all_variants: :boolean
+                   propagate_all_variants: :boolean, pickup_enabled: :boolean,
+                   admin_name: [:string, nullable: true],
+                   address2: [:string, nullable: true], state_name: [:string, nullable: true],
+                   phone: [:string, nullable: true], company: [:string, nullable: true],
+                   kind: :string, pickup_stock_policy: :string,
+                   pickup_ready_in_minutes: [:number, nullable: true],
+                   pickup_instructions: [:string, nullable: true]
 
-          attributes :active, :default, :backorderable_default, :propagate_all_variants,
+          attributes :admin_name, :address2, :state_name, :phone, :company,
+                     :active, :default, :backorderable_default, :propagate_all_variants,
+                     :kind, :pickup_enabled, :pickup_stock_policy,
+                     :pickup_ready_in_minutes, :pickup_instructions,
                      created_at: :iso8601, updated_at: :iso8601
         end
       end

data/app/serializers/spree/api/v3/admin/stock_reservation_serializer.rb

@@ -0,0 +1,46 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class StockReservationSerializer < V3::StockReservationSerializer
+          typelize stock_item_id: :string,
+                   line_item_id: :string,
+                   order_id: :string,
+                   variant_id: [:string, nullable: true],
+                   stock_location_id: [:string, nullable: true],
+                   quantity: :number,
+                   expires_at: :string,
+                   active: :boolean
+
+          attribute :stock_item_id do |reservation|
+            reservation.stock_item.prefixed_id
+          end
+
+          attribute :line_item_id do |reservation|
+            reservation.line_item.prefixed_id
+          end
+
+          attribute :order_id do |reservation|
+            reservation.order.prefixed_id
+          end
+
+          attribute :variant_id do |reservation|
+            reservation.stock_item&.variant&.prefixed_id
+          end
+
+          attribute :stock_location_id do |reservation|
+            reservation.stock_item&.stock_location&.prefixed_id
+          end
+
+          attributes :quantity, expires_at: :iso8601
+
+          attribute :active do |reservation|
+            reservation.active?
+          end
+
+          attributes created_at: :iso8601, updated_at: :iso8601
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/stock_transfer_serializer.rb

@@ -0,0 +1,37 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Inventory movement between two stock locations (or external →
+        # location for receives). The originating location is `nil` for
+        # receives (vendor stock arriving) and present for transfers.
+        class StockTransferSerializer < V3::BaseSerializer
+          typelize number: :string,
+                   reference: [:string, nullable: true],
+                   source_location_id: [:string, nullable: true],
+                   destination_location_id: [:string, nullable: true],
+                   metadata: 'Record<string, unknown>'
+
+          attributes :number, :reference, :metadata,
+                     created_at: :iso8601, updated_at: :iso8601
+
+          attribute :source_location_id do |stock_transfer|
+            stock_transfer.source_location&.prefixed_id
+          end
+
+          attribute :destination_location_id do |stock_transfer|
+            stock_transfer.destination_location&.prefixed_id
+          end
+
+          one :source_location,
+              resource: Spree.api.admin_stock_location_serializer,
+              if: proc { expand?('source_location') }
+
+          one :destination_location,
+              resource: Spree.api.admin_stock_location_serializer,
+              if: proc { expand?('destination_location') }
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/store_credit_category_serializer.rb

@@ -0,0 +1,19 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class StoreCreditCategorySerializer < V3::BaseSerializer
+          typelize name: :string,
+                   non_expiring: :boolean
+
+          attributes :name,
+                     created_at: :iso8601, updated_at: :iso8601
+
+          attribute :non_expiring do |store_credit_category|
+            store_credit_category.non_expiring?
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/store_credit_serializer.rb

@@ -5,9 +5,13 @@ module Spree
         class StoreCreditSerializer < V3::StoreCreditSerializer
           typelize customer_id: [:string, nullable: true],
                    created_by_id: [:string, nullable: true],
-                   metadata: 'Record<string, unknown> | null'
+                   category_id: [:string, nullable: true],
+                   category_name: [:string, nullable: true],
+                   memo: [:string, nullable: true],
+                   metadata: 'Record<string, unknown>'
 
-          attributes created_at: :iso8601, updated_at: :iso8601
+          attributes :memo, :metadata,
+                     created_at: :iso8601, updated_at: :iso8601
 
           attribute :customer_id do |store_credit|
             store_credit.user&.prefixed_id
@@ -17,11 +21,13 @@ module Spree
             store_credit.created_by&.prefixed_id
           end
 
-          attribute :metadata do |store_credit|
-            store_credit.metadata.presence
+          attribute :category_id do |store_credit|
+            store_credit.category&.prefixed_id
           end
 
-          attributes created_at: :iso8601, updated_at: :iso8601
+          attribute :category_name do |store_credit|
+            store_credit.category_name
+          end
         end
       end
     end

data/app/serializers/spree/api/v3/admin/store_serializer.rb

@@ -0,0 +1,55 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class StoreSerializer < V3::BaseSerializer
+          typelize name: :string, url: :string,
+                   default_currency: :string, default_locale: :string,
+                   supported_currencies: [:string, multi: true],
+                   supported_locales: [:string, multi: true],
+                   logo_url: [:string, nullable: true],
+                   mailer_logo_url: [:string, nullable: true],
+                   mail_from_address: [:string, nullable: true],
+                   customer_support_email: [:string, nullable: true],
+                   new_order_notifications_email: [:string, nullable: true],
+                   preferred_send_consumer_transactional_emails: :boolean,
+                   preferred_admin_locale: [:string, nullable: true],
+                   preferred_timezone: :string,
+                   preferred_weight_unit: :string,
+                   preferred_unit_system: :string,
+                   metadata: 'Record<string, unknown>'
+
+          attributes :metadata,
+                     :name,
+                     :default_currency,
+                     :default_locale,
+                     :mail_from_address,
+                     :customer_support_email,
+                     :new_order_notifications_email,
+                     :preferred_send_consumer_transactional_emails,
+                     :preferred_admin_locale,
+                     :preferred_timezone,
+                     :preferred_weight_unit,
+                     :preferred_unit_system,
+                     created_at: :iso8601, updated_at: :iso8601
+
+          attribute :url, &:storefront_url
+
+          attribute :supported_currencies do |store|
+            store.supported_currencies_list.map(&:iso_code)
+          end
+
+          attribute :supported_locales, &:supported_locales_list
+
+          attribute :logo_url do |store|
+            image_url_for(store.logo)
+          end
+
+          attribute :mailer_logo_url do |store|
+            image_url_for(store.mailer_logo)
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/admin/tax_category_serializer.rb

@@ -3,10 +3,12 @@ module Spree
     module V3
       module Admin
         class TaxCategorySerializer < V3::BaseSerializer
-          typelize name: :string, tax_code: [:string, nullable: true],
+          typelize name: :string,
+                   tax_code: [:string, nullable: true],
+                   description: [:string, nullable: true],
                    is_default: :boolean
 
-          attributes :name, :tax_code, :is_default,
+          attributes :name, :tax_code, :description, :is_default,
                      created_at: :iso8601, updated_at: :iso8601
         end
       end

data/app/serializers/spree/api/v3/admin/variant_serializer.rb

@@ -6,16 +6,43 @@ module Spree
         # Full variant data including admin-only fields
         class VariantSerializer < V3::VariantSerializer
 
-          # Additional type hints for admin-only attributes
-          typelize position: :number, tax_category_id: [:string, nullable: true],
+          typelize product_name: :string,
+                   position: :number, tax_category_id: [:string, nullable: true],
                    cost_price: [:string, nullable: true], cost_currency: [:string, nullable: true],
-                   total_on_hand: [:number, nullable: true],
-                   deleted_at: [:string, nullable: true]
+                   barcode: [:string, nullable: true],
+                   weight_unit: [:string, nullable: true], dimensions_unit: [:string, nullable: true],
+                   available_stock: [:number, nullable: true],
+                   reserved_quantity: :number, total_on_hand: [:number, nullable: true],
+                   deleted_at: [:string, nullable: true],
+                   metadata: 'Record<string, unknown>'
 
-          # Admin-only attributes
-          attributes :position, :total_on_hand, :tax_category_id, :cost_price, :cost_currency, deleted_at: :iso8601,
+          attributes :metadata, :position, :cost_price, :cost_currency,
+                     :barcode, :weight_unit, :dimensions_unit, deleted_at: :iso8601,
                      created_at: :iso8601, updated_at: :iso8601
 
+          attribute :tax_category_id do |variant|
+            variant.tax_category&.prefixed_id
+          end
+
+          # Physical pool minus already-allocated units. In 5.5 allocated_count
+          # is always 0, so this equals SUM(stock_items.count_on_hand).
+          attribute :available_stock do |variant|
+            variant.available_stock.to_i if variant.should_track_inventory?
+          end
+
+          attribute :reserved_quantity do |variant|
+            variant.reserved_quantity.to_i
+          end
+
+          # Purchasable now: available_stock minus active reservations.
+          attribute :total_on_hand do |variant|
+            variant.total_on_hand.to_i if variant.should_track_inventory?
+          end
+
+          attribute :product_name do |variant|
+            variant.product&.name
+          end
+
           # Override inherited associations to use admin serializers
           one :primary_media,
               resource: Spree.api.admin_media_serializer,
@@ -37,6 +64,10 @@ module Spree
                key: :custom_fields,
                resource: Spree.api.admin_custom_field_serializer,
                if: proc { expand?('custom_fields') }
+
+          many :stock_items,
+               resource: Spree.api.admin_stock_item_serializer,
+               if: proc { expand?('stock_items') }
         end
       end
     end