spree_api 6.0.0.rc3 → 6.0.0.rc5

data/app/serializers/spree/api/v3/address_owner_serializer.rb

@@ -0,0 +1,27 @@
+module Spree
+  module Api
+    module V3
+      # Which address book an entry came out of. A checkout offering the
+      # buyer's own addresses beside their company's sites has to label the
+      # two, and the owner is the only thing that tells a warehouse from
+      # somebody's flat.
+      class AddressOwnerSerializer < BaseSerializer
+        typelize type: [:string, enum: %w[customer company seller], enum_type_name: 'AddressOwnerType'],
+                 name: [:string, nullable: true]
+
+        attribute :type do |owner|
+          Spree::Base.polymorphic_api_type(owner.class.to_s)
+        end
+
+        # What to call the book. A company node answers with its own name, so
+        # a division's own sites and the headquarters sites it inherits are
+        # told apart rather than filed under one heading. A customer's book is
+        # the caller's own and needs no name — "your addresses" is the client's
+        # word for it, in the shopper's language.
+        attribute :name do |owner|
+          owner.name if owner.is_a?(Spree::Company)
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/address_serializer.rb

@@ -12,7 +12,7 @@ module Spree
                  country_iso: [:string, deprecated: 'Use `country_code`. Removed in 6.1.'],
                  country_name: :string,
                  quick_checkout: :boolean, is_default_billing: :boolean, is_default_shipping: :boolean,
-                 label: [:string, nullable: true]
+                 label: [:string, nullable: true], owner: { nullable: true }
 
         # What the address is filed under in whichever book owns it — a
         # customer's ("Home") or a company node's ("Northern Warehouse").
@@ -31,6 +31,10 @@ module Spree
         attribute :state_name do |address|
           address.state_name.presence || address.state&.name
         end
+
+        # The address book the entry belongs to. Null for an address in no
+        # book: one a guest typed in, or the copy a placed order keeps.
+        one :owner, resource: proc { Spree.api.address_owner_serializer }
       end
     end
   end

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

@@ -0,0 +1,10 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class AddressOwnerSerializer < V3::AddressOwnerSerializer
+        end
+      end
+    end
+  end
+end

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

@@ -7,8 +7,6 @@ module Spree
           %i[state_abbr country_iso].each { |key| _attributes.delete(key) }
 
           typelize customer_id: [:string, nullable: true],
-                   owner_id: [:string, nullable: true],
-                   owner_type: [:string, nullable: true],
                    latitude: [:number, nullable: true],
                    longitude: [:number, nullable: true],
                    metadata: 'Record<string, unknown>'
@@ -29,14 +27,7 @@ module Spree
 
           prefixed_id_attributes customer_id: :customer_owner
 
-          # Who the row belongs to — a customer's book, a company node's, or a
-          # seller's billing address. `customer_id` above stays as the
-          # customer-only shorthand the customers surface reads.
-          prefixed_id_attributes :owner
-
-          attribute :owner_type do |address|
-            Spree::Base.polymorphic_api_type(address.owner_type)
-          end
+          one :owner, resource: proc { Spree.api.admin_address_owner_serializer }
         end
       end
     end

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

@@ -12,7 +12,7 @@ module Spree
         # via {#plaintext_token} below — it is `nil` everywhere else.
         class ApiKeySerializer < V3::BaseSerializer
           typelize name: :string,
-                   key_type: [:string, enum: Spree::ApiKey::KEY_TYPES],
+                   key_type: [:string, enum: Spree::ApiKey::KEY_TYPES, enum_type_name: 'ApiKeyType'],
                    token_prefix: [:string, nullable: true],
                    plaintext_token: [:string, nullable: true],
                    scopes: [:string, multi: true],

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

@@ -3,7 +3,7 @@ module Spree
     module V3
       module Admin
         class CatalogAssignmentSerializer < V3::BaseSerializer
-          typelize catalog_id: :string, assignable_type: :string, assignable_id: :string,
+          typelize catalog_id: :string, assignable_type: [:string, enum: Spree::CatalogAssignment::ASSIGNABLE_TYPES.map { |type| Spree::Base.polymorphic_api_type(type) }, enum_type_name: 'CatalogAssignableType'], assignable_id: :string,
                    assignable_name: [:string, nullable: true]
 
           attributes created_at: :iso8601

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

@@ -17,7 +17,7 @@ module Spree
           _attributes.delete(:id)
 
           typelize id: 'string | null', label: 'string | null', sku: 'string | null',
