spree_api 6.0.0.rc7 → 6.0.1

data/app/services/spree/api/v3/request_schema.rb

@@ -40,22 +40,25 @@ module Spree
           datetime: { type: :string, format: :'date-time' },
           id: { type: :string },
           any: {},
-          # Codes from the closed lists below.
+          # Codes from the lists below.
           country: { type: :string },
           currency: { type: :string },
           locale: { type: :string },
+          time_zone: { type: :string },
           weight_unit: { type: :string },
           dimension_unit: { type: :string }
         }.freeze
 
-        # The closed lists a code field takes, published once per API as a
-        # named component — the same `CountryCode`, `CurrencyCode` and
-        # `WeightUnit` types the serializers declare, so a value read from a
-        # response is the type a request takes.
+        # The lists a code field takes, published once per API as a named
+        # component — the same `CountryCode`, `CurrencyCode` and `WeightUnit`
+        # types the serializers declare, so a value read from a response is the
+        # type a request takes. A list `Typelizer::OpenEnums` does not close
+        # only suggests its values.
         CODE_LISTS = {
           country: ['CountryCode', -> { Spree::IsoData.country_codes }],
           currency: ['CurrencyCode', -> { Spree::Money::Rounding::CURRENCY_CODES }],
           locale: ['LocaleCode', -> { Spree::Locales::ALL }],
+          time_zone: ['TimeZone', -> { Spree::TimeZones::SUGGESTED }],
           weight_unit: ['WeightUnit', -> { Spree::Variant::WEIGHT_UNITS }],
           dimension_unit: ['DimensionUnit', -> { Spree::Variant::DIMENSION_UNITS }]
         }.freeze
@@ -348,7 +351,12 @@ module Spree
             next unless CODE_LISTS.key?(field.kind)
 
             name, values = CODE_LISTS[field.kind]
-            lists[name] = { type: :string, enum: values.call }
+            lists[name] = if Typelizer::OpenEnums.closed?(name)
+                            { type: :string, enum: values.call }
+                          else
+                            Typelizer::OpenEnums.open_schema({ type: :string }, values.call)
+                              .merge(description: Typelizer::OpenEnums.description(name)).compact
+                          end
           end
         end
 
@@ -469,7 +477,7 @@ module Spree
 
           # The same open list the serializers publish (`enum_type_name`):
           # clients autocomplete the built-in values and still accept any other.
-          { anyOf: [schema.merge(enum: field.enum), schema] }
+          Typelizer::OpenEnums.open_schema(schema, field.enum)
         end
       end
     end

data/config/routes.rb

@@ -22,6 +22,9 @@ Spree::Core::Engine.add_routes do
         # Current channel context (never a list — see Store::ChannelController)
         resource :channel, only: [:show], controller: 'channel'
 
+        # Current store context (name and default SEO metadata, localized)
+        resource :store, only: [:show], controller: 'store'
+
         # Catalog
         resources :products, only: [:index, :show] do
           collection do
@@ -287,9 +290,9 @@ Spree::Core::Engine.add_routes do
         resource :store, only: [:show, :update], controller: 'store' do
           get :data_sources
         end
-        # The store's own custom fields, addressed by its id like every other
+        # The store's own custom fields and translations, addressed by its id like every other
         # parent. The controller only ever resolves the current store.
-        resources :stores, only: [], concerns: :custom_fieldable
+        resources :stores, only: [], concerns: [:custom_fieldable, :translatable]
 
         # Staff & access (invitations, admin users, roles, API keys)
         resources :admin_users, only: [:index, :show, :update, :destroy]
@@ -509,6 +512,15 @@ Spree::Core::Engine.add_routes do
           post :test, on: :member
         end
 
+        # Maintenance tasks — see docs/plans/6.0-maintenance-tasks.md.
+        # A run names its task by the short name the upgrade steps give.
+        resources :upgrade_steps, only: [:index]
+        resources :maintenance_task_runs, only: [:index, :show, :create] do
+          scope module: :maintenance_task_runs do
+            resource :cancellation, only: [:create]
+          end
+        end
+
         # Promotions, with nested actions/rules/coupon codes.
         resources :promotions, concerns: :custom_fieldable do
           resources :promotion_actions, only: [:index, :show, :create, :update, :destroy]

data/lib/spree/api/dependencies.rb

