@wix/stores 1.0.236 → 1.0.237

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/stores",
-  "version": "1.0.236",
+  "version": "1.0.237",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -26,7 +26,7 @@
     "@wix/stores_inventory": "1.0.39",
     "@wix/stores_inventory-items-v-3": "1.0.14",
     "@wix/stores_products": "1.0.54",
-    "@wix/stores_products-v-3": "1.0.43",
+    "@wix/stores_products-v-3": "1.0.44",
     "@wix/stores_ribbons-v-3": "1.0.10",
     "@wix/stores_stores-locations-v-3": "1.0.11",
     "@wix/stores_subscription-options": "1.0.35",
@@ -55,5 +55,5 @@
       "fqdn": ""
     }
   },
-  "falconPackageHash": "e1b9133b2fd5cd1254f63064a4e78b151b2f8e6e1ccce6502756ad48"
+  "falconPackageHash": "97109abeb5d3a2ecef54b575d4c4ccdfd86bf4edd098761e66038025"
 }

package/type-bundles/context.bundle.d.ts

@@ -13223,6 +13223,18 @@ interface WixCommonSorting {
     fieldName?: string;
     /** Sort order. */
     order?: WixCommonSortOrder;
+    /**
+     * When `field_name` is a property of repeated field that is marked as `MATCH_ITEMS` and sort should be done by
+     * a specific element from a collection, filter can/should be provided to ensure correct sort value is picked.
+     *
+     * If multiple filters are provided, they are combined with AND operator.
+     *
+     * Example:
+     * Given we have document like {"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}
+     * and `nestedField` is marked as `MATCH_ITEMS`, to ensure that sorting is done by correct region, filter should be
+     * { fieldName: "nestedField.price", "select_items_by": [{"nestedField.region": "US"}] }
+     */
+    selectItemsBy?: Record<string, any>[] | null;
 }
 declare enum WixCommonSortOrder {
     ASC = "ASC",

package/type-bundles/index.bundle.d.ts

@@ -13223,6 +13223,18 @@ interface WixCommonSorting {
     fieldName?: string;
     /** Sort order. */
     order?: WixCommonSortOrder;
+    /**
+     * When `field_name` is a property of repeated field that is marked as `MATCH_ITEMS` and sort should be done by
+     * a specific element from a collection, filter can/should be provided to ensure correct sort value is picked.
+     *
+     * If multiple filters are provided, they are combined with AND operator.
+     *
+     * Example:
+     * Given we have document like {"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}
+     * and `nestedField` is marked as `MATCH_ITEMS`, to ensure that sorting is done by correct region, filter should be
+     * { fieldName: "nestedField.price", "select_items_by": [{"nestedField.region": "US"}] }
+     */
+    selectItemsBy?: Record<string, any>[] | null;
 }
 declare enum WixCommonSortOrder {
     ASC = "ASC",

package/type-bundles/meta.bundle.d.ts

@@ -14309,6 +14309,18 @@ interface WixCommonSorting$1 {
     fieldName?: string;
     /** Sort order. */
     order?: WixCommonSortOrder$1;
+    /**
+     * When `field_name` is a property of repeated field that is marked as `MATCH_ITEMS` and sort should be done by
+     * a specific element from a collection, filter can/should be provided to ensure correct sort value is picked.
+     *
+     * If multiple filters are provided, they are combined with AND operator.
+     *
+     * Example:
+     * Given we have document like {"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}
+     * and `nestedField` is marked as `MATCH_ITEMS`, to ensure that sorting is done by correct region, filter should be
+     * { fieldName: "nestedField.price", "select_items_by": [{"nestedField.region": "US"}] }
+     */
+    selectItemsBy?: Record<string, any>[] | null;
 }
 declare enum WixCommonSortOrder$1 {
     ASC = "ASC",
@@ -18725,6 +18737,18 @@ interface WixCommonSorting {
     fieldName?: string;
     /** Sort order. */
     order?: WixCommonSortOrder;
+    /**
+     * When `field_name` is a property of repeated field that is marked as `MATCH_ITEMS` and sort should be done by
+     * a specific element from a collection, filter can/should be provided to ensure correct sort value is picked.
+     *
+     * If multiple filters are provided, they are combined with AND operator.
+     *
+     * Example:
+     * Given we have document like {"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}
+     * and `nestedField` is marked as `MATCH_ITEMS`, to ensure that sorting is done by correct region, filter should be
+     * { fieldName: "nestedField.price", "select_items_by": [{"nestedField.region": "US"}] }
+     */
+    selectItemsBy?: Record<string, any>[] | null;
 }
 declare enum WixCommonSortOrder {
     ASC = "ASC",