-                   currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode'], source: [:string, enum: Spree::CatalogPrice::SOURCES], break_count: :number
+                   currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode'], source: [:string, enum: Spree::CatalogPrice::SOURCES, enum_type_name: 'CatalogPriceSource'], break_count: :number
 
           # The variant this prices, so a row can name what it is showing —
           # a product's variants can be priced differently, and one figure

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

@@ -8,7 +8,7 @@ module Spree
         # wire shorthand (e.g. "tag"), matching every other typed-rule
         # serializer and what the writer accepts.
         class CollectionRuleSerializer < BaseSerializer
-          typelize type: [:string, comment: 'Rule type. Built-in: tag, available_on, sale. Extensions may register more.'], value: [:string, nullable: true], match_policy: [:string, enum: Spree::CollectionRule::MATCH_POLICIES]
+          typelize type: [:string, comment: 'Rule type. Built-in: tag, available_on, sale. Extensions may register more.'], value: [:string, nullable: true], match_policy: [:string, enum: Spree::CollectionRule::MATCH_POLICIES, enum_type_name: 'CollectionRuleMatchPolicy']
 
           attributes :value, :match_policy
 

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

@@ -8,7 +8,7 @@ module Spree
         class CollectionSerializer < V3::CollectionSerializer
           include Spree::Api::V3::Admin::Translatable
 
-          typelize automatic: :boolean, rules_match_policy: [:string, enum: Spree::Collection::RULES_MATCH_POLICIES],
+          typelize automatic: :boolean, rules_match_policy: [:string, enum: Spree::Collection::RULES_MATCH_POLICIES, enum_type_name: 'MatchPolicy'],
                    metadata: 'Record<string, unknown>'
 
           attributes :automatic, :rules_match_policy, :metadata,

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

@@ -19,8 +19,8 @@ module Spree
                    line_item_id: 'string | null',
                    fulfillment_id: 'string | null',
                    commission_rate_id: 'string | null',
-                   kind: [:string, enum: Spree::CommissionRate::KINDS],
-                   taxability_reason: 'string | null',
+                   kind: [:string, enum: Spree::CommissionRate::KINDS, enum_type_name: 'CommissionKind'],
+                   taxability_reason: [:string, nullable: true, enum: Spree::TaxLine::BUILT_IN_TAXABILITY_REASONS, enum_type_name: 'TaxabilityReason'],
                    country_code: [:string, nullable: true, enum: Spree::IsoData.country_codes, enum_type_name: 'CountryCode'],
                    state_code: 'string | null',
                    currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode']

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

@@ -15,7 +15,7 @@ module Spree
                    enabled: :boolean,
                    position: :number,
                    global: :boolean,
-                   kind: [:string, enum: Spree::CommissionRate::KINDS],
+                   kind: [:string, enum: Spree::CommissionRate::KINDS, enum_type_name: 'CommissionKind'],
                    amounts: 'Record<string, string>',
                    bounds: 'Record<string, { min_amount: string | null; max_amount: string | null }>',
                    tax_inclusive: :boolean,

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

@@ -5,7 +5,7 @@ module Spree
         # Admin API Consent Record Serializer
         # The evidence trail behind a customer's consent state.
         class ConsentRecordSerializer < BaseSerializer
-          typelize purpose: :string, source: [:string, enum: Spree::ConsentRecord::SOURCES], accepted: :boolean,
+          typelize purpose: :string, source: [:string, enum: Spree::ConsentRecord::SOURCES, enum_type_name: 'ConsentSource'], accepted: :boolean,
                    email: [:string, nullable: true],
                    ip_address: [:string, nullable: true],
                    recorded_at: [:string, nullable: true],

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

@@ -7,7 +7,7 @@ module Spree
         # default, and the draft in progress.
         class EmailTemplateSerializer < V3::BaseSerializer
           typelize key: :string,
-                   kind: [:string, enum: Spree::Emails::EditableTemplates::KINDS.map(&:to_s)],
+                   kind: [:string, enum: Spree::Emails::EditableTemplates::KINDS.map(&:to_s), enum_type_name: 'EmailTemplateKind'],
                    language: :string,
                    customized: :boolean,
                    customized_languages: [:string, multi: true],

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

@@ -3,6 +3,8 @@ module Spree
     module V3
       module Admin
         class FulfillmentSerializer < V3::FulfillmentSerializer
