@revolugo/common 7.0.0 → 7.0.1-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revolugo/common",
-  "version": "7.0.0",
+  "version": "7.0.1-alpha.1",
   "private": false,
   "description": "Revolugo common",
   "author": "Revolugo",
@@ -34,7 +34,7 @@
     "dayjs": "1.11.19",
     "ky": "1.14.3",
     "slugify": "1.6.6",
-    "type-fest": "5.4.3",
+    "type-fest": "5.4.4",
     "uuid": "13.0.0",
     "zod": "4.3.6"
   },

package/src/cancellation-policies.test.ts

@@ -238,7 +238,10 @@ describe('sanitizeCancellationPolicies', () => {
 
     describe('when Booking Date < Release Date < Check In Date', () => {
       const releaseDate = '2021-01-05'
-      const releaseDatetime = getFormattedUTCLocalTime(releaseDate, timezone)
+      const releaseDateCP = dayjs(releaseDate)
+        .add(1, 'day')
+        .format('YYYY-MM-DD')
+      const releaseDatetime = getFormattedUTCLocalTime(releaseDateCP, timezone)
       const bookingDatetime = getFormattedUTCLocalTime(
         '2021-01-01T10:00:00',
         timezone,
@@ -404,7 +407,10 @@ describe('sanitizeCancellationPolicies', () => {
 
     describe('when Booking Date < Release Date < DF_0', () => {
       const releaseDate = '2020-12-30'
-      const releaseDatetime = getFormattedUTCLocalTime(releaseDate, timezone)
+      const releaseDateCP = dayjs(releaseDate)
+        .add(1, 'day')
+        .format('YYYY-MM-DD')
+      const releaseDatetime = getFormattedUTCLocalTime(releaseDateCP, timezone)
       const bookingDatetime = getFormattedUTCLocalTime(
         '2020-12-20T10:00:00',
         timezone,

package/src/cancellation-policies.ts

@@ -34,6 +34,31 @@ export interface SanitizeCancellationPolicies {
   timezone?: string
 }
 
+function initReleaseDateUTC({
+  checkInDate,
+  releaseDate,
+  timezone,
+}: {
+  releaseDate?: string
+  timezone: string
+  checkInDate: string
+}): string | undefined {
+  if (!releaseDate) {
+    return undefined
+  }
+
+  if (dayjs(releaseDate).isSameOrAfter(dayjs(checkInDate))) {
+    return dayjs.tz(releaseDate, timezone).startOf('day').utc().format()
+  }
+
+  return dayjs
+    .tz(releaseDate, timezone)
+    .add(1, 'day')
+    .startOf('day')
+    .utc()
+    .format()
+}
+
 // eslint-disable-next-line complexity, max-statements, max-lines-per-function
 export function sanitizeCancellationPolicies({
   bookingDatetime,
@@ -62,8 +87,11 @@ export function sanitizeCancellationPolicies({
 
   const nextDayCheckInDateUTC = nextDay(checkInDatetimeUTC)
 
-  const releaseDatetimeUTC =
-    releaseDate && dayjs.tz(releaseDate, timezone).startOf('day').utc().format()
+  const releaseDatetimeUTC = initReleaseDateUTC({
+    checkInDate,
+    releaseDate,
+    timezone,
+  })
 
   if (dayjs(bookingDatetimeUTC).isAfter(nextDayCheckInDateUTC)) {
     return sanitizeCancellationPolicies({
@@ -452,10 +480,10 @@ export function getSanitizedCancellationPolicies({
   initialDate,
   timezone,
 }: {
-  checkInDate: string
   cancellationPolicies: ICancellationPolicy[]
-  timezone?: string
+  checkInDate: string
   initialDate?: string
+  timezone?: string
 }): ICancellationPolicy[] {
   if (!cancellationPolicies.length) {
     return []
@@ -511,3 +539,28 @@ export function isFreeCancellable(cps: ICancellationPolicy[]): boolean {
       dayjs().isBetween(dayjs(freeCp.dateFrom), dayjs(freeCp.dateTo)))
   )
 }
+
+export function filterForCustomers(
+  cps: ICancellationPolicy[],
+): ICancellationPolicy[] {
+  const now = dayjs()
+  const nowPlus2Hours = now.add(2, 'hours')
+
+  return cps.reduce<ICancellationPolicy[]>((result, cp) => {
+    if (
+      dayjs(cp.dateFrom).isSameOrBefore(nowPlus2Hours) &&
+      dayjs(cp.dateTo).isAfter(nowPlus2Hours)
+    ) {
+      result.push({
+        ...cp,
+        dateFrom: now.format(),
+      })
+    }
+
+    if (dayjs(cp.dateFrom).isAfter(nowPlus2Hours)) {
+      result.push(cp)
+    }
+
+    return result
+  }, [])
+}

package/src/currencies/types.ts

@@ -3,11 +3,11 @@ import type { CurrencyCode } from './constants.ts'
 export interface ICurrency {
   code: CurrencyCode
   decimalDigits: number
+  deprecated?: boolean
   name: string
   namePlural: string
   rounding: number
   symbol: string
   symbolNative: string
   zeroDecimal: boolean
-  deprecated?: boolean
 }

package/src/currencies/utils.ts

@@ -98,49 +98,50 @@ export class MoneyCalculator {
     this.isNormalized = isNormalized
   }
 
-  public denormalize(): this {
-    if (!this.isNormalized) {
+  public ceil(): this {
+    this.amount = Math.ceil(this.amount)
+
+    return this
+  }
+
+  public convert({
+    currency,
+    exchangeRate,
+  }: {
+    currency: CurrencyCode
+    exchangeRate: number
+  }): this {
+    if (this.currency === currency || this.amount === 0) {
       return this
     }
 
-    this.amount = denormalizeAmount({
-      amount: this.amount,
-      currency: this.currency,
-    })
+    const startingIsNormalized = this.isNormalized
 
-    this.isNormalized = false
+    if (startingIsNormalized) {
+      this.denormalize()
+    }
 
-    return this
-  }
+    this.amount *= exchangeRate
+    this.currency = currency
 
-  public markup(percentage: number): this {
-    this.amount /= 1 - percentage
+    if (startingIsNormalized) {
+      this.normalize()
+    }
 
     return this
   }
 
-  public normalize(): this {
-    if (this.isNormalized) {
+  public denormalize(): this {
+    if (!this.isNormalized) {
       return this
     }
 
-    this.amount = Number(
-      normalizeAmount({
-        // Making sure we only have 2 decimals after comma
-        amount: Number(this.amount.toFixed(2)),
-        currency: this.currency,
-        // Making sure Javascript doesnt give us back a float number
-        // 1172.64 * 100 = 117264.00000000001 💩
-      }).toFixed(0),
-    )
-
-    this.isNormalized = true
-
-    return this
-  }
+    this.amount = denormalizeAmount({
+      amount: this.amount,
+      currency: this.currency,
+    })
 
-  public ceil(): this {
-    this.amount = Math.ceil(this.amount)
+    this.isNormalized = false
 
     return this
   }
@@ -151,12 +152,6 @@ export class MoneyCalculator {
     return this
   }
 
-  public round(): this {
-    this.amount = Math.round(this.amount)
-
-    return this
-  }
-
   public format(locale?: string, space?: string): string {
     return formatAmount({
       amount: this.amount,
@@ -170,29 +165,34 @@ export class MoneyCalculator {
     return this.amount
   }
 
-  public convert({
-    currency,
-    exchangeRate,
-  }: {
-    exchangeRate: number
-    currency: CurrencyCode
-  }): this {
-    if (this.currency === currency || this.amount === 0) {
+  public markup(percentage: number): this {
+    this.amount /= 1 - percentage
+
+    return this
+  }
+
+  public normalize(): this {
+    if (this.isNormalized) {
       return this
     }
 
-    const startingIsNormalized = this.isNormalized
+    this.amount = Number(
+      normalizeAmount({
+        // Making sure we only have 2 decimals after comma
+        amount: Number(this.amount.toFixed(2)),
+        currency: this.currency,
+        // Making sure Javascript doesnt give us back a float number
+        // 1172.64 * 100 = 117264.00000000001 💩
+      }).toFixed(0),
+    )
 
-    if (startingIsNormalized) {
-      this.denormalize()
-    }
+    this.isNormalized = true
 
-    this.amount *= exchangeRate
-    this.currency = currency
+    return this
+  }
 
-    if (startingIsNormalized) {
-      this.normalize()
-    }
+  public round(): this {
+    this.amount = Math.round(this.amount)
 
     return this
   }

package/src/schemas/hotel-room-offer.ts

@@ -5,12 +5,14 @@ import {
   BreakfastOption,
   HotelRoomOfferType,
   PackageType,
+  StayTaxesInfoEnum,
 } from '../constants/index.ts'
 
 import { CANCELLATION_POLICY_SCHEMA } from './cancellation-policies.ts'
 import { CURRENCY_SCHEMA } from './currency.ts'
 import { SOURCE_MARKET_SCHEMA } from './hotel-offer-request.ts'
 import { HOTEL_ROOMS_SCHEMA } from './hotel-room.ts'
+import { LIST_POLLING_META_SCHEMA } from './list-polling-meta.ts'
 import { TAGS_SCHEMA } from './tag.ts'
 import { TAXES_SCHEMA } from './taxes.ts'
 
@@ -27,21 +29,17 @@ export const PACKAGE_TYPES_DESCRIPTION = `An **Hotel Room Offer** of type **${Ho
 
 export const HOTEL_ROOM_OFFER_SCHEMA = z
   .object({
-    breakfast_count: z.number().min(0).optional().nullish().openapi({
+    breakfast_count: z.number().min(0).nullish().openapi({
       description:
         'Quantity of breakfast per night included in the given **Hotel Room Offer**',
     }),
     breakfast_option: z.enum(BreakfastOption).openapi({
       description: BREAKFAST_OPTION_DESCRIPTION,
     }),
-    breakfast_price_per_guest_per_night: z
-      .number()
-      .optional()
-      .nullish()
-      .openapi({
-        description:
-          'Price of breakfast per guest per night for the given **Hotel Room Offer**, expressed in the requested **currency**, when applicable.\n\n <div style="background-color: #ffffef; padding: 20px; border: 1px solid lightgrey; border-radius: 5px;"><b style="color: red; margin-top: 10px;">🛑 DEPRECATED.</b>\n\n <b style="color: orange;">Field renamed to "breakfast_unit_price"</div>',
-      }),
+    breakfast_price_per_guest_per_night: z.number().nullish().openapi({
+      description:
+        'Price of breakfast per guest per night for the given **Hotel Room Offer**, expressed in the requested **currency**, when applicable.\n\n <div style="background-color: #ffffef; padding: 20px; border: 1px solid lightgrey; border-radius: 5px;"><b style="color: red; margin-top: 10px;">🛑 DEPRECATED.</b>\n\n <b style="color: orange;">Field renamed to "breakfast_unit_price"</div>',
+    }),
     breakfast_unit_price: z.number().optional().nullish().openapi({
       description:
         'Price of breakfast per guest per night for the given **Hotel Room Offer**, expressed in the requested **currency**, when applicable.',
@@ -54,7 +52,6 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       }),
     count: z
       .number()
-      .optional()
       .nullish()
       .openapi({
         description: `When **type = ${HotelRoomOfferType.HotelRoom}**: this parameters represents the available quantity for the given **Hotel Room Offer**.
@@ -73,13 +70,15 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       .openapi({
         description: PACKAGE_TYPES_DESCRIPTION,
       })
-      .nullish()
-      .optional(),
+      .nullish(),
     price: z.number().openapi({
       description:
         'Price with taxes NOT INCLUDED of the given **Hotel Room Offer** including breakfast(s) when applicable, expressed in the requested **currency**.',
     }),
     source_market: SOURCE_MARKET_SCHEMA,
+    stay_taxes_info: z
+      .enum(StayTaxesInfoEnum)
+      .openapi({ description: 'Either INCLUDED, NOT_INCLUDED or UNKNOWN' }),
     tags: TAGS_SCHEMA,
     tax_included_price: z.number().openapi({
       description: `Price of the given **Hotel Room Offer** including breakfast(s) when applicable, and including all taxes from returned **taxes** list parameter expressed in the requested **currency**.\n\nThis data is not returned for a **Hotel Room Offer** of type **${HotelRoomOfferType.HotelRoom}**, you'll need to compute and display the actual tax included price of the final **Hotel Room** package corresponding to the guest count and night count requested, or make a call to the **[Create Hotel Room Offer](/v1/documentation#operation/postV1Hotel_room_offers)** endpoint in order to get a valid and bookable **Hotel Room Offer** where **type = ${HotelRoomOfferType.Package}** based on a packaged list of **Hotel Room Offers** of type **${HotelRoomOfferType.HotelRoom}**.`,
@@ -90,10 +89,16 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       .openapi({
         description: `Hotel Room Offer type.\n\n **Hotel Room Offers** with **type = "${HotelRoomOfferType.Package}"** are **Hotel Room Offers** that are already bookable and you'll be able to follow the next step of the **Booking Flow** calling **[Create Booking Policies endpoint](/v1/documentation#operation/postV1Booking_policies)**. \n\n Otherwise, you'll be able to create a new **Hotel Room Offer** with **type = "${HotelRoomOfferType.Package}"** from multiple **Hotel Room Offers** with **type = "${HotelRoomOfferType.HotelRoom}"**. See **[Create Hotel Room Offer endpoint](/v1/documentation#operation/postV1Hotel_room_offers)** for details.`,
       })
-      .nullish()
       .optional(),
   })
   .openapi('hotelRoomOfferApi', {
     description: 'Description of the Hotel Room Offer.',
   })
+
+export const HOTEL_ROOM_OFFERS_SCHEMA = z.array(HOTEL_ROOM_OFFER_SCHEMA)
+
+export const HOTEL_ROOM_OFFERS_RESPONSE_SCHEMA = z.object({
+  data: HOTEL_ROOM_OFFERS_SCHEMA,
+  meta: LIST_POLLING_META_SCHEMA,
+})
 /* eslint-enable camelcase */

package/src/schemas/hotel-room.ts

@@ -57,10 +57,7 @@ export const HOTEL_ROOM_SCHEMA = z
       .openapi({ description: 'Whether high resolution images are available.' })
       .optional()
       .nullish(),
-    id: z
-      .string()
-      .optional()
-      .openapi({ description: 'Hotel Room id, when applicable.' }),
+    id: z.string().openapi({ description: 'Hotel Room id, when applicable.' }),
     image_indexes: z.array(z.number()).optional().nullish().openapi({
       description:
         'List of indexes corresponding to image names for the given Hotel Room among the related hotel images.',

package/src/types/calendar.ts

@@ -6,11 +6,11 @@ export interface ICalendarRange<
   T extends ICalendarRangeDay = ICalendarRangeDay,
   U = Record<string, unknown> | undefined,
 > {
+  id: string
+  data: U
   dateFrom: string
   dateTo: string
   days: T[]
-  data: U
-  id: string
   name: string
   resourceId: string
 }

package/src/types/elements/amenity.ts

@@ -113,6 +113,12 @@ export interface Amenities {
    * @memberof Amenities
    */
   handicapAccessible?: boolean
+  /**
+   * Indoor pool.
+   * @type {boolean}
+   * @memberof Amenities
+   */
+  indoorPool?: boolean
   /**
    * In house bar.
    * @type {boolean}
@@ -131,12 +137,6 @@ export interface Amenities {
    * @memberof Amenities
    */
   inRoomMovies?: boolean
-  /**
-   * Indoor pool.
-   * @type {boolean}
-   * @memberof Amenities
-   */
-  indoorPool?: boolean
   /**
    * Interior room entrance.
    * @type {boolean}
@@ -216,17 +216,17 @@ export interface Amenities {
    */
   sauna?: boolean
   /**
-   * TV in room.
+   * Tennis court.
    * @type {boolean}
    * @memberof Amenities
    */
-  tVInRoom?: boolean
+  tennisCourt?: boolean
   /**
-   * Tennis court.
+   * TV in room.
    * @type {boolean}
    * @memberof Amenities
    */
-  tennisCourt?: boolean
+  tVInRoom?: boolean
   /**
    *  24/7 security.
    * @type {boolean}

package/src/types/elements/booking-policy.ts

@@ -3,6 +3,12 @@ import type { CurrencyType } from './currency.ts'
 import type { HotelRoomOffer } from './hotel-room-offer.ts'
 
 export interface BookingPolicies {
+  /**
+   * **Booking Policy** id
+   * @type {string}
+   * @memberof BookingPolicies
+   */
+  id: string
   /**
    * The total number of adults who will be staying in the property.
    * @type {number}
@@ -39,6 +45,7 @@ export interface BookingPolicies {
    * @memberof BookingPolicies
    */
   currency: CurrencyType
+
   /**
    * Expiration date for this **Booking Policy**.
    *
@@ -47,7 +54,6 @@ export interface BookingPolicies {
    * @memberof BookingPolicies
    */
   expiresAt: string | null
-
   hasRoomingLists: boolean
   /**
    * Hotel id
@@ -61,12 +67,6 @@ export interface BookingPolicies {
    * @memberof BookingPolicies
    */
   hotelRoomOffer: HotelRoomOffer
-  /**
-   * **Booking Policy** id
-   * @type {string}
-   * @memberof BookingPolicies
-   */
-  id: string
   /**
    * Indicates whether the price of the **Hotel Room Offer** (without breakfast included) has increased compared to the price returned by [Retrieve Hotel Room Offers endpoint](/v1/documentation#operation/getV1Hotel_room_offers).
    *

package/src/types/elements/booking.ts

@@ -10,6 +10,12 @@ import type { SourceMarket } from './source-market.ts'
 import type { Tax } from './tax.ts'
 
 export interface Booking {
+  /**
+   * Booking Id
+   * @type {string}
+   * @memberof Booking
+   */
+  id?: string | null
   /**
    * The total number of adults who will be staying in the property.
    * @type {number}
@@ -100,12 +106,6 @@ export interface Booking {
    * @memberof Booking
    */
   hotelId: string
-  /**
-   *
-   * @type {HotelRoomOffer}
-   * @memberof Booking
-   */
-  hotelRoomOffer: HotelRoomOffer
   /**
    * Hotel rooming lists of a hotel booking
    * @type {Array<HotelRoomingList>}
@@ -113,11 +113,11 @@ export interface Booking {
    */
   hotelRoomingLists?: HotelRoomingList[]
   /**
-   * Booking Id
-   * @type {string}
+   *
+   * @type {HotelRoomOffer}
    * @memberof Booking
    */
-  id?: string | null
+  hotelRoomOffer: HotelRoomOffer
   /**
    * The list of invoices and credit notes (when applicable) direct urls associated to the Booking.
    * @type {Array<InvoiceApi>}
@@ -184,18 +184,18 @@ export interface Booking {
    * @memberof Booking
    */
   taxAmount: number
-  /**
-   * Price of the booking including taxes expressed in the booking currency.
-   * @type {number}
-   * @memberof Booking
-   */
-  taxIncludedPrice: number
   /**
    *
    * @type {Array<Tax>}
    * @memberof Booking
    */
   taxes?: Tax[] | null
+  /**
+   * Price of the booking including taxes expressed in the booking currency.
+   * @type {number}
+   * @memberof Booking
+   */
+  taxIncludedPrice: number
   /**
    * Link to Revolugo terms and conditions under which the booking is made.
    * @type {string}

package/src/types/elements/contact-person.ts

@@ -167,4 +167,11 @@ export interface PrebookFormValues {
   phoneNumber: string
   salutation: ContactPerson['salutation']
   specialRequests: ContactPerson['remarks']
+  organizationAddress?: string
+  organizationCity?: string
+  organizationCountry?: string
+  organizationName?: string
+  organizationState?: string
+  organizationVatNumber?: string
+  organizationZipCode?: string
 }

package/src/types/elements/event-metadata.ts

@@ -1,22 +1,22 @@
 export interface EventMetadata {
   /**
-   * End date of the event formatted as YYYY-MM-DD.
+   * Unique id of the event
    * @type {string}
    * @memberof EventMetadata
    */
-  dateEnd?: string
+  id?: string
   /**
-   * Start date of the event formatted as YYYY-MM-DD.
+   * End date of the event formatted as YYYY-MM-DD.
    * @type {string}
    * @memberof EventMetadata
    */
-  dateStart?: string
+  dateEnd?: string
   /**
-   * Unique id of the event
+   * Start date of the event formatted as YYYY-MM-DD.
    * @type {string}
    * @memberof EventMetadata
    */
-  id?: string
+  dateStart?: string
   /**
    * Image URL of the event
    * @type {string}

package/src/types/elements/hotel-offer-list.ts

@@ -12,11 +12,11 @@ export type HotelOffersSortByOrderType = `${HotelOffersSortByOrderEnum}`
 
 export interface HotelOffersListPayload {
   currency: CurrencyType
-  hotelOfferRequestId: string
   endingBefore?: string | null
   filterByPrice?: string
   filterByReviewRating?: number
   filterByStar?: string
+  hotelOfferRequestId: string
   hotelRoomOffersLimit?: number
   includeHotelContentDetails?: boolean | null
   lang?: Locale

package/src/types/elements/hotel-offer-request.ts

@@ -2,6 +2,11 @@ import type { EventMetadata } from './event-metadata.ts'
 import type { SourceMarket } from './source-market.ts'
 
 export interface HotelOfferRequest {
+  /**
+   * id of the **Hotel Offer Request**
+   * @type {string}
+   */
+  id: string
   /**
    * This endpoint allows to find the geo-coordinates of a known address, place or locality via this free-text address query field. This address will eventually be geocoded into a latitude/longitude pair.
    *
@@ -29,6 +34,12 @@ export interface HotelOfferRequest {
    * @type {string}
    */
   children?: string | null
+  /**
+   * Date of the **Hotel Room Offer Request** creation
+   * @type {string}
+   * @memberof HotelOfferRequestApiResponse
+   */
+  createdAt: string
   /**
    *
    * @type {EventMetadata}
@@ -60,20 +71,15 @@ export interface HotelOfferRequest {
    * @type {SourceMarket}
    */
   sourceMarket: SourceMarket
-  /**
-   * Date of the **Hotel Room Offer Request** creation
-   * @type {string}
-   * @memberof HotelOfferRequestApiResponse
-   */
-  createdAt: string
+}
+
+export interface HotelOfferRequestResponse {
   /**
    * id of the **Hotel Offer Request**
    * @type {string}
+   * @memberof HotelOfferRequestApiResponse
    */
   id: string
-}
-
-export interface HotelOfferRequestResponse {
   /**
    * This endpoint allows to find the geo-coordinates of a known address, place or locality via this free-text address query field. This address will eventually be geocoded into a latitude/longitude pair.
    *
@@ -106,6 +112,12 @@ export interface HotelOfferRequestResponse {
    * @memberof HotelOfferRequestApiResponse
    */
   children?: string | null
+  /**
+   * Date of the **Hotel Offer Request** creation
+   * @type {string}
+   * @memberof HotelOfferRequestApiResponse
+   */
+  createdAt: string
   /**
    *
    * @type {EventMetadataApi}
@@ -142,18 +154,6 @@ export interface HotelOfferRequestResponse {
    * @memberof HotelOfferRequestApiResponse
    */
   sourceMarket: SourceMarket
-  /**
-   * Date of the **Hotel Offer Request** creation
-   * @type {string}
-   * @memberof HotelOfferRequestApiResponse
-   */
-  createdAt: string
-  /**
-   * id of the **Hotel Offer Request**
-   * @type {string}
-   * @memberof HotelOfferRequestApiResponse
-   */
-  id: string
 }
 
 export interface HotelOfferRequestCreate {

package/src/types/elements/hotel-offer.ts

@@ -9,6 +9,12 @@ import type { TravelTimeItem } from './travel-times.ts'
 import type { CurrencyCode } from '../../currencies/constants.ts'
 
 export interface HotelOffer {
+  /**
+   * Hotel id.
+   * @type {string}
+   * @memberof HotelOffer
+   */
+  id: string
   /**
    * Hotel address.
    * @type {string}
@@ -102,11 +108,11 @@ export interface HotelOffer {
    */
   hotelReviewRatings?: HotelReviewRating[] | null
   /**
-   * Hotel id.
-   * @type {string}
+   *
+   * @type {Array<HotelRoomOffer>}
    * @memberof HotelOffer
    */
-  id: string
+  hotelRoomOffers: HotelRoomOffer[]
   /**
    *
    * @type {HotelImages}
@@ -162,6 +168,12 @@ export interface HotelOffer {
    * @memberof HotelOffer
    */
   state?: string | null
+  /**
+   *
+   * @type {Array<Tag>}
+   * @memberof HotelOffer
+   */
+  tags?: Tag[]
   /**
    * TripAdvisor property id. When applicable.
    * @type {string}
@@ -186,18 +198,6 @@ export interface HotelOffer {
    * @memberof HotelOffer
    */
   website?: string | null
-  /**
-   *
-   * @type {Array<HotelRoomOffer>}
-   * @memberof HotelOffer
-   */
-  hotelRoomOffers: HotelRoomOffer[]
-  /**
-   *
-   * @type {Array<Tag>}
-   * @memberof HotelOffer
-   */
-  tags?: Tag[]
 }
 
 export enum HotelOffersSortByEnum {

package/src/types/elements/hotel-offers-filters.ts

@@ -9,9 +9,9 @@ export enum FilterName {
 }
 
 export interface HotelOffersFilters {
+  [FilterName.Price]: [number, number]
   [FilterName.Rating]: string
   [FilterName.ReviewRating]?: number
-  [FilterName.Price]: [number, number]
   [FilterName.SortBy]: {
     direction: HotelOffersSortByOrderType
     value: HotelOffersSortByEnum

package/src/types/elements/hotel-room-offer-request.ts

@@ -2,6 +2,12 @@ import type { EventMetadata } from './event-metadata.ts'
 import type { SourceMarket } from './source-market.ts'
 
 export interface HotelRoomOfferRequest {
+  /**
+   * id of the **Hotel Room Offer Request**
+   * @type {string}
+   * @memberof HotelRoomOfferRequest
+   */
+  id: string
   /**
    * Requested number of adult(s) to be accommodated.
    * @type {number}
@@ -26,6 +32,12 @@ export interface HotelRoomOfferRequest {
    * @memberof HotelRoomOfferRequest
    */
   children?: string | null
+  /**
+   * Date of the **Hotel Room Offer Request** creation
+   * @type {string}
+   * @memberof HotelRoomOfferRequest
+   */
+  createdAt: string
   /**
    *
    * @type {EventMetadata}
@@ -50,21 +62,15 @@ export interface HotelRoomOfferRequest {
    * @memberof HotelRoomOfferRequest
    */
   sourceMarket: SourceMarket
-  /**
-   * Date of the **Hotel Room Offer Request** creation
-   * @type {string}
-   * @memberof HotelRoomOfferRequest
-   */
-  createdAt: string
+}
+
+export interface HotelRoomOfferRequestResponse {
   /**
    * id of the **Hotel Room Offer Request**
    * @type {string}
-   * @memberof HotelRoomOfferRequest
+   * @memberof HotelRoomOfferRequestApiResponse
    */
   id: string
-}
-
-export interface HotelRoomOfferRequestResponse {
   /**
    * Requested number of adult(s) to be accommodated.
    * @type {number}
@@ -89,6 +95,12 @@ export interface HotelRoomOfferRequestResponse {
    * @memberof HotelRoomOfferRequestApiResponse
    */
   children?: string | null
+  /**
+   * Date of the **Hotel Room Offer Request** creation
+   * @type {string}
+   * @memberof HotelRoomOfferRequestApiResponse
+   */
+  createdAt: string
   /**
    *
    * @type {EventMetadataApi}
@@ -113,18 +125,6 @@ export interface HotelRoomOfferRequestResponse {
    * @memberof HotelRoomOfferRequestApiResponse
    */
   sourceMarket: SourceMarket
-  /**
-   * Date of the **Hotel Room Offer Request** creation
-   * @type {string}
-   * @memberof HotelRoomOfferRequestApiResponse
-   */
-  createdAt: string
-  /**
-   * id of the **Hotel Room Offer Request**
-   * @type {string}
-   * @memberof HotelRoomOfferRequestApiResponse
-   */
-  id: string
 }
 
 export type HotelRoomOfferRequestCreate = Pick<

package/src/types/elements/hotel-room-offer.ts

@@ -70,6 +70,12 @@ export interface HotelRoomOffersDataResponse {
  * @interface HotelRoomOffer
  */
 export interface HotelRoomOffer {
+  /**
+   * Hotel Room Offer id.
+   * @type {string}
+   * @memberof HotelRoomOffer
+   */
+  id?: string
   /**
    * Quantity of breakfast per night included in the given **Hotel Room Offer**
    * @type {number}
@@ -138,12 +144,6 @@ export interface HotelRoomOffer {
    * @memberof HotelRoomOffer
    */
   hotelRooms: HotelRoom[]
-  /**
-   * Hotel Room Offer id.
-   * @type {string}
-   * @memberof HotelRoomOffer
-   */
-  id?: string
   /**
    * An **Hotel Room Offer** of type **PACKAGE** can be of **4 types**, described by **package_type** parameter:
    *
@@ -157,7 +157,7 @@ export interface HotelRoomOffer {
    * @type {string}
    * @memberof HotelRoomOffer
    */
-  packageType?: HotelRoomOfferPackageType
+  packageType?: HotelRoomOfferPackageType | null
   /**
    * Price with taxes NOT INCLUDED of the given **Hotel Room Offer** including breakfast(s) when applicable, expressed in the requested **currency**.
    * @type {number}
@@ -172,18 +172,16 @@ export interface HotelRoomOffer {
   sourceMarket: SourceMarket
   /**
    *
-   * @type {Array<Tag>}
+   * @type {StayTaxesInfo}
    * @memberof HotelRoomOffer
    */
-  tags?: Tag[]
+  stayTaxesInfo: StayTaxesInfo
   /**
-   * Price of the given **Hotel Room Offer** including breakfast(s) when applicable, and including all taxes from returned **taxes** list parameter expressed in the requested **currency**.
    *
-   * This data is not returned for a **Hotel Room Offer** of type **HOTEL_ROOM**, you'll need to compute and display the actual tax included price of the final **Hotel Room** package corresponding to the guest count and night count requested, or make a call to the **[Create Hotel Room Offer](/v1/documentation#operation/postV1Hotel_room_offers)** endpoint in order to get a valid and bookable **Hotel Room Offer** where **type = PACKAGE** based on a packaged list of **Hotel Room Offers** of type **HOTEL_ROOM**.
-   * @type {number}
+   * @type {Array<Tag>}
    * @memberof HotelRoomOffer
    */
-  taxIncludedPrice: number
+  tags?: Tag[]
   /**
    *
    * @type {Array<Tax>}
@@ -192,11 +190,13 @@ export interface HotelRoomOffer {
   taxes?: Tax[]
 
   /**
+   * Price of the given **Hotel Room Offer** including breakfast(s) when applicable, and including all taxes from returned **taxes** list parameter expressed in the requested **currency**.
    *
-   * @type {StayTaxesInfo}
+   * This data is not returned for a **Hotel Room Offer** of type **HOTEL_ROOM**, you'll need to compute and display the actual tax included price of the final **Hotel Room** package corresponding to the guest count and night count requested, or make a call to the **[Create Hotel Room Offer](/v1/documentation#operation/postV1Hotel_room_offers)** endpoint in order to get a valid and bookable **Hotel Room Offer** where **type = PACKAGE** based on a packaged list of **Hotel Room Offers** of type **HOTEL_ROOM**.
+   * @type {number}
    * @memberof HotelRoomOffer
    */
-  stayTaxesInfo: StayTaxesInfo
+  taxIncludedPrice: number
 
   /**
    * Hotel Room Offer type.

package/src/types/elements/hotel-room.ts

@@ -2,6 +2,12 @@ import type { Bed } from './bed.ts'
 import type { HotelImage } from './hotel-image.ts'
 
 export interface HotelRoom {
+  /**
+   * Hotel Room id, when applicable.
+   * @type {string}
+   * @memberof HotelRoom
+   */
+  id: string
   /**
    * List of amenities in the room. May be subject to changes at the Hotel.
    * @type {Array<string>}
@@ -52,12 +58,6 @@ export interface HotelRoom {
    * @memberof HotelRoom
    */
   highresImages?: boolean | null
-  /**
-   * Hotel Room id, when applicable.
-   * @type {string}
-   * @memberof HotelRoom
-   */
-  id: string
   /**
    * List of indexes corresponding to image names for the given Hotel Room among the related hotel images.
    * @type {Array<number>}

package/src/types/elements/hotel-rooming-list.ts

@@ -6,16 +6,22 @@ export interface HotelRoomingListGuest {
    * @type {string}
    * @memberof HotelRoomingListGuest
    */
-  fullname: string
+  id: string
   /**
    *
    * @type {string}
    * @memberof HotelRoomingListGuest
    */
-  id: string
+  fullname: string
 }
 
 export interface HotelRoomingList {
+  /**
+   *
+   * @type {string}
+   * @memberof HotelRoomingList
+   */
+  id: string
   /**
    *
    * @type {HotelRoom}
@@ -34,12 +40,6 @@ export interface HotelRoomingList {
    * @memberof HotelRoomingList
    */
   hotelRoomingListGuests: HotelRoomingListGuest[]
-  /**
-   *
-   * @type {string}
-   * @memberof HotelRoomingList
-   */
-  id: string
   /**
    *
    * @type {string}

package/src/types/elements/hotel.ts

@@ -6,6 +6,12 @@ import type { HotelReviewRating } from './hotel-review-rating.ts'
 import type { TravelTimeItem } from './travel-times.ts'
 
 export interface Hotel {
+  /**
+   * Hotel id.
+   * @type {string}
+   * @memberof HotelApi
+   */
+  id: string
   /**
    * Hotel address.
    * @type {string}
@@ -96,12 +102,6 @@ export interface Hotel {
    * @memberof HotelApi
    */
   hotelReviewRatings?: HotelReviewRating[] | null
-  /**
-   * Hotel id.
-   * @type {string}
-   * @memberof HotelApi
-   */
-  id: string
   /**
    *
    * @type {HotelImages}

package/src/types/elements/meta-polling.ts

@@ -22,16 +22,16 @@ export interface MetaPollingResponse {
    * @memberof MetaApiPollingResponse
    */
   startingAfter?: string | null
-  /**
-   *
-   * @type {number}
-   * @memberof HotelOffersApiResponseMeta
-   */
-  totalCount?: number | null
   /**
    *
    * @type {PollerType}
    * @memberof MetaApiPollingResponse
    */
   status: PollerType
+  /**
+   *
+   * @type {number}
+   * @memberof HotelOffersApiResponseMeta
+   */
+  totalCount?: number | null
 }

package/src/types/event.ts

@@ -1,7 +1,7 @@
 export interface IEvent {
+  id: string
   eventDateFrom?: Date
   eventDateTo?: Date
-  id: string
   name: string
   slug: string
 }

package/src/types/hotel-contract.ts

@@ -1,13 +1,13 @@
 import type { IHotelRoomStock } from './hotel-room-stock.ts'
 
 export interface IHotelContract {
+  id: string
   createdAt: string
   forcedTotalComissionsAmount: number
   forcedTotalPurchasedAmount: number
   forcedTotalVatComissionsAmount: number
   hotelId: string
   hotelRoomStocks?: IHotelRoomStock[]
-  id: string
   name: string
   status: string
   updatedAt: string

package/src/types/hotel-room-stock.ts

@@ -1,6 +1,7 @@
 import type { BreakfastOption } from '../constants/hotel.ts'
 
 export interface IHotelRoomStock {
+  id?: string
   breakfastOption: BreakfastOption
   breakfastRetrocommission?: number
   breakfastUnitPrice?: number
@@ -9,7 +10,6 @@ export interface IHotelRoomStock {
   eventScoped: boolean
   hotelContractId?: string
   hotelRoomId: string
-  id?: string
   marginRate: number
   minNightCount?: number
   rate: number

package/src/types/pagination.ts

@@ -17,10 +17,10 @@ export interface IPaginationOptions {
 }
 
 export interface IPaginationPageInfo {
+  endCursor: string | null
   hasNextPage: boolean
   hasPreviousPage: boolean
   startCursor: string | null
-  endCursor: string | null
   totalCount: number
 }
 
@@ -30,8 +30,8 @@ export interface IPaginationEdge<T> {
 }
 
 export interface IPaginationConnection<T> {
-  pageInfo: IPaginationPageInfo
   edges: IPaginationEdge<T>[]
+  pageInfo: IPaginationPageInfo
 }
 
 export enum PaginationException {

package/src/utils/create-composite-key.ts

@@ -1,7 +1,7 @@
 interface CompositeLeafAttributes {
   excludedTokens?: string[]
-  removeSplitCharacters?: boolean
   parentKey?: string
+  removeSplitCharacters?: boolean
 }
 
 export enum CompositeAttributesType {
@@ -17,7 +17,6 @@ type CompositeKeyOptions<T> =
     ? CompositeKeyOptions<U>
     : CompositeLeafAttributes & {
         attributes: CompositeOmitAttributes<T> | CompositeAttributesType
-        sort?: (keyof T)[]
         children?: {
           [K in keyof T]?: NonNullable<T[K]> extends object
             ? CompositeKeyOptions<NonNullable<T[K]>>
@@ -25,6 +24,7 @@ type CompositeKeyOptions<T> =
               ? CompositeKeyOptions<U>
               : CompositeLeafAttributes
         }
+        sort?: (keyof T)[]
       }
 
 export function createCompositeKey<T>(

package/src/utils/debounce.ts

@@ -17,8 +17,8 @@ export interface DebouncedFunction<
 }
 
 interface DebouncedPromise<FunctionReturn> {
-  resolve: (result: FunctionReturn) => void
   reject: (reason?: any) => void
+  resolve: (result: FunctionReturn) => void
 }
 
 export function debounce<Args extends any[], F extends (...args: Args) => any>(

package/src/utils/get-sanitized-room-count.ts

@@ -6,8 +6,8 @@ export function getSanitizedRoomCount({
   roomCount,
 }: {
   adultCount: number
-  roomCount: number
   maxAdultsPerRoom?: number
+  roomCount: number
 }): number {
   // Ensure at least enough rooms for each adult and at most MAX_ADULTS_PER_ROOM per room
   if (!Number.isFinite(roomCount) || roomCount < 1) {

package/src/utils/poller.ts

@@ -45,13 +45,14 @@ export class Poller<V extends IPollerResponse> {
     minCallCount: 1,
   }
 
-  private pollings: Record<string, string> = {}
   private events: TPollerEvents<V> = {
     complete: () => undefined,
     data: () => undefined,
     error: () => undefined,
   }
 
+  private pollings: Record<string, string> = {}
+
   static getInstance<R extends IPollerResponse>(): Poller<R> {
     if (!Poller.instance) {
       Poller.instance = new Poller<R>() as Poller<IPollerResponse>
@@ -60,6 +61,13 @@ export class Poller<V extends IPollerResponse> {
     return Poller.instance as Poller<R>
   }
 
+  on(
+    eventName: TPollerEventName,
+    eventCallback: TPollerEventCallback<V>,
+  ): void {
+    this.events[eventName] = eventCallback
+  }
+
   poll(request: TRequest<V>, options: TOptions<V>): Poller<V> {
     const buildedOptions = this.buildPollerOptions(options)
     this.storeCurrentPolling(buildedOptions)
@@ -75,13 +83,6 @@ export class Poller<V extends IPollerResponse> {
     return this
   }
 
-  on(
-    eventName: TPollerEventName,
-    eventCallback: TPollerEventCallback<V>,
-  ): void {
-    this.events[eventName] = eventCallback
-  }
-
   public stop(type: string): void {
     if (type && this.pollings[type]) {
       // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
@@ -89,6 +90,25 @@ export class Poller<V extends IPollerResponse> {
     }
   }
 
+  private buildPollerOptions(options: TOptions<V>): TOptions<V> {
+    const compactedOptions = Object.entries(options).reduce<
+      Record<string, unknown>
+    >((acc, [key, value]) => {
+      if (value !== undefined) {
+        const tKey = key as keyof TOptions<V>
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        acc[tKey] = value as any
+      }
+
+      return acc
+    }, {}) as TOptions<V>
+
+    return {
+      ...this.defaultOptions,
+      ...compactedOptions,
+    }
+  }
+
   private dispatch(
     eventName: TPollerEventName,
     payload?: TPollerEventCallbackArg<V>,
@@ -96,6 +116,27 @@ export class Poller<V extends IPollerResponse> {
     this.events[eventName](payload)
   }
 
+  private isActivePoller(options: TOptions<V>): boolean {
+    if (options.type) {
+      return (
+        !!this.pollings[options.type] &&
+        this.pollings[options.type] === options.uuid
+      )
+    }
+
+    return true
+  }
+
+  private isInProgress(result: V): boolean {
+    return (result?.meta?.status ?? '') !== 'COMPLETE'
+  }
+
+  private onComplete(result: V, options: TOptions<V>) {
+    this.dispatch('data', result)
+    this.dispatch('complete', result)
+    this.removeCurrentPolling(options)
+  }
+
   private async onRequest(
     result: V,
     request: TRequest<V>,
@@ -148,53 +189,6 @@ export class Poller<V extends IPollerResponse> {
     }
   }
 
-  private onComplete(result: V, options: TOptions<V>) {
-    this.dispatch('data', result)
-    this.dispatch('complete', result)
-    this.removeCurrentPolling(options)
-  }
-
-  private isInProgress(result: V): boolean {
-    return (result?.meta?.status ?? '') !== 'COMPLETE'
-  }
-
-  private buildPollerOptions(options: TOptions<V>): TOptions<V> {
-    const compactedOptions = Object.entries(options).reduce<
-      Record<string, unknown>
-    >((acc, [key, value]) => {
-      if (value !== undefined) {
-        const tKey = key as keyof TOptions<V>
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        acc[tKey] = value as any
-      }
-
-      return acc
-    }, {}) as TOptions<V>
-
-    return {
-      ...this.defaultOptions,
-      ...compactedOptions,
-    }
-  }
-
-  private storeCurrentPolling(options: TOptions<V>): void {
-    if (options.type && !options.uuid) {
-      options.uuid = uuidv4()
-      this.pollings[options.type] = options.uuid
-    }
-  }
-
-  private isActivePoller(options: TOptions<V>): boolean {
-    if (options.type) {
-      return (
-        !!this.pollings[options.type] &&
-        this.pollings[options.type] === options.uuid
-      )
-    }
-
-    return true
-  }
-
   private pause(options: TOptions<V>): Promise<void> {
     return new Promise(resolve => {
       setTimeout(resolve, options.interval)
@@ -207,6 +201,13 @@ export class Poller<V extends IPollerResponse> {
       delete this.pollings[options.type]
     }
   }
+
+  private storeCurrentPolling(options: TOptions<V>): void {
+    if (options.type && !options.uuid) {
+      options.uuid = uuidv4()
+      this.pollings[options.type] = options.uuid
+    }
+  }
 }
 
 export type PollerReturn<R extends IPollerResponse = IPollerResponse> =