@revolugo/common 7.1.1-alpha.2 → 7.1.1-alpha.20

package/package.json

@@ -1,19 +1,13 @@
 {
   "name": "@revolugo/common",
-  "version": "7.1.1-alpha.2",
+  "version": "7.1.1-alpha.20",
   "private": false,
   "description": "Revolugo common",
   "author": "Revolugo",
-  "type": "module",
-  "engines": {
-    "node": ">=20.18.1 <25"
-  },
-  "volta": {
-    "extends": "../../package.json"
-  },
   "files": [
     "src"
   ],
+  "type": "module",
   "exports": {
     "./amenities": "./src/amenities/index.ts",
     "./cancellation-policies": "./src/cancellation-policies.ts",
@@ -38,6 +32,12 @@
     "uuid": "13.0.0",
     "zod": "4.3.6"
   },
+  "engines": {
+    "node": ">=20.18.1 <25"
+  },
+  "volta": {
+    "extends": "../../package.json"
+  },
   "scripts": {
     "test": "vitest"
   }

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

@@ -1,8 +1,3 @@
-export enum HotelRoomOfferType {
-  HotelRoom = 'HOTEL_ROOM',
-  Package = 'PACKAGE',
-}
-
 export enum PackageType {
   BestMatch = 'BEST_MATCH',
   Cheapest = 'CHEAPEST',

package/src/constants/poller.ts

@@ -3,6 +3,8 @@ export enum PollerStatus {
   InProgress = 'IN_PROGRESS',
 }
 
+export type PollerStatusType = `${PollerStatus}`
+
 export enum PollerType {
   // eslint-disable-next-line @typescript-eslint/naming-convention
   HOTEL_ROOM_OFFERS = 'HOTEL_ROOM_OFFERS',

package/src/countries/index.ts

@@ -1,2 +1,3 @@
 export * from './countries.ts'
 export * from './europe.ts'
+export type * from './types.ts'

package/src/currencies/utils.ts

@@ -1,8 +1,9 @@
 import { CURRENCIES } from './currencies.ts'
 
 import type { CurrencyCode } from './constants.ts'
+import type { CurrencyType } from '../types/index.ts'
 
-export function getCurrencySymbol(currency: CurrencyCode): string {
+export function getCurrencySymbol(currency: CurrencyType): string {
   const symbol = CURRENCIES[currency]?.symbol
 
   if (!symbol) {
@@ -12,7 +13,7 @@ export function getCurrencySymbol(currency: CurrencyCode): string {
   return symbol
 }
 
-export function isZeroDecimal(currency: CurrencyCode): boolean {
+export function isZeroDecimal(currency: CurrencyType): boolean {
   return (CURRENCIES[currency] && CURRENCIES[currency].zeroDecimal) || false
 }
 
@@ -27,7 +28,7 @@ export function normalizeAmount({
   currency,
 }: {
   amount: number
-  currency: CurrencyCode
+  currency: CurrencyType
 }): number {
   if (isZeroDecimal(currency)) {
     return amount
@@ -41,7 +42,7 @@ export function denormalizeAmount({
   currency,
 }: {
   amount: number
-  currency: CurrencyCode
+  currency: CurrencyType
 }): number {
   if (isZeroDecimal(currency)) {
     return amount
@@ -81,7 +82,7 @@ export function formatAmount({
 
 export class MoneyCalculator {
   private amount: number
-  private currency: CurrencyCode
+  private currency: CurrencyType
   private isNormalized: boolean
 
   constructor({
@@ -90,7 +91,7 @@ export class MoneyCalculator {
     isNormalized = false,
   }: {
     amount: number
-    currency: CurrencyCode
+    currency: CurrencyType
     isNormalized?: boolean
   }) {
     this.amount = amount
@@ -108,7 +109,7 @@ export class MoneyCalculator {
     currency,
     exchangeRate,
   }: {
-    currency: CurrencyCode
+    currency: CurrencyType
     exchangeRate: number
   }): this {
     if (this.currency === currency || this.amount === 0) {

package/src/models/paginated-queries.ts

@@ -1,10 +1,10 @@
 import type { IPaginatedQueriesConfig } from '../types/index.ts'
 
 /* @__PURE__ */
-export const PAGINATED_QUERY_DEFAULT_CONFIG: IPaginatedQueriesConfig = {
+export const PAGINATED_QUERY_DEFAULT_CONFIG = {
   defaultScope: {
     limit: 20,
     order: 'DESC',
     orderBy: 'createdAt',
   },
-}
+} satisfies Required<IPaginatedQueriesConfig>

package/src/schemas/booking-policy.ts

@@ -22,9 +22,9 @@ export const BOOKING_POLICY_SCHEMA = z
     }),
     check_in_date: CHECK_IN_DATE_SCHEMA,
     check_out_date: CHECK_OUT_DATE_SCHEMA,
-    children: CHILDREN_SCHEMA.optional().nullish(),
+    children: CHILDREN_SCHEMA.nullish(),
     currency: CURRENCY_SCHEMA,
-    expires_at: z.coerce.date().openapi({
+    expires_at: z.coerce.date().nullable().openapi({
       description:
         'Expiration date for this **Booking Policy**.\n\nThe returned  **Booking Policy** (price and cancellation policies) is valid bookable policy up to this **expires_at** date, while it may be valid for a longer period in the case of some suppliers, this API call is equivalent to an availability check and it is important not to let long periods between retrieval of this policy and the booking confirmation call itself as this will often reduce the likelihood of a **Hotel Room Offer** being successfully booked.',
     }),

package/src/schemas/breakfast.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod'
+
+import { BreakfastOption } from '../constants/index.ts'
+import { HotelRoomOfferTypeEnum } from '../types/index.ts'
+
+export const BREAKFAST_OPTION_DESCRIPTION = `This parameter describes the breakfast option for the given **Hotel Room Offer**:
+- **breakfast_option = "${BreakfastOption.Included}"**:
+  1. When **HotelRoomOffer.type = "${HotelRoomOfferTypeEnum.Package}"**:
+  the returned **Hotel Room Offer** includes breakfast for the requested **guest count (adult_count + children over 3)**, you cannot choose otherwise, and the returned **price** already includes it,
+  2. When **HotelRoomOffer.type = "${HotelRoomOfferTypeEnum.HotelRoom}"**:
+  the returned **Hotel Room Offer** includes breakfast for the **Hotel Room Offer** maximum occupancy, you cannot choose otherwise, and the returned **price** already includes it,
+-**breakfast_option = "${BreakfastOption.Optional}"**: the returned **Hotel Room Offer** does not include by default the breakfast and so does the returned **price**, but you'll be able to let your customers choose to add it to their booking. In that case, a **breakfast_price_per_guest_per_night** expressed in the requested **currency** will be available in the returned data, and you'll be to perform one of the two following actions: \n - Call **[Create Hotel Room Offer endpoint](/v1/documentation#operation/postV1Hotel_room_offers)** and get a fresh **Hotel Room Offer** with updated price \n - Compute and display the total price of the **Hotel Room Offer** related to the guest_count and night count requested including extra breafasts.,
+- **breakfast_option = "${BreakfastOption.NotIncluded}"**: the returned **Hotel Room Offer** does not include breakfast and you cannot choose otherwise through API. Guest may still be able to add extra breakfast option(s) at the time of check-in directly at the hotel's reception.`
+
+export const BREAKFAST_OPTION_SCHEMA = z
+  .enum(BreakfastOption)
+  .openapi('BreakfastOption', { description: BREAKFAST_OPTION_DESCRIPTION })
+
+export type BreakfastOptionSchema = z.infer<typeof BREAKFAST_OPTION_SCHEMA>
+
+export const ADD_BREAKFAST_SCHEMA = z
+  .boolean()
+  .nullish()
+  .openapi('addBreakfast', {
+    description: `This parameter allows to add breakfast to the booking as long as every requested Hotel Room Offers **breakfast_option = ${BreakfastOption.Optional}** .\n\nThe final breakfast count that will be included in the Hotel Room Offer will be returned in the response and is calculated as follows: \n\n - If the returned Hotel Room Offer **total room count**  > **hotel_room_offer_request.adult_count** then **breakfast_count** will be equal to the **total room count** of the returned Hotel Room Offer, \n\n - Otherwise **breakfast_count** will be equal to the minimum value between related **hotel_room_offer_request.adult_count** and returned Hotel Room Offer **total occupancy**. \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;">If you already use this field, don't worry as we still support it with the following behaviour:</b>\n- <span style="color: orange;">When **add_breakfast = true** then **breakfast_count = MIN(guest count, total offer occupancy)** where **guest count** is the total number of adult and children over 3.</span>\n- <span style="color: orange;">Otherwise **breakfast_count = 0**.</span></div>`,
+  })
+
+export const BREAKFAST_COUNT = z
+  .number()
+  .optional()
+  .openapi('breakfastCount', {
+    description: `This parameter describes the quantity of breakfast / night that should be included in the **Booking**. When **breakfast_option = ${BreakfastOption.Optional}**, valid **breakfast_count** lower bound is **room count** and upper bound is **guest count**, where **guest count** is the number of adult and children over 3.\n\n⚠️ The actual breakfast count that will be included in the **Booking** is the one that is returned in the response of this endpoint and might be different from this **breakfast_count** paramater in some cases. Please, make sure to check the actual breakfast count included in the **Hotel Room Offer** returned in the response of this endpoint.`,
+  })

package/src/schemas/currency.ts

@@ -5,3 +5,5 @@ import { STRIPE_CURRENCY_CODES } from '../currencies/index.ts'
 export const CURRENCY_SCHEMA = z
   .enum(STRIPE_CURRENCY_CODES)
   .openapi('CurrencyClient', { description: 'ISO 4217 currency code.' })
+
+export type CurrencySchema = z.infer<typeof CURRENCY_SCHEMA>

package/src/schemas/global.ts

@@ -1,25 +1,13 @@
 /* eslint-disable camelcase */
 import { z } from 'zod'
 
-import {
-  BreakfastOption,
-  CountryIso2Code,
-  Locale,
-  Status,
-} from '../constants/index.ts'
+import { CountryIso2Code, Locale, Status } from '../constants/index.ts'
 
 export const validStringDate = (): z.ZodString =>
   z
     .string()
     .regex(/^(19|20)\d\d[- /.](0[1-9]|1[012])[- /.](0[1-9]|[12][0-9]|3[01])$/u)
 
-export const ADD_BREAKFAST_SCHEMA = z
-  .boolean()
-  .nullish()
-  .openapi('addBreakfast', {
-    description: `This parameter allows to add breakfast to the booking as long as every requested Hotel Room Offers **breakfast_option = ${BreakfastOption.Optional}** .\n\nThe final breakfast count that will be included in the Hotel Room Offer will be returned in the response and is calculated as follows: \n\n - If the returned Hotel Room Offer **total room count**  > **hotel_room_offer_request.adult_count** then **breakfast_count** will be equal to the **total room count** of the returned Hotel Room Offer, \n\n - Otherwise **breakfast_count** will be equal to the minimum value between related **hotel_room_offer_request.adult_count** and returned Hotel Room Offer **total occupancy**. \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;">If you already use this field, don't worry as we still support it with the following behaviour:</b>\n- <span style="color: orange;">When **add_breakfast = true** then **breakfast_count = MIN(guest count, total offer occupancy)** where **guest count** is the total number of adult and children over 3.</span>\n- <span style="color: orange;">Otherwise **breakfast_count = 0**.</span></div>`,
-  })
-
 export const ADULT_COUNT_SCHEMA = z
   .number()
   .int()
@@ -30,13 +18,6 @@ export const ADULT_COUNT_SCHEMA = z
       'The total number of adults who will be staying in the property.',
   })
 
-export const BREAKFAST_COUNT = z
-  .number()
-  .optional()
-  .openapi('breakfastCount', {
-    description: `This parameter describes the quantity of breakfast / night that should be included in the **Booking**. When **breakfast_option = ${BreakfastOption.Optional}**, valid **breakfast_count** lower bound is **room count** and upper bound is **guest count**, where **guest count** is the number of adult and children over 3.\n\n⚠️ The actual breakfast count that will be included in the **Booking** is the one that is returned in the response of this endpoint and might be different from this **breakfast_count** paramater in some cases. Please, make sure to check the actual breakfast count included in the **Hotel Room Offer** returned in the response of this endpoint.`,
-  })
-
 export const CHECK_IN_DATE_SCHEMA = validStringDate().openapi('checkInDate', {
   description: 'Date of check-in formatted as YYYY-MM-DD.',
 })

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

@@ -1,13 +1,10 @@
 /* eslint-disable camelcase */
 import { z } from 'zod'
 
-import {
-  BreakfastOption,
-  HotelRoomOfferType,
-  PackageType,
-  StayTaxesInfoEnum,
-} from '../constants/index.ts'
+import { PackageType, StayTaxesInfoEnum } from '../constants/index.ts'
+import { HotelRoomOfferTypeEnum } from '../types/elements/hotel-room-offer-type.ts'
 
+import { BREAKFAST_OPTION_SCHEMA } from './breakfast.ts'
 import { CANCELLATION_POLICY_SCHEMA } from './cancellation-policies.ts'
 import { CURRENCY_SCHEMA } from './currency.ts'
 import { SOURCE_MARKET_SCHEMA } from './global.ts'
@@ -21,16 +18,8 @@ export const HOTEL_ROOM_OFFERS_IMAGES = z.array(z.array(HOTEL_IMAGE)).openapi({
   description:
     'List of hotel room offer images in various sizes featuring an indicator for the primary (hero) image',
 })
-export const BREAKFAST_OPTION_DESCRIPTION = `This parameter describes the breakfast option for the given **Hotel Room Offer**:
-- **breakfast_option = "${BreakfastOption.Included}"**:
-  1. When **HotelRoomOffer.type = "${HotelRoomOfferType.Package}"**:
-  the returned **Hotel Room Offer** includes breakfast for the requested **guest count (adult_count + children over 3)**, you cannot choose otherwise, and the returned **price** already includes it,
-  2. When **HotelRoomOffer.type = "${HotelRoomOfferType.HotelRoom}"**:
-  the returned **Hotel Room Offer** includes breakfast for the **Hotel Room Offer** maximum occupancy, you cannot choose otherwise, and the returned **price** already includes it,
--**breakfast_option = "${BreakfastOption.Optional}"**: the returned **Hotel Room Offer** does not include by default the breakfast and so does the returned **price**, but you'll be able to let your customers choose to add it to their booking. In that case, a **breakfast_price_per_guest_per_night** expressed in the requested **currency** will be available in the returned data, and you'll be to perform one of the two following actions: \n - Call **[Create Hotel Room Offer endpoint](/v1/documentation#operation/postV1Hotel_room_offers)** and get a fresh **Hotel Room Offer** with updated price \n - Compute and display the total price of the **Hotel Room Offer** related to the guest_count and night count requested including extra breafasts.,
-- **breakfast_option = "${BreakfastOption.NotIncluded}"**: the returned **Hotel Room Offer** does not include breakfast and you cannot choose otherwise through API. Guest may still be able to add extra breakfast option(s) at the time of check-in directly at the hotel's reception.`
 
-export const PACKAGE_TYPES_DESCRIPTION = `An **Hotel Room Offer** of type **${HotelRoomOfferType.Package}** can be of **4 types**, described by **package_type** parameter: \n\n - **${PackageType.Cheapest}** : The cheapest combination of hotel rooms that can accommodate the requested guest count. Note that it may not match the requested room count (e.g., 4 guests and 2 rooms requested may return an hotel room package including only 1 room with an occupancy of 4). \n\n -**${PackageType.MatchingRoomCount}** : the cheapest hotel room package that can accommodate the given guest count and that matches exactly the room count given. \n\n -**${PackageType.BestMatch}** : The cheapest hotel room package that matches the given room and guest count with a balanced distribution of guests across the rooms (e.g.; 8 guests and 3 rooms requested may return an **Hotel Room Offer** package including 2 rooms with an occupancy of 3 on each one and 1 room with an occupancy of 2). \n\n -**${PackageType.Regular}** : any other available package.`
+export const PACKAGE_TYPES_DESCRIPTION = `An **Hotel Room Offer** of type **${HotelRoomOfferTypeEnum.Package}** can be of **4 types**, described by **package_type** parameter: \n\n - **${PackageType.Cheapest}** : The cheapest combination of hotel rooms that can accommodate the requested guest count. Note that it may not match the requested room count (e.g., 4 guests and 2 rooms requested may return an hotel room package including only 1 room with an occupancy of 4). \n\n -**${PackageType.MatchingRoomCount}** : the cheapest hotel room package that can accommodate the given guest count and that matches exactly the room count given. \n\n -**${PackageType.BestMatch}** : The cheapest hotel room package that matches the given room and guest count with a balanced distribution of guests across the rooms (e.g.; 8 guests and 3 rooms requested may return an **Hotel Room Offer** package including 2 rooms with an occupancy of 3 on each one and 1 room with an occupancy of 2). \n\n -**${PackageType.Regular}** : any other available package.`
 
 export const HOTEL_ROOM_OFFER_SCHEMA = z
   .object({
@@ -38,9 +27,7 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       description:
         'Quantity of breakfast per night included in the given **Hotel Room Offer**',
     }),
-    breakfast_option: z.enum(BreakfastOption).openapi({
-      description: BREAKFAST_OPTION_DESCRIPTION,
-    }),
+    breakfast_option: BREAKFAST_OPTION_SCHEMA,
     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>',
@@ -59,8 +46,8 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       .number()
       .nullish()
       .openapi({
-        description: `When **type = ${HotelRoomOfferType.HotelRoom}**: this parameters represents the available quantity for the given **Hotel Room Offer**.
-  When **type = ${HotelRoomOfferType.Package}**: count = 1 always.`,
+        description: `When **type = ${HotelRoomOfferTypeEnum.HotelRoom}**: this parameters represents the available quantity for the given **Hotel Room Offer**.
+  When **type = ${HotelRoomOfferTypeEnum.Package}**: count = 1 always.`,
       }),
     currency: CURRENCY_SCHEMA,
     hotel_id: z
@@ -69,7 +56,7 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
     hotel_rooms: HOTEL_ROOMS_SCHEMA.openapi({
       description: 'List of Hotel Rooms included in the Hotel Room Offer.',
     }),
-    id: z.string().openapi({ description: 'Hotel Room Offer id.' }).optional(),
+    id: z.string().optional().openapi({ description: 'Hotel Room Offer id.' }),
     package_type: z
       .enum(PackageType)
       .openapi({
@@ -86,13 +73,13 @@ export const HOTEL_ROOM_OFFER_SCHEMA = z
       .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}**.`,
+      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 **${HotelRoomOfferTypeEnum.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 = ${HotelRoomOfferTypeEnum.Package}** based on a packaged list of **Hotel Room Offers** of type **${HotelRoomOfferTypeEnum.HotelRoom}**.`,
     }),
     taxes: TAXES_SCHEMA,
     type: z
-      .enum(HotelRoomOfferType)
+      .enum(HotelRoomOfferTypeEnum)
       .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.`,
+        description: `Hotel Room Offer type.\n\n **Hotel Room Offers** with **type = "${HotelRoomOfferTypeEnum.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 = "${HotelRoomOfferTypeEnum.Package}"** from multiple **Hotel Room Offers** with **type = "${HotelRoomOfferTypeEnum.HotelRoom}"**. See **[Create Hotel Room Offer endpoint](/v1/documentation#operation/postV1Hotel_room_offers)** for details.`,
       })
       .optional(),
   })

package/src/schemas/index.ts

@@ -1,3 +1,4 @@
+export * from './breakfast.ts'
 export * from './booking-policy.ts'
 export * from './cancellation-policies.ts'
 export * from './currency.ts'

package/src/types/elements/index.ts

@@ -14,7 +14,7 @@ export * from './hotel-room-offer-type.ts'
 export * from './hotel-room-offer-package-type.ts'
 export type * from './hotel-room-offer-request.ts'
 export type * from './hotel-room.ts'
-export { SourceMarketEnum } from './source-market.ts'
+export * from './source-market.ts'
 export type * from './tag.ts'
 export * from './tax.ts'
 export * from './booking.ts'

package/src/utils/case-transformers.ts

@@ -79,7 +79,7 @@ export function keysChangeCase<T>(
 
   options: { deep?: boolean; exclude?: (string | RegExp)[] } = { deep: true },
 ): unknown {
-  if (isObject(obj)) {
+  if (isObject(obj) && !(obj instanceof Date)) {
     return Object.keys(obj).reduce<any>((result, key) => {
       // Check if key should be excluded from the transformation
       const transformedKey =

package/src/utils/dayjs.ts

@@ -17,7 +17,7 @@ import 'dayjs/locale/fr.js'
 import 'dayjs/locale/en.js'
 /* eslint-enable no-restricted-syntax, import/no-unassigned-import */
 
-/* eslint-disable import-x/no-named-as-default-member */
+/* eslint-disable import/no-named-as-default-member */
 dayjs.extend(advancedFormat)
 dayjs.extend(isBetween)
 dayjs.extend(isSameOrAfter)
@@ -28,7 +28,7 @@ dayjs.extend(minMax)
 dayjs.extend(relativeTime)
 dayjs.extend(timezone)
 dayjs.extend(utc)
-/* eslint-enable import-x/no-named-as-default-member */
+/* eslint-enable import/no-named-as-default-member */
 
 export { dayjs }