+          include Concerns::ExternalReferencesAttribute
+
           without_formatted_money
 
           # The Admin API has no guest gating — money fields inherited from the

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

@@ -5,6 +5,8 @@ module Spree
         # Admin API Line Item Serializer
         # Extends the store serializer with metadata visibility
         class LineItemSerializer < V3::LineItemSerializer
+          include Concerns::ExternalReferencesAttribute
+
           without_formatted_money
 
           # The Admin API has no guest gating — money fields inherited from the

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

@@ -0,0 +1,62 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # One person's live access through a connected client.
+        #
+        # The token itself is never serialized: it is a bearer credential, and
+        # the screen that lists connections only needs to say whose access it
+        # is and what that person approved.
+        class OauthAccessTokenSerializer < V3::BaseSerializer
+          typelize owner_id: [:string, nullable: true],
+                   owner_type: [:string, nullable: true],
+                   scopes: [:string, multi: true],
+                   expired: :boolean
+
+          attributes created_at: :iso8601
+
+          # Who connected, without expanding: the id and the kind, so a
+          # client can render a reference or follow it.
+          attribute :owner_id do |token|
+            token.resource_owner.try(:prefixed_id)
+          end
+
+          attribute :owner_type do |token|
+            Spree::Base.polymorphic_api_type(token.resource_owner_type)
+          end
+
+          # Who connected, as the record itself rather than a summary of it,
+          # so the dashboard shows a person the way it does everywhere else:
+          # a name over an email, with an avatar.
+          #
+          # The serializer follows the record's kind, because a grant's owner
+          # is polymorphic — an admin today, a customer when a storefront
+          # client needs one. Alba hands the proc the object for exactly this.
+          one :resource_owner,
+              key: :owner,
+              resource: proc { |owner| owner_serializer_for(owner) },
+              if: proc { expand?('owner') }
+
+          # @param owner [Object] the grant's resource owner
+          # @return [Class] the serializer for that kind of owner
+          def self.owner_serializer_for(owner)
+            case Spree::Base.polymorphic_api_type(owner.class.name)
+            when 'customer' then Spree.api.admin_customer_serializer
+            else Spree.api.admin_admin_user_serializer
+            end.to_s.constantize
+          end
+
+          # What this person approved, as permission keys.
+          attribute :scopes do |token|
+            token.scopes.to_a
+          end
+
+          # Whether the current access token has lapsed. The connection is
+          # still live — a refresh mints another — but a merchant reading the
+          # list deserves to know which agents hold access right now.
+          attribute :expired, &:expired?
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Admin API serializer for {Spree::OauthApplication}.
+        #
+        # Exposes `client_id` but never `secret`. The id is public by
+        # design — it is what a merchant pastes into a connector — while the
+        # secret is null here anyway, because every MCP client is a public
+        # client that proves itself with PKCE instead.
+        #
+        # `scopes` and `last_authorized_at` come from the live tokens rather than
+        # the registration — a client is registered once and granted per
+        # consent, so what the merchant approved lives on the token.
+        class OauthApplicationSerializer < V3::BaseSerializer
+          typelize name: :string,
+                   client_id: :string,
+                   connected: :boolean,
+                   scopes: [:string, multi: true],
+                   last_authorized_at: [:string, nullable: true],
+                   authorized_at: [:string, nullable: true],
+                   authorized_by: [:string, nullable: true],
+                   redirect_uri: [:string, nullable: true]
+
+          attributes :name, :redirect_uri, created_at: :iso8601, updated_at: :iso8601
+
+          attribute :client_id, &:uid
+
+          # A registration nobody has connected and one whose access was
+          # revoked both carry no scopes, so the list alone cannot tell them
+          # apart — and a merchant pressing Revoke has to see that it worked.
+          attribute :connected, &:connected?
+
+          attribute :scopes do |application|
+            application.live_token_scopes
+          end
+
+          attribute :last_authorized_at do |application|
+            application.last_authorized_at&.iso8601
+          end
+
+          attribute :authorized_at do |application|
+            application.authorized_at&.iso8601
+          end
+
+          # Who allowed this, in the words a person is known by. On the screen
+          # that decides whether to revoke, the permission alone is half the
+          # story.
+          attribute :authorized_by do |application|
+            application.authorized_by.try(:actor_label)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Admin API serializer for {Spree::OauthConsentRequest}.
+        #
+        # Alba directly rather than through {BaseSerializer}: a consent
+        # request is a computed view with no id to expose, and inheriting one
+        # would put a null `id` in every response.
+        class OauthConsentRequestSerializer
+          include Alba::Resource
+          include Typelizer::DSL
+
+          typelize client_name: :string,
+                   scopes: [:string, multi: true],
+                   grantable_scopes: [:string, multi: true],
+                   resource: [:string, nullable: true],
+                   redirect_uri: :string
+
+          attributes :client_name, :scopes, :grantable_scopes, :resource, :redirect_uri
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Serializer for {Spree::OauthProtectedResource}, the RFC 9728
+        # document a client reads to find the authorization server.
+        #
+        # Alba directly rather than through {BaseSerializer}: the document is
+        # a computed view with no id, and inheriting one would put a null
+        # `id` in a document the spec defines exactly.
+        class OauthProtectedResourceSerializer
+          include Alba::Resource
+          include Typelizer::DSL
+
+          typelize resource: :string,
+                   authorization_servers: [:string, multi: true],
+                   scopes_supported: [:string, multi: true],
+                   bearer_methods_supported: [:string, multi: true],
+                   resource_documentation: :string
+
+          attributes :resource, :authorization_servers, :scopes_supported,
+                     :bearer_methods_supported, :resource_documentation
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Admin API serializer for {Spree::OauthRedirect}.
+        class OauthRedirectSerializer
+          include Alba::Resource
+          include Typelizer::DSL
+
+          typelize redirect_uri: :string
+
+          attributes :redirect_uri
+        end
+      end
+    end
+  end
+end

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

