@jay-framework/wix-stores 0.15.4 → 0.15.5

package/dist/actions/get-variant-stock.jay-action

@@ -0,0 +1,7 @@
+name: getVariantStock
+description: Get variant stock availability for a product with color + text options. Returns a map of colorChoiceId -> textChoiceId -> inStock.
+
+inputSchema:
+  productId: string
+
+outputSchema: record(record(boolean))

package/dist/actions/search-products.jay-action

@@ -11,6 +11,9 @@ inputSchema:
     minPrice?: number
     maxPrice?: number
     categoryIds?: string[]
+    optionFilters?:
+      - optionName: string
+        choiceNames: string[]
   sortBy?: enum(relevance | price_asc | price_desc | name_asc | name_desc | newest)
   cursor?: string
   pageSize?: number
@@ -31,3 +34,12 @@ outputSchema:
         maxValue?: number
         productCount: number
         isSelected: boolean
+  optionFilters?:
+    - optionId: string
+      optionName: string
+      optionRenderType: enum(TEXT_CHOICES | SWATCH_CHOICES)
+      choices:
+        - choiceId: string
+          choiceName: string
+          colorCode: string
+          productCount: number

package/dist/contracts/product-search.jay-contract

@@ -180,7 +180,69 @@ tags:
         dataType: boolean
         elementType: HTMLInputElement
         description: Show only in-stock products checkbox
-        
+
+      # Option-based filters (e.g., Color, Size)
+      - tag: optionFilters
+        type: sub-contract
+        repeated: true
+        trackBy: optionId
+        phase: fast+interactive
+        description: Filter by product options (e.g., Color, Size)
+        tags:
+          - tag: optionId
+            type: data
+            dataType: string
+            description: Customization ID
+
+          - tag: optionName
+            type: data
+            dataType: string
+            description: Option display name (e.g., Color, Size)
+
+          - tag: optionRenderType
+            type: variant
+            dataType: enum (TEXT_CHOICES | SWATCH_CHOICES)
+            description: How to render the option choices
+
+          - tag: choices
+            type: sub-contract
+            repeated: true
+            trackBy: choiceId
+            description: Available choices for this option
+            tags:
+              - tag: choiceId
+                type: data
+                dataType: string
+                description: Choice ID
+
+              - tag: choiceName
+                type: data
+                dataType: string
+                description: Choice display name (e.g., Red, Large)
+
+              - tag: colorCode
+                type: data
+                dataType: string
+                description: HEX color code (for swatch rendering)
+
+              - tag: productCount
+                type: data
+                dataType: number
+                phase: fast+interactive
+                description: Number of products with this choice in current results
+
+              - tag: isSelected
+                type: [data, interactive]
+                dataType: boolean
+                elementType: HTMLInputElement
+                description: Checkbox to toggle this choice filter
+
+              - tag: isDisabled
+                type: data
+                dataType: boolean
+                phase: fast+interactive
+                description: Whether this choice has no matching products (count=0)
+
       - tag: clearFilters
         type: interactive
         elementType: HTMLButtonElement

package/dist/contracts/product-search.jay-contract.d.ts

@@ -30,10 +30,32 @@ export interface CategoryFilterOfFilterOfProductSearchViewState {
   categories: Array<CategoryOfCategoryFilterOfFilterOfProductSearchViewState>
 }
 
+export enum OptionRenderType {
+  TEXT_CHOICES,
+  SWATCH_CHOICES
+}
+
+export interface ChoiceOfOptionFilterOfFilterOfProductSearchViewState {
+  choiceId: string,
+  choiceName: string,
+  colorCode: string,
+  productCount: number,
+  isSelected: boolean,
+  isDisabled: boolean
+}
+
+export interface OptionFilterOfFilterOfProductSearchViewState {
+  optionId: string,
+  optionName: string,
+  optionRenderType: OptionRenderType,
+  choices: Array<ChoiceOfOptionFilterOfFilterOfProductSearchViewState>
+}
+
 export interface FilterOfProductSearchViewState {
   priceRange: PriceRangeOfFilterOfProductSearchViewState,
   categoryFilter: CategoryFilterOfFilterOfProductSearchViewState,
-  inStockOnly: boolean
+  inStockOnly: boolean,
+  optionFilters: Array<OptionFilterOfFilterOfProductSearchViewState>
 }
 
 export enum CurrentSort {
@@ -141,6 +163,7 @@ export type ProductSearchFastViewState = Pick<ProductSearchViewState, 'searchExp
     categoryFilter: {
     categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
 };
+    optionFilters: Array<ProductSearchViewState['filters']['optionFilters'][number]>;
 };
     sortBy: ProductSearchViewState['sortBy'];
     suggestions: Array<ProductSearchViewState['suggestions'][number]>;
@@ -153,6 +176,7 @@ export type ProductSearchInteractiveViewState = Pick<ProductSearchViewState, 'se
     categoryFilter: {
     categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
 };
+    optionFilters: Array<ProductSearchViewState['filters']['optionFilters'][number]>;
 };
     sortBy: ProductSearchViewState['sortBy'];
     suggestions: Array<ProductSearchViewState['suggestions'][number]>;
