added note about timeout to addProducts/createProduct

wix-docs-feds · roysha-wix · web-flow · commit 34e84d33f9bf · 2022-12-07T11:07:57.000+02:00
* DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - no significant changes detected, but 1 issue detected issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wixcode-stores - 1 change detected, but 1 issue detected changes: Service wix-stores.Cart operation addProducts has changed description issues: Browserslist: caniuse-lite is outdated. Please run: npx browserslist@latest --update-db Why you should do it regularly: https://github.com/browserslist/browserslist#browsers-data-updating * DocWorks for wix-stores-backend - 1 change detected, but 6 issue detected changes: Service wix-stores-backend operation createProduct has changed description issues: Message SeoTag has an unknown property type object (products.js (94)) Message SeoTag has an unknown property type object (products.js (94)) Message ItemMetadataError has an unknown property type object (products.js (637)) Message SeoTag has an unknown property type object (products.js (94)) Message SeoTag has an unknown property type object (products.js (94)) Message ItemMetadataError has an unknown property type object (products.js (637)) Co-authored-by: roysha-wix <62389977+roysha-wix@users.noreply.github.com>
diff --git a/wix-stores-backend/wix-stores-backend.service.json b/wix-stores-backend/wix-stores-backend.service.json
@@ -1487,7 +1487,8 @@
         "extra":
           {  } },
       { "name": "createProduct",
-        "labels": [],
+        "labels":
+          [ "changed" ],
         "nameParams": [],
         "params":
           [ { "name": "productInfo",
@@ -1511,9 +1512,9 @@
                 " Creating a product is the first step in the process of enabling visitors to buy your products. After you create a product, you can",
                 " add choices and variants to the product.",
                 "",
-                "> **Note:** Do not pass important information from client-side code.",
-                "Doing so opens a vulnerability that a malicious user can exploit to change information, such as a buyer’s personal details (address, email, etc.) or product price information.",
-                "To learn more about how to keep your code secure, see [Security Considerations When Working with Wix Code](https://support.wix.com/en/article/velo-security-best-practices#code-visibility)." ],
+                "> **Notes:**",
+                "+ If you create a product immediately before adding it to the cart, we suggest [setting a timeout](https://developer.mozilla.org/en-US/docs/Web/API/setTimeout) for `\"1000\"` milliseconds (1 second) before calling [`wix-stores.cart.addProducts()`](https://www.wix.com/velo/reference/wix-stores/cart/addproducts). While this slows down the operation slightly, it also ensures proper retrieval of the newly created product before adding it to the cart.",
+                "+ Do not pass important information from client-side code. Doing so opens a vulnerability that a malicious user can exploit to change information, such as a buyer’s personal details (address, email, etc.) or product price information. To learn more about how to keep your code secure, see [Security Considerations When Working with Wix Code](https://support.wix.com/en/article/velo-security-best-practices#code-visibility)." ],
             "links":
               [ "[getProduct()]($w.ProductPage.html#getProduct)" ],
             "examples":
@@ -10833,8 +10834,7 @@
                   "members":
                     [ "productId",
                       "inventoryId" ] } ] },
-        "labels":
-          [ "changed" ] },
+        "labels": [] },
       { "name": "Discount",
         "locations":
           [ { "lineno": 547,
@@ -12079,8 +12079,7 @@
                   "members":
                     [ "productId",
                       "inventoryId" ] } ] },
-        "labels":
-          [ "changed" ] },
+        "labels": [] },
       { "name": "InventoryItem",
         "locations":
           [ { "lineno": 1,
diff --git a/wixcode-stores/wix-stores.service.json b/wixcode-stores/wix-stores.service.json
@@ -2038,8 +2038,7 @@
         "labels":
           [ "removed" ] } ],
   "extra":
-    { "scopes":
-        [ "frontend" ] },
+    {  },
   "menuSections": "APIs",
   "relatedContent":
     [ { "icon": "video",
diff --git a/wixcode-stores/wix-stores/Cart.service.json b/wixcode-stores/wix-stores/Cart.service.json
@@ -1,7 +1,8 @@
 { "name": "Cart",
   "memberOf": "wix-stores",
   "mixes": [],
-  "labels": [],
+  "labels":
+    [ "changed" ],
   "location":
     { "lineno": 18,
       "filename": "stores-index.js" },
@@ -20,7 +21,8 @@
   "properties": [],
   "operations":
     [ { "name": "addProducts",
-        "labels": [],
+        "labels":
+          [ "changed" ],
         "nameParams": [],
         "params":
           [ { "name": "products",
@@ -58,9 +60,9 @@
                 " You can use [`product.getOptionsAvailability()`](https://www.wix.com/velo/reference/wix-stores/product/getoptionsavailability)",
                 " to determine if an item with specific options is available for purchase.",
                 "",
-                "> **Note:** This function replaces the deprecated [`$w.cartIcon.addToCart()`]($w/carticon/addtocart) and [`$w.cartIcon.addProductsToCart()`]($w/carticon/addproductstocart).",
-                "The deprecated functions will continue to work, but they will not receive updates.",
-                "To keep any existing code compatible with future changes, see each function's [migration instructions]($w/carticon/addtocart#migration-instructions)." ],
+                "> **Notes:**",
+                "+ If you use [`wix-stores-backend.createProduct()`](https://www.wix.com/velo/reference/wix-stores-backend/createproduct) immediately before adding that product to the cart, we suggest [setting a timeout](https://developer.mozilla.org/en-US/docs/Web/API/setTimeout) for `\"1000\"` milliseconds (1 second) before calling `cart.addProducts()`. While this slows down the operation slightly, it also ensures proper retrieval of the newly created product before adding it to the cart.",
+                "+ This function replaces the deprecated [`$w.cartIcon.addToCart()`]($w/carticon/addtocart) and [`$w.cartIcon.addProductsToCart()`]($w/carticon/addproductstocart). The deprecated functions will continue to work, but they will not receive updates. To keep any existing code compatible with future changes, see each function's [migration instructions]($w/carticon/addtocart#migration-instructions)." ],
             "links": [],
             "examples":
               [ { "title": "Add products to the cart",