@@ -18,7 +18,7 @@ module Spree
            product_filter_sort_option media_event return return_line_item exchange exchange_line_item claim
            claim_line_item return_reason claim_reason digital_asset export gift_card_batch import import_row
            invitation newsletter_subscriber promotion refund stock_level stock_movement stock_reservation
-           stock_transfer company company_membership company_invitation seller file_upload file_upload_target].freeze
+           stock_transfer company company_membership company_invitation seller file_upload file_upload_target store].freeze
 
       ADMIN_SERIALIZERS =
         %i[country state locale applied_promotion discount tax_line cart delivery_zone delivery_profile
@@ -41,6 +41,7 @@ module Spree
            store setup_task update_status api_key oauth_application oauth_access_token oauth_consent_request oauth_redirect
            oauth_protected_resource allowed_origin webhook_endpoint webhook_event webhook_delivery invitation
            invitation_acceptance_link role permission export saved_report import import_row import_mapping promotion
+           maintenance_task_run
            promotion_action promotion_rule coupon_code price_adjustment_tier price_list price_rule
            resource_translations email_template email_template_draft email_template_revision email_template_preview
            email_template_sample_record file_upload file_upload_target].freeze

data/lib/spree/api/enum_types.rb

@@ -110,7 +110,8 @@ module Spree
           type = "export type #{name} = (typeof #{constant})[number] | (string & {})"
           type = "export type #{name} =\n  | (typeof #{constant})[number]\n  | (string & {})" if type.length > LINE_WIDTH
 
-          "\n/** The built-in values of `#{name}`. Extensions may add more. */\n#{line}\n#{type}\n"
+          summary = Typelizer::OpenEnums.description(name) || "The built-in values of `#{name}`. Extensions may add more."
+          "\n/** #{summary} */\n#{line}\n#{type}\n"
         end
       end
     end

data/lib/typelizer/open_enums.rb

@@ -34,6 +34,25 @@ module Typelizer
       TaxRemittance UnitSystem
     ].freeze
 
+    # Open lists whose values are suggestions rather than built-ins an
+    # extension adds to, described as such wherever the list is published.
+    DESCRIPTIONS = {
+      'TimeZone' => 'Common IANA time zones; any other IANA time zone identifier is accepted too.'
+    }.freeze
+
+    # @param name [String, nil] a list's `enum_type_name`
+    # @return [String, nil] what the list's values are, when they are not built-ins
+    def self.description(name)
+      DESCRIPTIONS[name]
+    end
+
+    # @param schema [Hash] the schema of any value in the list
+    # @param values [Array<String>] the values to suggest
+    # @return [Hash] a schema suggesting the values while accepting any other
+    def self.open_schema(schema, values)
+      { anyOf: [schema.merge(enum: values), schema] }
+    end
+
     # @param name [String, nil] a list's `enum_type_name`
     # @return [Boolean] whether the list is closed: no value outside it is valid
     def self.closed?(name)
@@ -63,7 +82,7 @@ module Typelizer
         return super unless property.enum_type_name && property.enum.is_a?(Array) && !property.multi
         return super if OpenEnums.closed?(property.enum_type_name)
 
-        open = { anyOf: [{ type: :string, enum: property.enum.compact }, { type: :string }] }
+        open = OpenEnums.open_schema({ type: :string }, property.enum.compact)
         # OpenAPI 3.0 ignores `nullable` beside `anyOf`, which is where
         # Typelizer puts it, so the free-string branch carries it instead.
         if property.nullable && !v31?(openapi_version)
@@ -72,7 +91,7 @@ module Typelizer
           apply_nullable(open, property, openapi_version: openapi_version)
         end
         apply_metadata(open, property)
-        open[:description] ||= OPEN_ENUM_DESCRIPTION
+        open[:description] ||= OpenEnums.description(property.enum_type_name) || OPEN_ENUM_DESCRIPTION
         open
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spree_api
 version: !ruby/object:Gem::Version
-  version: 6.0.0.rc7
+  version: 6.0.1
 platform: ruby
 authors:
 - Vendo Connect Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-26 00:00:00.000000000 Z
+date: 2026-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rswag-specs
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 6.0.0.rc7
+        version: 6.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 6.0.0.rc7
+        version: 6.0.1
 description: Spree Commerce Store / Admin API and HTTP webhooks
 email:
 - hello@spreecommerce.org
