@curless/hotel-storefront 0.27.28 → 0.28.0

package/dist/huazhu/backend.js

@@ -3,6 +3,7 @@ import { DEFAULT_PAGE, MAX_PAGE, REQUEST_KINDS, REQUEST_NOTE_MAX, guestTooLong,
 import { addDays, atHotelTime, nights as nightsBetween, stayProblem, todayAt } from '../dates.js';
 import { byWords, splitByStay } from '../demo-hotels.js';
 import { FACILITIES, hasFacility } from '../facilities.js';
+import { endOf, startProblem } from '../hourly.js';
 import { BOOKING_LIMITS, DAY_MS, HOUR_MS, WindowCounter } from '../limits.js';
 import { formatMoney, minorFactor, money, multiplyMoney, toMinor } from '../money.js';
 import { MAX_ROOMS_PER_LINE, quoteLineKey } from '../trip.js';
@@ -10,8 +11,9 @@ import { IN_REQUEST_AT_MS, StoreWriteError, nextCheckAt, statusOf, } from './boo
 import { describePolicy, feeFor, freeUntilOf, nightAuditOf, parseCancelPolicy, penaltyAt, refundableFrom, } from './cancel-policy.js';
 import { haystackOf, inPlace, roomPhoto, toHotel } from './catalog.js';
 import { HuazhuRefusal, HuazhuUnreachable } from './client.js';
-import { bedNameEn, offerNameEn, roomNameEn } from './english.js';
-import { ariRanges, bookableNow, clockAt, offeredAtAll, sell, } from './sellable.js';
+import { bedNameEn, offerNameEn, rateNameEn, roomNameEn } from './english.js';
+import { rateLabels } from './labels.js';
+import { ariRanges, bookableNow, clockAt, hourlyWindow, inStayWindow, offeredAtAll, sell, } from './sellable.js';
 import { BOOK_EXISTS, BOOK_REFUSALS, CODES, } from './wire.js';
 export const HUAZHU_CAPABILITIES = {
     members: false,
@@ -312,6 +314,8 @@ export const createHuazhuHotels = (opts) => {
     /** A room as offered - type and rate - in the connector's language. */
     const offerOf = (p) => (en ? offerNameEn(p.roomTypeName, p.rateCodeName) : undefined) ??
         [p.roomTypeName, p.rateCodeName].filter(Boolean).join(' · ');
+    /** A rate's own name in the connector's language, or Huazhu's words as they are. */
+    const rateNameOf = (p) => (en ? rateNameEn(p.rateCodeName) : undefined) ?? p.rateCodeName ?? p.rateCode;
     const today = () => todayAt(now(), opts.tz);
     const limits = { ...BOOKING_LIMITS, ...(opts.limits ?? {}) };
     const requestsByEmail = new WindowCounter(DAY_MS, now);
@@ -494,7 +498,9 @@ export const createHuazhuHotels = (opts) => {
     };
     /** Every sellable-or-not product of one hotel for one stay. */
     const priceStay = async (h, stay, rooms, fresh = false) => {
-        const { value: products, sellDays } = await productsWithDays(h.hotelId);
+        const { value: all, sellDays } = await productsWithDays(h.hotelId);
+        // Nights only: rooms by the hour are priced for today apart - `priceHourly`.
+        const products = all.filter((p) => p.checkinType === 'DAY');
         if (products.length === 0)
             return [];
         const roomTypeOf = (p) => (h.hotelRoomTypeList ?? []).find((r) => r.roomTypeCode === p.roomTypeCode);
@@ -537,6 +543,84 @@ export const createHuazhuHotels = (opts) => {
         })
             .filter((x) => !(x.roomType && x.roomType.status === 0));
     };
+    const hourlyAriCache = new Map();
+    /**
+     * Today's prices and rooms for a hotel's rooms by the hour. Huazhu answers
+     * these for today only ("时租房 … 只能查 startDate 为当天的 ARI"), asked apart
+     * from the nights with `checkinType: HOUR`.
+     */
+    const hourlyAriFor = async (hotelId, date, fresh = false) => {
+        const key = `${hotelId}|${date}`;
+        const hit = hourlyAriCache.get(key);
+        if (!fresh && hit && now() - hit.at < ariTtl)
+            return hit.value;
+        const [offers, inventory] = await Promise.all([
+            client.offers(hotelId, date, date, undefined, 'HOUR').catch((err) => {
+                if (err instanceof HuazhuRefusal && [4206, 2008].includes(err.code))
+                    return { dailyOffers: [] };
+                throw err;
+            }),
+            client.inventory(hotelId, date, date, undefined, 'HOUR').catch((err) => {
+                if (err instanceof HuazhuRefusal && [4306, 2008].includes(err.code))
+                    return {
+                        dailyInventories: [],
+                    };
+                throw err;
+            }),
+        ]);
+        const out = new Map();
+        for (const offer of offers.dailyOffers ?? []) {
+            const row = (inventory.dailyInventories ?? []).find((i) => roomIdOf(i) === roomIdOf(offer));
+            out.set(roomIdOf(offer), { start: date, offer, inventory: row?.inventories ?? [] });
+        }
+        hourlyAriCache.set(key, { at: now(), value: out });
+        if (hourlyAriCache.size > 500)
+            hourlyAriCache.delete(hourlyAriCache.keys().next().value);
+        return out;
+    };
+    /**
+     * A hotel's rooms by the hour, for today on the hotel's own date and clock:
+     * each sellable one with the starts it takes, or why not.
+     *
+     * ⚠️ TODAY IS THE HOTEL'S, NOT THE SERVER'S (总线程, 2026-10-12): at 01:00 in
+     * Singapore it is still yesterday nowhere that matters, and a start that has
+     * already gone by on the hotel's clock is not offered.
+     */
+    const priceHourly = async (h, guests, rooms, fresh = false) => {
+        const products = (await productsOf(h.hotelId)).filter((p) => p.checkinType === 'HOUR');
+        if (products.length === 0)
+            return [];
+        const date = today();
+        const clock = clockAt(now(), opts.tz);
+        const live = products.filter((p) => bookableNow(p.bookWindow, date, clock) && inStayWindow(p.stayWindow, date));
+        if (live.length === 0)
+            return [];
+        const ari = await hourlyAriFor(h.hotelId, date, fresh);
+        // One day, priced once: `sell` reads it as a single night from today.
+        const context = {
+            checkIn: date,
+            checkOut: addDays(date, 1),
+            adults: guests,
+            rooms,
+            today: date,
+            clock,
+            paymentType: opts.paymentType,
+            allowTags,
+        };
+        return live
+            .map((product) => {
+            const roomType = (h.hotelRoomTypeList ?? []).find((r) => r.roomTypeCode === product.roomTypeCode);
+            const w = ari.get(roomIdOf(product));
+            const hourly = hourlyWindow(product, date, clock);
+            let res = w
+                ? sell(product, w, roomType, context)
+                : { ok: false, kind: 'no-price', why: 'no price for today' };
+            if (res.ok && !hourly)
+                res = { ok: false, kind: 'closed', why: 'no start time is left today' };
+            return { product, roomType, res, ...(hourly ? { hourly } : {}) };
+        })
+            .filter((x) => !(x.roomType && x.roomType.status === 0));
+    };
     const policyOf = (code) => parseCancelPolicy(code);
     const toRoom = (h, p, stay) => {
         const s = p.res;
@@ -553,6 +637,8 @@ export const createHuazhuHotels = (opts) => {
             .filter(Boolean)
             .join(' '))
             .filter(Boolean);
+        const hourly = p.hourly;
+        const maxChildren = Number(p.product.occupancy?.maxChild ?? rt?.maxChild);
         return {
             id: roomIdOf(p.product),
             name: offerOf(p.product),
@@ -565,11 +651,14 @@ export const createHuazhuHotels = (opts) => {
                 ? { imageUrl: roomPhoto(h, p.product.roomTypeCode) }
                 : {}),
             // A whole yuan, as a hotel quotes a nightly rate - not ¥343.50 (2026-10-05
-            // audit, P3). The stay total stays exact.
-            nightly: money(Math.round(pre / n / minorFactor(cur)) * minorFactor(cur), cur),
+            // audit, P3). The stay total stays exact. A room by the hour is the
+            // price of its hours, and no nights.
+            nightly: hourly
+                ? money(total, cur)
+                : money(Math.round(pre / n / minorFactor(cur)) * minorFactor(cur), cur),
             stayTotal: money(total, cur),
             taxesAndFees: money(total - pre, cur),
-            nights: n,
+            nights: hourly ? 0 : n,
             refundable: policy ? refundableFrom(policy, stay.checkIn, opts.tz, now()) : false,
             ...(freeUntil
                 ? {
@@ -581,6 +670,15 @@ export const createHuazhuHotels = (opts) => {
                 }
                 : {}),
             roomsLeft: s.roomsLeft,
+            roomType: { id: p.product.roomTypeCode, name: roomTypeOf(p.product) },
+            rate: { id: p.product.rateCode, name: rateNameOf(p.product) },
+            labels: rateLabels(p.product, { type: s.mealType, count: s.mealCount }),
+            // ⚠️ AT THE HOTEL, ALWAYS, HERE: prepaid rates are left out before
+            // this (`sell`, kind 'prepaid') until robin decides how that money is
+            // taken - a live deployment never offers one (总线程, 2026-10-12).
+            payment: 'at-hotel',
+            ...(hourly ? { hourly } : {}),
+            ...(maxChildren > 0 && maxChildren < 99 ? { maxChildren } : {}),
         };
     };
     /** Why nothing here can be sold for these nights - the most useful reason first. */
@@ -636,7 +734,13 @@ export const createHuazhuHotels = (opts) => {
                 });
                 continue;
             }
-            const problem = stayProblem(line.stay, today());
+            const hourly = line.hourly;
+            // A room by the hour is today, on the hotel's date, in and out the same day.
+            const problem = hourly
+                ? line.stay.checkIn !== today() || line.stay.checkOut !== line.stay.checkIn
+                    ? `Rooms by the hour are sold for today (${today()}) only, in and out the same day.`
+                    : undefined
+                : stayProblem(line.stay, today());
             if (problem) {
                 dropped.push({ title: hotelName, why: problem });
                 continue;
@@ -644,7 +748,9 @@ export const createHuazhuHotels = (opts) => {
             const wanted = Math.max(1, Math.floor(line.rooms ?? 1));
             let priced;
             try {
-                priced = await priceStay(h, line.stay, wanted, fresh);
+                priced = hourly
+                    ? await priceHourly(h, line.stay.guests, wanted, fresh)
+                    : await priceStay(h, line.stay, wanted, fresh);
             }
             catch (err) {
                 dropped.push({
@@ -657,7 +763,7 @@ export const createHuazhuHotels = (opts) => {
             if (!p) {
                 dropped.push({
                     title: `${hotelName} - ${line.roomId}`,
-                    why: 'That rate is no longer sold.',
+                    why: hourly ? 'That room by the hour is not sold today.' : 'That rate is no longer sold.',
                 });
                 continue;
             }
@@ -665,7 +771,20 @@ export const createHuazhuHotels = (opts) => {
                 dropped.push({ title: `${hotelName} - ${roomTypeOf(p.product)}`, why: `${p.res.why}.` });
                 continue;
             }
-            const held = `${h.hotelId}|${line.roomId}|${line.stay.checkIn}|${line.stay.checkOut}`;
+            if (hourly) {
+                // ⚠️ CHECKED AGAIN AT EVERY PRICING: the starts a room takes shrink as
+                // the day goes on, and a start that was fine at noon is gone by four.
+                const bad = !p.hourly
+                    ? 'No start time is left today.'
+                    : hourly.hours !== p.hourly.hours
+                        ? `This room is ${p.hourly.hours} hours, not ${hourly.hours}.`
+                        : startProblem(p.hourly, hourly.start);
+                if (bad) {
+                    dropped.push({ title: `${hotelName} - ${offerOf(p.product)}`, why: bad });
+                    continue;
+                }
+            }
+            const held = `${h.hotelId}|${line.roomId}|${line.stay.checkIn}|${line.stay.checkOut}${hourly ? `|${hourly.start}` : ''}`;
             const already = taken.get(held) ?? 0;
             if (p.res.roomsLeft - already < wanted) {
                 dropped.push({
@@ -703,11 +822,13 @@ export const createHuazhuHotels = (opts) => {
                     p.res.meal
                         ? `${p.res.meal}${p.res.mealCount > 1 ? ` × ${p.res.mealCount}` : ''}`
                         : 'Room only',
+                    hourly ? `${hourly.start}–${endOf(hourly.start, hourly.hours)}` : undefined,
                 ]
                     .filter(Boolean)
                     .join(' · '),
                 stay: line.stay,
                 nights: room.nights,
+                ...(hourly ? { hourly } : {}),
                 quantity: wanted,
                 unit: room.nightly,
                 total: money(preTax, room.stayTotal.currency),
@@ -756,6 +877,7 @@ export const createHuazhuHotels = (opts) => {
         hotelId: b.hotelId,
         hotelName: b.hotelName,
         stay: b.stay,
+        ...(b.hourly ? { hourly: b.hourly } : {}),
         guest: b.guest,
         quote: b.quote,
         ...(b.cancelledAt ? { cancelledAt: b.cancelledAt } : {}),
@@ -961,6 +1083,20 @@ export const createHuazhuHotels = (opts) => {
             slots.delete(slot);
         }
     };
+    /**
+     * A stay's dates as Huazhu takes them: check-in and check-out, and for a room
+     * by the hour the same day with its hours ("时租入离同一天").
+     */
+    const stayDatesOf = (line) => line.hourly
+        ? {
+            checkin: line.stay.checkIn,
+            checkout: line.stay.checkIn,
+            hourlyRoom: {
+                hourlyRateStartTime: line.hourly.start,
+                hourlyRateEndTime: endOf(line.hourly.start, line.hourly.hours),
+            },
+        }
+        : { checkin: line.stay.checkIn, checkout: line.stay.checkOut };
     const bookHeld = async (lines, shown, tripKey, email, guest, contact, who, requests, slot) => {
         // Priced afresh, not from the cache: this is the price that will be sent.
         const priced = await quoteLines({ lines }, true);
@@ -988,14 +1124,13 @@ export const createHuazhuHotels = (opts) => {
             try {
                 const out = await client.prebook({
                     hotelId: plan.line.hotelId,
-                    checkinType: 'DAY',
+                    checkinType: plan.line.hourly ? 'HOUR' : 'DAY',
                     paymentType: opts.paymentType,
                     reservations: [
                         {
                             roomTypeCode: plan.sold.product.roomTypeCode,
                             rateCode: plan.sold.product.rateCode,
-                            checkin: plan.line.stay.checkIn,
-                            checkout: plan.line.stay.checkOut,
+                            ...stayDatesOf(plan.line),
                             amountAfterTax: s.after,
                             ...(s.before ? { amountBeforeTax: s.before } : {}),
                             currencyCode: s.currency,
@@ -1103,6 +1238,7 @@ export const createHuazhuHotels = (opts) => {
                     hotelId: plan.line.hotelId,
                     hotelName: plan.qline.hotelName,
                     stay: plan.line.stay,
+                    ...(plan.line.hourly ? { hourly: plan.line.hourly } : {}),
                     guest,
                     quote: {
                         lines: [plan.qline],
@@ -1147,8 +1283,7 @@ export const createHuazhuHotels = (opts) => {
                 const reservation = {
                     roomTypeCode: plan.sold.product.roomTypeCode,
                     rateCode: plan.sold.product.rateCode,
-                    checkin: plan.line.stay.checkIn,
-                    checkout: plan.line.stay.checkOut,
+                    ...stayDatesOf(plan.line),
                     amountAfterTax: s.after,
                     ...(s.before ? { amountBeforeTax: s.before } : {}),
                     ...(s.rack ? { rackRate: s.rack } : {}),
@@ -1161,7 +1296,7 @@ export const createHuazhuHotels = (opts) => {
                 };
                 const request = {
                     hotelId: plan.line.hotelId,
-                    checkinType: 'DAY',
+                    checkinType: plan.line.hourly ? 'HOUR' : 'DAY',
                     contactPerson: contact,
                     distributorResId: dres,
                     paymentType: opts.paymentType,
@@ -1239,7 +1374,7 @@ export const createHuazhuHotels = (opts) => {
     };
     return {
         brand: opts.brand,
-        capabilities: HUAZHU_CAPABILITIES,
+        capabilities: { ...HUAZHU_CAPABILITIES, ...(opts.hourly ? { hourly: true } : {}) },
         imageDomains() {
             const hosts = new Set();
             for (const h of catalog.all()) {
@@ -1332,10 +1467,17 @@ export const createHuazhuHotels = (opts) => {
                 return terms.every((t) => hay.includes(t));
             });
             const f = q.filters ?? {};
-            const stay = q.stay;
+            // Rooms by the hour are today's, on the hotel's date: the nights asked
+            // for, if any, do not apply to them.
+            const hourlyOnly = !!f.hourly;
+            const stay = hourlyOnly
+                ? { checkIn: today(), checkOut: today(), guests: q.stay?.guests ?? 2 }
+                : q.stay;
             const wantRooms = Math.max(1, Math.min(MAX_ROOMS_PER_LINE, Math.floor(q.rooms ?? 1)));
             const unapplied = [];
             const ignored = {};
+            if (hourlyOnly && q.stay)
+                unapplied.push('Rooms by the hour are sold for today only, so the nights asked for were not used.');
             const roomTerms = !!(f.freeCancellation || f.breakfast);
             // A brand by the name shown or by Huazhu's own: "Hanting" and "汉庭" are one brand.
             const passesStatic = (h, over, raw) => (!over.brand ||
@@ -1357,6 +1499,8 @@ export const createHuazhuHotels = (opts) => {
                 if (roomTerms)
                     ignored.roomTerms = true;
             }
+            if (hourlyOnly && !priceEverything)
+                unapplied.push(`${matches.length} hotels matched - too many to ask each for rooms by the hour at once, so only this page was asked. A district, a brand or a landmark narrows it.`);
             if (stay && !priceEverything && (wantsPriceKnob || roomTerms)) {
                 unapplied.push(`${matches.length} hotels matched - too many to price at once, so ${[
                     wantsPriceKnob ? 'the price order and ceiling' : '',
@@ -1365,7 +1509,7 @@ export const createHuazhuHotels = (opts) => {
                     .filter(Boolean)
                     .join(' and ')} were not applied. A district, a brand or a landmark narrows it.`);
             }
-            if (!stay && (wantsPriceKnob || roomTerms)) {
+            if (!stay && !hourlyOnly && (wantsPriceKnob || roomTerms)) {
                 unapplied.push('Prices, free cancellation and breakfast belong to a room on given nights, and Huazhu publishes no price without them - with check-in and check-out they apply.');
             }
             const best = new Map();
@@ -1375,6 +1519,19 @@ export const createHuazhuHotels = (opts) => {
             const priceHotel = async (raw) => {
                 if (!stay || pricedRooms.has(raw.hotelId))
                     return;
+                if (hourlyOnly) {
+                    try {
+                        const priced = await priceHourly(raw, stay.guests, wantRooms);
+                        pricedRooms.set(raw.hotelId, priced);
+                        if (!priced.some((p) => p.res.ok))
+                            why.set(raw.hotelId, 'No room by the hour here today.');
+                    }
+                    catch {
+                        pricedRooms.set(raw.hotelId, []);
+                        why.set(raw.hotelId, 'Rooms by the hour could not be read from Huazhu just now; open the hotel for them.');
+                    }
+                    return;
+                }
                 const problem = stayProblem(stay, today());
                 if (problem) {
                     pricedRooms.set(raw.hotelId, []);
@@ -1417,7 +1574,7 @@ export const createHuazhuHotels = (opts) => {
             if (priceEverything)
                 await pool(matches.map((m) => m.raw), PRICE_CONCURRENCY, priceHotel);
             const canRoomFilter = priceEverything;
-            if (canRoomFilter && roomTerms)
+            if (canRoomFilter && (roomTerms || hourlyOnly))
                 matches = matches.filter(({ raw }) => bestFor(raw, f) !== null);
             const currencies = [...new Set(matches.map((m) => m.hotel.currency))].sort();
             const onePrice = currencies.length === 1;
@@ -1492,6 +1649,8 @@ export const createHuazhuHotels = (opts) => {
                         nights: b.room.nights,
                         roomsLeft: b.room.roomsLeft,
                         freeCancellation: !!b.room.freeCancellationUntil,
+                        ...(b.room.hourly ? { hours: b.room.hourly.hours } : {}),
+                        ...(b.room.labels?.length ? { labels: b.room.labels } : {}),
                     },
                 };
             };
@@ -1593,6 +1752,36 @@ export const createHuazhuHotels = (opts) => {
                 ...(rooms.length === 0 ? { noRooms: noRoomsWhy(priced, stay, 1) } : {}),
             };
         },
+        async hourlyRooms(id, guests) {
+            const raw = findHotel(id);
+            if (!raw)
+                return null;
+            const hotel = toHotel(raw, view, now());
+            const date = today();
+            const stay = { checkIn: date, checkOut: date, guests };
+            let priced;
+            try {
+                priced = await priceHourly(raw, guests, 1);
+            }
+            catch (err) {
+                return {
+                    hotel,
+                    stay,
+                    noRooms: `Huazhu could not be asked for this hotel's rooms by the hour just now (${err instanceof HuazhuRefusal ? err.huazhuMessage : 'no answer'}). Try again in a moment.`,
+                };
+            }
+            const rooms = priced
+                .filter((p) => p.res.ok)
+                .map((p) => toRoom(raw, p, stay))
+                .sort((a, b) => a.stayTotal.minor - b.stayTotal.minor);
+            const why = priced.length === 0
+                ? 'This hotel sells no rooms by the hour today.'
+                : priced.some((p) => !p.res.ok && p.res.kind === 'prepaid') &&
+                    priced.every((p) => !p.res.ok)
+                    ? "This hotel's rooms by the hour are paid in advance, and this connector books rates paid at the hotel."
+                    : 'No room by the hour is left here today.';
+            return { hotel, stay, rooms, ...(rooms.length === 0 ? { noRooms: why } : {}) };
+        },
         async datesAround(id, stay, o) {
             const raw = findHotel(id);
             if (!raw)