Merge pull request #148 from amadeus4dev/add-hotel-search-v3-only

add hotel search v3, keep v2

Author: tsolakoua

README.md

@@ -374,6 +374,15 @@ amadeus.shopping.hotelOffersByHotel.get({
 // Confirm the availability of a specific offer id
 amadeus.shopping.hotelOffer('XXX').get()
 
+// Hotel Search API V3
+// Get list of available offers in specific hotels by hotel ids
+amadeus.shopping.hotelOffersSearch.get({
+    hotelIds: 'RTPAR001',
+    adults: '2'
+})
+// Check offer conditions of a specific offer id
+amadeus.shopping.hotelOfferSearch('XXX').get()
+
 // Hotel Booking API
 amadeus.booking.hotelBookings.post(
   JSON.stringify({

spec/amadeus/namespaces.test.js

@@ -69,6 +69,9 @@ describe('Namespaces', () => {
       expect(amadeus.shopping.hotelOffersByHotel).toBeDefined();
       expect(amadeus.shopping.hotelOffer).toBeDefined();
 
+      expect(amadeus.shopping.hotelOfferSearch).toBeDefined();
+      expect(amadeus.shopping.hotelOffersSearch).toBeDefined();
+
       expect(amadeus.shopping.availability).toBeDefined();
       expect(amadeus.shopping.availability.flightAvailabilities).toBeDefined();
 
@@ -131,6 +134,9 @@ describe('Namespaces', () => {
       expect(amadeus.shopping.hotelOffersByHotel.get).toBeDefined();
       expect(amadeus.shopping.hotelOffer('XXX').get).toBeDefined();
 
+      expect(amadeus.shopping.hotelOfferSearch('XXX').get).toBeDefined();
+      expect(amadeus.shopping.hotelOffersSearch.get).toBeDefined();
+
       expect(amadeus.shopping.activities.get).toBeDefined();
       expect(amadeus.shopping.activities.bySquare.get).toBeDefined();
       expect(amadeus.shopping.activity('XXX').get).toBeDefined();
@@ -399,6 +405,20 @@ describe('Namespaces', () => {
         .toHaveBeenCalledWith('/v2/shopping/hotel-offers/XXX', {});
     });
 
+    it('.amadeus.shopping.hotelOfferSearch().get', () => {
+      amadeus.client.get = jest.fn();
+      amadeus.shopping.hotelOfferSearch('XXX').get();
+      expect(amadeus.client.get)
+        .toHaveBeenCalledWith('/v3/shopping/hotel-offers/XXX', {});
+    });
+
+    it('.amadeus.shopping.hotelOffersSearch.get', () => {
+      amadeus.client.get = jest.fn();
+      amadeus.shopping.hotelOffersSearch.get();
+      expect(amadeus.client.get)
+        .toHaveBeenCalledWith('/v3/shopping/hotel-offers', {});
+    });
+
     it('.amadeus.shopping.activities.get', () => {
       amadeus.client.get = jest.fn();
       amadeus.shopping.activities.get();

src/amadeus/namespaces/shopping.js

@@ -6,14 +6,16 @@ import Seatmaps           from './shopping/seatmaps';
 import HotelOffers        from './shopping/hotel_offers';
 import HotelOffersByHotel from './shopping/hotel_offers_by_hotel';
 import HotelOffer         from './shopping/hotel_offer';
+import HotelOfferSearch   from './shopping/hotel_offer_search';
+import HotelOffersSearch  from './shopping/hotel_offers_search';
 import Activities         from './shopping/activities';
 import Activity           from './shopping/activity';
 import Availability       from './shopping/availability';
 
 
 /**
  * A namespaced client for the
- * `/v1/shopping` and `/v2/shopping` endpoints
+ * `/v1/shopping`, `/v2/shopping` and `/v3/shopping` endpoints
  *
  * Access via the {@link Amadeus} object
  *
@@ -31,6 +33,8 @@ import Availability       from './shopping/availability';
  * @property {HotelOffers} hotelOffers
  * @property {HotelOffer} hotelOffer
  * @property {HotelOffersByHotel} hotelOffersByHotel
+ * @property {HotelOfferSearch} hotelOffers
+ * @property {HotelOffersSearch} hotelOffers
  * @property {Availability} availability
  */
 class Shopping {
@@ -43,13 +47,14 @@ class Shopping {
     this.seatmaps           = new Seatmaps(client);
     this.hotelOffers        = new HotelOffers(client);
     this.hotelOffersByHotel = new HotelOffersByHotel(client);
+    this.hotelOffersSearch  = new HotelOffersSearch(client);
     this.activities         = new Activities(client);
     this.availability       = new Availability(client);
   }
 
 
   /**
-   * Loads a namespaced path for a specific offer ID
+   * Loads a namespaced path for a specific offer ID for Hotel Search V2
    *
    * @param  {string} [offerId]  The ID of the offer for a dedicated hotel
    * @return {HotelOffer}
@@ -58,6 +63,16 @@ class Shopping {
     return new HotelOffer(this.client, offerId);
   }
 
+  /**
+   * Loads a namespaced path for a specific offer ID for Hotel Search V3
+   *
+   * @param  {string} [offerId]  The ID of the offer for a dedicated hotel
+   * @return {HotelOfferSearch}
+   **/
+  hotelOfferSearch(offerId) {
+    return new HotelOfferSearch(this.client, offerId);
+  }
+
   /**
    * Loads a namespaced path for a specific activity ID
    *

src/amadeus/namespaces/shopping/hotel_offer_search.js

@@ -0,0 +1,40 @@
+/**
+ * A namespaced client for the
+ * `/v3/shopping/hotel-offers/:offer_id` endpoints
+ *
+ * Access via the {@link Amadeus} object
+ *
+ * ```js
+ * let amadeus = new Amadeus();
+ * amadeus.shopping.hotelOfferSearch('XXX');
+ * ```
+ *
+ * @param {Client} client
+ * @property {number} offerId
+ */
+class hotelOfferSearch {
+  constructor(client, offerId) {
+    this.client = client;
+    this.offerId = offerId;
+  }
+
+  /**
+   * Returns details for a specific offer
+   *
+   * @param {Object} params
+   * @return {Promise.<Response,ResponseError>} a Promise
+   *
+   * Find details for the offer with ID 'XXX'
+   *
+   * ```js
+   *  amadeus.shopping.hotelOfferSearch('XXX').get();
+   * ```
+   */
+  get(params = {}) {
+    return this.client.get(
+      `/v3/shopping/hotel-offers/${this.offerId}`, params
+    );
+  }
+}
+
+export default hotelOfferSearch;

src/amadeus/namespaces/shopping/hotel_offers_search.js

@@ -0,0 +1,42 @@
+/**
+ * A namespaced client for the
+ * `/v3/shopping/hotel-offers` endpoints
+ *
+ * Access via the {@link Amadeus} object
+ *
+ * ```js
+ * let amadeus = new Amadeus();
+ * amadeus.shopping.hotelOffersSearch;
+ * ```
+ *
+ * @param {Client} client
+ */
+class hotelOffersSearch {
+  constructor(client) {
+    this.client = client;
+  }
+
+  /**
+   * Find the list of available offers in the specific hotels
+   *
+   * @param {Object} params
+   * @param {string} params.hotelIds Comma separated list of Amadeus hotel
+   * codes to request. Example: RTPAR001
+   * @param {string} params.adults Number of adult guests (1-9) per room.
+   * @return {Promise.<Response,ResponseError>} a Promise
+   *
+   * Search for available offers in Novotel Paris for 2 adults
+   *
+   * ```js
+   * amadeus.shopping.hotelOffersSearch.get({
+   *   hotelIds: 'RTPAR001',
+   *   adults: '2'
+   * })
+   * ```
+   */
+  get(params = {}) {
+    return this.client.get('/v3/shopping/hotel-offers', params);
+  }
+}
+
+export default hotelOffersSearch;