@@ -31,7 +31,7 @@ module Spree
                    total: [:string, nullable: false],
                    amount_due: [:string, nullable: false]
 
-          typelize status: [:string, enum: Spree::Order::STATUSES],
+          typelize status: [:string, enum: Spree::Order::STATUSES, enum_type_name: 'OrderStatus'],
                    last_ip_address: [:string, nullable: true],
                    considered_risky: :boolean, confirmation_delivered: :boolean,
                    store_owner_notification_delivered: [:boolean, nullable: true],

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

@@ -7,14 +7,14 @@ module Spree
         # only — a shopper never picks their packaging.
         class PackageTypeSerializer < V3::BaseSerializer
           typelize name: :string,
-                   kind: [:string, enum: Spree::PackageType::KINDS],
+                   kind: [:string, enum: Spree::PackageType::KINDS, enum_type_name: 'PackageTypeKind'],
                    length: [:string, nullable: true],
                    width: [:string, nullable: true],
                    height: [:string, nullable: true],
-                   dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS],
+                   dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS, enum_type_name: 'DimensionUnit'],
                    weight: [:string, nullable: true],
                    max_weight: [:string, nullable: true],
-                   weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS],
+                   weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS, enum_type_name: 'WeightUnit'],
                    volume: [:string, nullable: true],
                    default: :boolean,
                    seller_id: [:string, nullable: true],

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

@@ -0,0 +1,16 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # Serializes Spree::PaymentCaptureEvent — one capture of money a
+        # payment had authorized. A payment captured in parts has one per part.
+        class PaymentCaptureEventSerializer < V3::BaseSerializer
+          attributes created_at: :iso8601, updated_at: :iso8601
+
+          money_attributes :amount
+          typelize amount: [:string, nullable: false]
+        end
+      end
+    end
+  end
+end

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

@@ -13,11 +13,18 @@ module Spree
                    order_id: [:string, nullable: true],
                    avs_response: [:string, nullable: true],
                    cvv_response_code: [:string, nullable: true],
-                   cvv_response_message: [:string, nullable: true]
+                   cvv_response_message: [:string, nullable: true],
+                   gateway_dashboard_payment_url: [:string, nullable: true],
+                   avs_risky: [:boolean, comment: 'Whether the card issuer reported that the billing address did not match.'],
+                   cvv_risky: [:boolean, comment: 'Whether the card issuer reported that the security code did not match.']
 
           attributes :metadata, :avs_response, :cvv_response_code, :cvv_response_message,
+                     :gateway_dashboard_payment_url,
                      created_at: :iso8601, updated_at: :iso8601
 
+          attribute(:avs_risky, &:is_avs_risky?)
+          attribute(:cvv_risky, &:is_cvv_risky?)
+
           money_attributes :captured_amount
           typelize captured_amount: [:string, nullable: false]
 
