Changelog

Current version: 1.0.0

All notable changes to qoliber/ucp are listed here. The format follows Keep a Changelog, and versions follow Semantic Versioning.

[1.0.0] - Unreleased

Added

• UCP 2026-08-25 catalog REST binding: discovery at /.well-known/ucp, search, batch lookup with variant inputs correlation, and product detail with interactive option selection.
• Opt-in per store view under Stores → Configuration → Qoliber → UCP Catalog. The module ships disabled.
• Merchant-maintained platform profile snapshots of up to 64 KiB. Unknown agent profiles are refused without fetching remote URLs, and unreadable stored profiles are written to the Magento log.
• Stateless endpoints that never start a PHP session.
• Strict request validation: invalid requests return HTTP 400, including lookups of more than 50 IDs (request_too_large) and searches with only unknown filters. Problems with catalog data return HTTP 500 and are logged.
• Simple, virtual, downloadable and configurable products. Store and website membership, status and visibility apply as on the storefront: text search returns products visible in search, filter browsing returns products visible in the catalog.
• Text search on product name and SKU, category and price filters, and keyset cursor pagination. Cursors ignore JSON key order and category order or duplicates.
• Category filters and product categories from Magento's category index: an anchor category matches products in its subcategories, and inactive categories and the store root never appear.
• Configurable variants featuring the first purchasable variant. Product detail lists every option value with exists and available flags and selects the requested variant. Option names stay strings, including numeric ones.
• Case-insensitive SKU lookup.
• Plain-text descriptions without Page Builder styles or CMS directives, falling back to the short description.
• Product, variant and image URLs on the store's secure base URLs.
• Guest single-unit prices in the store currency with the NOT LOGGED IN group's tax class, catalog price rules and fixed product tax according to Magento's display and VAT settings. Minor units round as checkout does on every supported PHP version.
• price_range covering every variant of a product.
• Availability from the website's MSI stock; a configurable variant is available only when its parent and the variant are both salable.
• Limits of 200 variants per product and 1,000 per request. Products over a limit are reported with catalog_complexity_limit or catalog_request_limit messages instead of failing the response, and search continues through its cursor.
• Batched loading of catalog data, prices, stock and fixed product tax: a search page of 30 configurable products takes about 110 database queries.
• Support for PHP 8.1–8.5 with Magento Inventory (magento/module-inventory-sales), magento/module-weee and magento/module-quote, without an SEO package dependency.