chore(docs): Generated API Reference (#5601)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>

www/apps/api-reference/specs/store/paths/store_auth.yaml

@@ -91,6 +91,10 @@ delete:
   x-codegen:
     method: deleteSession
   x-codeSamples:
+    - lang: JavaScript
+      label: JS Client
+      source:
+        $ref: ../code_samples/JavaScript/store_auth/delete.js
     - lang: Shell
       label: cURL
       source:

www/apps/api-reference/specs/store/paths/store_carts.yaml

@@ -10,8 +10,8 @@ post:
     changes their region.
 
 
-    If a customer is logged in, the cart's customer ID and email will
-    automatically be set.
+    If a customer is logged in, make sure to pass its ID or email within the
+    cart's details so that the cart is attached to the customer.
   requestBody:
     content:
       application/json:

www/apps/api-reference/specs/store/paths/store_carts_{id}_complete.yaml

@@ -2,8 +2,8 @@ post:
   summary: Complete a Cart
   operationId: PostCartsCartComplete
   description: >
-    Complete a cart and place an order or create a swap, based on what the cart
-    is created for. This includes attempting to authorize the cart's payment.
+    Complete a cart and place an order or create a swap, based on the cart's
+    type. This includes attempting to authorize the cart's payment.
 
     If authorizing the payment requires more action, the cart will not be
     completed and the order will not be placed or the swap will not be created.

www/apps/api-reference/specs/store/paths/store_carts_{id}_discounts_{code}.yaml

@@ -3,8 +3,8 @@ delete:
   summary: Remove Discount
   description: >-
     Remove a Discount from a Cart. This only removes the application of the
-    discount, and not completely delete it. The totals will be re-calculated and
-    the payment sessions will be refreshed after the removal.
+    discount, and not completely deletes it. The totals will be re-calculated
+    and the payment sessions will be refreshed after the removal.
   parameters:
     - in: path
       name: id

www/apps/api-reference/specs/store/paths/store_carts_{id}_payment-sessions.yaml

@@ -3,7 +3,7 @@ post:
   summary: Create Payment Sessions
   description: >-
     Create Payment Sessions for each of the available Payment Providers in the
-    Cart's Region. If there only one payment session is created, it will be
+    Cart's Region. If there's only one payment session created, it will be
     selected by default. The creation of the payment session uses the payment
     provider and may require sending requests to third-party services.
   parameters:

www/apps/api-reference/specs/store/paths/store_payment-collections_{id}_sessions_batch.yaml

@@ -10,7 +10,7 @@ post:
     - in: path
       name: id
       required: true
-      description: The ID of the Payment Collections.
+      description: The ID of the Payment Collection.
       schema:
         type: string
   requestBody:

www/apps/api-reference/specs/store/paths/store_payment-collections_{id}_sessions_{session_id}_authorize.yaml

@@ -7,7 +7,7 @@ post:
     - in: path
       name: id
       required: true
-      description: The ID of the Payment Collections.
+      description: The ID of the Payment Collection.
       schema:
         type: string
     - in: path

www/apps/api-reference/specs/store/paths/store_variants.yaml

@@ -147,6 +147,10 @@ get:
     method: list
     queryParams: StoreGetVariantsParams
   x-codeSamples:
+    - lang: JavaScript
+      label: JS Client
+      source:
+        $ref: ../code_samples/JavaScript/store_variants/get.js
     - lang: Shell
       label: cURL
       source:

www/apps/api-reference/specs/store/paths/store_variants_{id}.yaml

@@ -62,6 +62,10 @@ get:
     method: retrieve
     queryParams: StoreGetVariantsVariantParams
   x-codeSamples:
+    - lang: JavaScript
+      label: JS Client
+      source:
+        $ref: ../code_samples/JavaScript/store_variants_{id}/get.js
     - lang: Shell
       label: cURL
       source: