@revolugo/common 6.15.8 → 7.0.0-rc.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revolugo/common",
-  "version": "6.15.8",
+  "version": "7.0.0-rc.0",
   "private": false,
   "description": "Revolugo common",
   "author": "Revolugo",
@@ -16,7 +16,6 @@
   ],
   "exports": {
     "./amenities": "./src/amenities/index.ts",
-    "./assets": "./src/assets/index.ts",
     "./cancellation-policies": "./src/cancellation-policies.ts",
     "./countries": "./src/countries/index.ts",
     "./constants": "./src/constants/index.ts",
@@ -30,13 +29,14 @@
     "./utils": "./src/utils/index.ts"
   },
   "dependencies": {
+    "@asteasolutions/zod-to-openapi": "8.4.0",
     "change-case": "5.4.4",
     "dayjs": "1.11.19",
-    "ky": "1.14.1",
+    "ky": "1.14.3",
     "slugify": "1.6.6",
-    "type-fest": "5.3.0",
+    "type-fest": "5.4.3",
     "uuid": "13.0.0",
-    "zod": "3.25.76"
+    "zod": "4.3.6"
   },
   "scripts": {
     "test": "vitest"

package/src/amenities/index.ts

@@ -1,6 +1,7 @@
 export const AMENITY_TO_ICONS = Object.freeze({
   AirConditioning: 'wind',
   AirportTransportation: 'planeTakeOff',
+  Bed: 'bed',
   BusinessCenter: 'building',
   CarRentDesk: 'car',
   ChildrenAllowed: 'baby',
@@ -14,6 +15,7 @@ export const AMENITY_TO_ICONS = Object.freeze({
   ExteriorRoomEntrance: 'doorOpen',
   FamilyRooms: 'usersThree',
   FitnessFacility: 'gym',
+  Floor: 'arrowHorizontal',
   GameRoom: 'gameController',
   GolfCourse: 'golf',
   HairDryer: 'hairDryer',
@@ -38,6 +40,7 @@ export const AMENITY_TO_ICONS = Object.freeze({
   TennisCourt: 'tennisBall',
   TvInRoom: 'monitor',
   TwentyFourHourSecurity: 'shield',
+  Users: 'users',
   ValetParking: 'car',
   VideoCheckOut: 'filmReel',
   VoiceMail: 'phone',

package/src/cancellation-policies.ts

@@ -454,7 +454,7 @@ export function getSanitizedCancellationPolicies({
 }: {
   checkInDate: string
   cancellationPolicies: ICancellationPolicy[]
-  timezone: string
+  timezone?: string
   initialDate?: string
 }): ICancellationPolicy[] {
   if (!cancellationPolicies.length) {

package/src/constants/locales.ts

@@ -19,6 +19,8 @@ export enum Lang {
   PT = 'pt',
 }
 
+export type ExtendedLocale = Locale | Lang
+
 export function langFromString(langStr: string): Lang | undefined {
   return Object.entries(Lang).find(entry => {
     if (entry[0].toLocaleLowerCase() === langStr.toLocaleLowerCase()) {

package/src/icons/index.ts

@@ -1,5 +1,6 @@
 export const ICONS_NAME = Object.freeze({
   airplane: 'ph:airplane',
+  appleBrand: 'logos:apple',
   archive: 'ph:archive',
   arrowDown: 'ph:arrow-down',
   arrowHorizontal: 'ph:arrows-horizontal',
@@ -39,6 +40,7 @@ export const ICONS_NAME = Object.freeze({
   circle: 'ph:circle',
   circleNotch: 'ph:circle-notch',
   clock: 'ph:clock',
+  clockClockwise: 'ph:clock-clockwise',
   close: 'ph:x',
   closeCircle: 'ph:x-circle',
   cloud: 'ph:cloud',
@@ -87,6 +89,7 @@ export const ICONS_NAME = Object.freeze({
   gear: 'ph:gear',
   globe: 'ph:globe',
   golf: 'ph:golf',
+  googleCalendar: 'logos:google-calendar',
   graph: 'ph:graph',
   gym: 'ph:barbell',
   hairDryer: 'ph:hair-dryer',
@@ -100,16 +103,19 @@ export const ICONS_NAME = Object.freeze({
   images: 'ph:images',
   imagesSquare: 'ph:images-square',
   info: 'ph:info',
+  instagram: 'ph:instagram-logo',
   key: 'ph:key',
   leaf: 'ph:leaf',
   lightning: 'ph:lightning',
   link: 'ph:link',
   linkBreak: 'ph:link-break',
+  linkedin: 'ph:linkedin-logo',
   lock: 'ph:lock',
   lockKey: 'ph:lock-key',
   lockKeyOpen: 'ph:lock-key-open',
   lockOpen: 'ph:lock-open',
   magnifyingGlass: 'ph:magnifying-glass',
+  magnifyingGlassList: 'ph:list-magnifying-glass',
   mapPin: 'ph:map-pin',
   mapPinArea: 'ph:map-pin-area',
   mapPinSimpleArea: 'ph:map-pin-simple-area',
@@ -119,6 +125,8 @@ export const ICONS_NAME = Object.freeze({
   money: 'ph:money',
   monitor: 'ph:monitor',
   mosque: 'ph:mosque',
+  msOffice365: 'custom:ms-office-365',
+  msOutlook: 'custom:ms-outlook',
   musicNotes: 'ph:music-notes',
   noSmoking: 'ph:cigarette-slash',
   note: 'ph:note',
@@ -137,11 +145,13 @@ export const ICONS_NAME = Object.freeze({
   policeCar: 'ph:police-car',
   praying: 'ph:hands-praying',
   questionMark: 'ph:question-mark',
+  receiptFail: 'ph:receipt-x',
   refresh: 'ph:arrows-counter-clockwise',
   running: 'ph:person-simple-run',
   scissors: 'ph:scissors',
   shield: 'ph:shield',
   shirt: 'ph:shirt-folded',
+  shoppingBag: 'ph:shopping-bag',
   shoppingCart: 'ph:shopping-cart',
   shrink: 'ph:arrows-in-simple',
   signOut: 'ph:sign-out',
@@ -163,9 +173,10 @@ export const ICONS_NAME = Object.freeze({
   tent: 'ph:tent',
   thermometerHot: 'ph:thermometer-hot',
   thumbsUp: 'ph:thumbs-up',
+  timer: 'ph:timer',
   tooth: 'ph:tooth',
   train: 'ph:train',
-  trash: 'ph:trash',
+  trash: 'ph:trash-simple',
   tree: 'ph:tree',
   trendDown: 'ph:trend-down',
   trendUp: 'ph:trend-up',
@@ -178,6 +189,7 @@ export const ICONS_NAME = Object.freeze({
   van: 'ph:van',
   vault: 'ph:vault',
   walking: 'ph:person-simple-walk',
+  wallet: 'ph:wallet',
   warning: 'ph:warning',
   warningCircle: 'ph:warning-circle',
   wheelchair: 'ph:wheelchair',

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

@@ -26,7 +26,7 @@ export const CHILDREN_SCHEMA = z
   })
 
 export const COUNTRY_ISO2_CODE_SCHEMA = z
-  .nativeEnum(CountryIso2Code)
+  .enum(CountryIso2Code)
   .refine(check => Object.values(CountryIso2Code).includes(check), {
     message: 'Invalid ISO Alpha-2 country code.',
   })

package/src/schemas/hotel-offer.ts

@@ -23,7 +23,7 @@ List of hotel images in various sizes featuring an indicator for the primary (he
   hotel_room_offers: z.array(HOTEL_ROOM_OFFER_SCHEMA),
   tags: TAGS_SCHEMA,
   venues: VENUES_SCHEMA,
-})
+}).openapi('hotelOfferApi')
 
 export const HOTEL_OFFERS_SCHEMA = z.array(HOTEL_OFFER_SCHEMA)
 
@@ -52,7 +52,5 @@ export const HOTEL_OFFERS_RESPONSE_SCHEMA = z.object({
     }),
   }),
   event: z.any().optional(),
-  meta: LIST_POLLING_META_SCHEMA.extend({
-    total_count: z.number(),
-  }),
+  meta: LIST_POLLING_META_SCHEMA,
 })

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

@@ -31,7 +31,7 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       description:
         'Quantity of breakfast per night included in the given **Hotel Room Offer**',
     }),
-    breakfast_option: z.nativeEnum(BreakfastOption).openapi({
+    breakfast_option: z.enum(BreakfastOption).openapi({
       description: BREAKFAST_OPTION_DESCRIPTION,
     }),
     breakfast_price_per_guest_per_night: z
@@ -69,7 +69,7 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
     }),
     id: z.string().openapi({ description: 'Hotel Room Offer id.' }).optional(),
     package_type: z
-      .nativeEnum(PackageType)
+      .enum(PackageType)
       .openapi({
         description: PACKAGE_TYPES_DESCRIPTION,
       })
@@ -86,7 +86,7 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
     }),
     taxes: TAXES_SCHEMA,
     type: z
-      .nativeEnum(HotelRoomOfferType)
+      .enum(HotelRoomOfferType)
       .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.`,
       })

package/src/schemas/list-polling-meta.ts

@@ -14,7 +14,7 @@ export const STARTING_AFTER_SCHEMA = z.string().optional().nullable().openapi({
 })
 
 export const STATUS_SCHEMA = z
-  .nativeEnum(PollerStatus)
+  .enum(PollerStatus)
   .openapi({ description: 'Status of the response data.' })
   .openapi('pollerStatus')
 
@@ -39,5 +39,9 @@ export const LIST_META_SCHEMA = z
 
 export const LIST_POLLING_META_SCHEMA = LIST_META_SCHEMA.extend({
   status: STATUS_SCHEMA,
+  total_count: z
+    .number()
+    .optional()
+    .openapi({ description: 'Total count of the response list.' }),
 }).openapi('metaApiPollingResponse')
 /* eslint-enable camelcase */

package/src/schemas/taxes.ts

@@ -19,11 +19,11 @@ export const TAX_SCHEMA = z
       .optional()
       .nullish()
       .openapi({ description: 'Tax percentage on the total amount.' }),
-    tax_frequency: z.nativeEnum(TaxFrequency).openapi({
+    tax_frequency: z.enum(TaxFrequency).openapi({
       description:
         'Tax frequency. Specifies if the tax applies per stay or per night',
     }),
-    tax_mode: z.nativeEnum(TaxMode).openapi({
+    tax_mode: z.enum(TaxMode).openapi({
       description:
         'Tax mode. Specifies if the tax applies per occupant, per booking or per room',
     }),

package/src/types/booking.ts

@@ -1,5 +1,7 @@
-export enum PayLaterStatus {
+export enum PayLaterStatusEnum {
   Disabled = 'DISABLED',
   Enabled = 'ENABLED',
   Forced = 'FORCED',
 }
+
+export type PayLaterStatus = `${PayLaterStatusEnum}`

package/src/types/elements/allowed-payment-method.ts

@@ -0,0 +1,17 @@
+import type {
+  BasePaymentMethodCoupon,
+  BasePaymentMethodCreditCard,
+  BasePaymentMethodDepositAccount,
+  BasePaymentMethodPayLater,
+  PayloadPayLater,
+} from './payment-method.ts'
+
+export type AllowedPaymentMethod =
+  | BasePaymentMethodCoupon
+  | BasePaymentMethodCreditCard
+  | BasePaymentMethodDepositAccount
+  | AllowedPaymentMethodPayLater
+
+export interface AllowedPaymentMethodPayLater extends BasePaymentMethodPayLater {
+  payload: PayloadPayLater
+}

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

@@ -47,6 +47,8 @@ export interface BookingPolicies {
    * @memberof BookingPolicies
    */
   expiresAt: string | null
+
+  hasRoomingLists: boolean
   /**
    * Hotel id
    * @type {string}
@@ -78,3 +80,36 @@ export interface BookingPolicies {
    */
   isPriceIncreased: boolean
 }
+
+/**
+ *
+ * @export
+ * @interface BookingCreateApiGuestsListInner
+ */
+export interface BookingCreateApiGuestsListInner {
+  /**
+   *
+   * @type {Array<BookingCreateApiGuestsListInnerGuestsInner>}
+   * @memberof BookingCreateApiGuestsListInner
+   */
+  guests: BookingCreateApiGuestsListInnerGuestsInner[]
+  /**
+   *
+   * @type {string}
+   * @memberof BookingCreateApiGuestsListInner
+   */
+  hotelRoomId: string
+}
+/**
+ *
+ * @export
+ * @interface BookingCreateApiGuestsListInnerGuestsInner
+ */
+export interface BookingCreateApiGuestsListInnerGuestsInner {
+  /**
+   *
+   * @type {string}
+   * @memberof BookingCreateApiGuestsListInnerGuestsInner
+   */
+  fullname: string
+}

package/src/types/elements/booking.ts

@@ -5,7 +5,7 @@ import type { Event } from './event.ts'
 import type { HotelRoomOffer } from './hotel-room-offer.ts'
 import type { HotelRoomingList } from './hotel-rooming-list.ts'
 import type { InvoiceApi } from './invoice.ts'
-import type { PaymentMethodApi } from './payment-method.ts'
+import type { PaymentMethod } from './payment-method.ts'
 import type { SourceMarket } from './source-market.ts'
 import type { Tax } from './tax.ts'
 
@@ -148,10 +148,10 @@ export interface Booking {
    * List of preferred payment methods to be used along with their respective payload (when applicable) in order to fulfill the booking.
    *
    * ⚠️ This field is only returned when **booking.status = bkg-created**
-   * @type {Array<PaymentMethodApi>}
+   * @type {Array<PaymentMethod>}
    * @memberof Booking
    */
-  paymentMethods?: PaymentMethodApi[]
+  paymentMethods?: PaymentMethod[]
   /**
    * Penalty percentage of the requested Booking.
    *

package/src/types/elements/elements-events.ts

@@ -13,7 +13,7 @@ import type {
   HotelRoomOffersResponse,
 } from './hotel-room-offer.ts'
 import type { Hotel } from './hotel.ts'
-import type { Locale } from 'change-case'
+import type { Locale } from '@revolugo/common/constants'
 
 export enum ElementsEvent {
   BookingCreated = 'booking:created',
@@ -34,7 +34,6 @@ export enum ElementsEvent {
   HotelOffersMarkerClick = 'hotel-offers:marker:click',
   HotelOffersPollingStarted = 'hotel-offers:polling:started',
   HotelOffersRetrieved = 'hotel-offers:retrieved',
-  HotelOffersViewShowMap = 'hotel-offers-view:show-map',
   HotelRetrieved = 'hotel:retrieved',
   HotelRoomOfferRequestCreated = 'hotel-room-offer-request:created',
   HotelRoomOfferRequestRetrieved = 'hotel-room-offer-request:retrieved',
@@ -57,18 +56,17 @@ export interface ElementsEventCallbacks {
   [ElementsEvent.BookingPolicyCreated]: BookingPolicies
   [ElementsEvent.CancellationPoliciesUpdated]: CancellationPolicy[]
   [ElementsEvent.CurrencyUpdated]: CurrencyType
-  [ElementsEvent.HotelOfferItemMouseleave]: [HotelOffer, number]
-  [ElementsEvent.HotelOfferItemMouseover]: [HotelOffer, number]
-  [ElementsEvent.HotelOfferItemVisible]: [HotelOffer, number]
+  [ElementsEvent.HotelOfferItemMouseleave]: HotelOffer | [HotelOffer, number]
+  [ElementsEvent.HotelOfferItemMouseover]: HotelOffer | [HotelOffer, number]
+  [ElementsEvent.HotelOfferItemVisible]: HotelOffer | [HotelOffer, number]
   [ElementsEvent.HotelOfferRequestCreated]: HotelOfferRequestResponse
   [ElementsEvent.HotelOfferRequestRetrieved]: HotelOfferRequestResponse
   [ElementsEvent.HotelOffersFiltersUpdated]: Partial<HotelOffersFilters>
-  [ElementsEvent.HotelOffersItemClick]: [HotelOffer, number]
-  [ElementsEvent.HotelOffersMarkerClick]: HotelOffer
+  [ElementsEvent.HotelOffersItemClick]: HotelOffer | [HotelOffer, number]
+  [ElementsEvent.HotelOffersMarkerClick]: HotelOffer | [HotelOffer, number]
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   [ElementsEvent.HotelOffersPollingStarted]: any
   [ElementsEvent.HotelOffersRetrieved]: HotelOffer[]
-  [ElementsEvent.HotelOffersViewShowMap]: boolean
   [ElementsEvent.HotelRetrieved]: Hotel
   [ElementsEvent.HotelRoomOfferRequestCreated]: HotelRoomOfferRequestResponse
   [ElementsEvent.HotelRoomOfferRequestRetrieved]: HotelRoomOfferRequestResponse

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

@@ -40,14 +40,14 @@ export interface HotelOfferRequest {
    * <b style="color: red;"> when no address parameter passed.</b>
    * @type {number}
    */
-  latitude?: number | null
+  latitude: number
   /**
    * Search location longitude.
    *
    * <b style="color: red;"> when no address parameter passed.</b>
    * @type {number}
    */
-  longitude?: number | null
+  longitude: number
   /**
    * The total number of rooms requested for the stay. Results may display offers matching a different room count than the requested one, however those results will always provide enough occupancy for the total guest count needed.
    *
@@ -156,16 +156,15 @@ export interface HotelOfferRequestResponse {
   id: string
 }
 
-export type HotelOfferRequestCreate = Pick<
-  HotelOfferRequest,
-  | 'address'
-  | 'adultCount'
-  | 'checkInDate'
-  | 'checkOutDate'
-  | 'children'
-  | 'eventMetadata'
-  | 'latitude'
-  | 'longitude'
-  | 'roomCount'
-  | 'sourceMarket'
->
+export interface HotelOfferRequestCreate {
+  address?: HotelOfferRequest['address']
+  adultCount: HotelOfferRequest['adultCount']
+  checkInDate: HotelOfferRequest['checkInDate']
+  checkOutDate: HotelOfferRequest['checkOutDate']
+  children?: HotelOfferRequest['children']
+  eventMetadata?: HotelOfferRequest['eventMetadata']
+  latitude?: HotelOfferRequest['latitude']
+  longitude?: HotelOfferRequest['longitude']
+  roomCount: HotelOfferRequest['roomCount']
+  sourceMarket: HotelOfferRequest['sourceMarket']
+}

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

@@ -57,7 +57,7 @@ export interface HotelRoom {
    * @type {string}
    * @memberof HotelRoom
    */
-  id?: string
+  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/index.ts

@@ -2,6 +2,7 @@ export type * from './bed.ts'
 export type * from './booking-flow.ts'
 export type * from './booking-policy.ts'
 export type * from './cancellation-policy.ts'
+export type * from './currency.ts'
 export * from './elements-events.ts'
 export type * from './event-metadata.ts'
 export type * from './hotel-image.ts'
@@ -26,3 +27,5 @@ export type * from './hotel-review-rating.ts'
 export type * from './travel-times.ts'
 export * from './hotel-offer-list.ts'
 export type * from './hotel-room-offer-list.ts'
+export type * from './hotel-rooming-list.ts'
+export type * from './allowed-payment-method.ts'

package/src/types/elements/payment-method.ts

@@ -1,159 +1,72 @@
-export interface PaymentMethodRequestPayloadApi {
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodRequestPayloadApi
-   */
-  couponId?: string | null
+import type { PayLaterStatus } from '../booking.ts'
+
+export enum PaymentMethodNameEnum {
+  CreditCard = 'CREDIT_CARD',
+  Coupon = 'COUPON',
+  DepositAccount = 'DEPOSIT_ACCOUNT',
+  PayLater = 'PAY_LATER',
 }
 
-export interface PaymentMethodRequestApi {
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodRequestApi
-   */
-  name: PaymentMethodApiName
-  /**
-   *
-   * @type {PaymentMethodRequestPayloadApi}
-   * @memberof PaymentMethodRequestApi
-   */
-  payload?: PaymentMethodRequestPayloadApi
+export type PaymentMethodName = `${PaymentMethodNameEnum}`
+
+export interface BasePaymentMethod {
+  name: PaymentMethodName
 }
 
-export interface PaymentMethodApi {
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf
-   */
-  name: PaymentMethodApiName
-  /**
-   *
-   * @type {PaymentMethodApiOneOfPayload}
-   * @memberof PaymentMethodApiOneOf
-   */
-  payload:
-    | PaymentMethodApiOneOfPayload
-    | PaymentMethodApiOneOf1Payload
-    | PaymentMethodApiOneOf2Payload
+export type PaymentMethod =
+  | PaymentMethodCoupon
+  | PaymentMethodCreditCard
+  | PaymentMethodDepositAccount
+  | PaymentMethodPayLater
+
+export interface BasePaymentMethodCreditCard extends BasePaymentMethod {
+  name: 'CREDIT_CARD'
 }
 
-export enum PaymentMethodApiNameEnum {
-  CreditCard = 'CREDIT_CARD',
-  Coupon = 'COUPON',
-  DepositAccount = 'DEPOSIT_ACCOUNT',
+export interface PaymentMethodCreditCard extends BasePaymentMethodCreditCard {
+  payload: {
+    amount: number
+    couponId?: string | null
+    token: string
+  }
 }
 
-type PaymentMethodApiName = `${PaymentMethodApiNameEnum}`
+export interface BasePaymentMethodCoupon extends BasePaymentMethod {
+  name: 'COUPON'
+}
 
-/**
- *
- * @export
- * @interface PaymentMethodApiOneOf1
- */
-export interface PaymentMethodApiOneOf1 {
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf1
-   */
-  name: PaymentMethodApiName
-  /**
-   *
-   * @type {PaymentMethodApiOneOf1Payload}
-   * @memberof PaymentMethodApiOneOf1
-   */
-  payload: PaymentMethodApiOneOf1Payload
+export interface PaymentMethodCoupon extends BasePaymentMethodCoupon {
+  payload: {
+    amount: number
+    couponId: string
+  }
 }
 
-/**
- *
- * @export
- * @interface PaymentMethodApiOneOf1Payload
- */
-export interface PaymentMethodApiOneOf1Payload {
-  /**
-   *
-   * @type {number}
-   * @memberof PaymentMethodApiOneOf1Payload
-   */
-  amount: number
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf1Payload
-   */
-  couponId?: string | null
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf1Payload
-   */
-  token: string
+export interface BasePaymentMethodDepositAccount extends BasePaymentMethod {
+  name: 'DEPOSIT_ACCOUNT'
 }
-/**
- *
- * @export
- * @interface PaymentMethodApiOneOf2
- */
-export interface PaymentMethodApiOneOf2 {
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf2
-   */
-  name: PaymentMethodApiName
-  /**
-   *
-   * @type {PaymentMethodApiOneOf2Payload}
-   * @memberof PaymentMethodApiOneOf2
-   */
-  payload: PaymentMethodApiOneOf2Payload
+
+export interface PaymentMethodDepositAccount extends BasePaymentMethodDepositAccount {
+  payload: {
+    amount: number
+    couponId?: string | null
+  }
 }
 
-/**
- *
- * @export
- * @interface PaymentMethodApiOneOf2Payload
- */
-export interface PaymentMethodApiOneOf2Payload {
-  /**
-   *
-   * @type {number}
-   * @memberof PaymentMethodApiOneOf2Payload
-   */
-  amount: number
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf2Payload
-   */
-  couponId?: string | null
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOf2Payload
-   */
-  token?: string | null
+export interface BasePaymentMethodPayLater extends BasePaymentMethod {
+  name: 'PAY_LATER'
 }
-/**
- *
- * @export
- * @interface PaymentMethodApiOneOfPayload
- */
-export interface PaymentMethodApiOneOfPayload {
-  /**
-   *
-   * @type {number}
-   * @memberof PaymentMethodApiOneOfPayload
-   */
-  amount: number
-  /**
-   *
-   * @type {string}
-   * @memberof PaymentMethodApiOneOfPayload
-   */
-  couponId: string
+
+export interface PayloadPayLater {
+  status: PayLaterStatus
+}
+export interface PaymentMethodPayLater extends BasePaymentMethodPayLater {
+  payload: { amount: number; couponId?: string | null } & PayloadPayLater
+}
+
+export interface PaymentMethodRequest {
+  name: PaymentMethodName
+  payload?: {
+    couponId?: string | null
+  }
 }

package/src/types/http-exception/base.exception.ts

@@ -1,3 +1,3 @@
 export class HttpException extends Error {
-  declare status: number
+  status!: number
 }

package/src/utils/create-dummy-hotel-images.ts

@@ -0,0 +1,15 @@
+import { getRandomHexColor } from './get-random-hex-color.ts'
+import { getRandomInt } from './get-random-int.ts'
+
+import type { HotelImage } from '../types/index.ts'
+
+export function createDummyHotelImage(count: number): HotelImage[] {
+  return Array.from({ length: count }, () => ({
+    isHeroImage: false,
+    l: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    m: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    s: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    xl: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    xs: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+  }))
+}

package/src/utils/generate-dummy-hotel-images.ts

@@ -0,0 +1,15 @@
+import { getRandomHexColor } from './get-random-hex-color.ts'
+import { getRandomInt } from './get-random-int.ts'
+
+import type { HotelImage } from '../types/index.ts'
+
+export function generateDummyHotelImages(): HotelImage {
+  return {
+    isHeroImage: false,
+    l: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    m: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    s: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    xl: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+    xs: `https://dummyimage.com/${getRandomInt(300, 900)}x${getRandomInt(300, 900)}/${getRandomHexColor()}/${getRandomHexColor()}`,
+  }
+}

package/src/utils/generate-random-nearby-geolocation.ts

@@ -0,0 +1,31 @@
+import type { GeoCoordinates } from '../types/geo-coordinates.ts'
+
+/**
+ * Generate random coordinates near a given latitude and longitude.
+ *
+ * @param lat - Base latitude
+ * @param lon - Base longitude
+ * @param radiusInMeters - Max distance from base point, in meters
+ * @returns { lat: number, lon: number }
+ */
+export function generateRandomNearbyGeolocation(
+  { latitude: lat, longitude: lon }: GeoCoordinates,
+  radiusInMeters: number,
+): GeoCoordinates {
+  // Convert radius from meters to degrees
+  const radiusInDegrees = radiusInMeters / 111_320
+
+  // Random distance and angle
+  const u = Math.random()
+  const v = Math.random()
+  const w = radiusInDegrees * Math.sqrt(u)
+  const t = 2 * Math.PI * v
+
+  const deltaLat = w * Math.cos(t)
+  const deltaLon = (w * Math.sin(t)) / Math.cos((lat * Math.PI) / 180)
+
+  const newLat = lat + deltaLat
+  const newLon = lon + deltaLon
+
+  return { latitude: newLat, longitude: newLon }
+}

package/src/utils/get-hotel-room-offer-room-count.ts

@@ -0,0 +1,7 @@
+import type { HotelRoomOffer } from '../types/elements/index.ts'
+
+export function getHotelRoomOfferRoomCount(
+  hotelRoomOffer: HotelRoomOffer,
+): number {
+  return hotelRoomOffer.hotelRooms.reduce((acc, room) => acc + room.count, 0)
+}

package/src/utils/get-night-count.ts

@@ -0,0 +1,11 @@
+import { dayjs } from './dayjs.ts'
+
+/**
+ * Get the number of nights between two dates.
+ * @param startDate - The start date
+ * @param endDate - The end date
+ * @returns The number of nights
+ */
+export function getNightCount(startDate: string, endDate: string): number {
+  return dayjs(endDate).diff(dayjs(startDate), 'day')
+}

package/src/utils/index.ts

@@ -15,9 +15,13 @@ export * from './debounce.ts'
 export * from './defaults-deep.ts'
 export * from './delay.ts'
 export * from './find-unique-keys.ts'
+export * from './generate-dummy-hotel-images.ts'
 export * from './generate-numbers-from-str.ts'
 export * from './generate-pseudo-random-string.ts'
+export * from './generate-random-nearby-geolocation.ts'
 export * from './get-guest-count.ts'
+export * from './get-night-count.ts'
+export * from './get-hotel-room-offer-room-count.ts'
 export * from './get-random-element-from-array.ts'
 export * from './get-random-hex-color.ts'
 export * from './get-random-int.ts'
@@ -48,9 +52,12 @@ export * from './sort-by.ts'
 export * from './sum-by.ts'
 export * from './sum.ts'
 export * from './to-boolean.ts'
+export * from './to-lang.ts'
+export * from './to-locale.ts'
 export * from './transform-schema-keys.ts'
 export * from './uniq.ts'
 export * from './uniq-by.ts'
 export * from './uniq-with.ts'
 export * from './validators.ts'
 export * from './weighted-mean.ts'
+export * from './create-dummy-hotel-images.ts'

package/src/utils/to-lang.ts

@@ -0,0 +1,39 @@
+import { Lang, Locale } from '../constants/locales.ts'
+
+import type { ExtendedLocale } from '../constants/locales.ts'
+
+export function toLang(localeOrLang: ExtendedLocale): Lang {
+  switch (localeOrLang) {
+    case Lang.EN:
+    case Locale.en_US: {
+      return Lang.EN
+    }
+    case Lang.FR:
+    case Locale.fr_FR: {
+      return Lang.FR
+    }
+    case Lang.DE:
+    case Locale.de_DE: {
+      return Lang.DE
+    }
+    case Lang.ES:
+    case Locale.es_ES: {
+      return Lang.ES
+    }
+    case Lang.IT:
+    case Locale.it_IT: {
+      return Lang.IT
+    }
+    case Lang.NL:
+    case Locale.nl_NL: {
+      return Lang.NL
+    }
+    case Lang.PT:
+    case Locale.pt_PT: {
+      return Lang.PT
+    }
+    default: {
+      return Lang.EN
+    }
+  }
+}

package/src/utils/to-locale.ts

@@ -0,0 +1,39 @@
+import { Lang, Locale } from '../constants/locales.ts'
+
+import type { ExtendedLocale } from '../constants/locales.ts'
+
+export function toLocale(localeOrLang: ExtendedLocale): Locale {
+  switch (localeOrLang) {
+    case Lang.EN:
+    case Locale.en_US: {
+      return Locale.en_US
+    }
+    case Lang.FR:
+    case Locale.fr_FR: {
+      return Locale.fr_FR
+    }
+    case Lang.DE:
+    case Locale.de_DE: {
+      return Locale.de_DE
+    }
+    case Lang.ES:
+    case Locale.es_ES: {
+      return Locale.es_ES
+    }
+    case Lang.IT:
+    case Locale.it_IT: {
+      return Locale.it_IT
+    }
+    case Lang.NL:
+    case Locale.nl_NL: {
+      return Locale.nl_NL
+    }
+    case Lang.PT:
+    case Locale.pt_PT: {
+      return Locale.pt_PT
+    }
+    default: {
+      return Locale.en_US
+    }
+  }
+}

package/src/utils/transform-schema-keys.ts

@@ -1,22 +1,25 @@
-import { type ZodTypeAny, z } from 'zod'
+import { getOpenApiMetadata, getRefId } from '@asteasolutions/zod-to-openapi'
+import { z } from 'zod'
 
 import {
   CASE_TRANSFORMERS_MAPPING,
   type CaseTransformer,
 } from './case-transformers.ts'
 
+import type { $ZodType } from 'zod/v4/core'
+
 /* eslint-disable no-underscore-dangle, max-statements */
 
 function transformSchemaKeysWithTransformer(
-  schema: ZodTypeAny,
+  schema: z.ZodType,
   transformer: (str: string) => string,
-): ZodTypeAny {
-  let result: ZodTypeAny = schema
+): z.ZodType {
+  let result: z.ZodType = schema
 
   // Handle ZodObject
   if (schema instanceof z.ZodObject) {
-    const shape = schema._def.shape()
-    const transformedShape: Record<string, ZodTypeAny> = {}
+    const { shape } = schema.def
+    const transformedShape: Record<string, $ZodType> = {}
 
     for (const key in shape) {
       if (Object.hasOwn(shape, key)) {
@@ -28,86 +31,76 @@ function transformSchemaKeysWithTransformer(
       }
     }
 
-    result = z.object(transformedShape) as ZodTypeAny
+    result = z.object(transformedShape) as z.ZodType
   }
 
   // Handle ZodArray
   else if (schema instanceof z.ZodArray) {
-    const { type: elementSchema } = schema._def
+    const { element } = schema.def
     result = z.array(
-      transformSchemaKeysWithTransformer(elementSchema, transformer),
+      transformSchemaKeysWithTransformer(element as z.ZodType, transformer),
     )
   }
 
   // Handle ZodOptional
   else if (schema instanceof z.ZodOptional) {
-    const { innerType: innerSchema } = schema._def
+    const { innerType: innerSchema } = schema.def
     result = transformSchemaKeysWithTransformer(
-      innerSchema,
+      innerSchema as z.ZodType,
       transformer,
     ).optional()
   }
 
   // Handle ZodNullable
   else if (schema instanceof z.ZodNullable) {
-    const { innerType: innerSchema } = schema._def
+    const { innerType: innerSchema } = schema.def
     result = transformSchemaKeysWithTransformer(
-      innerSchema,
+      innerSchema as z.ZodType,
       transformer,
     ).nullable()
   }
 
   // Handle ZodDefault
   else if (schema instanceof z.ZodDefault) {
-    const { defaultValue, innerType: innerSchema } = schema._def
+    const { defaultValue, innerType: innerSchema } = schema.def
+    const defaultValueValue =
+      typeof defaultValue === 'function' ? defaultValue() : defaultValue
     result = transformSchemaKeysWithTransformer(
-      innerSchema,
-      transformer,
-    ).default(defaultValue())
-  }
-
-  // Handle ZodEffects (includes .refine(), .transform(), etc.)
-  else if (schema instanceof z.ZodEffects) {
-    const { schema: innerSchema } = schema._def
-    const transformedInner = transformSchemaKeysWithTransformer(
-      innerSchema,
+      innerSchema as z.ZodType,
       transformer,
-    )
-
-    // We need to reconstruct the effects
-    // This is a simplified version - effects are not transformed, just passed through
-    result = transformedInner
+    ).default(defaultValueValue)
   }
 
   // Handle ZodUnion
   else if (schema instanceof z.ZodUnion) {
-    const { options } = schema._def
-    const transformedOptions = options.map((option: ZodTypeAny) =>
-      transformSchemaKeysWithTransformer(option, transformer),
+    const { options } = schema.def
+    const transformedOptions = options.map((option: $ZodType) =>
+      transformSchemaKeysWithTransformer(option as z.ZodType, transformer),
     )
     result = z.union(
-      transformedOptions as [ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]],
+      transformedOptions as [z.ZodType, z.ZodType, ...z.ZodType[]],
     )
   }
 
   // Handle ZodIntersection
   else if (schema instanceof z.ZodIntersection) {
-    const { left, right } = schema._def
+    const { left, right } = schema.def
     result = z.intersection(
-      transformSchemaKeysWithTransformer(left, transformer),
-      transformSchemaKeysWithTransformer(right, transformer),
+      transformSchemaKeysWithTransformer(left as z.ZodType, transformer),
+      transformSchemaKeysWithTransformer(right as z.ZodType, transformer),
     )
   }
 
   // Propagate openapi metadata
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const { openapi } = schema._def as any
-  if (openapi && result !== schema) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ;(result._def as any).openapi = openapi
+  const openapiRefId = getRefId(schema)
+
+  const openapiMetadata = getOpenApiMetadata(schema)
+
+  if (openapiRefId) {
+    result = result.openapi(openapiRefId)
   }
 
-  return result
+  return result.openapi(openapiMetadata)
 }
 
 /**
@@ -129,7 +122,7 @@ function transformSchemaKeysWithTransformer(
  * // Results in: { firstName: z.string(), lastName: z.string() }
  * ```
  */
-export function transformSchemaKeys<T extends ZodTypeAny>(
+export function transformSchemaKeys<T extends z.ZodType>(
   schema: T,
   toCase: CaseTransformer,
 ): T {

package/src/assets/index.ts

@@ -1,3 +0,0 @@
-export { default as hotelImagePlaceholder } from './placeholder-hotel.png'
-
-export { default as roomImagePlaceholder } from './placeholder-room.png'