@@ -41,6 +48,10 @@ module Spree
             serializer.new(payment.source).to_h
           end
 
+          many :capture_events,
+               resource: proc { Spree.api.admin_payment_capture_event_serializer },
+               if: proc { expand?('capture_events') }
+
           one :order,
               resource: proc { Spree.api.admin_order_serializer },
               if: proc { expand?('order') }

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

@@ -10,7 +10,7 @@ module Spree
           include Alba::Resource
           include Typelizer::DSL
 
-          typelize key: :string, resource: :string, kind: [:string, enum: %w[read write]], group: :string,
+          typelize key: :string, resource: :string, kind: [:string, enum: %w[read write], enum_type_name: 'PermissionKind'], group: :string,
                    group_label: :string, label: :string, description: :string
 
           attributes :key

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

@@ -14,7 +14,7 @@ module Spree
                    starts_at: 'string | null',
                    ends_at: 'string | null',
                    deleted_at: 'string | null',
-                   match_policy: [:string, enum: Spree::PriceList::MATCH_POLICIES],
+                   match_policy: [:string, enum: Spree::PriceList::MATCH_POLICIES, enum_type_name: 'MatchPolicy'],
                    price_adjustment_percentage: 'string | null',
                    adjust_compare_at: :boolean,
                    automatic_pricing: :boolean,

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

@@ -6,7 +6,7 @@ module Spree
         # the merchant owes and expects, which no customer ever sees.
         class PurchaseOrderSerializer < V3::BaseSerializer
           typelize number: :string,
-                   status: :string,
+                   status: [:string, enum: Spree::PurchaseOrder.statuses, enum_type_name: 'PurchaseOrderStatus'],
                    currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode'],
                    reference: 'string | null',
                    notes: 'string | null',

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

@@ -5,6 +5,8 @@ module Spree
     module V3
       module Admin
         class ReturnSerializer < V3::ReturnSerializer
+          include Concerns::ExternalReferencesAttribute
+
           without_formatted_money
 
           typelize memo: [:string, nullable: true],

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

@@ -12,7 +12,7 @@ module Spree
 
           typelize id: :string, kind: [:string, comment: 'Requirement kind. Built-in: accept_terms, complete_profile, billing_address, returns_address, delivery_method, package_type, minimum_products, payout_account, required_custom_fields, policy, attestation, operator_review, document. Extensions may register more.'], name: :string,
                    description: [:string, nullable: true],
-                   required: :boolean, position: :number, status: [:string, enum: Spree::SellerRequirementStatus::STATUSES],
+                   required: :boolean, position: :number, status: [:string, enum: Spree::SellerRequirementStatus::STATUSES, enum_type_name: 'SellerRequirementState'],
                    blocking: :boolean, action_url: [:string, nullable: true],
                    blocker: ['{ state: string; message: string | null } | null'],
                    required_policy_name: [:string, nullable: true]

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

@@ -10,8 +10,8 @@ module Spree
                    legal_name: [:string, nullable: true],
                    registration_number: [:string, nullable: true],
                    contact_email: [:string, nullable: true], billing_email: [:string, nullable: true],
-                   tax_remittance: :string,
-                   payouts_schedule_interval: [:string, nullable: true],
+                   tax_remittance: [:string, enum: Spree::Seller::TAX_REMITTANCES, enum_type_name: 'TaxRemittance'],
+                   payouts_schedule_interval: [:string, nullable: true, enum: Spree::Seller::PAYOUT_INTERVALS, enum_type_name: 'PayoutScheduleInterval'],
                    minimum_payout_amount: [:string, nullable: true],
                    holiday_mode_until: [:string, nullable: true],
                    terms_accepted_at: [:string, nullable: true],

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

@@ -14,7 +14,7 @@ module Spree
                    refund_id: 'string | null',
                    seller_name: 'string | null',
                    order_number: 'string | null',
-                   kind: [:string, enum: Spree::SellerTransfer::KINDS],
+                   kind: [:string, enum: Spree::SellerTransfer::KINDS, enum_type_name: 'SellerTransferKind'],
                    status: [:string, enum: Spree::SellerTransfer.statuses, enum_type_name: 'SellerTransferStatus'],
                    provider: [:string, comment: 'Payout provider. Built-in: system. Provider gems register more (e.g. stripe).'],
                    amount: :string,

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

