feat: allow guests as payload and receive it in some responses

Author: jekku

src/Stays/Stays.spec.ts

@@ -56,4 +56,63 @@ describe('Stays', () => {
     const response = await duffel.stays.search(mockSearchParams)
     expect(response.data).toEqual(mockResponse.data)
   })
+
+  it('should alternatively accept `guests` with `accommodation` as a search criteria and post it to /stays/search', async () => {
+    const mockResponse = { data: { results: [MOCK_SEARCH_RESULT] } }
+    const mockSearchParams = {
+      accommodation: {
+        ids: ['acc_12345'],
+        fetch_rates: true,
+      },
+      check_in_date: '2023-10-20',
+      check_out_date: '2023-10-24',
+      guests: [
+        { type: 'adult' },
+        { type: 'adult' },
+        { type: 'child', age: 5 },
+        { type: 'child', age: 11 },
+      ],
+      rooms: 2,
+    }
+
+    nock(/(.*)/)
+      .post('/stays/search', (body) => {
+        expect(body.data).toEqual(mockSearchParams)
+        return true
+      })
+      .reply(200, mockResponse)
+    const response = await duffel.stays.search(mockSearchParams)
+    expect(response.data).toEqual(mockResponse.data)
+  })
+
+  it('should alternatively accept `guests` with `location` as a search criteria and post it to /stays/search', async () => {
+    const mockResponse = { data: { results: [MOCK_SEARCH_RESULT] } }
+    const mockSearchParams = {
+      location: {
+        radius: 5,
+        geographic_coordinates: {
+          latitude: 40.73061,
+          longitude: -73.935242,
+        },
+      },
+      check_in_date: '2023-10-20',
+      check_out_date: '2023-10-24',
+      guests: [
+        { type: 'adult' },
+        { type: 'adult' },
+        { type: 'child', age: 5 },
+        { type: 'child', age: 11 },
+      ],
+      rooms: 2,
+    }
+
+    nock(/(.*)/)
+      .post('/stays/search', (body) => {
+        expect(body.data).toEqual(mockSearchParams)
+        return true
+      })
+      .reply(200, mockResponse)
+    const response = await duffel.stays.search(mockSearchParams)
+    expect(response.data).toEqual(mockResponse.data)
+  })
 })

src/Stays/StaysTypes.ts

@@ -530,6 +530,12 @@ export interface StaysQuote {
    * The number of rooms this quote is for
    */
   rooms: number
+
+  /*
+   * A list of guests representing the requested occupancy for this quote
+   */
+
+  guests: Array<Guest>
 }
 
 export type StaysBookingStatus = 'confirmed' | 'cancelled'
@@ -606,12 +612,19 @@ export interface StaysBooking {
   key_collection: StaysBookingKeyCollection | null
 }
 
-interface CommonStaysSearchParams {
+export type Guest = {
+  type: string
+  age?: number
+}
+
+type OccupancyCriteria = {
+  rooms: number
+} & ({ adults: number } | { guests: Array<Guest> })
+
+type CommonStaysSearchParams = {
   check_in_date: string
   check_out_date: string
-  adults: number
-  rooms: number
-}
+} & OccupancyCriteria
 
 type LocationSearchParams = {
   location: {
@@ -639,4 +652,5 @@ export interface StaysSearchResult {
   accommodation: StaysAccommodation
   adults: number
   rooms: number
+  guests: Array<Guest>
 }

src/Stays/mocks.ts

@@ -155,8 +155,9 @@ export const MOCK_SEARCH_RESULT: StaysSearchResult = {
   id: 'sta_something',
   check_in_date: '2023-03-24',
   check_out_date: '2023-03-28',
-  adults: 1,
+  adults: 2,
   rooms: 1,
+  guests: [{ type: 'adult' }, { type: 'adult' }],
 }
 
 export const MOCK_BOOKING: StaysBooking = {
@@ -213,6 +214,7 @@ export const MOCK_QUOTE: StaysQuote = {
   due_at_accommodation_currency: 'USD',
   supported_loyalty_programme: 'duffel_hotel_group_rewards',
   card_component_key: null,
-  adults: 1,
+  adults: 2,
   rooms: 1,
+  guests: [{ type: 'adult' }, { type: 'adult' }],
 }