@wix/headless-stores 0.0.105 → 0.0.107

package/cjs/dist/react/Option.d.ts

@@ -2,6 +2,7 @@ import React from 'react';
 import { AsChildChildren } from '@wix/headless-utils/react';
 export interface Option {
     name: string;
+    key?: string;
     choices?: any[];
     hasChoices?: boolean;
     type?: string;

package/cjs/dist/react/Product.d.ts

@@ -1,4 +1,4 @@
-import type { V3Product } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { AsChildChildren } from '@wix/headless-utils/react';
 import React from 'react';
 import { AsContent } from './types.js';
@@ -37,7 +37,7 @@ export type StockStatus = BasicStockStatus | 'can-pre-order';
  */
 export interface ProductRootProps {
     children: React.ReactNode;
-    product: V3Product;
+    product: productsV3.V3Product;
     selectedVariant?: any;
 }
 /**
@@ -268,7 +268,7 @@ export interface RawProps {
     asChild?: boolean;
     /** Custom render function when using asChild */
     children?: AsChildChildren<{
-        product: V3Product;
+        product: productsV3.V3Product;
     }>;
     /** CSS classes to apply to the default element */
     className?: string;

package/cjs/dist/react/Product.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { InventoryAvailabilityStatus } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { Quantity as QuantityComponent } from '@wix/headless-components/react';
 import { Commerce } from '@wix/headless-ecom/react';
 import { MediaGallery } from '@wix/headless-media/react';
@@ -406,15 +406,15 @@ export const Stock = React.forwardRef((props, ref) => {
             let status;
             let label;
             switch (availabilityStatus) {
-                case InventoryAvailabilityStatus.IN_STOCK:
+                case productsV3.InventoryAvailabilityStatus.IN_STOCK:
                     status = 'in-stock';
                     label = finalLabels.inStock;
                     break;
-                case InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
+                case productsV3.InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
                     status = 'limited-stock';
                     label = finalLabels.limitedStock;
                     break;
-                case InventoryAvailabilityStatus.OUT_OF_STOCK:
+                case productsV3.InventoryAvailabilityStatus.OUT_OF_STOCK:
                 default:
                     status = 'out-of-stock';
                     label = finalLabels.outOfStock;
@@ -1046,12 +1046,12 @@ function getStockStatusMessage(inStock, isPreOrderEnabled, availabilityStatus, l
     // Handle stock status based on availability
     if (inStock) {
         switch (availabilityStatus) {
-            case InventoryAvailabilityStatus.IN_STOCK:
+            case productsV3.InventoryAvailabilityStatus.IN_STOCK:
                 return {
                     status: 'in-stock',
                     label: labels.inStock,
                 };
-            case InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
+            case productsV3.InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
                 return {
                     status: 'limited-stock',
                     label: labels.limitedStock,

package/cjs/dist/react/ProductList.d.ts

@@ -1,4 +1,3 @@
-import type { V3Product } from '@wix/auto_sdk_stores_products-v-3';
 import { Sort as SortPrimitive, GenericListTotalsRenderProps, GenericListLoadMoreRenderProps, ListVariant, GenericListRepeaterRenderProps } from '@wix/headless-components/react';
 import React from 'react';
 import type { ProductsListServiceConfig } from '../services/products-list-service.js';
@@ -9,7 +8,7 @@ import { AsChildChildren } from '@wix/headless-utils/react';
  */
 export interface ProductListRootProps {
     children: React.ReactNode;
-    products?: V3Product[];
+    products?: productsV3.V3Product[];
     productsListConfig?: ProductsListServiceConfig;
     className?: string;
     variant?: ListVariant;
@@ -95,7 +94,7 @@ export declare const Products: React.ForwardRefExoticComponent<ProductsProps & R
 /**
  * Render props for ProductRepeater asChild pattern
  */
-export type ProductRepeaterRenderProps = GenericListRepeaterRenderProps<V3Product>;
+export type ProductRepeaterRenderProps = GenericListRepeaterRenderProps<productsV3.V3Product>;
 /**
  * Props for ProductList ProductRepeater component
  */

package/cjs/dist/react/core/Product.d.ts

@@ -1,5 +1,5 @@
 import { ProductServiceConfig } from '../../services/product-service.js';
-import type { V3Product, ProductMedia } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface RootProps {
     children: React.ReactNode;
     productServiceConfig: ProductServiceConfig;
@@ -81,18 +81,18 @@ export interface ProductDescriptionProps {
  */
 export interface ProductDescriptionRenderProps {
     /** Product description using the RICOS (Rich Content Object) format. See https://dev.wix.com/docs/ricos/api-reference/ricos-document */
-    description: NonNullable<V3Product['description']>;
+    description: NonNullable<productsV3.V3Product['description']>;
     /** Product description with plain html */
-    plainDescription: NonNullable<V3Product['plainDescription']>;
+    plainDescription: NonNullable<productsV3.V3Product['plainDescription']>;
 }
 /**
  * Render props for ProductDescription component
  */
 export interface ProductDescriptionRenderProps {
     /** Product description using the RICOS (Rich Content Object) format. See https://dev.wix.com/docs/ricos/api-reference/ricos-document */
-    description: NonNullable<V3Product['description']>;
+    description: NonNullable<productsV3.V3Product['description']>;
     /** Product description with plain html */
-    plainDescription: NonNullable<V3Product['plainDescription']>;
+    plainDescription: NonNullable<productsV3.V3Product['plainDescription']>;
 }
 /**
  * Headless component for product description display
@@ -129,15 +129,15 @@ export interface ProductMediaProps {
     children: (props: ProductMediaRenderProps) => React.ReactNode;
 }
 export interface ProductMediaRenderProps {
-    mediaItems: ProductMedia[];
-    mainMedia?: ProductMedia;
+    mediaItems: productsV3.ProductMedia[];
+    mainMedia?: productsV3.ProductMedia;
 }
 export declare function Media(props: ProductMediaProps): import("react").ReactNode;
 export interface ProductProps {
     children: (props: ProductRenderProps) => React.ReactNode;
 }
 export interface ProductRenderProps {
-    product: V3Product;
+    product: productsV3.V3Product;
 }
 export declare function Content(props: ProductProps): import("react").ReactNode;
 export interface LoadingProps {

package/cjs/dist/react/core/ProductModifiers.d.ts

@@ -1,4 +1,4 @@
-import { type ConnectedModifier, type ConnectedModifierChoice } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface RootProps {
     children: React.ReactNode;
 }
@@ -89,7 +89,7 @@ export interface ModifiersProps {
  */
 export interface ModifiersRenderProps {
     /** Array of product modifiers */
-    modifiers: ConnectedModifier[];
+    modifiers: productsV3.ConnectedModifier[];
     /** Whether product has modifiers */
     hasModifiers: boolean;
     /** Currently selected modifier values */
@@ -148,7 +148,7 @@ export declare function Modifiers(props: ModifiersProps): import("react").ReactN
  */
 export interface ModifierProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Render prop function that receives modifier data */
     children: (props: ModifierRenderProps) => React.ReactNode;
 }
@@ -156,14 +156,16 @@ export interface ModifierProps {
  * Render props for Modifier component
  */
 export interface ModifierRenderProps {
-    /** Modifier name */
+    /** Modifier name (may be translated) */
     name: string;
+    /** Modifier key (unique identifier) */
+    key: string;
     /** Modifier type */
     type: any;
     /** Whether this modifier is mandatory */
     mandatory: boolean;
     /** Array of choices for this modifier (for choice-based modifiers) */
-    choices: ConnectedModifierChoice[];
+    choices: productsV3.ConnectedModifierChoice[];
     /** Currently selected value for this modifier */
     selectedValue: any;
     /** Whether this modifier has choices */
@@ -227,9 +229,9 @@ export declare function Modifier(props: ModifierProps): import("react").ReactNod
  */
 export interface ChoiceProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Choice data */
-    choice: ConnectedModifierChoice;
+    choice: productsV3.ConnectedModifierChoice;
     /** Render prop function that receives choice data */
     children: (props: ChoiceRenderProps) => React.ReactNode;
 }
@@ -288,7 +290,7 @@ export declare function Choice(props: ChoiceProps): import("react").ReactNode;
  */
 export interface FreeTextProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Render prop function that receives free text data */
     children: (props: FreeTextRenderProps) => React.ReactNode;
 }
@@ -354,7 +356,7 @@ export declare function FreeText(props: FreeTextProps): import("react").ReactNod
  */
 export interface ToggleFreeTextProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Render prop function that receives toggle data */
     children: (props: ToggleFreeTextRenderProps) => React.ReactNode;
 }

package/cjs/dist/react/core/ProductModifiers.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useState } from 'react';
 import { useService, WixServices } from '@wix/services-manager-react';
 import { ProductModifiersServiceDefinition, ProductModifiersService, } from '../../services/product-modifiers-service.js';
-import { ModifierRenderType, } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { createServicesMap } from '@wix/services-manager';
 /**
  * Root component that provides the ProductModifiers service context to its children.
@@ -208,17 +208,20 @@ export function Modifier(props) {
     const modifiersService = useModifiersService();
     const { modifier } = props;
     const name = modifier.name || '';
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const key = modifier.key || name;
     const type = modifier.modifierRenderType;
     const mandatory = modifier.mandatory || false;
     const choices = modifier.choicesSettings?.choices || [];
     const hasChoices = choices.length > 0;
-    const isFreeText = type === ModifierRenderType.FREE_TEXT;
+    const isFreeText = type === productsV3.ModifierRenderType.FREE_TEXT;
     const freeTextSettings = modifier.freeTextSettings;
     const maxChars = freeTextSettings?.maxLength;
     const placeholder = freeTextSettings?.placeholder;
     const selectedValue = modifiersService?.selectedModifiers.get()[name] || null;
     return props.children({
         name,
+        key,
         type,
         mandatory,
         choices,
@@ -265,7 +268,7 @@ export function Choice(props) {
     const modifierName = modifier.name || '';
     const renderType = modifier.modifierRenderType;
     // For TEXT_CHOICES, use choice.key; for SWATCH_CHOICES, use choice.name
-    const choiceValue = renderType === ModifierRenderType.TEXT_CHOICES
+    const choiceValue = renderType === productsV3.ModifierRenderType.TEXT_CHOICES
         ? choice.key || choice.name || ''
         : choice.name || '';
     const value = choice.name || ''; // Display name is always choice.name

package/cjs/dist/react/core/ProductVariantSelector.d.ts

@@ -1,5 +1,5 @@
 import { SelectedVariantServiceConfig } from '../../services/selected-variant-service.js';
-import { type ConnectedOption, type ConnectedOptionChoice, InventoryAvailabilityStatus } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface RootProps {
     children: React.ReactNode;
     selectedVariantServiceConfig?: SelectedVariantServiceConfig;
@@ -55,7 +55,7 @@ export interface OptionsProps {
  */
 export interface OptionsRenderProps {
     /** Array of product options */
-    options: ConnectedOption[];
+    options: productsV3.ConnectedOption[];
     /** Whether product has options */
     hasOptions: boolean;
     /** Currently selected choices */
@@ -99,7 +99,7 @@ export declare function Options(props: OptionsProps): import("react").ReactNode;
  */
 export interface OptionProps {
     /** Product option data */
-    option: ConnectedOption;
+    option: productsV3.ConnectedOption;
     /** Render prop function that receives option data */
     children: (props: OptionRenderProps) => React.ReactNode;
 }
@@ -107,10 +107,12 @@ export interface OptionProps {
  * Render props for Option component
  */
 export interface OptionRenderProps {
-    /** Option name */
+    /** Option name (may be translated) */
     name: string;
+    /** Option key (unique identifier) */
+    key: string;
     /** Array of choices for this option */
-    choices: ConnectedOptionChoice[];
+    choices: productsV3.ConnectedOptionChoice[];
     /** Currently selected value for this option */
     selectedValue: string | null;
     /** Whether this option has choices */
@@ -153,9 +155,9 @@ export declare function Option(props: OptionProps): import("react").ReactNode;
  */
 export interface ChoiceProps {
     /** Product option data */
-    option: ConnectedOption;
+    option: productsV3.ConnectedOption;
     /** Choice data */
-    choice: ConnectedOptionChoice;
+    choice: productsV3.ConnectedOptionChoice;
     /** Render prop function that receives choice data */
     children: (props: ChoiceRenderProps) => React.ReactNode;
 }
@@ -165,6 +167,8 @@ export interface ChoiceProps {
 export interface ChoiceRenderProps {
     /** Choice value to display */
     value: string;
+    /** Choice key (unique identifier) */
+    valueKey: string;
     /** Whether this choice is currently selected */
     isSelected: boolean;
     /** Whether this choice is visible */
@@ -175,8 +179,10 @@ export interface ChoiceRenderProps {
     isPreOrderEnabled: boolean;
     /** Function to select this choice */
     select: () => void;
-    /** Option name */
+    /** Option name (may be translated) */
     optionName: string;
+    /** Option key (unique identifier) */
+    optionKey: string;
     /** Choice value */
     choiceValue: string;
 }
@@ -223,7 +229,7 @@ export interface StockRenderProps {
     /** Whether pre-order is enabled */
     isPreOrderEnabled: boolean;
     /** Raw inventory availability status */
-    availabilityStatus: InventoryAvailabilityStatus | string;
+    availabilityStatus: productsV3.InventoryAvailabilityStatus | string;
     /** Whether stock tracking is enabled */
     trackInventory: boolean;
     /** Current variant id */

package/cjs/dist/react/core/ProductVariantSelector.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useService, WixServices } from '@wix/services-manager-react';
 import { SelectedVariantServiceDefinition, SelectedVariantService, } from '../../services/selected-variant-service.js';
 import { createServicesMap } from '@wix/services-manager';
-import { InventoryAvailabilityStatus, } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 /**
  * Root component that provides the ProductVariantSelector service context to its children.
  * This component sets up the necessary services for rendering and managing product variant selection.
@@ -122,10 +122,13 @@ export function Option(props) {
     const selectedChoices = variantService.selectedChoices.get();
     const { option } = props;
     const name = option.name || '';
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const key = option.key || name;
     const choices = option.choicesSettings?.choices || [];
     const selectedValue = selectedChoices[name] || null;
     return props.children({
         name,
+        key,
         choices,
         selectedValue,
         hasChoices: choices.length > 0,
@@ -162,30 +165,36 @@ export function Choice(props) {
     const selectedChoices = variantService.selectedChoices.get();
     const { option, choice } = props;
     const optionName = option.name || '';
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const optionKey = option.key || optionName;
     const choiceValue = choice.name || '';
-    const isSelected = selectedChoices[optionName] === choiceValue;
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const choiceKey = choice.key || choiceValue;
+    const isSelected = selectedChoices[optionKey] === choiceKey;
     // Check if this choice is available based on current selections
-    const isVisible = variantService.isChoiceAvailable(optionName, choiceValue);
+    const isVisible = variantService.isChoiceAvailable(optionKey, choiceKey);
     // Check if this choice results in an in-stock variant
-    const isInStock = variantService.isChoiceInStock(optionName, choiceValue);
+    const isInStock = variantService.isChoiceInStock(optionKey, choiceKey);
     // Check if this choice is available for pre-order
-    const isPreOrderEnabled = variantService.isChoicePreOrderEnabled(optionName, choiceValue);
-    const value = choiceValue;
+    const isPreOrderEnabled = variantService.isChoicePreOrderEnabled(optionKey, choiceKey);
+    const valueKey = choiceKey;
     const select = () => {
         const newChoices = {
             ...selectedChoices,
-            [optionName]: choiceValue,
+            [optionKey]: choiceKey,
         };
         variantService.setSelectedChoices(newChoices);
     };
     return props.children({
-        value,
+        value: choiceValue,
+        valueKey,
         isSelected,
         isVisible,
         isInStock,
         isPreOrderEnabled,
         select,
         optionName,
+        optionKey,
         choiceValue,
     });
 }
@@ -230,8 +239,8 @@ export function Stock(props) {
     const selectedQuantity = variantService.selectedQuantity.get();
     // Return raw availability status - UI components will handle display conversion
     const availabilityStatus = inStock
-        ? InventoryAvailabilityStatus.IN_STOCK
-        : InventoryAvailabilityStatus.OUT_OF_STOCK;
+        ? productsV3.InventoryAvailabilityStatus.IN_STOCK
+        : productsV3.InventoryAvailabilityStatus.OUT_OF_STOCK;
     const incrementQuantity = () => {
         variantService.incrementQuantity();
     };

package/cjs/dist/services/buy-now-service.js

@@ -1,7 +1,7 @@
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
 import { getCheckoutUrlForProduct } from '../utils/index.js';
-import { getProductBySlug } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 /**
  * Service definition for the Buy Now service.
  * This defines the reactive API contract for managing buy now functionality.
@@ -136,7 +136,7 @@ export const BuyNowServiceImplementation = implementService.withConfig()(BuyNowS
  * ```
  */
 export const loadBuyNowServiceInitialData = async (productSlug, variantId) => {
-    const res = await getProductBySlug(productSlug, {
+    const res = await productsV3.getProductBySlug(productSlug, {
         fields: ['CURRENCY'],
     });
     const product = res.product;

package/cjs/dist/services/product-modifiers-service.d.ts

@@ -1,6 +1,6 @@
 import { type ServiceFactoryConfig } from '@wix/services-definitions';
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface ModifierValue {
     modifierName: string;
     choiceValue?: string;

package/cjs/dist/services/product-modifiers-service.js

@@ -1,6 +1,6 @@
 import { defineService, implementService, } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { ProductServiceDefinition } from './product-service.js';
 export const ProductModifiersServiceDefinition = defineService('productModifiers');
 export const ProductModifiersService = implementService.withConfig()(ProductModifiersServiceDefinition, ({ getService }) => {

package/cjs/dist/services/product-service.d.ts

@@ -1,4 +1,4 @@
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { type Signal } from '@wix/services-definitions/core-services/signals';
 /**
  * API interface for the Product service, providing reactive product data management.

package/cjs/dist/services/product-service.js

@@ -1,4 +1,4 @@
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
 import { analytics } from '@wix/site';

package/cjs/dist/services/selected-variant-service.d.ts

@@ -1,5 +1,5 @@
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface SelectedVariantServiceAPI {
     selectedQuantity: Signal<number>;
     selectedChoices: Signal<Record<string, string>>;
@@ -39,15 +39,15 @@ export interface SelectedVariantServiceAPI {
     decrementQuantity: () => void;
     selectVariantById: (id: string) => void;
     resetSelections: () => void;
-    getAvailableChoicesForOption: (optionName: string) => string[];
-    getChoiceInfo: (optionName: string, choiceValue: string) => {
+    getAvailableChoicesForOption: (optionKey: string) => string[];
+    getChoiceInfo: (optionKey: string, choiceValue: string) => {
         isAvailable: boolean;
         isInStock: boolean;
         isPreOrderEnabled: boolean;
     };
-    isChoiceAvailable: (optionName: string, choiceValue: string) => boolean;
-    isChoiceInStock: (optionName: string, choiceValue: string) => boolean;
-    isChoicePreOrderEnabled: (optionName: string, choiceValue: string) => boolean;
+    isChoiceAvailable: (optionKey: string, choiceValue: string) => boolean;
+    isChoiceInStock: (optionKey: string, choiceValue: string) => boolean;
+    isChoicePreOrderEnabled: (optionKey: string, choiceValue: string) => boolean;
     hasAnySelections: () => boolean;
     IsAllVariantsAreOutOfStock: () => boolean;
 }

package/cjs/dist/services/selected-variant-service.js

@@ -1,7 +1,6 @@
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
-import * as inventoryItemsV3 from '@wix/auto_sdk_stores_inventory-items-v-3';
+import { inventoryItemsV3, productsV3 } from '@wix/stores';
 import { CurrentCartServiceDefinition } from '@wix/headless-ecom/services';
 import { MediaGalleryServiceDefinition } from '@wix/headless-media/services';
 import { ProductServiceDefinition } from './product-service.js';
@@ -202,8 +201,8 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
             if (Object.keys(choices).length !==
                 Object.keys(variantChoices).length)
                 return false;
-            return Object.entries(choices).every(([optionName, optionValue]) => {
-                return variantChoices[optionName] === optionValue;
+            return Object.entries(choices).every(([optionKey, optionValue]) => {
+                return variantChoices[optionKey] === optionValue;
             });
         }) || null);
     }));
@@ -410,7 +409,7 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
         selectedQuantity.set(newQuantity);
     };
     // New methods for smart variant selection
-    const getAvailableChoicesForOption = (optionName) => {
+    const getAvailableChoicesForOption = (optionKey) => {
         const currentChoices = selectedChoices.get();
         const variantsList = variants.get();
         // Get all possible choices for this option that result in valid variants
@@ -419,21 +418,21 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
             const variantChoices = processVariantChoices(variant);
             // Check if this variant matches all currently selected choices (except for the option we're checking)
             const matchesOtherChoices = Object.entries(currentChoices)
-                .filter(([key]) => key !== optionName)
+                .filter(([key]) => key !== optionKey)
                 .every(([key, value]) => variantChoices[key] === value);
-            if (matchesOtherChoices && variantChoices[optionName]) {
-                availableChoices.add(variantChoices[optionName]);
+            if (matchesOtherChoices && variantChoices[optionKey]) {
+                availableChoices.add(variantChoices[optionKey]);
             }
         });
         return Array.from(availableChoices);
     };
     // Core method that provides both availability and stock info efficiently
-    const getChoiceInfo = (optionName, choiceValue) => {
+    const getChoiceInfo = (optionKey, choiceValue) => {
         // Create hypothetical choices with this choice selected
         const currentChoices = selectedChoices.get();
         const hypotheticalChoices = {
             ...currentChoices,
-            [optionName]: choiceValue,
+            [optionKey]: choiceValue,
         };
         // Get all variants and find one that matches these choices
         const variantsList = variants.get();
@@ -459,14 +458,14 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
         return { isAvailable, isInStock, isPreOrderEnabled };
     };
     // Simplified methods using the core getChoiceInfo
-    const isChoiceAvailable = (optionName, choiceValue) => {
-        return getChoiceInfo(optionName, choiceValue).isAvailable;
+    const isChoiceAvailable = (optionKey, choiceValue) => {
+        return getChoiceInfo(optionKey, choiceValue).isAvailable;
     };
-    const isChoiceInStock = (optionName, choiceValue) => {
-        return getChoiceInfo(optionName, choiceValue).isInStock;
+    const isChoiceInStock = (optionKey, choiceValue) => {
+        return getChoiceInfo(optionKey, choiceValue).isInStock;
     };
-    const isChoicePreOrderEnabled = (optionName, choiceValue) => {
-        return getChoiceInfo(optionName, choiceValue).isPreOrderEnabled;
+    const isChoicePreOrderEnabled = (optionKey, choiceValue) => {
+        return getChoiceInfo(optionKey, choiceValue).isPreOrderEnabled;
     };
     const hasAnySelections = () => {
         const currentChoices = selectedChoices.get();

package/dist/react/Option.d.ts

@@ -2,6 +2,7 @@ import React from 'react';
 import { AsChildChildren } from '@wix/headless-utils/react';
 export interface Option {
     name: string;
+    key?: string;
     choices?: any[];
     hasChoices?: boolean;
     type?: string;

package/dist/react/Product.d.ts

@@ -1,4 +1,4 @@
-import type { V3Product } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { AsChildChildren } from '@wix/headless-utils/react';
 import React from 'react';
 import { AsContent } from './types.js';
@@ -37,7 +37,7 @@ export type StockStatus = BasicStockStatus | 'can-pre-order';
  */
 export interface ProductRootProps {
     children: React.ReactNode;
-    product: V3Product;
+    product: productsV3.V3Product;
     selectedVariant?: any;
 }
 /**
@@ -268,7 +268,7 @@ export interface RawProps {
     asChild?: boolean;
     /** Custom render function when using asChild */
     children?: AsChildChildren<{
-        product: V3Product;
+        product: productsV3.V3Product;
     }>;
     /** CSS classes to apply to the default element */
     className?: string;

package/dist/react/Product.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { InventoryAvailabilityStatus } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { Quantity as QuantityComponent } from '@wix/headless-components/react';
 import { Commerce } from '@wix/headless-ecom/react';
 import { MediaGallery } from '@wix/headless-media/react';
@@ -406,15 +406,15 @@ export const Stock = React.forwardRef((props, ref) => {
             let status;
             let label;
             switch (availabilityStatus) {
-                case InventoryAvailabilityStatus.IN_STOCK:
+                case productsV3.InventoryAvailabilityStatus.IN_STOCK:
                     status = 'in-stock';
                     label = finalLabels.inStock;
                     break;
-                case InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
+                case productsV3.InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
                     status = 'limited-stock';
                     label = finalLabels.limitedStock;
                     break;
-                case InventoryAvailabilityStatus.OUT_OF_STOCK:
+                case productsV3.InventoryAvailabilityStatus.OUT_OF_STOCK:
                 default:
                     status = 'out-of-stock';
                     label = finalLabels.outOfStock;
@@ -1046,12 +1046,12 @@ function getStockStatusMessage(inStock, isPreOrderEnabled, availabilityStatus, l
     // Handle stock status based on availability
     if (inStock) {
         switch (availabilityStatus) {
-            case InventoryAvailabilityStatus.IN_STOCK:
+            case productsV3.InventoryAvailabilityStatus.IN_STOCK:
                 return {
                     status: 'in-stock',
                     label: labels.inStock,
                 };
-            case InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
+            case productsV3.InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
                 return {
                     status: 'limited-stock',
                     label: labels.limitedStock,

package/dist/react/ProductList.d.ts

@@ -1,4 +1,3 @@
-import type { V3Product } from '@wix/auto_sdk_stores_products-v-3';
 import { Sort as SortPrimitive, GenericListTotalsRenderProps, GenericListLoadMoreRenderProps, ListVariant, GenericListRepeaterRenderProps } from '@wix/headless-components/react';
 import React from 'react';
 import type { ProductsListServiceConfig } from '../services/products-list-service.js';
@@ -9,7 +8,7 @@ import { AsChildChildren } from '@wix/headless-utils/react';
  */
 export interface ProductListRootProps {
     children: React.ReactNode;
-    products?: V3Product[];
+    products?: productsV3.V3Product[];
     productsListConfig?: ProductsListServiceConfig;
     className?: string;
     variant?: ListVariant;
@@ -95,7 +94,7 @@ export declare const Products: React.ForwardRefExoticComponent<ProductsProps & R
 /**
  * Render props for ProductRepeater asChild pattern
  */
-export type ProductRepeaterRenderProps = GenericListRepeaterRenderProps<V3Product>;
+export type ProductRepeaterRenderProps = GenericListRepeaterRenderProps<productsV3.V3Product>;
 /**
  * Props for ProductList ProductRepeater component
  */

package/dist/react/core/Product.d.ts

@@ -1,5 +1,5 @@
 import { ProductServiceConfig } from '../../services/product-service.js';
-import type { V3Product, ProductMedia } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface RootProps {
     children: React.ReactNode;
     productServiceConfig: ProductServiceConfig;
@@ -81,18 +81,18 @@ export interface ProductDescriptionProps {
  */
 export interface ProductDescriptionRenderProps {
     /** Product description using the RICOS (Rich Content Object) format. See https://dev.wix.com/docs/ricos/api-reference/ricos-document */
-    description: NonNullable<V3Product['description']>;
+    description: NonNullable<productsV3.V3Product['description']>;
     /** Product description with plain html */
-    plainDescription: NonNullable<V3Product['plainDescription']>;
+    plainDescription: NonNullable<productsV3.V3Product['plainDescription']>;
 }
 /**
  * Render props for ProductDescription component
  */
 export interface ProductDescriptionRenderProps {
     /** Product description using the RICOS (Rich Content Object) format. See https://dev.wix.com/docs/ricos/api-reference/ricos-document */
-    description: NonNullable<V3Product['description']>;
+    description: NonNullable<productsV3.V3Product['description']>;
     /** Product description with plain html */
-    plainDescription: NonNullable<V3Product['plainDescription']>;
+    plainDescription: NonNullable<productsV3.V3Product['plainDescription']>;
 }
 /**
  * Headless component for product description display
@@ -129,15 +129,15 @@ export interface ProductMediaProps {
     children: (props: ProductMediaRenderProps) => React.ReactNode;
 }
 export interface ProductMediaRenderProps {
-    mediaItems: ProductMedia[];
-    mainMedia?: ProductMedia;
+    mediaItems: productsV3.ProductMedia[];
+    mainMedia?: productsV3.ProductMedia;
 }
 export declare function Media(props: ProductMediaProps): import("react").ReactNode;
 export interface ProductProps {
     children: (props: ProductRenderProps) => React.ReactNode;
 }
 export interface ProductRenderProps {
-    product: V3Product;
+    product: productsV3.V3Product;
 }
 export declare function Content(props: ProductProps): import("react").ReactNode;
 export interface LoadingProps {

package/dist/react/core/ProductModifiers.d.ts

@@ -1,4 +1,4 @@
-import { type ConnectedModifier, type ConnectedModifierChoice } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface RootProps {
     children: React.ReactNode;
 }
@@ -89,7 +89,7 @@ export interface ModifiersProps {
  */
 export interface ModifiersRenderProps {
     /** Array of product modifiers */
-    modifiers: ConnectedModifier[];
+    modifiers: productsV3.ConnectedModifier[];
     /** Whether product has modifiers */
     hasModifiers: boolean;
     /** Currently selected modifier values */
@@ -148,7 +148,7 @@ export declare function Modifiers(props: ModifiersProps): import("react").ReactN
  */
 export interface ModifierProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Render prop function that receives modifier data */
     children: (props: ModifierRenderProps) => React.ReactNode;
 }
@@ -156,14 +156,16 @@ export interface ModifierProps {
  * Render props for Modifier component
  */
 export interface ModifierRenderProps {
-    /** Modifier name */
+    /** Modifier name (may be translated) */
     name: string;
+    /** Modifier key (unique identifier) */
+    key: string;
     /** Modifier type */
     type: any;
     /** Whether this modifier is mandatory */
     mandatory: boolean;
     /** Array of choices for this modifier (for choice-based modifiers) */
-    choices: ConnectedModifierChoice[];
+    choices: productsV3.ConnectedModifierChoice[];
     /** Currently selected value for this modifier */
     selectedValue: any;
     /** Whether this modifier has choices */
@@ -227,9 +229,9 @@ export declare function Modifier(props: ModifierProps): import("react").ReactNod
  */
 export interface ChoiceProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Choice data */
-    choice: ConnectedModifierChoice;
+    choice: productsV3.ConnectedModifierChoice;
     /** Render prop function that receives choice data */
     children: (props: ChoiceRenderProps) => React.ReactNode;
 }
@@ -288,7 +290,7 @@ export declare function Choice(props: ChoiceProps): import("react").ReactNode;
  */
 export interface FreeTextProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Render prop function that receives free text data */
     children: (props: FreeTextRenderProps) => React.ReactNode;
 }
@@ -354,7 +356,7 @@ export declare function FreeText(props: FreeTextProps): import("react").ReactNod
  */
 export interface ToggleFreeTextProps {
     /** Product modifier data */
-    modifier: ConnectedModifier;
+    modifier: productsV3.ConnectedModifier;
     /** Render prop function that receives toggle data */
     children: (props: ToggleFreeTextRenderProps) => React.ReactNode;
 }

package/dist/react/core/ProductModifiers.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useState } from 'react';
 import { useService, WixServices } from '@wix/services-manager-react';
 import { ProductModifiersServiceDefinition, ProductModifiersService, } from '../../services/product-modifiers-service.js';
-import { ModifierRenderType, } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { createServicesMap } from '@wix/services-manager';
 /**
  * Root component that provides the ProductModifiers service context to its children.
@@ -208,17 +208,20 @@ export function Modifier(props) {
     const modifiersService = useModifiersService();
     const { modifier } = props;
     const name = modifier.name || '';
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const key = modifier.key || name;
     const type = modifier.modifierRenderType;
     const mandatory = modifier.mandatory || false;
     const choices = modifier.choicesSettings?.choices || [];
     const hasChoices = choices.length > 0;
-    const isFreeText = type === ModifierRenderType.FREE_TEXT;
+    const isFreeText = type === productsV3.ModifierRenderType.FREE_TEXT;
     const freeTextSettings = modifier.freeTextSettings;
     const maxChars = freeTextSettings?.maxLength;
     const placeholder = freeTextSettings?.placeholder;
     const selectedValue = modifiersService?.selectedModifiers.get()[name] || null;
     return props.children({
         name,
+        key,
         type,
         mandatory,
         choices,
@@ -265,7 +268,7 @@ export function Choice(props) {
     const modifierName = modifier.name || '';
     const renderType = modifier.modifierRenderType;
     // For TEXT_CHOICES, use choice.key; for SWATCH_CHOICES, use choice.name
-    const choiceValue = renderType === ModifierRenderType.TEXT_CHOICES
+    const choiceValue = renderType === productsV3.ModifierRenderType.TEXT_CHOICES
         ? choice.key || choice.name || ''
         : choice.name || '';
     const value = choice.name || ''; // Display name is always choice.name

package/dist/react/core/ProductVariantSelector.d.ts

@@ -1,5 +1,5 @@
 import { SelectedVariantServiceConfig } from '../../services/selected-variant-service.js';
-import { type ConnectedOption, type ConnectedOptionChoice, InventoryAvailabilityStatus } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface RootProps {
     children: React.ReactNode;
     selectedVariantServiceConfig?: SelectedVariantServiceConfig;
@@ -55,7 +55,7 @@ export interface OptionsProps {
  */
 export interface OptionsRenderProps {
     /** Array of product options */
-    options: ConnectedOption[];
+    options: productsV3.ConnectedOption[];
     /** Whether product has options */
     hasOptions: boolean;
     /** Currently selected choices */
@@ -99,7 +99,7 @@ export declare function Options(props: OptionsProps): import("react").ReactNode;
  */
 export interface OptionProps {
     /** Product option data */
-    option: ConnectedOption;
+    option: productsV3.ConnectedOption;
     /** Render prop function that receives option data */
     children: (props: OptionRenderProps) => React.ReactNode;
 }
@@ -107,10 +107,12 @@ export interface OptionProps {
  * Render props for Option component
  */
 export interface OptionRenderProps {
-    /** Option name */
+    /** Option name (may be translated) */
     name: string;
+    /** Option key (unique identifier) */
+    key: string;
     /** Array of choices for this option */
-    choices: ConnectedOptionChoice[];
+    choices: productsV3.ConnectedOptionChoice[];
     /** Currently selected value for this option */
     selectedValue: string | null;
     /** Whether this option has choices */
@@ -153,9 +155,9 @@ export declare function Option(props: OptionProps): import("react").ReactNode;
  */
 export interface ChoiceProps {
     /** Product option data */
-    option: ConnectedOption;
+    option: productsV3.ConnectedOption;
     /** Choice data */
-    choice: ConnectedOptionChoice;
+    choice: productsV3.ConnectedOptionChoice;
     /** Render prop function that receives choice data */
     children: (props: ChoiceRenderProps) => React.ReactNode;
 }
@@ -165,6 +167,8 @@ export interface ChoiceProps {
 export interface ChoiceRenderProps {
     /** Choice value to display */
     value: string;
+    /** Choice key (unique identifier) */
+    valueKey: string;
     /** Whether this choice is currently selected */
     isSelected: boolean;
     /** Whether this choice is visible */
@@ -175,8 +179,10 @@ export interface ChoiceRenderProps {
     isPreOrderEnabled: boolean;
     /** Function to select this choice */
     select: () => void;
-    /** Option name */
+    /** Option name (may be translated) */
     optionName: string;
+    /** Option key (unique identifier) */
+    optionKey: string;
     /** Choice value */
     choiceValue: string;
 }
@@ -223,7 +229,7 @@ export interface StockRenderProps {
     /** Whether pre-order is enabled */
     isPreOrderEnabled: boolean;
     /** Raw inventory availability status */
-    availabilityStatus: InventoryAvailabilityStatus | string;
+    availabilityStatus: productsV3.InventoryAvailabilityStatus | string;
     /** Whether stock tracking is enabled */
     trackInventory: boolean;
     /** Current variant id */

package/dist/react/core/ProductVariantSelector.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useService, WixServices } from '@wix/services-manager-react';
 import { SelectedVariantServiceDefinition, SelectedVariantService, } from '../../services/selected-variant-service.js';
 import { createServicesMap } from '@wix/services-manager';
-import { InventoryAvailabilityStatus, } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 /**
  * Root component that provides the ProductVariantSelector service context to its children.
  * This component sets up the necessary services for rendering and managing product variant selection.
@@ -122,10 +122,13 @@ export function Option(props) {
     const selectedChoices = variantService.selectedChoices.get();
     const { option } = props;
     const name = option.name || '';
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const key = option.key || name;
     const choices = option.choicesSettings?.choices || [];
     const selectedValue = selectedChoices[name] || null;
     return props.children({
         name,
+        key,
         choices,
         selectedValue,
         hasChoices: choices.length > 0,
@@ -162,30 +165,36 @@ export function Choice(props) {
     const selectedChoices = variantService.selectedChoices.get();
     const { option, choice } = props;
     const optionName = option.name || '';
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const optionKey = option.key || optionName;
     const choiceValue = choice.name || '';
-    const isSelected = selectedChoices[optionName] === choiceValue;
+    // @ts-expect-error - This field is currently INTERNAL but will be public in the future
+    const choiceKey = choice.key || choiceValue;
+    const isSelected = selectedChoices[optionKey] === choiceKey;
     // Check if this choice is available based on current selections
-    const isVisible = variantService.isChoiceAvailable(optionName, choiceValue);
+    const isVisible = variantService.isChoiceAvailable(optionKey, choiceKey);
     // Check if this choice results in an in-stock variant
-    const isInStock = variantService.isChoiceInStock(optionName, choiceValue);
+    const isInStock = variantService.isChoiceInStock(optionKey, choiceKey);
     // Check if this choice is available for pre-order
-    const isPreOrderEnabled = variantService.isChoicePreOrderEnabled(optionName, choiceValue);
-    const value = choiceValue;
+    const isPreOrderEnabled = variantService.isChoicePreOrderEnabled(optionKey, choiceKey);
+    const valueKey = choiceKey;
     const select = () => {
         const newChoices = {
             ...selectedChoices,
-            [optionName]: choiceValue,
+            [optionKey]: choiceKey,
         };
         variantService.setSelectedChoices(newChoices);
     };
     return props.children({
-        value,
+        value: choiceValue,
+        valueKey,
         isSelected,
         isVisible,
         isInStock,
         isPreOrderEnabled,
         select,
         optionName,
+        optionKey,
         choiceValue,
     });
 }
@@ -230,8 +239,8 @@ export function Stock(props) {
     const selectedQuantity = variantService.selectedQuantity.get();
     // Return raw availability status - UI components will handle display conversion
     const availabilityStatus = inStock
-        ? InventoryAvailabilityStatus.IN_STOCK
-        : InventoryAvailabilityStatus.OUT_OF_STOCK;
+        ? productsV3.InventoryAvailabilityStatus.IN_STOCK
+        : productsV3.InventoryAvailabilityStatus.OUT_OF_STOCK;
     const incrementQuantity = () => {
         variantService.incrementQuantity();
     };

package/dist/services/buy-now-service.js

@@ -1,7 +1,7 @@
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
 import { getCheckoutUrlForProduct } from '../utils/index.js';
-import { getProductBySlug } from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 /**
  * Service definition for the Buy Now service.
  * This defines the reactive API contract for managing buy now functionality.
@@ -136,7 +136,7 @@ export const BuyNowServiceImplementation = implementService.withConfig()(BuyNowS
  * ```
  */
 export const loadBuyNowServiceInitialData = async (productSlug, variantId) => {
-    const res = await getProductBySlug(productSlug, {
+    const res = await productsV3.getProductBySlug(productSlug, {
         fields: ['CURRENCY'],
     });
     const product = res.product;

package/dist/services/product-modifiers-service.d.ts

@@ -1,6 +1,6 @@
 import { type ServiceFactoryConfig } from '@wix/services-definitions';
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface ModifierValue {
     modifierName: string;
     choiceValue?: string;

package/dist/services/product-modifiers-service.js

@@ -1,6 +1,6 @@
 import { defineService, implementService, } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { ProductServiceDefinition } from './product-service.js';
 export const ProductModifiersServiceDefinition = defineService('productModifiers');
 export const ProductModifiersService = implementService.withConfig()(ProductModifiersServiceDefinition, ({ getService }) => {

package/dist/services/product-service.d.ts

@@ -1,4 +1,4 @@
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { type Signal } from '@wix/services-definitions/core-services/signals';
 /**
  * API interface for the Product service, providing reactive product data management.

package/dist/services/product-service.js

@@ -1,4 +1,4 @@
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
 import { analytics } from '@wix/site';

package/dist/services/selected-variant-service.d.ts

@@ -1,5 +1,5 @@
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
+import { productsV3 } from '@wix/stores';
 export interface SelectedVariantServiceAPI {
     selectedQuantity: Signal<number>;
     selectedChoices: Signal<Record<string, string>>;
@@ -39,15 +39,15 @@ export interface SelectedVariantServiceAPI {
     decrementQuantity: () => void;
     selectVariantById: (id: string) => void;
     resetSelections: () => void;
-    getAvailableChoicesForOption: (optionName: string) => string[];
-    getChoiceInfo: (optionName: string, choiceValue: string) => {
+    getAvailableChoicesForOption: (optionKey: string) => string[];
+    getChoiceInfo: (optionKey: string, choiceValue: string) => {
         isAvailable: boolean;
         isInStock: boolean;
         isPreOrderEnabled: boolean;
     };
-    isChoiceAvailable: (optionName: string, choiceValue: string) => boolean;
-    isChoiceInStock: (optionName: string, choiceValue: string) => boolean;
-    isChoicePreOrderEnabled: (optionName: string, choiceValue: string) => boolean;
+    isChoiceAvailable: (optionKey: string, choiceValue: string) => boolean;
+    isChoiceInStock: (optionKey: string, choiceValue: string) => boolean;
+    isChoicePreOrderEnabled: (optionKey: string, choiceValue: string) => boolean;
     hasAnySelections: () => boolean;
     IsAllVariantsAreOutOfStock: () => boolean;
 }

package/dist/services/selected-variant-service.js

@@ -1,7 +1,6 @@
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-import * as productsV3 from '@wix/auto_sdk_stores_products-v-3';
-import * as inventoryItemsV3 from '@wix/auto_sdk_stores_inventory-items-v-3';
+import { inventoryItemsV3, productsV3 } from '@wix/stores';
 import { CurrentCartServiceDefinition } from '@wix/headless-ecom/services';
 import { MediaGalleryServiceDefinition } from '@wix/headless-media/services';
 import { ProductServiceDefinition } from './product-service.js';
@@ -202,8 +201,8 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
             if (Object.keys(choices).length !==
                 Object.keys(variantChoices).length)
                 return false;
-            return Object.entries(choices).every(([optionName, optionValue]) => {
-                return variantChoices[optionName] === optionValue;
+            return Object.entries(choices).every(([optionKey, optionValue]) => {
+                return variantChoices[optionKey] === optionValue;
             });
         }) || null);
     }));
@@ -410,7 +409,7 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
         selectedQuantity.set(newQuantity);
     };
     // New methods for smart variant selection
-    const getAvailableChoicesForOption = (optionName) => {
+    const getAvailableChoicesForOption = (optionKey) => {
         const currentChoices = selectedChoices.get();
         const variantsList = variants.get();
         // Get all possible choices for this option that result in valid variants
@@ -419,21 +418,21 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
             const variantChoices = processVariantChoices(variant);
             // Check if this variant matches all currently selected choices (except for the option we're checking)
             const matchesOtherChoices = Object.entries(currentChoices)
-                .filter(([key]) => key !== optionName)
+                .filter(([key]) => key !== optionKey)
                 .every(([key, value]) => variantChoices[key] === value);
-            if (matchesOtherChoices && variantChoices[optionName]) {
-                availableChoices.add(variantChoices[optionName]);
+            if (matchesOtherChoices && variantChoices[optionKey]) {
+                availableChoices.add(variantChoices[optionKey]);
             }
         });
         return Array.from(availableChoices);
     };
     // Core method that provides both availability and stock info efficiently
-    const getChoiceInfo = (optionName, choiceValue) => {
+    const getChoiceInfo = (optionKey, choiceValue) => {
         // Create hypothetical choices with this choice selected
         const currentChoices = selectedChoices.get();
         const hypotheticalChoices = {
             ...currentChoices,
-            [optionName]: choiceValue,
+            [optionKey]: choiceValue,
         };
         // Get all variants and find one that matches these choices
         const variantsList = variants.get();
@@ -459,14 +458,14 @@ export const SelectedVariantService = implementService.withConfig()(SelectedVari
         return { isAvailable, isInStock, isPreOrderEnabled };
     };
     // Simplified methods using the core getChoiceInfo
-    const isChoiceAvailable = (optionName, choiceValue) => {
-        return getChoiceInfo(optionName, choiceValue).isAvailable;
+    const isChoiceAvailable = (optionKey, choiceValue) => {
+        return getChoiceInfo(optionKey, choiceValue).isAvailable;
     };
-    const isChoiceInStock = (optionName, choiceValue) => {
-        return getChoiceInfo(optionName, choiceValue).isInStock;
+    const isChoiceInStock = (optionKey, choiceValue) => {
+        return getChoiceInfo(optionKey, choiceValue).isInStock;
     };
-    const isChoicePreOrderEnabled = (optionName, choiceValue) => {
-        return getChoiceInfo(optionName, choiceValue).isPreOrderEnabled;
+    const isChoicePreOrderEnabled = (optionKey, choiceValue) => {
+        return getChoiceInfo(optionKey, choiceValue).isPreOrderEnabled;
     };
     const hasAnySelections = () => {
         const currentChoices = selectedChoices.get();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-stores",
-  "version": "0.0.105",
+  "version": "0.0.107",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -50,7 +50,7 @@
     "@vitest/ui": "^3.1.4",
     "@wix/categories": "^1.0.133",
     "@wix/headless-components": "0.0.0",
-    "@wix/stores": "^1.0.551",
+    "@wix/stores": "^1.0.606",
     "jsdom": "^26.1.0",
     "prettier": "^3.4.2",
     "typescript": "^5.8.3",
@@ -60,11 +60,7 @@
     "@radix-ui/react-slot": "^1.2.3",
     "@wix/auto_sdk_bookings_availability-calendar": "^1.0.155",
     "@wix/auto_sdk_categories_categories": "^1.0.62",
-    "@wix/auto_sdk_stores_customizations-v-3": "^1.0.26",
-    "@wix/auto_sdk_stores_inventory-items-v-3": "^1.0.26",
-    "@wix/auto_sdk_stores_products-v-3": "^1.0.53",
-    "@wix/auto_sdk_stores_read-only-variants-v-3": "^1.0.23",
-    "@wix/ecom": "^1.0.1461",
+    "@wix/ecom": "^1.0.1560",
     "@wix/essentials": "^0.1.24",
     "@wix/headless-ecom": "0.0.38",
     "@wix/headless-media": "0.0.18",
@@ -72,7 +68,8 @@
     "@wix/redirects": "^1.0.83",
     "@wix/services-definitions": "^0.1.4",
     "@wix/services-manager-react": "^0.1.26",
-    "@wix/site": "^1.27.0"
+    "@wix/site": "^1.37.0",
+    "@wix/stores": "^1.0.606"
   },
   "peerDependencies": {
     "@wix/headless-components": "^0.0.0"
@@ -87,5 +84,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "2937c978ada9e33f794daf2161a4f84ffe9ea93141e59938401efb95"
+  "falconPackageHash": "4a62e19798c3f18e7717f4cd36622647f56a785719bee0cba904bc33"
 }