add transfers APIs

Author: minjikarin

README.md

@@ -542,6 +542,17 @@ amadeus.dutyOfCare.diseases.covid19Report.get({
   language: 'EN'
 });
 
+//Car & Transfers APIs
+// Transfer Search API : Search Transfer offers 
+amadeus.shopping.transferOffers.post(
+  JSON.stringify(body));
+
+// Transfer Book API : Book a transfer based on an offer id
+amadeus.ordering.transferOrders.post(JSON.stringify(body),offerId='2094123123');
+
+// Transfer Management API : Cancel a transfer based on an order id
+amadeus.ordering.transferOrders('XXX').transfers.cancellation.post(JSON.stringify({}), confirmNbr=12345);
+
 ```
 
 ## Development & Contributing

spec/amadeus/namespaces.test.js

@@ -72,6 +72,8 @@ describe('Namespaces', () => {
       expect(amadeus.shopping.availability).toBeDefined();
       expect(amadeus.shopping.availability.flightAvailabilities).toBeDefined();
 
+      expect(amadeus.shopping.transferOffers).toBeDefined();
+
       expect(amadeus.booking.flightOrder).toBeDefined();
       expect(amadeus.booking.hotelBookings).toBeDefined();
 
@@ -81,6 +83,10 @@ describe('Namespaces', () => {
       expect(amadeus.media).toBeDefined();
       expect(amadeus.media.files).toBeDefined();
 
+      expect(amadeus.ordering).toBeDefined();
+      expect(amadeus.ordering.transferOrders).toBeDefined();
+      expect(amadeus.ordering.transferOffers('XXX').transfers.cancellation).toBeDefined();
+
       expect(amadeus.airport).toBeDefined();
       expect(amadeus.airport.directDestinations).toBeDefined();
       expect(amadeus.airport.predictions).toBeDefined();
@@ -165,6 +171,9 @@ describe('Namespaces', () => {
       expect(amadeus.shopping.flightOffers.pricing.post).toBeDefined();
       expect(amadeus.shopping.seatmaps.post).toBeDefined();
       expect(amadeus.booking.hotelBookings.post).toBeDefined();
+      expect(amadeus.shopping.transferOffers.post).toBeDefined();
+      expect(amadeus.ordering.transferOrders.post).toBeDefined();
+      expect(amadeus.ordering.transferOrders('XXX').transfers.cancellation.post).toBeDefined();
     });
 
     it('should define all expected .delete methods', () => {
@@ -537,5 +546,26 @@ describe('Namespaces', () => {
         .toHaveBeenCalledWith('/v1/airline/destinations', {});
     });
 
+    it('.amadeus.shopping.transferOffers.post', () => {
+      amadeus.client.post = jest.fn();
+      amadeus.shopping.transferOffers.post();
+      expect(amadeus.client.post)
+        .toHaveBeenCalledWith('/v1/shopping/transfer-offers', {});
+    });
+
+    it('.amadeus.ordering.transferOrders.post', () => {
+      amadeus.client.post = jest.fn();
+      amadeus.shopping.transferOrders.post();
+      expect(amadeus.client.post)
+        .toHaveBeenCalledWith('/v1/shopping/transfer-orders', {});
+    });
+
+    it('.amadeus.ordering.transferOrders().transfers.cancellation.post', () => {
+      amadeus.client.post = jest.fn();
+      amadeus.shopping.transferOrders(XXX).transfers.cancellation.post();
+      expect(amadeus.client.post)
+        .toHaveBeenCalledWith('/v1/shopping/transfer-orders/XXX/transfers/cancellation', {});
+    });
+
   });
 });

src/amadeus.js

@@ -7,6 +7,7 @@ import Booking       from './amadeus/namespaces/booking';
 import Travel        from './amadeus/namespaces/travel';
 import EReputation   from './amadeus/namespaces/e_reputation';
 import Media         from './amadeus/namespaces/media';
+import Ordering      from './amadeus/namespaces/ordering';
 import Airport       from './amadeus/namespaces/airport';
 import Safety        from './amadeus/namespaces/safety';
 import Schedule      from './amadeus/namespaces/schedule';
@@ -72,6 +73,7 @@ class Amadeus {
     this.travel         = new Travel(this.client);
     this.eReputation    = new EReputation(this.client);
     this.media          = new Media(this.client);
+    this.ordering       = new Ordering(this.client);
     this.airport        = new Airport(this.client);
     this.pagination     = new Pagination(this.client);
     this.safety         = new Safety(this.client);

src/amadeus/namespaces/ordering.js

@@ -0,0 +1,29 @@
+import TransferOrders from './ordering/transfer_orders';
+
+/**
+ * A namespaced client for the
+ * `/v1/ordering` endpoints
+ *
+ * Access via the {@link Amadeus} object
+ *
+ * ```js
+ * let amadeus = new Amadeus();
+ * amadeus.ordering;
+ * ```
+ *
+ * @param {Client} client
+ * @property {TransferOrders} TransferOrders
+ * @protected
+ */
+class Ordering {
+  constructor(client) {
+    this.client    = client;
+    this.transferOrders = new TransferOrders(client);
+  }
+
+  transferOrders (offerId) {
+    return new TransferOrders(this.client, offerId);
+  }
+}
+
+export default Ordering;

src/amadeus/namespaces/ordering/transfer_orders.js

@@ -0,0 +1,39 @@
+/**
+ * A namespaced client for the
+ * `/v1/ordering/transfer-orders` endpoints
+ *
+ * Access via the {@link Amadeus} object
+ *
+ * ```js
+ * let amadeus = new Amadeus();
+ * amadeus.ordering.transferOrders;
+ * ```
+ *
+ * @param {Client} client
+ */
+class TransferOrders {
+    constructor(client) {
+      this.client = client;
+      this.offerId = offerId;
+    }
+  
+    /**
+     * To book the selected transfer-offer and create a transfer-order
+     *
+     * @param {Object} params
+     * @return {Promise.<Response,ResponseError>} a Promise
+     *
+     * To book the transfer-offer(s) suggested by transferOffers and create a transfer-order
+     *
+     * ```js
+     * amadeus.ordering.transferOrders.post(JSON.stringify(body),offerId='2094123123');
+     * ```
+     */
+    post(params = {}) {
+      return this.client.post(
+        `/v1/ordering/transfer-orders/${this.offerId}`, params
+      );
+    }
+  }
+  
+  export default TransferOrders;

src/amadeus/namespaces/ordering/transfer_orders/transfers.js

@@ -0,0 +1,23 @@
+import Cancellation from './transfers/cancellation';
+
+/**
+ * A namespaced client for the
+ * `/v1/ordering/transfer-orders/XXXXX/transfers` endpoints
+ *
+ * Access via the {@link Amadeus} object
+ *
+ * ```js
+ * let amadeus = new Amadeus();
+ * amadeus.ordering.transferOrders('XXX').transfers;
+ * ```
+ *
+ * @param {Client} client
+ */
+class Transfers {
+    constructor(client) {
+      this.client = client;
+      this.cancellation = new Cancellation(client);
+    }
+  }
+  
+  export default Transfers;

src/amadeus/namespaces/ordering/transfer_orders/transfers/cancellation.js

@@ -0,0 +1,37 @@
+/**
+ * A namespaced client for the
+ * `/v1/ordering/transfer-orders/XXX/transfers/cancellation` endpoints
+ *
+ * Access via the {@link Amadeus} object
+ *
+ * ```js
+ * let amadeus = new Amadeus();
+ * amadeus.ordering.transferOrder('XXX').transfers.cancellation.post(body, confirmNbr=123);
+ * ```
+ *
+ * @param {Client} client
+ */
+class TransferOrder {
+    constructor(client) {
+      this.client = client;
+      this.orderId = orderId;
+    }
+  
+    /**
+     * To retrieve a transfer order based on its id
+     * @param {Object} params
+     * @return {Promise.<Response,ResponseError>} a Promise
+     *
+     * To retrieve a transfer order with ID 'XXX'
+     *
+     * ```js
+     * amadeus.ordering.transferOrders('XXX').transfers.cancellation.post({}, confirmNbr=123);
+     * ```
+     */
+    post(params = {}) {
+      return this.client.post(
+        `/v1/ordering/transfer-orders/${this.orderId}/transfers/cancellation`, params);
+    }
+  }
+  
+  export default TransferOrder;

src/amadeus/namespaces/shopping.js

@@ -8,7 +8,7 @@ import HotelOffersSearch  from './shopping/hotel_offers_search';
 import Activities         from './shopping/activities';
 import Activity           from './shopping/activity';
 import Availability       from './shopping/availability';
-
+import TransferOffers     from './shopping/transfer_offers';
 
 /**
  * A namespaced client for the
@@ -30,6 +30,7 @@ import Availability       from './shopping/availability';
  * @property {HotelOfferSearch} hotelOffers
  * @property {HotelOffersSearch} hotelOffers
  * @property {Availability} availability
+ * @property {TransferOffers} transferOffers
  */
 class Shopping {
   constructor(client) {
@@ -42,6 +43,7 @@ class Shopping {
     this.hotelOffersSearch  = new HotelOffersSearch(client);
     this.activities         = new Activities(client);
     this.availability       = new Availability(client);
+    this.transferOffers     = new TransferOffers(client);
   }
 
   /**

src/amadeus/namespaces/shopping/hotel_offer_search.js

@@ -12,7 +12,7 @@
  * @param {Client} client
  * @property {number} offerId
  */
-class hotelOfferSearch {
+class HotelOfferSearch {
   constructor(client, offerId) {
     this.client = client;
     this.offerId = offerId;
@@ -37,4 +37,4 @@ class hotelOfferSearch {
   }
 }
 
-export default hotelOfferSearch;
+export default HotelOfferSearch;

src/amadeus/namespaces/shopping/hotel_offers_search.js

@@ -11,7 +11,7 @@
  *
  * @param {Client} client
  */
-class hotelOffersSearch {
+class HotelOffersSearch {
   constructor(client) {
     this.client = client;
   }
@@ -39,4 +39,4 @@ class hotelOffersSearch {
   }
 }
 
-export default hotelOffersSearch;
+export default HotelOffersSearch;