wineater-bot 4.23.2 → 4.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wineater-bot",
-  "version": "4.23.2",
+  "version": "4.24.0",
   "description": "",
   "main": "dist/wineater-chatbot.mjs",
   "module": "src/index.js",

package/src/App.svelte

@@ -18,6 +18,17 @@
 	import { appStore } from './services/store/app-store.svelte';
 	import { getTranslation, translateTexts } from './services/i18n/i18n';
 	import { generateInlineStyle, preconnectFontHosts } from './services/ui-config/utils';
+	import {
+		QuotaExceededError,
+		shopifyContext,
+		storefrontSessionId,
+		variantIdOf
+	} from './services/shopify/shopify';
+	import { addToCart } from './services/shopify/cart';
+
+	// Shopify storefront (app embed): add to cart instead of a link out, no Wineater link,
+	// no cookies of our own, no web fonts; the shop's searches are limited by its plan.
+	const shopify = shopifyContext();
 
 	function initCookies() {
 		// chatbotToken — токен магазина, не данные посетителя. uniqueUserID
@@ -27,8 +38,10 @@
 	}
 
 	const DEMO_TOKEN = 'HeUw6IXuhvz6tRuXdPEGEbj3SGQ3Q2YtEc1Z8jd41Kg9LtyPb4Epu0to31SYIadG';
-	initCookies();
-	preconnectFontHosts();
+	if (!shopify) {
+		initCookies();
+		preconnectFontHosts();
+	}
 
 	const INSTANT_CACHE_MAX_AGE_MS = 6 * 60 * 60 * 1000;
 	// A personal start grid follows the taste profile, which changes with every
@@ -68,6 +81,10 @@
 	// Один id на поиск: уходит в тело search/v2 и в каждое событие обратной
 	// связи (shown/click/...), чтобы бэкенд связал клики с конкретной выдачей.
 	let currentQueryId: string | null = null;
+	// Shopify: wines put into the cart from this widget (the button shows "Added")
+	let addedIds = $state<string[]>([]);
+	// Shopify: the shop used up its monthly searches — instant picks + a soft line instead of an error
+	let sommelierResting = $state(false);
 
 	// Профиль вкуса: что показали и в каком порядке. Пустая выдача не событие.
 	function feedbackShown(wines: (Wine | RecommendedWine)[], text: string) {
@@ -85,6 +102,7 @@
 	let storeId = $derived(appStore.getStoreId());
 	let isStoreInitialized = $derived(appStore.isInitialized());
 	let uiConfig = $derived(appStore.getUiConfig());
+	let searchAvailable = $derived(appStore.isSearchAvailable());
 
 	function setSearchError() {
 		errorMessage = getTranslation({ key: 'errorMessage', lang: appLanguage });
@@ -169,6 +187,21 @@
 		}
 	}
 
