@revolugo/common 7.0.1-alpha.0 → 7.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revolugo/common",
-  "version": "7.0.1-alpha.0",
+  "version": "7.0.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.4",
+    "type-fest": "5.4.3",
     "uuid": "13.0.0",
     "zod": "4.3.6"
   },

package/src/cancellation-policies.test.ts

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

package/src/cancellation-policies.ts

@@ -34,31 +34,6 @@ 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,
@@ -87,11 +62,8 @@ export function sanitizeCancellationPolicies({
 
   const nextDayCheckInDateUTC = nextDay(checkInDatetimeUTC)
 
-  const releaseDatetimeUTC = initReleaseDateUTC({
-    checkInDate,
-    releaseDate,
-    timezone,
-  })
+  const releaseDatetimeUTC =
+    releaseDate && dayjs.tz(releaseDate, timezone).startOf('day').utc().format()
 
   if (dayjs(bookingDatetimeUTC).isAfter(nextDayCheckInDateUTC)) {
     return sanitizeCancellationPolicies({
@@ -480,10 +452,10 @@ export function getSanitizedCancellationPolicies({
   initialDate,
   timezone,
 }: {
-  cancellationPolicies: ICancellationPolicy[]
   checkInDate: string
-  initialDate?: string
+  cancellationPolicies: ICancellationPolicy[]
   timezone?: string
+  initialDate?: string
 }): ICancellationPolicy[] {
   if (!cancellationPolicies.length) {
     return []
@@ -539,28 +511,3 @@ 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,39 +98,6 @@ export class MoneyCalculator {
     this.isNormalized = 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
-    }
-
-    const startingIsNormalized = this.isNormalized
-
-    if (startingIsNormalized) {
-      this.denormalize()
-    }
-
-    this.amount *= exchangeRate
-    this.currency = currency
-
-    if (startingIsNormalized) {
-      this.normalize()
-    }
-
-    return this
-  }
-
   public denormalize(): this {
     if (!this.isNormalized) {
       return this
@@ -146,25 +113,6 @@ export class MoneyCalculator {
     return this
   }
 
-  public floor(): this {
-    this.amount = Math.floor(this.amount)
-
-    return this
-  }
-
-  public format(locale?: string, space?: string): string {
-    return formatAmount({
-      amount: this.amount,
-      currency: this.currency,
-      locale,
-      space,
-    })
-  }
-
-  public getAmount(): number {
-    return this.amount
-  }
-
   public markup(percentage: number): this {
     this.amount /= 1 - percentage
 
@@ -191,11 +139,63 @@ export class MoneyCalculator {
     return this
   }
 
+  public ceil(): this {
+    this.amount = Math.ceil(this.amount)
+
+    return this
+  }
+
+  public floor(): this {
+    this.amount = Math.floor(this.amount)
+
+    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,
+      currency: this.currency,
+      locale,
+      space,
+    })
+  }
+
+  public getAmount(): number {
+    return this.amount
+  }
+
+  public convert({
+    currency,
+    exchangeRate,
+  }: {
+    exchangeRate: number
+    currency: CurrencyCode
+  }): this {
+    if (this.currency === currency || this.amount === 0) {
+      return this
+    }
+
+    const startingIsNormalized = this.isNormalized
+
+    if (startingIsNormalized) {
+      this.denormalize()
+    }
+
+    this.amount *= exchangeRate
+    this.currency = currency
+
+    if (startingIsNormalized) {
+      this.normalize()
+    }
+
+    return this
+  }
 }
 
 export function ceilNormalizedAmount({

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

@@ -5,14 +5,12 @@ 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'
 
@@ -29,17 +27,21 @@ 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).nullish().openapi({
+    breakfast_count: z.number().min(0).optional().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().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()
+      .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_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.',
@@ -52,6 +54,7 @@ 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**.
@@ -70,15 +73,13 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       .openapi({
         description: PACKAGE_TYPES_DESCRIPTION,
       })
-      .nullish(),
+      .nullish()
+      .optional(),
     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}**.`,
@@ -89,16 +90,10 @@ 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,7 +57,10 @@ export const HOTEL_ROOM_SCHEMA = z
       .openapi({ description: 'Whether high resolution images are available.' })
       .optional()
       .nullish(),
-    id: z.string().openapi({ description: 'Hotel Room id, when applicable.' }),
+    id: z
+      .string()
+      .optional()
+      .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,12 +113,6 @@ export interface Amenities {
    * @memberof Amenities
    */
   handicapAccessible?: boolean
-  /**
-   * Indoor pool.
-   * @type {boolean}
-   * @memberof Amenities
-   */
-  indoorPool?: boolean
   /**
    * In house bar.
    * @type {boolean}
@@ -137,6 +131,12 @@ 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
   /**
-   * Tennis court.
+   * TV in room.
    * @type {boolean}
    * @memberof Amenities
    */
-  tennisCourt?: boolean
+  tVInRoom?: boolean
   /**
-   * TV in room.
+   * Tennis court.
    * @type {boolean}
    * @memberof Amenities
    */
-  tVInRoom?: boolean
+  tennisCourt?: boolean
   /**
    *  24/7 security.
    * @type {boolean}

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

@@ -3,12 +3,6 @@ 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}
@@ -45,7 +39,6 @@ export interface BookingPolicies {
    * @memberof BookingPolicies
    */
   currency: CurrencyType
-
   /**
    * Expiration date for this **Booking Policy**.
    *
@@ -54,6 +47,7 @@ export interface BookingPolicies {
    * @memberof BookingPolicies
    */
   expiresAt: string | null
+
   hasRoomingLists: boolean
   /**
    * Hotel id
@@ -67,6 +61,12 @@ 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,12 +10,6 @@ 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}
@@ -106,6 +100,12 @@ 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[]
   /**
-   *
-   * @type {HotelRoomOffer}
+   * Booking Id
+   * @type {string}
    * @memberof Booking
    */
-  hotelRoomOffer: HotelRoomOffer
+  id?: string | null
   /**
    * 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
-  /**
-   *
-   * @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
+  /**
+   *
+   * @type {Array<Tax>}
+   * @memberof Booking
+   */
+  taxes?: Tax[] | null
   /**
    * Link to Revolugo terms and conditions under which the booking is made.
    * @type {string}

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

@@ -167,11 +167,4 @@ 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,10 +1,4 @@
 export interface EventMetadata {
-  /**
-   * Unique id of the event
-   * @type {string}
-   * @memberof EventMetadata
-   */
-  id?: string
   /**
    * End date of the event formatted as YYYY-MM-DD.
    * @type {string}
@@ -17,6 +11,12 @@ export interface EventMetadata {
    * @memberof EventMetadata
    */
   dateStart?: string
+  /**
+   * Unique id of the event
+   * @type {string}
+   * @memberof EventMetadata
+   */
+  id?: 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,11 +2,6 @@ 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.
    *
@@ -34,12 +29,6 @@ export interface HotelOfferRequest {
    * @type {string}
    */
   children?: string | null
-  /**
-   * Date of the **Hotel Room Offer Request** creation
-   * @type {string}
-   * @memberof HotelOfferRequestApiResponse
-   */
-  createdAt: string
   /**
    *
    * @type {EventMetadata}
@@ -71,15 +60,20 @@ export interface HotelOfferRequest {
    * @type {SourceMarket}
    */
   sourceMarket: SourceMarket
-}
-
-export interface HotelOfferRequestResponse {
   /**
-   * id of the **Hotel Offer Request**
+   * Date of the **Hotel Room Offer Request** creation
    * @type {string}
    * @memberof HotelOfferRequestApiResponse
    */
+  createdAt: string
+  /**
+   * id of the **Hotel Offer Request**
+   * @type {string}
+   */
   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.
    *
@@ -112,12 +106,6 @@ export interface HotelOfferRequestResponse {
    * @memberof HotelOfferRequestApiResponse
    */
   children?: string | null
-  /**
-   * Date of the **Hotel Offer Request** creation
-   * @type {string}
-   * @memberof HotelOfferRequestApiResponse
-   */
-  createdAt: string
   /**
    *
    * @type {EventMetadataApi}
@@ -154,6 +142,18 @@ 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,12 +9,6 @@ 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}
@@ -108,11 +102,11 @@ export interface HotelOffer {
    */
   hotelReviewRatings?: HotelReviewRating[] | null
   /**
-   *
-   * @type {Array<HotelRoomOffer>}
+   * Hotel id.
+   * @type {string}
    * @memberof HotelOffer
    */
-  hotelRoomOffers: HotelRoomOffer[]
+  id: string
   /**
    *
    * @type {HotelImages}
@@ -168,12 +162,6 @@ export interface HotelOffer {
    * @memberof HotelOffer
    */
   state?: string | null
-  /**
-   *
-   * @type {Array<Tag>}
-   * @memberof HotelOffer
-   */
-  tags?: Tag[]
   /**
    * TripAdvisor property id. When applicable.
    * @type {string}
@@ -198,6 +186,18 @@ 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,12 +2,6 @@ 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}
@@ -32,12 +26,6 @@ export interface HotelRoomOfferRequest {
    * @memberof HotelRoomOfferRequest
    */
   children?: string | null
-  /**
-   * Date of the **Hotel Room Offer Request** creation
-   * @type {string}
-   * @memberof HotelRoomOfferRequest
-   */
-  createdAt: string
   /**
    *
    * @type {EventMetadata}
@@ -62,15 +50,21 @@ export interface HotelRoomOfferRequest {
    * @memberof HotelRoomOfferRequest
    */
   sourceMarket: SourceMarket
-}
-
-export interface HotelRoomOfferRequestResponse {
+  /**
+   * Date of the **Hotel Room Offer Request** creation
+   * @type {string}
+   * @memberof HotelRoomOfferRequest
+   */
+  createdAt: string
   /**
    * id of the **Hotel Room Offer Request**
    * @type {string}
-   * @memberof HotelRoomOfferRequestApiResponse
+   * @memberof HotelRoomOfferRequest
    */
   id: string
+}
+
+export interface HotelRoomOfferRequestResponse {
   /**
    * Requested number of adult(s) to be accommodated.
    * @type {number}
@@ -95,12 +89,6 @@ export interface HotelRoomOfferRequestResponse {
    * @memberof HotelRoomOfferRequestApiResponse
    */
   children?: string | null
-  /**
-   * Date of the **Hotel Room Offer Request** creation
-   * @type {string}
-   * @memberof HotelRoomOfferRequestApiResponse
-   */
-  createdAt: string
   /**
    *
    * @type {EventMetadataApi}
@@ -125,6 +113,18 @@ 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,12 +70,6 @@ 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}
@@ -144,6 +138,12 @@ 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 | null
+  packageType?: HotelRoomOfferPackageType
   /**
    * Price with taxes NOT INCLUDED of the given **Hotel Room Offer** including breakfast(s) when applicable, expressed in the requested **currency**.
    * @type {number}
@@ -172,16 +172,18 @@ export interface HotelRoomOffer {
   sourceMarket: SourceMarket
   /**
    *
-   * @type {StayTaxesInfo}
+   * @type {Array<Tag>}
    * @memberof HotelRoomOffer
    */
-  stayTaxesInfo: StayTaxesInfo
+  tags?: Tag[]
   /**
+   * 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 {Array<Tag>}
+   * 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
    */
-  tags?: Tag[]
+  taxIncludedPrice: number
   /**
    *
    * @type {Array<Tax>}
@@ -190,13 +192,11 @@ 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**.
    *
-   * 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 {StayTaxesInfo}
    * @memberof HotelRoomOffer
    */
-  taxIncludedPrice: number
+  stayTaxesInfo: StayTaxesInfo
 
   /**
    * Hotel Room Offer type.

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

@@ -2,12 +2,6 @@ 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>}
@@ -58,6 +52,12 @@ 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,22 +6,16 @@ export interface HotelRoomingListGuest {
    * @type {string}
    * @memberof HotelRoomingListGuest
    */
-  id: string
+  fullname: string
   /**
    *
    * @type {string}
    * @memberof HotelRoomingListGuest
    */
-  fullname: string
+  id: string
 }
 
 export interface HotelRoomingList {
-  /**
-   *
-   * @type {string}
-   * @memberof HotelRoomingList
-   */
-  id: string
   /**
    *
    * @type {HotelRoom}
@@ -40,6 +34,12 @@ export interface HotelRoomingList {
    * @memberof HotelRoomingList
    */
   hotelRoomingListGuests: HotelRoomingListGuest[]
+  /**
+   *
+   * @type {string}
+   * @memberof HotelRoomingList
+   */
+  id: string
   /**
    *
    * @type {string}

package/src/types/elements/hotel.ts

@@ -6,12 +6,6 @@ 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}
@@ -102,6 +96,12 @@ 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 {PollerType}
-   * @memberof MetaApiPollingResponse
-   */
-  status: PollerType
   /**
    *
    * @type {number}
    * @memberof HotelOffersApiResponseMeta
    */
   totalCount?: number | null
+  /**
+   *
+   * @type {PollerType}
+   * @memberof MetaApiPollingResponse
+   */
+  status: PollerType
 }

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,7 +1,6 @@
 import type { BreakfastOption } from '../constants/hotel.ts'
 
 export interface IHotelRoomStock {
-  id?: string
   breakfastOption: BreakfastOption
   breakfastRetrocommission?: number
   breakfastUnitPrice?: number
@@ -10,6 +9,7 @@ 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> {
-  edges: IPaginationEdge<T>[]
   pageInfo: IPaginationPageInfo
+  edges: IPaginationEdge<T>[]
 }
 
 export enum PaginationException {

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

@@ -1,7 +1,7 @@
 interface CompositeLeafAttributes {
   excludedTokens?: string[]
-  parentKey?: string
   removeSplitCharacters?: boolean
+  parentKey?: string
 }
 
 export enum CompositeAttributesType {
@@ -17,6 +17,7 @@ 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]>>
@@ -24,7 +25,6 @@ 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> {
-  reject: (reason?: any) => void
   resolve: (result: FunctionReturn) => void
+  reject: (reason?: any) => 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
-  maxAdultsPerRoom?: number
   roomCount: number
+  maxAdultsPerRoom?: 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,14 +45,13 @@ 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>
@@ -61,13 +60,6 @@ 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)
@@ -83,6 +75,13 @@ 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
@@ -90,25 +89,6 @@ 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>,
@@ -116,27 +96,6 @@ 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>,
@@ -189,6 +148,53 @@ 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)
@@ -201,13 +207,6 @@ 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> =