@@ -7,15 +7,15 @@ module Spree
         # The file is streamed through +download_url+, never linked to storage.
         class ShippingLabelSerializer < V3::BaseSerializer
           typelize owner_id: :string,
-                   owner_type: [:string, enum: Spree::ShippingLabel::OWNER_TYPES.map { |type| Spree::Base.polymorphic_api_type(type) }],
-                   source: [:string, enum: Spree::ShippingLabel::SOURCES],
+                   owner_type: [:string, enum: Spree::ShippingLabel::OWNER_TYPES.map { |type| Spree::Base.polymorphic_api_type(type) }, enum_type_name: 'ShippingLabelOwnerType'],
+                   source: [:string, enum: Spree::ShippingLabel::SOURCES, enum_type_name: 'ShippingLabelSource'],
                    status: [:string, enum: Spree::ShippingLabel.statuses, enum_type_name: 'ShippingLabelStatus'],
                    carrier: [:string, nullable: true],
                    carrier_name: [:string, nullable: true],
                    service: [:string, nullable: true],
                    tracking_number: [:string, nullable: true],
                    currency: [:string, nullable: true, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode'],
-                   format: [:string, nullable: true],
+                   format: [:string, nullable: true, enum: Spree::ShippingLabel::FORMATS, enum_type_name: 'ShippingLabelFormat'],
                    external_id: [:string, nullable: true],
                    integration_id: [:string, nullable: true],
                    download_url: [:string, nullable: true],

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

@@ -15,7 +15,7 @@ module Spree
                    address2: [:string, nullable: true], state_name: [:string, nullable: true],
                    phone: [:string, nullable: true], company: [:string, nullable: true],
                    kind: [:string, enum: Spree::StockLocation::KINDS, enum_type_name: 'StockLocationKind'],
-                   pickup_stock_policy: [:string, enum: Spree::StockLocation::PICKUP_STOCK_POLICIES],
+                   pickup_stock_policy: [:string, enum: Spree::StockLocation::PICKUP_STOCK_POLICIES, enum_type_name: 'PickupStockPolicy'],
                    pickup_ready_in_minutes: [:number, nullable: true],
                    pickup_instructions: [:string, nullable: true]
 

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

@@ -7,9 +7,9 @@ module Spree
         class StockReceiptItemSerializer < V3::BaseSerializer
           typelize quantity_accepted: :number,
                    quantity_rejected: :number,
-                   rejection_reason: [:string, enum: Spree::StockReceiptItem::REJECTION_REASONS, nullable: true],
+                   rejection_reason: [:string, enum: Spree::StockReceiptItem::REJECTION_REASONS, nullable: true, enum_type_name: 'StockReceiptRejectionReason'],
                    notes: 'string | null',
-                   line_type: [:string, enum: %w[purchase_order_item stock_transfer_item]],
+                   line_type: [:string, enum: %w[purchase_order_item stock_transfer_item], enum_type_name: 'StockReceiptLineType'],
                    line_id: 'string | null',
                    product_id: 'string | null',
                    variant_id: 'string | null',

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

@@ -9,7 +9,7 @@ module Spree
                    reference: 'string | null',
                    notes: 'string | null',
                    received_at: :string,
-                   receivable_type: [:string, enum: %w[purchase_order stock_transfer]],
+                   receivable_type: [:string, enum: %w[purchase_order stock_transfer], enum_type_name: 'StockReceiptReceivableType'],
                    receivable_id: :string,
                    received_by_id: 'string | null',
                    received_by_type: [:string, nullable: true, enum: Spree::Actor::BUILT_IN_KINDS, enum_type_name: 'ActorKind'],

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

@@ -6,7 +6,7 @@ module Spree
         # has a middle: `shipped_at` is when the units left the source,
         # `received_at` when the destination finished counting them in.
         class StockTransferSerializer < V3::StockTransferSerializer
-          typelize status: :string,
+          typelize status: [:string, enum: Spree::StockTransfer.statuses, enum_type_name: 'StockTransferStatus'],
                    notes: 'string | null',
                    items_count: :number,
                    quantity_shipped_total: :number,

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

@@ -36,6 +36,7 @@ module Spree
           # and rate settings are formatted below.
           preference_attributes Spree::Store, except: %i[order_routing_strategy payout_provider
                                                          default_minimum_payout_amount default_commission_tax_rate]
+          typelize weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS, enum_type_name: 'WeightUnit']
 
           # Once the counter has issued a number the starting value no longer
           # applies, so the settings page can say that instead of accepting a