+	// Shopify: searches used up — show the start picks again with a soft line, never an error
+	async function showRestingPicks() {
+		sommelierResting = true;
+		appStore.setSearchAvailable(false);
+		try {
+			const { wines } = await wineaterApi.getInstantRecommendations();
+			results = wines;
+			translatedPopups = [];
+			hasMore = false;
+		} catch (error) {
+			console.error('[wineater] instant recommendations error:', error);
+			results = [];
+		}
+	}
+
 	// Простая функция-анимация: поднимаем карточки и ждём
 	function animateClearAll(duration = 220): Promise<void> {
 		if (!results || results.length === 0) return Promise.resolve();
@@ -224,7 +257,8 @@
 				// Пагинация доступна только для search/v2 — у instant/legacy-путей нет
 				// "more"-эндпоинта. Неполная выдача (< 4) означает, что кандидаты и так
 				// кончились: кнопка в этом случае только мигнула бы впустую.
-				hasMore = apiVersion === '2' && searchResults.length >= 4;
+				// в Shopify нет "more": каждый запрос считается в лимит плана
+				hasMore = apiVersion === '2' && !shopify && searchResults.length >= 4;
 				feedbackShown(searchResults, query);
 				trackWidgetEvent(WIDGET_EVENTS.SEARCH_RESULTS_DISPLAYED, storeId, {
 					results_count: searchResults.length,
@@ -272,6 +306,10 @@
 			}
 		} catch (error) {
 			if (myQueryId !== currentQueryId) return;
+			if (error instanceof QuotaExceededError) {
+				await showRestingPicks();
+				return;
+			}
 			results = [];
 			console.error('[wineater] search error:', error);
 			trackWidgetEvent(WIDGET_EVENTS.ERROR_OCCURRED, storeId, {
@@ -419,6 +457,27 @@
 		});
 	}
 
+	// Shopify: the BUY button puts the bottle into the shop's cart (on click only)
+	async function handleAddToCart(wine: Wine | RecommendedWine, index: number) {
+		const variantId = variantIdOf(wine as { url?: string | null; itemId?: string | null });
+		if (!shopify || !variantId) return;
+		trackFeedback({ type: 'add_to_cart', query_id: currentQueryId ?? undefined, sku_ids: [wine.id], position: index });
+		trackWidgetEvent(WIDGET_EVENTS.BUY_BUTTON_CLICKED, storeId, {
+			action: 'add_to_cart',
+			wine_id: wine.id,
+			wine_title: wine.title,
+			wine_url: wine.url,
+			variant_id: variantId,
+			query: lastSearchedQuery || undefined,
+			is_mobile: window.innerWidth <= 768
+		});
+		const result = await addToCart(variantId, { root: shopify.root, sessionId: storefrontSessionId() });
+		if (!result.ok) return; // the cart page is opening
+		addedIds = [...addedIds, wine.id];
+		// the embed closes its panel so the theme's cart drawer is visible
+		window.dispatchEvent(new CustomEvent('wineater:added-to-cart', { detail: { variantId, via: result.via } }));
+	}
+
 	function closePopup() {
 		const wine = results.find((w) => w.id === selectedWineId);
 		trackWidgetEvent(WIDGET_EVENTS.WINE_DETAILS_CLOSED, storeId, {
@@ -465,7 +524,9 @@
 	}
 
 	function handleClickOutside(event: MouseEvent) {
-		const target = event.target as HTMLElement;
+		// inside a shadow root (Shopify embed) document listeners see the host as the target
+		const target = (event.composedPath?.()[0] ?? event.target) as HTMLElement;
+		if (!target?.closest) return;
 		const isInsidePopup = target.closest('.js-WinePopup') || target.closest('.js-WineTileAction');
 
 		if (!isInsidePopup) {
@@ -474,12 +535,16 @@
 	}
 
 	// Set CSS variable from config reactively
+	// Shopify: variables go on the shadow host, not on the theme's <html>
+	const cssVarTarget: HTMLElement =
+		((window?.wineaterData?.mountTarget?.getRootNode?.() as ShadowRoot | undefined)?.host as HTMLElement) ||
+		document.documentElement;
 	$effect(() => {
 		if (uiConfig?.brandColor) {
-			document.documentElement.style.setProperty('--wr-brand-color', uiConfig.brandColor);
+			cssVarTarget.style.setProperty('--wr-brand-color', uiConfig.brandColor);
 		}
 		if (uiConfig?.wineaterColor) {
-			document.documentElement.style.setProperty('--wr-wineater-color', uiConfig.wineaterColor);
+			cssVarTarget.style.setProperty('--wr-wineater-color', uiConfig.wineaterColor);
 		}
 	});
 
@@ -504,6 +569,7 @@
 			}
 
 			initialized = true;
+			if (shopify && !searchAvailable) sommelierResting = true;
 			// без согласия (EU-магазин) событие уходит обезличенно — не повторяем
 			// его после «Принять», иначе инициализация посчиталась бы дважды
 			trackWidgetEvent(WIDGET_EVENTS.WIDGET_INITIALIZED, storeId);
@@ -518,7 +584,7 @@
 {#if isStoreInitialized}
 	<!-- wr-Custom is used only for custom styling -->
 	<!-- id is used to increase specificity -->
-	<div id="wr-Custom" class="wr-App">
+	<div id="wr-Custom" class="wr-App" class:wr-App--embedded={!!shopify}>
 		{#if uiConfig.logoUrl}
 			<div class="wr-App-picture">
 				<img class="wr-App-logo" src={uiConfig.logoUrl} alt="" />
@@ -529,6 +595,11 @@
 		<Search bind:searchQuery onSubmit={handleSearch} {initialized} />
 
 		<div class="wr-App-content">
+			{#if sommelierResting && !errorMessage}
+				<p class="wr-App-resting" role="status">
+					{getTranslation({ key: 'sommelierResting', lang: appLanguage })}
+				</p>
+			{/if}
 			{#if errorMessage}
 				<div class="wr-App-error">
 					<p>{errorMessage}</p>
@@ -545,8 +616,10 @@
 							translatedPopup={translatedPopups[index]}
 							onBuyClick={handleBuyBtnClick}
 							onBuyLinkClick={handleBuyLinkClick}
+							onAddToCart={shopify ? handleAddToCart : undefined}
+							addedToCart={addedIds.includes(wine.id)}
 							onPopupClose={closePopup}
-							onSimilarClick={handleSimilarClick}
+							onSimilarClick={shopify ? undefined : handleSimilarClick}
 							{onTileEnter}
 							{onTileLeave}
 							{onTileClick}
@@ -569,11 +642,13 @@
 			<CookieConsent lang={appLanguage} />
 		{/if}
 
-		<Footer {countryCode} />
+		{#if !shopify}
+			<Footer {countryCode} />
+		{/if}
 	</div>
 {:else if !configFailed}
 	<!-- Shell with the same footprint as the widget while the store config loads -->
-	<div class="wr-App wr-App--loading" aria-busy="true">
+	<div class="wr-App wr-App--loading" class:wr-App--embedded={!!shopify} aria-busy="true">
 		<div class="wr-App-loadingTop"></div>
 		<SkeletonTiles />
 	</div>
@@ -616,6 +691,28 @@
 		position: relative;
 	}
 
+	/* Shopify: the embed's panel is the frame — fill it, no card of our own */
+	.wr-App.wr-App--embedded {
+		min-width: 0;
+		max-width: none;
+		width: 100%;
+		margin: 0;
+		box-shadow: none;
+		border-radius: 0;
+		min-height: 0;
+		padding-bottom: 12px;
+	}
+
+	.wr-App-resting {
+		margin: 0 0 8px;
+		padding: 10px 14px;
+		border-radius: 10px;
+		background: #f6f7fd;
+		color: #444;
+		font-size: 14px;
+		text-align: center;
+	}
+
 	.wr-App-loadingTop {
 		/* roughly the height of Header + Search, so tiles do not jump once they render */
 		height: 150px;
@@ -669,6 +766,11 @@
 			min-width: 100vw;
 		}
 
+		.wr-App.wr-App--embedded {
+			min-width: 0;
+			padding: 0 12px 12px;
+		}
+
 		.wr-App-placeholder {
 			display: flex;
 			gap: 8px;

package/src/components/WineTile.svelte

@@ -7,6 +7,7 @@
 	import Action from './ui/Action.svelte';
 	import WineBottle from './WineBottle.svelte';
 	import { hasImage } from '../services/bottle/bottle';
+	import { variantIdOf } from '../services/shopify/shopify';
 
 	// Desktop grid has 4 columns: the first row is above the fold
 	const FIRST_ROW_SIZE = 4;
@@ -26,6 +27,8 @@
 		onTileClick,
 		onBuyClick,
 		onBuyLinkClick,
+		onAddToCart,
+		addedToCart = false,
 		onPopupClose,
 		onSimilarClick,
 		isAnimating,
@@ -40,6 +43,9 @@
 		onTileClick: (event: MouseEvent, wine: Wine | RecommendedWine) => void;
 		onBuyClick: (wine: Wine | RecommendedWine, index: number) => void;
 		onBuyLinkClick: (wine: Wine | RecommendedWine, index: number) => void;
+		/** Shopify mode: BUY puts the bottle into the shop's cart */
+		onAddToCart?: (wine: Wine | RecommendedWine, index: number) => void;
+		addedToCart?: boolean;
 		onPopupClose: () => void;
 		onSimilarClick?: (wine: Wine | RecommendedWine) => void;
 		isAnimating: boolean;
@@ -78,6 +84,18 @@
 			.filter(Boolean);
 	}
 	let isMobile = $state(false);
+	let canAddToCart = $derived(!!onAddToCart && !!variantIdOf(wine as { url?: string | null; itemId?: string | null }));
+	let adding = $state(false);
+
+	async function addToCartClick() {
+		if (adding || addedToCart) return;
+		adding = true;
+		try {
+			await onAddToCart?.(wine, index);
+		} finally {
+			adding = false;
+		}
+	}
 
 	onMount(() => {
 		const checkIsMobile = () => {
@@ -129,7 +147,13 @@
 			</div>
 		{/if}
 
-		<h3 class="wr-WineTile-title">{wine.title}</h3>
+		{#if canAddToCart && wine.url}
+			<h3 class="wr-WineTile-title">
+				<a class="wr-WineTile-titleLink js-WineTileAction" href={wine.url}>{wine.title}</a>
+			</h3>
+		{:else}
+			<h3 class="wr-WineTile-title">{wine.title}</h3>
+		{/if}
 	</header>
 
 	{#if joinParams(wine, ['type', 'country', 'region', 'grape'])}
@@ -141,7 +165,15 @@
 	<footer class="wr-WineTile-footer">
 		<!-- We need this wrapper for top margin -->
 		<div class="wr-WineTile-actions">
-			{#if wine.url}
+			{#if canAddToCart}
+				<Action
+					handleClick={addToCartClick}
+					variant={addedToCart ? 'outlined' : 'primary'}
+					className="wr-WineTile-action wr-WineTile-action--cart js-WineTileAction"
+				>
+					{getTranslation({ key: addedToCart ? 'addedToCart' : 'addToCart', lang })}
+				</Action>
+			{:else if wine.url}
 				<Action
 					href={wine.url}
 					handleClick={() => onBuyLinkClick(wine, index)}
@@ -275,6 +307,15 @@
 		color: #000;
 	}
 
+	.wr-WineTile-titleLink {
+		color: inherit;
+		text-decoration: none;
+	}
+
+	.wr-WineTile-titleLink:hover {
+		text-decoration: underline;
+	}
+
 	.wr-WineTile-params {
 		font-size: 14px;
 		color: #666;

package/src/index.js

@@ -1,5 +1,7 @@
 import SvelteApp from './App.svelte'
 import { mount } from 'svelte';
 
-const app = mount(SvelteApp, { target: document.getElementById("wineater-widget-conteiner") });
+// Shopify app embed passes its own target (inside a shadow root); everyone else uses the page div
+const target = window.wineaterData?.mountTarget || document.getElementById("wineater-widget-conteiner");
+const app = mount(SvelteApp, { target });
 export default app

package/src/services/analytics/analytics.ts

@@ -1,4 +1,5 @@
 import { trackingAllowed } from '../profile/consent.svelte';
+import { shopifyContext } from '../shopify/shopify';
 
 function generateUUID(): string {
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
@@ -41,7 +42,14 @@ export function setUniqueUserCookie(): string {
 }
 
 export function trackWidgetEvent(event_type: string, store_id, data = {}, meta = {}) {
-    const endpoint = 'https://admin-api.wineater.com/api/widget-events';
+    // Тот же маршрут бэкенда, что и на admin-api.wineater.com (wineater-api выключен, домен admin-api
+    // смотрит на бэкенд ради уже опубликованных версий — его не снимать, пока они живы).
+    // Shopify storefront: the backend finds the store by `shop` (store_id from the client is ignored)
+    const shop = shopifyContext()?.shop;
+    const endpoint = shop
+        ? 'https://api.wineater.com/shopify/storefront/events'
+        : 'https://api.wineater.com/api/widget-events';
+    const target = shop ? { shop } : {};
     const event_time = new Date().toISOString();
     const region = navigator.language.split('-')[1] || null;
     const language = navigator.language.split('-')[0] || 'en';
@@ -52,6 +60,7 @@ export function trackWidgetEvent(event_type: string, store_id, data = {}, meta =
     // можно опознать). Грубый класс устройства оставляем для статистики.
     if (!trackingAllowed()) {
         const anonymousPayload = {
+            ...target,
             event_type,
             store_id,
             event_time,
@@ -94,6 +103,7 @@ export function trackWidgetEvent(event_type: string, store_id, data = {}, meta =
     }
 
     const payload = {
+        ...target,
         event_type,
         store_id,
         session_id,
@@ -113,7 +123,9 @@ export function trackWidgetEvent(event_type: string, store_id, data = {}, meta =
         headers: {
             'Content-Type': 'application/json'
         },
-        body: JSON.stringify(payload)
+        body: JSON.stringify(payload),
+        // Shopify: add to cart may fall back to the cart page right after this event
+        keepalive: !!shop
     })
         .then(response => {
             if (!response.ok) {

package/src/services/api/api.ts

@@ -1,6 +1,7 @@
 import { deserializeInstantRecommendation, deserializeRecommendedWine, deserializeMoreRecommendations } from "./deserialize";
 import { getUid } from "../profile/uid";
 import { initFeedback, type FeedbackEvent } from "../profile/events";
+import { QuotaExceededError, quotaErrorOf, shopifyContext, storefrontSessionId } from "../shopify/shopify";
 
 export type WineId = string;
 export type WinePrice = number;
@@ -39,6 +40,17 @@ export type RecommendedWine = Omit<Wine, "shortDescription" | "producer" | "pair
 
 const UID_HEADER = 'X-Wineater-Uid';
 
+/** HTTP error with the status and parsed body (the message keeps the old format). */
+export class ApiError extends Error {
+    status: number;
+    data: any;
+    constructor(status: number, data: any) {
+        super(`API call failed with status ${status}: ${data?.message || 'No additional error information'}`);
+        this.status = status;
+        this.data = data;
+    }
+}
+
 class WineaterApi {
     #baseUrl = 'https://api.wineater.com/';
     #token: string;
@@ -47,6 +59,8 @@ class WineaterApi {
     // preflight rejected by a backend that does not allow it yet): we then
     // retry without the header and stop sending it for this page.
     #uidHeaderUnsupported = false;
+    // Shopify mode only: answers in the storefront language (set by appStore)
+    #language: string | null = null;
 
     constructor(token: string, apiVersion: string = '1') {
         this.#token = token;
@@ -93,9 +107,14 @@ class WineaterApi {
         }
 
         const text = await response.text();
-        const data = text ? JSON.parse(text) : null;
+        let data = null;
+        try {
+            data = text ? JSON.parse(text) : null;
+        } catch {
+            if (response.ok) throw new Error('API returned invalid JSON');
+        }
         if (!response.ok) {
-            throw new Error(`API call failed with status ${response.status}: ${data?.message || 'No additional error information'}`);
+            throw new ApiError(response.status, data);
         }
         return { data: data as T, headers: response.headers };
     }
@@ -105,10 +124,13 @@ class WineaterApi {
     // its instant cache by it, so a recomputed profile is picked up next visit.
     async getInstantRecommendations(): Promise<{ wines: Wine[]; profileHash: string | null }> {
         try {
-            const endpoint = this.#apiVersion === '2'
-                ? 'dish/recommendations/instant/v2'
-                : 'dish/recommendations/instant';
-            const { data, headers } = await this.#send<any[]>(endpoint, {});
+            const shop = shopifyContext()?.shop;
+            const endpoint = shop
+                ? 'shopify/storefront/instant'
+                : this.#apiVersion === '2'
+                    ? 'dish/recommendations/instant/v2'
+                    : 'dish/recommendations/instant';
+            const { data, headers } = await this.#send<any[]>(endpoint, shop ? this.#shopBody({}) : {});
             return {
                 wines: data.filter(Boolean).map(deserializeInstantRecommendation),
                 profileHash: headers.get('X-Wineater-Profile') || null,
@@ -121,6 +143,7 @@ class WineaterApi {
     // `queryId` is generated by the widget per search and echoed in feedback
     // events, so the backend can tie clicks to the exact result set.
     async getWineRecommendationsSearch(text: string, queryId?: string): Promise<RecommendedWine[]> {
+        if (shopifyContext()) return this.#shopifySearch(text, queryId);
         try {
             const endpoint = this.#apiVersion === '2'
                 ? 'dish/recommendations/search/v2'
@@ -145,7 +168,8 @@ class WineaterApi {
         onWines: (wines: RecommendedWine[]) => void,
     ): Promise<RecommendedWine[]> {
         const fallback = () => this.getWineRecommendationsSearch(text, queryId);
-        if (this.#apiVersion !== '2') return fallback();
+        // the Shopify storefront search counts toward the plan and has no stream
+        if (this.#apiVersion !== '2' || shopifyContext()) return fallback();
 
         let response: Response;
         try {
@@ -218,6 +242,34 @@ class WineaterApi {
         await this.#request('events', batch, { keepalive: true });
     }
 
+    setLanguage(lang: string | null) {
+        this.#language = lang;
+    }
+
+    #shopBody<T extends object>(body: T): T & { shop: string; language?: string } {
+        const shop = shopifyContext()!.shop;
+        return this.#language ? { ...body, shop, language: this.#language } : { ...body, shop };
+    }
+
+    // Shopify storefront search: the backend counts it toward the shop's plan and answers
+    // 429 quota_exceeded once the monthly searches are used up.
+    async #shopifySearch(text: string, queryId?: string): Promise<RecommendedWine[]> {
+        try {
+            const body = this.#shopBody({ text, session_id: storefrontSessionId(), ...(queryId ? { query_id: queryId } : {}) });
+            const data = await this.#request<any[]>('shopify/storefront/search', body);
+            return (data ?? []).filter(Boolean).map(deserializeRecommendedWine);
+        } catch (error) {
+            if (error instanceof ApiError && quotaErrorOf(error.status, error.data)) throw new QuotaExceededError();
+            throw new Error(`Error in getWineRecommendations: ${error.message}`);
+        }
+    }
+
+    /** Public config of a Shopify shop when the embed had no app-data metafield. */
+    async getShopifyConfig(): Promise<any> {
+        const shop = shopifyContext()!.shop;
+        return this.#request<any>(`shopify/storefront/config?shop=${encodeURIComponent(shop)}`, undefined, { method: 'GET' });
+    }
+
     // TODO: define store type
     async getStoreConfig(): Promise<any> {
         try {

package/src/services/i18n/translations.json

@@ -67,7 +67,10 @@
         "consentText": "L'assistant vin enregistre un identifiant anonyme sur cet appareil pour apprendre vos goûts et améliorer ses recommandations. Vous pouvez l'utiliser sans accepter.",
         "consentAccept": "Accepter",
         "consentDecline": "Refuser",
-        "consentPrivacy": "Politique de confidentialité"
+        "consentPrivacy": "Politique de confidentialité",
+        "addToCart": "Ajouter au panier",
+        "addedToCart": "Ajouté",
+        "sommelierResting": "Notre sommelier se repose. Découvrez notre sélection ci-dessous."
     },
     "es": {
         "lang": "es",
@@ -137,7 +140,10 @@
         "consentText": "El asistente de vinos guarda un identificador anónimo en este dispositivo para conocer tus gustos y mejorar las recomendaciones. Puedes usarlo sin aceptar.",
         "consentAccept": "Aceptar",
         "consentDecline": "Rechazar",
-        "consentPrivacy": "Política de privacidad"
+        "consentPrivacy": "Política de privacidad",
+        "addToCart": "Añadir al carrito",
+        "addedToCart": "Añadido",
+        "sommelierResting": "Nuestro sumiller está descansando. Descubre nuestra selección."
     },
     "en": {
         "lang": "en",
@@ -207,7 +213,10 @@
         "consentText": "The wine assistant stores an anonymous identifier on this device to learn your taste and improve recommendations. You can use it without accepting.",
         "consentAccept": "Accept",
         "consentDecline": "Decline",
-        "consentPrivacy": "Privacy policy"
+        "consentPrivacy": "Privacy policy",
+        "addToCart": "Add to cart",
+        "addedToCart": "Added",
+        "sommelierResting": "Our sommelier is resting. Browse our picks below."
     },
     "sr": {
         "lang": "sr",
@@ -277,7 +286,10 @@
         "consentText": "Vinski asistent čuva anonimni identifikator na ovom uređaju kako bi upoznao vaš ukus i poboljšao preporuke. Možete ga koristiti i bez prihvatanja.",
         "consentAccept": "Prihvati",
         "consentDecline": "Odbij",
-        "consentPrivacy": "Politika privatnosti"
+        "consentPrivacy": "Politika privatnosti",
+        "addToCart": "Dodaj u korpu",
+        "addedToCart": "Dodato",
+        "sommelierResting": "Naš somelijer se odmara. Pogledajte naš izbor ispod."
     },
     "de": {
         "lang": "de",
@@ -346,7 +358,10 @@
         "consentText": "Der Weinassistent speichert eine anonyme Kennung auf diesem Gerät, um Ihren Geschmack kennenzulernen und Empfehlungen zu verbessern. Sie können ihn auch ohne Zustimmung nutzen.",
         "consentAccept": "Akzeptieren",
         "consentDecline": "Ablehnen",
-        "consentPrivacy": "Datenschutzerklärung"
+        "consentPrivacy": "Datenschutzerklärung",
+        "addToCart": "In den Warenkorb",
+        "addedToCart": "Hinzugefügt",
+        "sommelierResting": "Unser Sommelier macht gerade Pause. Entdecken Sie unsere Auswahl."
     },
     "ukr": {
         "lang": "ukr",
@@ -416,7 +431,10 @@
         "consentText": "Винний помічник зберігає на цьому пристрої анонімний ідентифікатор, щоб враховувати ваш смак і покращувати рекомендації. Користуватися можна й без згоди.",
         "consentAccept": "Прийняти",
         "consentDecline": "Відхилити",
-        "consentPrivacy": "Політика конфіденційності"
+        "consentPrivacy": "Політика конфіденційності",
+        "addToCart": "Додати в кошик",
+        "addedToCart": "Додано",
+        "sommelierResting": "Наш сомельє відпочиває. Перегляньте нашу добірку нижче."
     },
     "ru": {
         "lang": "ru",
@@ -486,7 +504,10 @@
         "consentText": "Винный помощник сохраняет на этом устройстве анонимный идентификатор, чтобы учитывать ваш вкус и улучшать рекомендации. Пользоваться можно и без согласия.",
         "consentAccept": "Принять",
         "consentDecline": "Отклонить",
-        "consentPrivacy": "Политика конфиденциальности"
+        "consentPrivacy": "Политика конфиденциальности",
+        "addToCart": "В корзину",
+        "addedToCart": "Добавлено",
+        "sommelierResting": "Наш сомелье отдыхает. Посмотрите нашу подборку ниже."
     },
     "kk": {
         "lang": "kk",
@@ -556,7 +577,10 @@
         "consentText": "Шарап көмекшісі сіздің талғамыңызды ескеріп, ұсыныстарды жақсарту үшін осы құрылғыда анонимді идентификатор сақтайды. Келісімсіз де пайдалана аласыз.",
         "consentAccept": "Қабылдау",
         "consentDecline": "Бас тарту",
-        "consentPrivacy": "Құпиялылық саясаты"
+        "consentPrivacy": "Құпиялылық саясаты",
+        "addToCart": "Себетке қосу",
+        "addedToCart": "Қосылды",
+        "sommelierResting": "Біздің сомелье демалып жатыр. Төмендегі таңдауымызды қараңыз."
     },
     "pt": {
         "lang": "pt",
@@ -626,6 +650,9 @@
         "consentText": "O assistente de vinhos guarda um identificador anónimo neste dispositivo para conhecer o seu gosto e melhorar as recomendações. Pode usá-lo sem aceitar.",
         "consentAccept": "Aceitar",
         "consentDecline": "Recusar",
-        "consentPrivacy": "Política de privacidade"
+        "consentPrivacy": "Política de privacidade",
+        "addToCart": "Adicionar ao carrinho",
+        "addedToCart": "Adicionado",
+        "sommelierResting": "Nosso sommelier está descansando. Veja nossas sugestões abaixo."
     }
 }

package/src/services/profile/consent.svelte.ts

@@ -37,6 +37,15 @@ let choice = $state<ConsentChoice | null>(readChoice());
 /** null — store config not loaded yet (unknown whether consent is required). */
 let storeRequires = $state<boolean | null>(null);
 
+// Shopify storefronts have their own cookie banner (Customer Privacy API): there the host decides
+// and we never show ours.
+let externalGate: (() => boolean) | null = null;
+
+/** Hand the consent decision to the host platform (Shopify mode). */
+export function setConsentGate(gate: () => boolean): void {
+    externalGate = gate;
+}
+
 /** Called by appStore once the store config is applied. */
 export function setStoreConsentPolicy(requiresConsent: boolean): void {
     storeRequires = requiresConsent;
@@ -54,6 +63,7 @@ export function consentChoice(): ConsentChoice | null {
 
 /** Show the banner: consent needed and the visitor has not chosen yet. */
 export function shouldAskConsent(): boolean {
+    if (externalGate) return false;
     return storeRequires !== null && consentRequired() && choice === null;
 }
 
@@ -64,6 +74,7 @@ export function shouldAskConsent(): boolean {
  */
 export function trackingAllowed(): boolean {
     if ((window as any)?.wineaterData?.tracking === false) return false;
+    if (externalGate) return externalGate();
     if (storeRequires === null) return false;
     if (!consentRequired()) return true;
     return choice === 'granted';