@@ -179,6 +203,11 @@ export interface ProductSearchRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {
@@ -210,6 +239,11 @@ export interface ProductSearchRepeatedRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {

package/dist/index.client.js

@@ -313,6 +313,11 @@ function ProductPageInteractive(props, refs, viewStateSignals, fastCarryForward,
   };
 }
 const productPage = makeJayStackComponent().withProps().withContexts(WIX_STORES_CONTEXT).withInteractive(ProductPageInteractive);
+var OptionRenderType = /* @__PURE__ */ ((OptionRenderType2) => {
+  OptionRenderType2[OptionRenderType2["TEXT_CHOICES"] = 0] = "TEXT_CHOICES";
+  OptionRenderType2[OptionRenderType2["SWATCH_CHOICES"] = 1] = "SWATCH_CHOICES";
+  return OptionRenderType2;
+})(OptionRenderType || {});
 var CurrentSort = /* @__PURE__ */ ((CurrentSort2) => {
   CurrentSort2[CurrentSort2["relevance"] = 0] = "relevance";
   CurrentSort2[CurrentSort2["priceAsc"] = 1] = "priceAsc";
@@ -369,6 +374,15 @@ function updateUrlFilters(searchTerm, filters, sort, categories) {
   }
   if (filters.inStockOnly)
     params.set("inStock", "1");
+  const optSegments = [];
+  for (const opt of filters.optionFilters || []) {
+    const selected = opt.choices.filter((c) => c.isSelected).map((c) => encodeURIComponent(c.choiceName));
+    if (selected.length > 0) {
+      optSegments.push(`${encodeURIComponent(opt.optionName)}:${selected.join(",")}`);
+    }
+  }
+  if (optSegments.length > 0)
+    params.set("opt", optSegments.join(";"));
   if (sort !== CurrentSort.relevance) {
     const sortNames = {
       [CurrentSort.priceAsc]: "priceAsc",
@@ -384,6 +398,30 @@ function updateUrlFilters(searchTerm, filters, sort, categories) {
   const query = params.toString();
   window.history.replaceState(null, "", query ? `?${query}` : window.location.pathname);
 }
+function buildOptionFiltersViewState(baseOptionFilters, filteredResult, optionSelections) {
+  const filteredChoiceCounts = /* @__PURE__ */ new Map();
+  for (const opt of filteredResult.optionFilters || []) {
+    for (const ch of opt.choices) {
+      filteredChoiceCounts.set(ch.choiceName.toLowerCase(), ch.productCount);
+    }
+  }
+  return baseOptionFilters.map((opt) => ({
+    optionId: opt.optionId,
+    optionName: opt.optionName,
+    optionRenderType: opt.optionRenderType === "SWATCH_CHOICES" ? OptionRenderType.SWATCH_CHOICES : OptionRenderType.TEXT_CHOICES,
+    choices: opt.choices.map((ch) => {
+      const count = filteredChoiceCounts.get(ch.choiceName.toLowerCase()) ?? 0;
+      return {
+        choiceId: ch.choiceId,
+        choiceName: ch.choiceName,
+        colorCode: ch.colorCode,
+        productCount: count,
+        isSelected: optionSelections.get(opt.optionName)?.has(ch.choiceName) ?? false,
+        isDisabled: count === 0
+      };
+    })
+  }));
+}
 function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForward, storesContext) {
   const baseCategoryId = fastCarryForward.baseCategoryId;
   const variantStockCache = {};
@@ -394,19 +432,41 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
   let debounceTimeout = null;
   let searchVersion = 0;
   const DEBOUNCE_MS = 300;
+  const [latestSearchResult, setLatestSearchResult] = createSignal(null);
+  const mergedFilters = createMemo(() => {
+    const f = filters();
+    const result = latestSearchResult();
+    if (!result)
+      return f;
+    const selections = /* @__PURE__ */ new Map();
+    for (const opt of f.optionFilters || []) {
+      const selected = opt.choices.filter((c) => c.isSelected).map((c) => c.choiceName);
+      if (selected.length > 0)
+        selections.set(opt.optionName, new Set(selected));
+    }
+    return {
+      ...f,
+      optionFilters: buildOptionFiltersViewState(fastCarryForward.baseOptionFilters, result, selections)
+    };
+  });
   const performSearch = async (version, searchTerm, currentFilters, currentSort) => {
     setIsSearching(true);
     setHasSearched(true);
     try {
       const userSelectedCategoryIds = currentFilters.categoryFilter.categories.filter((c) => c.isSelected).map((c) => c.categoryId);
       const categoryIds = baseCategoryId ? [baseCategoryId, ...userSelectedCategoryIds] : userSelectedCategoryIds;
+      const activeOptionFilters = (currentFilters.optionFilters || []).map((opt) => ({
+        optionName: opt.optionName,
+        choiceNames: opt.choices.filter((c) => c.isSelected).map((c) => c.choiceName)
+      })).filter((o) => o.choiceNames.length > 0);
       const result = await searchProducts({
         query: searchTerm || "",
         filters: {
           minPrice: currentFilters.priceRange.minPrice || void 0,
           maxPrice: currentFilters.priceRange.maxPrice || void 0,
           categoryIds,
-          inStockOnly: currentFilters.inStockOnly
+          inStockOnly: currentFilters.inStockOnly,
+          optionFilters: activeOptionFilters.length > 0 ? activeOptionFilters : void 0
         },
         sortBy: mapSortToAction(currentSort),
         // No cursor = start from beginning
@@ -421,6 +481,7 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       setLoadedCount(result.products.length);
       setHasMore(result.hasMore);
       setHasResults(result.products.length > 0);
+      setLatestSearchResult(result);
       currentCursor = result.nextCursor;
       updateUrlFilters(searchTerm, currentFilters, currentSort, fastCarryForward.categories);
     } catch (error) {
@@ -443,13 +504,18 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       const searchTerm = submittedSearchTerm();
       const userSelectedCategoryIds = currentFilters.categoryFilter.categories.filter((c) => c.isSelected).map((c) => c.categoryId);
       const categoryIds = baseCategoryId ? [baseCategoryId, ...userSelectedCategoryIds] : userSelectedCategoryIds;
+      const activeOptionFilters = (currentFilters.optionFilters || []).map((opt) => ({
+        optionName: opt.optionName,
+        choiceNames: opt.choices.filter((c) => c.isSelected).map((c) => c.choiceName)
+      })).filter((o) => o.choiceNames.length > 0);
       const result = await searchProducts({
         query: searchTerm || "",
         filters: {
           minPrice: currentFilters.priceRange.minPrice || void 0,
           maxPrice: currentFilters.priceRange.maxPrice || void 0,
           categoryIds,
-          inStockOnly: currentFilters.inStockOnly
+          inStockOnly: currentFilters.inStockOnly,
+          optionFilters: activeOptionFilters.length > 0 ? activeOptionFilters : void 0
         },
         sortBy: mapSortToAction(currentSort),
         cursor: currentCursor,
@@ -564,6 +630,24 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
     const isChecked = event.target.checked;
     setFilters(patch(filters(), [{ op: REPLACE, path: ["inStockOnly"], value: isChecked }]));
   });
+  refs.filters.optionFilters.choices.isSelected.oninput(({ event, coordinate }) => {
+    const [optionId, choiceId] = coordinate;
+    const currentFilters = filters();
+    const optionIndex = currentFilters.optionFilters.findIndex((o) => o.optionId === optionId);
+    if (optionIndex === -1)
+      return;
+    const choiceIndex = currentFilters.optionFilters[optionIndex].choices.findIndex((c) => c.choiceId === choiceId);
+    if (choiceIndex === -1)
+      return;
+    const isChecked = event.target.checked;
+    setFilters(patch(currentFilters, [
+      {
+        op: REPLACE,
+        path: ["optionFilters", optionIndex, "choices", choiceIndex, "isSelected"],
+        value: isChecked
+      }
+    ]));
+  });
   refs.filters.clearFilters.onclick(() => {
     const currentFilters = filters();
     const clearedCategories = currentFilters.categoryFilter.categories.map((cat) => ({
@@ -575,6 +659,10 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       isSelected: i === 0
       // First one is "Show all"
     }));
+    const clearedOptionFilters = (currentFilters.optionFilters || []).map((opt) => ({
+      ...opt,
+      choices: opt.choices.map((ch) => ({ ...ch, isSelected: false }))
+    }));
     setFilters({
       priceRange: {
         minPrice: 0,
@@ -584,7 +672,8 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
         ranges: clearedRanges
       },
       categoryFilter: { categories: clearedCategories },
-      inStockOnly: false
+      inStockOnly: false,
+      optionFilters: clearedOptionFilters
     });
   });
   refs.loadMoreButton.onclick(() => {
@@ -617,48 +706,48 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       ]));
     }
   });
+  const variantStockLoading = /* @__PURE__ */ new Set();
   const loadVariantStock = async (productId) => {
-    if (variantStockCache[productId])
-      return;
-    const stockMap = await getVariantStock({ productId });
-    variantStockCache[productId] = stockMap;
-    const currentResults = searchResults();
-    const productIndex = currentResults.findIndex((p) => p._id === productId);
-    if (productIndex === -1)
-      return;
-    const product = currentResults[productIndex];
-    if (product.quickAddType !== QuickAddType.COLOR_AND_TEXT_OPTIONS)
+    if (variantStockCache[productId] || variantStockLoading.has(productId))
       return;
-    const selectedColor = product.quickOption?.choices?.find((c) => c.isSelected);
-    const textChoices = product.secondQuickOption?.choices;
-    if (!selectedColor || !textChoices)
-      return;
-    const colorStock = stockMap[selectedColor.choiceId];
-    const updatedTextChoices = textChoices.map((c) => ({
-      ...c,
-      inStock: colorStock?.[c.choiceId] ?? false
-    }));
-    setSearchResults(patch(searchResults(), [
-      {
-        op: REPLACE,
-        path: [productIndex, "secondQuickOption", "choices"],
-        value: updatedTextChoices
-      }
-    ]));
+    variantStockLoading.add(productId);
+    try {
+      const currentResults = searchResults();
+      const productIndex = currentResults.findIndex((p) => p._id === productId);
+      if (productIndex === -1)
+        return;
+      const product = currentResults[productIndex];
+      if (product?.quickAddType !== QuickAddType.COLOR_AND_TEXT_OPTIONS)
+        return;
+      const stockMap = await getVariantStock({ productId });
+      variantStockCache[productId] = stockMap;
+      const selectedColor = product.quickOption?.choices?.find((c) => c.isSelected);
+      const textChoices = product.secondQuickOption?.choices;
+      if (!selectedColor || !textChoices)
+        return;
+      const colorStock = stockMap[selectedColor.choiceId];
+      const updatedTextChoices = textChoices.map((c) => ({
+        ...c,
+        inStock: colorStock?.[c.choiceId] ?? false
+      }));
+      setSearchResults(patch(searchResults(), [
+        {
+          op: REPLACE,
+          path: [productIndex, "secondQuickOption", "choices"],
+          value: updatedTextChoices
+        }
+      ]));
+    } finally {
+      variantStockLoading.delete(productId);
+    }
   };
   refs.searchResults.productLink.onmouseenter(({ coordinate }) => {
     const [productId] = coordinate;
-    const product = searchResults().find((p) => p._id === productId);
-    if (product?.quickAddType === QuickAddType.COLOR_AND_TEXT_OPTIONS) {
-      loadVariantStock(productId);
-    }
+    loadVariantStock(productId);
   });
   refs.searchResults.quickOption.choices.choiceButton.onmouseenter(({ coordinate }) => {
     const [productId] = coordinate;
-    const product = searchResults().find((p) => p._id === productId);
-    if (product?.quickAddType === QuickAddType.COLOR_AND_TEXT_OPTIONS) {
-      loadVariantStock(productId);
-    }
+    loadVariantStock(productId);
   });
   refs.searchResults.quickOption.choices.choiceButton.onclick(async ({ coordinate }) => {
     const [productId, choiceId] = coordinate;
@@ -763,6 +852,10 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       ]));
     }
   });
+  refs.searchResults.secondQuickOption.choices.choiceButton.onmouseenter(({ coordinate }) => {
+    const [productId] = coordinate;
+    loadVariantStock(productId);
+  });
   refs.searchResults.viewOptionsButton.onclick(({ coordinate }) => {
     const [productId] = coordinate;
     const product = searchResults().find((p) => p._id === productId);
@@ -780,7 +873,7 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       hasResults: hasResults(),
       hasSuggestions: hasSuggestions(),
       suggestions: suggestions(),
-      filters: filters(),
+      filters: mergedFilters(),
       sortBy: sortBy(),
       hasMore: hasMore(),
       loadedCount: loadedCount(),

package/dist/index.d.ts

@@ -7,14 +7,14 @@ import * as _jay_framework_runtime from '@jay-framework/runtime';
 import { HTMLElementCollectionProxy, HTMLElementProxy } from '@jay-framework/runtime';
 import { WixClient } from '@wix/sdk';
 import { BuildDescriptors } from '@wix/sdk-types';
-import { productsV3, inventoryItemsV3 } from '@wix/stores';
+import { productsV3, inventoryItemsV3, customizationsV3 } from '@wix/stores';
 import { categories } from '@wix/categories';
-import { currentCart } from '@wix/ecom';
+import { Customization } from '@wix/auto_sdk_stores_customizations-v-3';
 import { Getter } from '@jay-framework/reactive';
 import { OptionChoice } from '@wix/auto_sdk_stores_products-v-3';
 import { PluginSetupContext, PluginSetupResult, PluginReferencesContext, PluginReferencesResult } from '@jay-framework/stack-server-runtime';
 
-declare enum OptionRenderType$1 {
+declare enum OptionRenderType$2 {
   TEXT_CHOICES,
   COLOR_SWATCH_CHOICES
 }
@@ -36,7 +36,7 @@ interface ChoiceOfProductOptionsViewState {
 interface ProductOptionsViewState {
   _id: string,
   name: string,
-  optionRenderType: OptionRenderType$1,
+  optionRenderType: OptionRenderType$2,
   choices: Array<ChoiceOfProductOptionsViewState>
 }
 
@@ -164,10 +164,32 @@ interface CategoryFilterOfFilterOfProductSearchViewState {
   categories: Array<CategoryOfCategoryFilterOfFilterOfProductSearchViewState>
 }
 
+declare enum OptionRenderType$1 {
+  TEXT_CHOICES,
+  SWATCH_CHOICES
+}
+
+interface ChoiceOfOptionFilterOfFilterOfProductSearchViewState {
+  choiceId: string,
+  choiceName: string,
+  colorCode: string,
+  productCount: number,
+  isSelected: boolean,
+  isDisabled: boolean
+}
+
+interface OptionFilterOfFilterOfProductSearchViewState {
+  optionId: string,
+  optionName: string,
+  optionRenderType: OptionRenderType$1,
+  choices: Array<ChoiceOfOptionFilterOfFilterOfProductSearchViewState>
+}
+
 interface FilterOfProductSearchViewState {
   priceRange: PriceRangeOfFilterOfProductSearchViewState,
   categoryFilter: CategoryFilterOfFilterOfProductSearchViewState,
-  inStockOnly: boolean
+  inStockOnly: boolean,
+  optionFilters: Array<OptionFilterOfFilterOfProductSearchViewState>
 }
 
 declare enum CurrentSort {
@@ -275,6 +297,7 @@ type ProductSearchFastViewState = Pick<ProductSearchViewState, 'searchExpression
     categoryFilter: {
     categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
 };
+    optionFilters: Array<ProductSearchViewState['filters']['optionFilters'][number]>;
 };
     sortBy: ProductSearchViewState['sortBy'];
     suggestions: Array<ProductSearchViewState['suggestions'][number]>;
@@ -287,6 +310,7 @@ type ProductSearchInteractiveViewState = Pick<ProductSearchViewState, 'searchExp
     categoryFilter: {
     categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
 };
+    optionFilters: Array<ProductSearchViewState['filters']['optionFilters'][number]>;
 };
     sortBy: ProductSearchViewState['sortBy'];
     suggestions: Array<ProductSearchViewState['suggestions'][number]>;
@@ -313,6 +337,11 @@ interface ProductSearchRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {
@@ -390,14 +419,15 @@ interface WixStoresService {
     products: BuildDescriptors<typeof productsV3, {}>;
     categories: BuildDescriptors<typeof categories, {}>;
     inventory: BuildDescriptors<typeof inventoryItemsV3, {}>;
-    /** @deprecated Use WIX_CART_SERVICE from @jay-framework/wix-cart instead */
-    cart: BuildDescriptors<typeof currentCart, {}>;
+    customizations: BuildDescriptors<typeof customizationsV3, {}>;
     /** URL templates for building canonical links */
     urls: UrlTemplates;
     /** Slug of the fallback category for pages without category context */
     defaultCategory: string | null;
     /** Get the cached category tree. Lazily built on first call. */
     getCategoryTree(): Promise<CategoryTree>;
+    /** Get cached product customizations (options with choices). Lazily loaded. */
+    getCustomizations(): Promise<Customization[]>;
 }
 /**
  * Server service marker for Wix Stores.
@@ -473,6 +503,53 @@ interface WixStoresContext {
  */
 declare const WIX_STORES_CONTEXT: _jay_framework_runtime.ContextMarker<WixStoresContext>;
 
+interface SearchProductsInput {
+  query: string;
+  filters?: {
+    inStockOnly?: boolean;
+    minPrice?: number;
+    maxPrice?: number;
+    categoryIds?: Array<string>;
+    optionFilters?: Array<{
+        optionName: string;
+        choiceNames: Array<string>;
+      }>;
+  };
+  sortBy?: 'relevance' | 'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'newest';
+  cursor?: string;
+  pageSize?: number;
+}
+
+interface SearchProductsOutput {
+  products: Array<ProductCardViewState>;
+  totalCount: number;
+  nextCursor?: string;
+  hasMore: boolean;
+  priceAggregation?: {
+    minBound: number;
+    maxBound: number;
+    ranges: Array<{
+        rangeId: string;
+        label: string;
+        minValue?: number;
+        maxValue?: number;
+        productCount: number;
+        isSelected: boolean;
+      }>;
+  };
+  optionFilters?: Array<{
+      optionId: string;
+      optionName: string;
+      optionRenderType: 'TEXT_CHOICES' | 'SWATCH_CHOICES';
+      choices: Array<{
+          choiceId: string;
+          choiceName: string;
+          colorCode: string;
+          productCount: number;
+        }>;
+    }>;
+}
+
 /**
  * URL parameters for product search routes.
  * Supports: category (prefix slug), subcategory (sub-category slug).
@@ -500,6 +577,10 @@ interface SearchSlowCarryForward {
     categories: CategoryInfos;
     /** Root category ID when scoped to a category prefix (always applied, hidden from UI) */
     baseCategoryId: string | null;
+    /** Pre-loaded product results from slow phase (used when no query params) */
+    preloadedResult: SearchProductsOutput | null;
+    /** Base option filters from unfiltered search (static list, counts updated per search) */
+    baseOptionFilters: SearchProductsOutput['optionFilters'];
 }
 /**
  * Data carried forward from fast rendering to interactive phase
@@ -510,6 +591,8 @@ interface SearchFastCarryForward {
     categories: CategoryInfos;
     /** Root category ID when scoped to a category prefix (always applied, hidden from UI) */
     baseCategoryId: string | null;
+    /** Base option filters from unfiltered search (static list structure) */
+    baseOptionFilters: SearchProductsOutput['optionFilters'];
 }
 declare const productSearch: _jay_framework_fullstack_component.JayStackComponentDefinition<ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState, [SearchSlowCarryForward, WixStoresService], [Signals<ProductSearchFastViewState>, SearchFastCarryForward, WixStoresContext], PageProps & ProductSearchParams, ProductSearchParams, _jay_framework_component.JayComponentCore<PageProps & ProductSearchParams, ProductSearchInteractiveViewState>>;
 
@@ -857,75 +940,6 @@ declare const categoryList: _jay_framework_fullstack_component.JayStackComponent
     withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps, CategoryListRefs, CategoryListInteractiveViewState, [], _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>;
 };
 
-/**
- * Sort options for product search
- */
-type ProductSortField = 'relevance' | 'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'newest';
-/**
- * Product search filters
- */
-interface ProductSearchFilters {
-    /** Only show products in stock */
-    inStockOnly?: boolean;
-    /** Minimum price filter */
-    minPrice?: number;
-    /** Maximum price filter */
-    maxPrice?: number;
-    /** Filter by category IDs */
-    categoryIds?: string[];
-}
-/**
- * Price range bucket for aggregation
- */
-interface PriceRangeBucket {
-    rangeId: string;
-    label: string;
-    minValue: number | null;
-    maxValue: number | null;
-    productCount: number;
-    isSelected: boolean;
-}
-/**
- * Price aggregation data from search
- */
-interface PriceAggregationData {
-    /** Minimum price across all products */
-    minBound: number;
-    /** Maximum price across all products */
-    maxBound: number;
-    /** Price range buckets with product counts */
-    ranges: PriceRangeBucket[];
-}
-/**
- * Input for searchProducts action
- */
-interface SearchProductsInput {
-    /** Search query text */
-    query: string;
-    /** Filters to apply */
-    filters?: ProductSearchFilters;
-    /** Sort order */
-    sortBy?: ProductSortField;
-    /** Cursor for pagination (from previous response's nextCursor) */
-    cursor?: string;
-    /** Items per page (default: 12) */
-    pageSize?: number;
-}
-/**
- * Output for searchProducts action
- */
-interface SearchProductsOutput {
-    /** List of matching products */
-    products: ProductCardViewState[];
-    /** Total number of matching products */
-    totalCount: number;
-    /** Cursor for next page (null if no more results) */
-    nextCursor: string | null;
-    /** Whether there are more results */
-    hasMore: boolean;
-    /** Price aggregation data (bounds and ranges) */
-    priceAggregation?: PriceAggregationData;
-}
 /**
  * Input for getProductBySlug action
  */
@@ -1007,4 +1021,4 @@ declare function setupWixStores(ctx: PluginSetupContext): Promise<PluginSetupRes
  */
 declare function generateWixStoresReferences(ctx: PluginReferencesContext): Promise<PluginReferencesResult>;
 
-export { type CategoryTree, type GetProductBySlugInput, type PriceAggregationData, type PriceRangeBucket, type ProductPageParams, type ProductSearchFilters, type ProductSearchParams, type ProductSortField, type SearchProductsInput, type SearchProductsOutput, type SearchSortOption, WIX_STORES_CONTEXT, WIX_STORES_SERVICE_MARKER, type WixStoresContext, type WixStoresInitData, type WixStoresService, type WixStoresServiceOptions, buildCategoryUrl, buildProductUrl, categoryList, findCategoryImage, findRootCategoryId, findRootCategorySlug, generateWixStoresReferences, getCategories, getProductBySlug, getVariantStock, init, productPage, productSearch, provideWixStoresService, searchProducts, setupWixStores };
+export { type CategoryTree, type GetProductBySlugInput, type ProductPageParams, type ProductSearchParams, type SearchSortOption, WIX_STORES_CONTEXT, WIX_STORES_SERVICE_MARKER, type WixStoresContext, type WixStoresInitData, type WixStoresService, type WixStoresServiceOptions, buildCategoryUrl, buildProductUrl, categoryList, findCategoryImage, findRootCategoryId, findRootCategorySlug, generateWixStoresReferences, getCategories, getProductBySlug, getVariantStock, init, productPage, productSearch, provideWixStoresService, searchProducts, setupWixStores };

package/dist/index.js

@@ -1,7 +1,6 @@
-import { getCurrentCartClient } from "@jay-framework/wix-cart";
 import { WIX_CART_CONTEXT, WIX_CART_SERVICE, cartIndicator, cartPage, provideWixCartContext, provideWixCartService } from "@jay-framework/wix-cart";
 import { createJayService, makeJayQuery, ActionError, makeJayStackComponent, RenderPipeline, makeJayInit } from "@jay-framework/fullstack-component";
-import { inventoryItemsV3, productsV3 } from "@wix/stores";
+import { customizationsV3, inventoryItemsV3, productsV3 } from "@wix/stores";
 import { categories } from "@wix/categories";
 import { registerService, getService } from "@jay-framework/stack-server-runtime";
 import { createJayContext } from "@jay-framework/runtime";
@@ -10,6 +9,11 @@ import { WIX_CLIENT_SERVICE } from "@jay-framework/wix-server-client";
 import * as fs from "fs";
 import * as path from "path";
 import * as yaml from "js-yaml";
+var OptionRenderType$2 = /* @__PURE__ */ ((OptionRenderType2) => {
+  OptionRenderType2[OptionRenderType2["TEXT_CHOICES"] = 0] = "TEXT_CHOICES";
+  OptionRenderType2[OptionRenderType2["SWATCH_CHOICES"] = 1] = "SWATCH_CHOICES";
+  return OptionRenderType2;
+})(OptionRenderType$2 || {});
 var CurrentSort = /* @__PURE__ */ ((CurrentSort2) => {
   CurrentSort2[CurrentSort2["relevance"] = 0] = "relevance";
   CurrentSort2[CurrentSort2["priceAsc"] = 1] = "priceAsc";
@@ -22,7 +26,8 @@ var CurrentSort = /* @__PURE__ */ ((CurrentSort2) => {
 const instances = {
   productsV3ClientInstance: void 0,
   categoriesClientInstance: void 0,
-  inventoryV3ClientInstance: void 0
+  inventoryV3ClientInstance: void 0,
+  customizationsV3ClientInstance: void 0
 };
 function getProductsV3Client(wixClient) {
   if (!instances.productsV3ClientInstance) {
@@ -42,15 +47,23 @@ function getInventoryClient(wixClient) {
   }
   return instances.inventoryV3ClientInstance;
 }
+function getCustomizationsV3Client(wixClient) {
+  if (!instances.customizationsV3ClientInstance) {
+    instances.customizationsV3ClientInstance = wixClient.use(customizationsV3);
+  }
+  return instances.customizationsV3ClientInstance;
+}
 const WIX_STORES_SERVICE_MARKER = createJayService("Wix Store Service");
 function provideWixStoresService(wixClient, options) {
   let cachedTree = null;
+  let cachedCustomizations = null;
   const categoriesClient = getCategoriesClient(wixClient);
+  const customizationsClient = getCustomizationsV3Client(wixClient);
   const service = {
     products: getProductsV3Client(wixClient),
     categories: categoriesClient,
     inventory: getInventoryClient(wixClient),
-    cart: getCurrentCartClient(wixClient),
+    customizations: customizationsClient,
     urls: options?.urls ?? { product: "/products/{slug}", category: null },
     defaultCategory: options?.defaultCategory ?? null,
     async getCategoryTree() {
@@ -86,6 +99,17 @@ function provideWixStoresService(wixClient, options) {
       }
       cachedTree = { slugMap, parentMap, rootIds, imageMap };
       return cachedTree;
+    },
+    async getCustomizations() {
+      if (cachedCustomizations) return cachedCustomizations;
+      try {
+        const result = await customizationsClient.queryCustomizations().eq("customizationType", "PRODUCT_OPTION").limit(100).find();
+        cachedCustomizations = result.items || [];
+      } catch (error) {
+        console.error("[wix-stores] Failed to load customizations:", error);
+        cachedCustomizations = [];
+      }
+      return cachedCustomizations;
     }
   };
   registerService(WIX_STORES_SERVICE_MARKER, service);
@@ -329,8 +353,8 @@ function buildVariantStockMap(product) {
   const options = product.options;
   const variants = product.variantsInfo?.variants;
   if (!options || options.length !== 2 || !variants) return stockMap;
-  const colorOption = options.find((o) => o.optionRenderType === "COLOR_SWATCH_CHOICES");
-  const textOption = options.find((o) => o.optionRenderType !== "COLOR_SWATCH_CHOICES");
+  const colorOption = options.find((o) => o.optionRenderType === "SWATCH_CHOICES");
+  const textOption = options.find((o) => o.optionRenderType === "TEXT_CHOICES");
   if (!colorOption || !textOption) return stockMap;
   const colorOptionId = colorOption._id || "";
   const textOptionId = textOption._id || "";
@@ -428,6 +452,31 @@ const PRICE_BUCKETS = PRICE_BUCKET_BOUNDARIES.slice(0, -1).map((from, i) => ({
   to: PRICE_BUCKET_BOUNDARIES[i + 1]
 }));
 PRICE_BUCKETS.push({ from: PRICE_BUCKET_BOUNDARIES[PRICE_BUCKET_BOUNDARIES.length - 1] });
+function getAvailableProductOptions(aggResults, customizations) {
+  const optionNamesAgg = aggResults.find((a) => a.name === "optionNames")?.values;
+  const choiceNamesAgg = aggResults.find((a) => a.name === "choiceNames")?.values;
+  if (!optionNamesAgg?.results?.length || !choiceNamesAgg?.results?.length) {
+    return [];
+  }
+  const optionNames = new Set(optionNamesAgg.results.map((e) => e.value));
+  const choiceCounts = new Map(
+    choiceNamesAgg.results.map((e) => [e.value.toLowerCase(), e.count ?? 0])
+  );
+  return customizations.filter(
+    (c) => c.customizationType === "PRODUCT_OPTION" && c.name && optionNames.has(c.name) && (c.customizationRenderType === "TEXT_CHOICES" || c.customizationRenderType === "SWATCH_CHOICES")
+  ).map((c) => ({
+    optionId: c._id || "",
+    optionName: c.name || "",
+    optionRenderType: c.customizationRenderType,
+    // Sort by product count descending (most used choices first)
+    choices: (c.choicesSettings?.choices || []).filter((ch) => ch.name && choiceCounts.has(ch.name.toLowerCase())).map((ch) => ({
+      choiceId: ch._id || "",
+      choiceName: ch.name || "",
+      colorCode: ch.colorCode || "",
+      productCount: choiceCounts.get(ch.name.toLowerCase()) ?? 0
+    })).sort((a, b) => b.productCount - a.productCount)
+  })).filter((o) => o.choices.length > 0);
+}
 const searchProducts = makeJayQuery("wixStores.searchProducts").withServices(WIX_STORES_SERVICE_MARKER).withHandler(
   async (input, wixStores) => {
     const { query, filters = {}, sortBy = "relevance", cursor, pageSize = 12 } = input;
@@ -460,6 +509,22 @@ const searchProducts = makeJayQuery("wixStores.searchProducts").withServices(WIX
           }
         });
       }
+      if (filters.optionFilters && filters.optionFilters.length > 0) {
+        for (const optFilter of filters.optionFilters) {
+          if (optFilter.choiceNames.length > 0) {
+            filterConditions.push({
+              $and: [
+                { "options.name": { $hasSome: [optFilter.optionName] } },
+                {
+                  "options.choicesSettings.choices.name": {
+                    $hasSome: optFilter.choiceNames
+                  }
+                }
+              ]
+            });
+          }
+        }
+      }
       const filter = filterConditions.length === 1 ? filterConditions[0] : { $and: filterConditions };
       const sort = [];
       switch (sortBy) {
@@ -513,6 +578,28 @@ const searchProducts = makeJayQuery("wixStores.searchProducts").withServices(WIX
           name: "max-price",
           type: "SCALAR",
           scalar: { type: "MAX" }
+        },
+        // Option names for option-based filtering
+        {
+          fieldPath: "options.name",
+          name: "optionNames",
+          type: "VALUE",
+          value: {
+            limit: 20,
+            sortType: "VALUE",
+            sortDirection: "DESC"
+          }
+        },
+        // Choice names for option-based filtering
+        {
+          fieldPath: "options.choicesSettings.choices.name",
+          name: "choiceNames",
+          type: "VALUE",
+          value: {
+            limit: 50,
+            sortType: "COUNT",
+            sortDirection: "DESC"
+          }
         }
       ];
       const searchResult = await wixStores.products.searchProducts(
@@ -567,6 +654,8 @@ const searchProducts = makeJayQuery("wixStores.searchProducts").withServices(WIX
         };
       });
       priceRanges.push(...bucketRanges);
+      const customizations = await wixStores.getCustomizations();
+      const optionFilters = getAvailableProductOptions(aggResults, customizations);
       const tree = await wixStores.getCategoryTree();
       const mappedProducts = products.map(
         (p) => mapProductToCard(p, wixStores.urls, tree)
@@ -580,7 +669,8 @@ const searchProducts = makeJayQuery("wixStores.searchProducts").withServices(WIX
           minBound,
           maxBound,
           ranges: priceRanges
-        }
+        },
+        optionFilters
       };
     } catch (error) {
       console.error("[wixStores.searchProducts] Search failed:", error);
@@ -666,13 +756,28 @@ function mapSortToAction(sort) {
 function parseUrlFilters(url) {
   try {
     const params = new URL(url, "http://x").searchParams;
+    const optionSelections = /* @__PURE__ */ new Map();
+    const optParam = params.get("opt");
+    if (optParam) {
+      for (const segment of optParam.split(";")) {
+        const colonIdx = segment.indexOf(":");
+        if (colonIdx === -1)
+          continue;
+        const name = decodeURIComponent(segment.slice(0, colonIdx));
+        const choices = segment.slice(colonIdx + 1).split(",").map((c) => decodeURIComponent(c)).filter(Boolean);
+        if (choices.length > 0) {
+          optionSelections.set(name, new Set(choices));
+        }
+      }
+    }
     return {
       searchTerm: params.get("q") || "",
       selectedCategorySlugs: params.get("cat")?.split(",").filter(Boolean) || [],
       minPrice: params.has("min") ? Number(params.get("min")) : null,
       maxPrice: params.has("max") ? Number(params.get("max")) : null,
       inStockOnly: params.get("inStock") === "1",
-      sort: params.get("sort") || "relevance"
+      sort: params.get("sort") || "relevance",
+      optionSelections
     };
   } catch {
     return {
@@ -681,7 +786,8 @@ function parseUrlFilters(url) {
       minPrice: null,
       maxPrice: null,
       inStockOnly: false,
-      sort: "relevance"
+      sort: "relevance",
+      optionSelections: /* @__PURE__ */ new Map()
     };
   }
 }
@@ -696,6 +802,30 @@ function parseSortParam(sort) {
   };
   return sortMap[sort] ?? CurrentSort.relevance;
 }
+function buildOptionFiltersViewState(baseOptionFilters, filteredResult, optionSelections) {
+  const filteredChoiceCounts = /* @__PURE__ */ new Map();
+  for (const opt of filteredResult.optionFilters || []) {
+    for (const ch of opt.choices) {
+      filteredChoiceCounts.set(ch.choiceName.toLowerCase(), ch.productCount);
+    }
+  }
+  return baseOptionFilters.map((opt) => ({
+    optionId: opt.optionId,
+    optionName: opt.optionName,
+    optionRenderType: opt.optionRenderType === "SWATCH_CHOICES" ? OptionRenderType$2.SWATCH_CHOICES : OptionRenderType$2.TEXT_CHOICES,
+    choices: opt.choices.map((ch) => {
+      const count = filteredChoiceCounts.get(ch.choiceName.toLowerCase()) ?? 0;
+      return {
+        choiceId: ch.choiceId,
+        choiceName: ch.choiceName,
+        colorCode: ch.colorCode,
+        productCount: count,
+        isSelected: optionSelections.get(opt.optionName)?.has(ch.choiceName) ?? false,
+        isDisabled: count === 0
+      };
+    })
+  }));
+}
 const EMPTY_CATEGORY_HEADER = {
   name: "",
   description: "",
@@ -801,18 +931,35 @@ async function renderSlowlyChanging$2(props, wixStores) {
     if (baseCategoryId) {
       query = query.eq("parentCategory.id", baseCategoryId);
     }
-    const categoriesResult = await query.find();
-    return categoriesResult.items || [];
+    const baseCategoryIds = baseCategoryId ? [baseCategoryId] : [];
+    const [categoriesResult, productsResult] = await Promise.all([
+      query.find(),
+      searchProducts({
+        query: "",
+        filters: {
+          categoryIds: baseCategoryIds.length > 0 ? baseCategoryIds : void 0
+        },
+        pageSize: PAGE_SIZE
+      })
+    ]);
+    return {
+      categories: categoriesResult.items || [],
+      productsResult
+    };
   }).recover((error) => {
-    console.error("Failed to load categories:", error);
-    return Pipeline.ok([]);
-  }).toPhaseOutput((categories2) => {
+    console.error("Failed to load categories/products:", error);
+    return Pipeline.ok({
+      categories: [],
+      productsResult: null
+    });
+  }).toPhaseOutput(({ categories: categories2, productsResult }) => {
     const categoryInfos = categories2.map((cat) => ({
       categoryId: cat._id || "",
       categoryName: cat.name || "",
       categorySlug: cat.slug || "",
       categoryUrl: buildCategoryUrl(wixStores.urls, tree, cat.slug || "", cat._id || "") ?? ""
     }));
+    const baseOptionFilters = productsResult?.optionFilters || [];
     return {
       viewState: {
         searchFields: "name,description,sku",
@@ -829,7 +976,9 @@ async function renderSlowlyChanging$2(props, wixStores) {
         searchFields: "name,description,sku",
         fuzzySearch: true,
         categories: categoryInfos,
-        baseCategoryId
+        baseCategoryId,
+        preloadedResult: productsResult,
+        baseOptionFilters
       }
     };
   });
@@ -839,7 +988,15 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
   const urlFilters = parseUrlFilters(props.url);
   const initialSort = parseSortParam(urlFilters.sort);
   const initialCategoryIds = urlFilters.selectedCategorySlugs.map((slug) => slowCarryForward.categories.find((c) => c.categorySlug === slug)?.categoryId).filter(Boolean);
+  const initialOptionFilters = [];
+  for (const [optionName, choiceNames] of urlFilters.optionSelections) {
+    initialOptionFilters.push({ optionName, choiceNames: [...choiceNames] });
+  }
+  const hasActiveFilters = !!urlFilters.searchTerm || initialCategoryIds.length > 0 || urlFilters.minPrice !== null || urlFilters.maxPrice !== null || urlFilters.inStockOnly || initialSort !== CurrentSort.relevance || initialOptionFilters.length > 0;
   return Pipeline.try(async () => {
+    if (!hasActiveFilters && slowCarryForward.preloadedResult) {
+      return slowCarryForward.preloadedResult;
+    }
     const baseCategoryIds = slowCarryForward.baseCategoryId ? [slowCarryForward.baseCategoryId, ...initialCategoryIds] : initialCategoryIds;
     const result = await searchProducts({
       query: urlFilters.searchTerm || "",
@@ -847,7 +1004,8 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
         categoryIds: baseCategoryIds.length > 0 ? baseCategoryIds : void 0,
         minPrice: urlFilters.minPrice ?? void 0,
         maxPrice: urlFilters.maxPrice ?? void 0,
-        inStockOnly: urlFilters.inStockOnly || void 0
+        inStockOnly: urlFilters.inStockOnly || void 0,
+        optionFilters: initialOptionFilters.length > 0 ? initialOptionFilters : void 0
       },
       sortBy: initialSort !== CurrentSort.relevance ? mapSortToAction(initialSort) : void 0,
       pageSize: PAGE_SIZE
@@ -867,13 +1025,14 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
           {
             rangeId: "all",
             label: "Show all",
-            minValue: null,
-            maxValue: null,
+            minValue: 0,
+            maxValue: 1e3,
             productCount: 0,
             isSelected: true
           }
         ]
-      }
+      },
+      optionFilters: []
     });
   }).toPhaseOutput((result) => {
     const priceAgg = result.priceAggregation || {
@@ -883,8 +1042,8 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
         {
           rangeId: "all",
           label: "Show all",
-          minValue: null,
-          maxValue: null,
+          minValue: 0,
+          maxValue: 1e3,
           productCount: result.totalCount,
           isSelected: true
         }
@@ -907,14 +1066,19 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
             maxPrice: urlFilters.maxPrice ?? priceAgg.maxBound,
             minBound: priceAgg.minBound,
             maxBound: priceAgg.maxBound,
-            ranges: priceAgg.ranges
+            ranges: priceAgg.ranges.map((r) => ({
+              ...r,
+              minValue: r.minValue ?? 0,
+              maxValue: r.maxValue ?? 0
+            }))
           },
           categoryFilter: {
             categories: slowCarryForward.categories.map((cat) => ({
               categoryId: cat.categoryId,
               isSelected: initialCategoryIds.includes(cat.categoryId)
             }))
-          }
+          },
+          optionFilters: buildOptionFiltersViewState(slowCarryForward.baseOptionFilters, result, urlFilters.optionSelections)
         },
         sortBy: {
           currentSort: initialSort
@@ -927,7 +1091,8 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
         searchFields: slowCarryForward.searchFields,
         fuzzySearch: slowCarryForward.fuzzySearch,
         categories: slowCarryForward.categories,
-        baseCategoryId: slowCarryForward.baseCategoryId
+        baseCategoryId: slowCarryForward.baseCategoryId,
+        baseOptionFilters: slowCarryForward.baseOptionFilters
       }
     };
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-stores",
-  "version": "0.15.4",
+  "version": "0.15.5",
   "type": "module",
   "description": "Wix Stores API client for Jay Framework",
   "license": "Apache-2.0",
@@ -18,7 +18,8 @@
     "./category-list.jay-contract": "./dist/contracts/category-list.jay-contract",
     "./search-products.jay-action": "./dist/actions/search-products.jay-action",
     "./get-product-by-slug.jay-action": "./dist/actions/get-product-by-slug.jay-action",
-    "./get-categories.jay-action": "./dist/actions/get-categories.jay-action"
+    "./get-categories.jay-action": "./dist/actions/get-categories.jay-action",
+    "./get-variant-stock.jay-action": "./dist/actions/get-variant-stock.jay-action"
   },
   "scripts": {
     "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types",
@@ -33,28 +34,29 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.15.4",
-    "@jay-framework/fullstack-component": "^0.15.4",
-    "@jay-framework/reactive": "^0.15.4",
-    "@jay-framework/runtime": "^0.15.4",
-    "@jay-framework/secure": "^0.15.4",
-    "@jay-framework/stack-client-runtime": "^0.15.4",
-    "@jay-framework/stack-server-runtime": "^0.15.4",
-    "@jay-framework/wix-cart": "^0.15.4",
-    "@jay-framework/wix-server-client": "^0.15.4",
-    "@jay-framework/wix-utils": "^0.15.4",
+    "@jay-framework/component": "^0.15.5",
+    "@jay-framework/fullstack-component": "^0.15.5",
+    "@jay-framework/reactive": "^0.15.5",
+    "@jay-framework/runtime": "^0.15.5",
+    "@jay-framework/secure": "^0.15.5",
+    "@jay-framework/stack-client-runtime": "^0.15.5",
+    "@jay-framework/stack-server-runtime": "^0.15.5",
+    "@jay-framework/wix-cart": "^0.15.5",
+    "@jay-framework/wix-server-client": "^0.15.5",
+    "@jay-framework/wix-utils": "^0.15.5",
     "@wix/categories": "^1.0.185",
     "@wix/sdk": "^1.21.5",
-    "@wix/stores": "^1.0.723",
+    "@wix/sdk-runtime": "^1.0.11",
+    "@wix/stores": "^1.0.742",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.15.4",
-    "@jay-framework/jay-cli": "^0.15.4",
-    "@jay-framework/vite-plugin": "^0.15.4",
+    "@jay-framework/compiler-jay-stack": "^0.15.5",
+    "@jay-framework/jay-cli": "^0.15.5",
+    "@jay-framework/vite-plugin": "^0.15.5",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",
     "tslib": "^2.6.2",

package/plugin.yaml

@@ -24,6 +24,8 @@ actions:
     action: get-product-by-slug.jay-action
   - name: getCategories
     action: get-categories.jay-action
+  - name: getVariantStock
+    action: get-variant-stock.jay-action
 
 # Plugin initialization uses makeJayInit pattern in lib/init.ts
 # Export name defaults to 'init'