Market preview featured drinks experience

[thesmashcoder]

Summary

• Moves the Square-driven featured drink cards into the top Market Preview hero so mobile users immediately see real drink imagery.
• Adds event-aware market logic for Lake Carolina and Soda City, with hidden Square categories supported as internal merchandising tags.
• Supports the live Square category name Featured Drinks while keeping ID-based env fallbacks.
• Adds a live Square category-search fallback for featured categories when DB category links lag or Square exposes the category through search/reporting metadata.
• Clarifies market card UX so Available at Market is a non-clickable status pill on both featured and regular market cards, with View Details as the CTA.
• Adds a premium sold-out state for featured market items with a Sold Out Today overlay, Poured Out story pill, and restock update CTA.
• Keeps the existing market photos and product imagery intact; this change does not delete or replace image assets.

Root Cause

• The page changes were on dev, while the current public site still reflects main until the PR is merged/deployed.
• The live API was resolving Featured Drinks, but the DB bucket had zero linked products. Square category search did return Hibiscus Glow, so the API now falls back to Square category search and batch retrieval when the DB category result is empty.

Validation

• php -l api/v1/routes/public.commerce.products.get.php
• npm.cmd run build
• npm.cmd run test:api passed 12/12
• Live API check: Featured Drinks now returns Hibiscus Glow with its Square image URL.

Notes

• Pushed to dev at 4d4ad88.
• API route update was deployed over FTP so the live endpoint can return Square category-search fallback items immediately.