@@ -65,6 +65,7 @@ files:
 - app/controllers/concerns/spree/api/v3/admin/auth_cookies.rb
 - app/controllers/concerns/spree/api/v3/admin/email_template_lookup.rb
 - app/controllers/concerns/spree/api/v3/admin/embed_permissions.rb
+- app/controllers/concerns/spree/api/v3/admin/maintenance_tasks_switch.rb
 - app/controllers/concerns/spree/api/v3/admin/product_listing.rb
 - app/controllers/concerns/spree/api/v3/admin/product_membership.rb
 - app/controllers/concerns/spree/api/v3/admin/receivable_actions.rb
@@ -190,6 +191,8 @@ files:
 - app/controllers/spree/api/v3/admin/invitations/acceptance_links_controller.rb
 - app/controllers/spree/api/v3/admin/invitations_controller.rb
 - app/controllers/spree/api/v3/admin/locales_controller.rb
+- app/controllers/spree/api/v3/admin/maintenance_task_runs/cancellations_controller.rb
+- app/controllers/spree/api/v3/admin/maintenance_task_runs_controller.rb
 - app/controllers/spree/api/v3/admin/markets_controller.rb
 - app/controllers/spree/api/v3/admin/me_controller.rb
 - app/controllers/spree/api/v3/admin/media_controller.rb
@@ -276,6 +279,7 @@ files:
 - app/controllers/spree/api/v3/admin/translations_controller.rb
 - app/controllers/spree/api/v3/admin/translations_coverage_controller.rb
 - app/controllers/spree/api/v3/admin/updates_controller.rb
+- app/controllers/spree/api/v3/admin/upgrade_steps_controller.rb
 - app/controllers/spree/api/v3/admin/variants_controller.rb
 - app/controllers/spree/api/v3/admin/webhook_deliveries_controller.rb
 - app/controllers/spree/api/v3/admin/webhook_endpoints_controller.rb
@@ -386,6 +390,7 @@ files:
 - app/controllers/spree/api/v3/store/products_controller.rb
 - app/controllers/spree/api/v3/store/resource_controller.rb
 - app/controllers/spree/api/v3/store/sellers_controller.rb
+- app/controllers/spree/api/v3/store/store_controller.rb
 - app/controllers/spree/api/v3/store/wishlist_items_controller.rb
 - app/controllers/spree/api/v3/store/wishlists_controller.rb
 - app/controllers/spree/api/v3/webhooks/fulfillments_controller.rb
@@ -507,6 +512,7 @@ files:
 - app/serializers/spree/api/v3/admin/invitation_serializer.rb
 - app/serializers/spree/api/v3/admin/line_item_serializer.rb
 - app/serializers/spree/api/v3/admin/locale_serializer.rb
+- app/serializers/spree/api/v3/admin/maintenance_task_run_serializer.rb
 - app/serializers/spree/api/v3/admin/market_serializer.rb
 - app/serializers/spree/api/v3/admin/media_serializer.rb
 - app/serializers/spree/api/v3/admin/membership_product_serializer.rb
@@ -735,6 +741,7 @@ files:
 - app/serializers/spree/api/v3/stock_transfer_serializer.rb
 - app/serializers/spree/api/v3/store_credit_event_serializer.rb
 - app/serializers/spree/api/v3/store_credit_serializer.rb
+- app/serializers/spree/api/v3/store_serializer.rb
 - app/serializers/spree/api/v3/supplier_event_serializer.rb
 - app/serializers/spree/api/v3/tax_category_serializer.rb
 - app/serializers/spree/api/v3/tax_identifier_serializer.rb
@@ -831,9 +838,9 @@ licenses:
 - BSD-3-Clause
 metadata:
   bug_tracker_uri: https://github.com/spree/spree/issues
-  changelog_uri: https://github.com/spree/spree/releases/tag/v6.0.0.rc7
+  changelog_uri: https://github.com/spree/spree/releases/tag/v6.0.1
   documentation_uri: https://docs.spreecommerce.org/
-  source_code_uri: https://github.com/spree/spree/tree/v6.0.0.rc7
+  source_code_uri: https://github.com/spree/spree/tree/v6.0.1
 post_install_message:
 rdoc_options: []
 require_paths: