fix: medusa-js complete cart types + oas comments (#889)

packages/medusa-js/src/resources/carts.ts

@@ -1,10 +1,12 @@
 import {
   StoreCartsRes,
+  StoreOrdersRes,
   StorePostCartReq,
   StorePostCartsCartPaymentSessionReq,
   StorePostCartsCartPaymentSessionUpdateReq,
   StorePostCartsCartReq,
   StorePostCartsCartShippingMethodReq,
+  StoreSwapsRes,
 } from "@medusajs/medusa"
 import { ResponsePromise } from "../typings"
 import BaseResource from "./base"
@@ -34,9 +36,11 @@ class CartsResource extends BaseResource {
    * The completion of a cart can be performed idempotently with a provided header Idempotency-Key.
    * If not provuided, we will generate one for the request.
    * @param {string} cart_id is required
-   * @return {ResponsePromise<StoreCartsRes>}
+   * @return {ResponsePromise<StoreCartsRes | StoreSwapsRes | StoreOrdersRes>}
    */
-  complete(cart_id: string): ResponsePromise<StoreCartsRes> {
+  complete(
+    cart_id: string
+  ): ResponsePromise<StoreCartsRes | StoreSwapsRes | StoreOrdersRes> {
     const path = `/store/carts/${cart_id}/complete`
     return this.client.request("POST", path)
   }

packages/medusa/src/api/routes/store/carts/complete-cart.ts

@@ -38,6 +38,10 @@ import {
  *              properties:
  *                cart:
  *                  $ref: "#/components/schemas/cart"
+ *            - type: object
+ *              properties:
+ *                cart:
+ *                  $ref: "#/components/schemas/swap"
  */
 export default async (req, res) => {
   const { id } = req.params