@jay-framework/wix-stores 0.15.6 → 0.16.1

package/README.md

@@ -149,12 +149,12 @@ src/pages/products/polgat/
 
 ### Setting Params for Static Routes
 
-Static route directories use `jay-params` to tell the component which category they represent:
+Static route directories use `jay-params` to tell the component which prefix they represent:
 
 ```html
 <!-- src/pages/products/polgat/page.jay-html -->
 <script type="application/jay-params">
-  category: polgat
+  prefix: polgat
 </script>
 <script
   type="application/jay-headless"
@@ -168,8 +168,8 @@ Static route directories use `jay-params` to tell the component which category t
 
 The category header is always loaded. The component resolves category metadata using a fallback chain:
 
-1. **`subcategory` param** → load sub-category
-2. **`category` / `prefix` param** → load root category
+1. **`category` param** → load category
+2. **`prefix` param** → load root category
 3. **Neither** → load `defaultCategory` from config
 
 If the resolved category is missing image, description, or SEO data, the component walks up the parent chain until it finds the data. Each field inherits independently.

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

@@ -2,6 +2,7 @@ name: product-page
 description: Full product detail page with variants, options, media gallery, and add-to-cart. Use for individual product pages.
 params:
   slug: string
+  prefix: string?
   category: string?
 tags:
   - {tag: _id, type: data, dataType: string, description: Product GUID}

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

@@ -184,6 +184,7 @@ import { UrlParams } from '@jay-framework/fullstack-component';
 
 export interface ProductPageParams extends UrlParams {
   slug: string;
+  prefix?: string;
   category?: string;
 }
 

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

@@ -1,15 +1,8 @@
 name: product-search
 description: Product listing with filters, sorting, and pagination. Use for search results and category pages.
-props:
-  - name: category
-    type: string
-    description: Top-level category slug. Scopes search to this category.
-  - name: subcategory
-    type: string
-    description: Sub-category slug. Further scopes within the category.
 params:
+  prefix: string?
   category: string?
-  subcategory: string?
 tags:
   # Search input (matches Wix searchProducts search.search parameter)
   - tag: searchExpression
@@ -328,7 +321,7 @@ tags:
         elementType: HTMLButtonElement
         description: Button to use this suggestion
 
-  # Category header — always populated via fallback chain (subcategory → category → defaultCategory)
+  # Category header — always populated via fallback chain (category → prefix → defaultCategory)
   - tag: categoryHeader
     type: sub-contract
     description: Active category information for the page header

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

@@ -254,16 +254,11 @@ export interface ProductSearchRepeatedRefs {
   }
 }
 
-export interface ProductSearchProps {
-  category?: string;
-  subcategory?: string;
-}
-
 import { UrlParams } from '@jay-framework/fullstack-component';
 
 export interface ProductSearchParams extends UrlParams {
+  prefix?: string;
   category?: string;
-  subcategory?: string;
 }
 
-export type ProductSearchContract = JayContract<ProductSearchViewState, ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState, ProductSearchProps>
+export type ProductSearchContract = JayContract<ProductSearchViewState, ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState>

package/dist/index.d.ts

@@ -352,6 +352,11 @@ interface ProductSearchRefs {
   }
 }
 
+interface ProductSearchParams extends UrlParams {
+  prefix?: string;
+  category?: string;
+}
+
 /**
  * Configuration loader for wix-stores plugin.
  *
@@ -550,16 +555,6 @@ interface SearchProductsOutput {
     }>;
 }
 
-/**
- * URL parameters for product search routes.
- * Supports: category (prefix slug), subcategory (sub-category slug).
- */
-interface ProductSearchParams extends UrlParams {
-    /** Top-level category slug (e.g., 'polgat'). Scopes search to this category. */
-    category?: string;
-    /** Sub-category slug (e.g., 'shirts'). Further scopes within the category. */
-    subcategory?: string;
-}
 /**
  * Category info carried forward from slow to fast phase
  */
@@ -784,15 +779,12 @@ interface ProductPageRefs {
   }
 }
 
-/**
- * URL parameters for product page routes.
- * Supports /products/[slug] and /products/polgat/[slug] (category-prefixed).
- */
 interface ProductPageParams extends UrlParams {
-    slug: string;
-    /** Category prefix from static route (e.g., 'polgat'). Undefined for unprefixed routes. */
-    category?: string;
+  slug: string;
+  prefix?: string;
+  category?: string;
 }
+
 interface InteractiveVariant {
     _id: string;
     sku: string;

package/dist/index.js

@@ -920,17 +920,17 @@ async function buildCategoryHeader(wixStoreService, category, categoryUrlTemplat
 }
 async function renderSlowlyChanging$2(props, wixStores) {
   const Pipeline = RenderPipeline.for();
-  const subcategorySlug = props.subcategory ?? null;
   const categorySlug = props.category ?? null;
+  const prefixSlug = props.prefix ?? null;
   const defaultCategorySlug = wixStores.defaultCategory;
   let activeCategory = null;
   let baseCategoryId = null;
-  if (subcategorySlug) {
-    activeCategory = await findCategoryBySlug$1(wixStores.categories, subcategorySlug);
-    baseCategoryId = activeCategory?._id ?? null;
-  } else if (categorySlug) {
+  if (categorySlug) {
     activeCategory = await findCategoryBySlug$1(wixStores.categories, categorySlug);
     baseCategoryId = activeCategory?._id ?? null;
+  } else if (prefixSlug) {
+    activeCategory = await findCategoryBySlug$1(wixStores.categories, prefixSlug);
+    baseCategoryId = activeCategory?._id ?? null;
   } else if (defaultCategorySlug) {
     activeCategory = await findCategoryBySlug$1(wixStores.categories, defaultCategorySlug);
   }
@@ -1111,21 +1111,42 @@ async function renderFastChanging$1(props, slowCarryForward, _wixStores) {
 }
 async function* loadSearchParams([wixStores]) {
   try {
-    const result = await wixStores.categories.queryCategories({
+    let findRootParent = function(cat) {
+      let current = cat;
+      while (current.parentCategory?._id) {
+        const parent = categoryById.get(current.parentCategory._id);
+        if (!parent)
+          break;
+        current = parent;
+      }
+      return current._id !== cat._id ? current : null;
+    };
+    const allCategories = [];
+    let result = await wixStores.categories.queryCategories({
       treeReference: { appNamespace: "@wix/stores" }
     }).eq("visible", true).limit(100).find();
-    const categories2 = result.items || [];
-    yield categories2.filter((cat) => cat.slug && (cat.itemCounter ?? 0) > 0).map((cat) => ({
-      category: cat.slug
-    }));
-    for (const cat of categories2) {
-      if (!cat.slug || !cat.parentCategory?._id || (cat.itemCounter ?? 0) === 0)
+    allCategories.push(...result.items || []);
+    while (result.hasNext()) {
+      result = await result.next();
+      allCategories.push(...result.items || []);
+    }
+    const categoryById = /* @__PURE__ */ new Map();
+    for (const cat of allCategories) {
+      if (cat._id)
+        categoryById.set(cat._id, cat);
+    }
+    const params = [];
+    for (const cat of allCategories) {
+      if (!cat.slug || (cat.itemCounter ?? 0) === 0)
         continue;
-      const parent = categories2.find((c) => c._id === cat.parentCategory?._id);
-      if (parent?.slug) {
-        yield [{ category: parent.slug, subcategory: cat.slug }];
+      const rootParent = findRootParent(cat);
+      if (rootParent?.slug) {
+        params.push({ prefix: rootParent.slug, category: cat.slug });
+      } else {
+        params.push({ prefix: cat.slug });
       }
     }
+    yield params;
   } catch (error) {
     console.error("Failed to load category params:", error);
     yield [];
@@ -1175,14 +1196,32 @@ var MediaType = /* @__PURE__ */ ((MediaType2) => {
 })(MediaType || {});
 async function* loadProductParams([wixStores]) {
   const template = wixStores.urls.product;
-  const needsCategories = template.includes("{category}") || template.includes("{prefix}");
+  const needsPrefix = template.includes("{prefix}");
+  const needsCategory = template.includes("{category}");
+  const needsCategories = needsPrefix || needsCategory;
   const fields = needsCategories ? ["ALL_CATEGORIES_INFO"] : [];
   try {
+    const tree = needsCategories ? await wixStores.getCategoryTree() : null;
     let result = await wixStores.products.queryProducts({ fields: [...fields] }).find();
-    yield result.items.map((product) => ({ slug: product.slug ?? "" })).filter((p) => p.slug);
+    const mapProduct = (product) => {
+      const slug = product.slug ?? "";
+      if (!slug)
+        return null;
+      const params = { slug };
+      if (tree && product.mainCategoryId) {
+        if (needsCategory) {
+          params.category = tree.slugMap.get(product.mainCategoryId);
+        }
+        if (needsPrefix) {
+          params.prefix = findRootCategorySlug(product.mainCategoryId, tree);
+        }
+      }
+      return params;
+    };
+    yield result.items.map(mapProduct).filter((p) => p !== null);
     while (result.hasNext()) {
       result = await result.next();
-      yield result.items.map((product) => ({ slug: product.slug ?? "" })).filter((p) => p.slug);
+      yield result.items.map(mapProduct).filter((p) => p !== null);
     }
   } catch (error) {
     console.error("Failed to load product slugs:", error);
@@ -1227,12 +1266,19 @@ function mapMediaType(mediaType) {
     return MediaType.IMAGE;
 }
 function mapMedia(media) {
-  const mainMediaType = mapMediaType(media.main.mediaType);
+  const main = media?.main;
+  if (!main) {
+    return {
+      selectedMedia: { url: "", mediaType: MediaType.IMAGE, thumbnail_50x50: "" },
+      availableMedia: []
+    };
+  }
+  const mainMediaType = mapMediaType(main.mediaType);
   return {
     selectedMedia: {
-      url: formatWixMediaUrl(media.main._id, media.main.url),
+      url: formatWixMediaUrl(main._id, main.url),
       mediaType: mainMediaType,
-      thumbnail_50x50: formatWixMediaUrl(media.main._id, media.main.url, { w: 50, h: 50 })
+      thumbnail_50x50: formatWixMediaUrl(main._id, main.url, { w: 50, h: 50 })
     },
     availableMedia: media.itemsInfo?.items?.map((item) => ({
       mediaId: item._id,
@@ -1241,7 +1287,7 @@ function mapMedia(media) {
         mediaType: item.mediaType === "IMAGE" ? MediaType.IMAGE : MediaType.VIDEO,
         thumbnail_50x50: formatWixMediaUrl(item._id, item.url, { w: 50, h: 50 })
       },
-      selected: item._id === media.main._id ? Selected.selected : Selected.notSelected
+      selected: item._id === main._id ? Selected.selected : Selected.notSelected
     })) ?? []
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-stores",
-  "version": "0.15.6",
+  "version": "0.16.1",
   "type": "module",
   "description": "Wix Stores API client for Jay Framework",
   "license": "Apache-2.0",
@@ -35,16 +35,16 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.15.6",
-    "@jay-framework/fullstack-component": "^0.15.6",
-    "@jay-framework/reactive": "^0.15.6",
-    "@jay-framework/runtime": "^0.15.6",
-    "@jay-framework/secure": "^0.15.6",
-    "@jay-framework/stack-client-runtime": "^0.15.6",
-    "@jay-framework/stack-server-runtime": "^0.15.6",
-    "@jay-framework/wix-cart": "^0.15.6",
-    "@jay-framework/wix-server-client": "^0.15.6",
-    "@jay-framework/wix-utils": "^0.15.6",
+    "@jay-framework/component": "^0.16.1",
+    "@jay-framework/fullstack-component": "^0.16.1",
+    "@jay-framework/reactive": "^0.16.1",
+    "@jay-framework/runtime": "^0.16.1",
+    "@jay-framework/secure": "^0.16.1",
+    "@jay-framework/stack-client-runtime": "^0.16.1",
+    "@jay-framework/stack-server-runtime": "^0.16.1",
+    "@jay-framework/wix-cart": "^0.16.1",
+    "@jay-framework/wix-server-client": "^0.16.1",
+    "@jay-framework/wix-utils": "^0.16.1",
     "@wix/categories": "^1.0.185",
     "@wix/sdk": "^1.21.5",
     "@wix/sdk-runtime": "^1.0.11",
@@ -55,10 +55,10 @@
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.15.6",
-    "@jay-framework/jay-cli": "^0.15.6",
-    "@jay-framework/jay-stack-cli": "^0.15.6",
-    "@jay-framework/vite-plugin": "^0.15.6",
+    "@jay-framework/compiler-jay-stack": "^0.16.1",
+    "@jay-framework/jay-cli": "^0.16.1",
+    "@jay-framework/jay-stack-cli": "^0.16.1",
+    "@jay-framework/vite-plugin": "^0.16.1",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",
     "tslib": "^2.6.2",

package/plugin.yaml

@@ -10,7 +10,7 @@ contracts:
     contract: product-search.jay-contract
     component: productSearch
     description: Headless product search page
-  # category-page removed — use product-search with category param instead
+  # category-page removed — use product-search with prefix/category params instead
   - name: category-list
     contract: category-list.jay-contract
     component: categoryList