@curless/hotel-storefront 0.30.2 → 0.30.4

package/dist/huazhu/backend.js

@@ -1,6 +1,6 @@
 import { randomBytes, randomUUID } from 'node:crypto';
 import { DEFAULT_PAGE, MAX_PAGE, REQUEST_KINDS, REQUEST_NOTE_MAX, guestTooLong, partyNeeds, } from '../backend.js';
-import { addDays, arrivalInstant, atHotelTime, nights as nightsBetween, stayProblem, todayAt, } from '../dates.js';
+import { addDays, arrivalInstant, atHotelTime, nights as nightsBetween, stayProblem, stayProblemOf, todayAt, } from '../dates.js';
 import { byWords, splitByStay } from '../demo-hotels.js';
 import { FACILITIES, hasFacility } from '../facilities.js';
 import { endOf, startProblem } from '../hourly.js';
@@ -64,6 +64,8 @@ const SAME_TRIP_MS = 10 * 60_000;
  * rather than sorting the twenty it happened to price.
  */
 export const PRICE_ALL = 20;
+/** Hotels whose product lists are read to find which sell rooms by the hour today. */
+export const HOURLY_SCAN = 60;
 const PRICE_CONCURRENCY = 4;
 /** What a room is called here: the room type, then the rate when there is more than one. */
 const ROOM_SEP = '~';
@@ -509,6 +511,8 @@ export const createHuazhuHotels = (opts) => {
         return got;
     };
     const productsOf = async (hotelId) => (await productsWithDays(hotelId)).value;
+    /** Whether a hotel sells any room by the hour on its today - from its products, no prices. */
+    const sellsByTheHourToday = async (hotelId) => (await productsOf(hotelId)).some((p) => p.checkinType === 'HOUR' && inStayWindow(p.stayWindow, today()));
     const ariCache = new Map();
     /** Every product's prices, rules and rooms left, one element per date from `start` to `end`. */
     const ariFor = async (hotelId, start, end, fresh = false) => {
@@ -579,6 +583,7 @@ export const createHuazhuHotels = (opts) => {
                     ok: false,
                     kind: 'too-far',
                     why: `rooms here are on sale at most ${sellDays} days ahead`,
+                    args: { days: sellDays },
                 },
             }))
                 .filter((x) => !(x.roomType && x.roomType.status === 0));
@@ -795,6 +800,18 @@ export const createHuazhuHotels = (opts) => {
             ...(maxChildren > 0 && maxChildren < 99 ? { maxChildren } : {}),
         };
     };
+    /** A party too big for any room here, said by partyNeeds with its numbers beside it. */
+    const partyWhy = (guests, largest) => ({
+        why: partyNeeds(guests, largest),
+        code: 'party',
+        ...(largest > 0 ? { args: { largest, rooms: Math.ceil(guests / largest) } } : {}),
+    });
+    /** A hotel's "nothing to book", as HotelDetail carries it. */
+    const noRoomsOf = (w) => ({
+        noRooms: w.why,
+        noRoomsCode: w.code,
+        ...(w.args ? { noRoomsArgs: w.args } : {}),
+    });
     /** The most a room here sleeps, from rates refused for the party ("sleeps 2"). */
     const largestOf = (fails) => Math.max(...fails.map((f) => Number(/\d+/.exec(f.why)?.[0] ?? 0)));
     /**
@@ -807,49 +824,84 @@ export const createHuazhuHotels = (opts) => {
      */
     const hourlyNoRoomsWhy = (priced, guests) => {
         if (priced.length === 0)
-            return 'This hotel sells no rooms by the hour today.';
+            return { why: 'This hotel sells no rooms by the hour today.', code: 'hourly-none' };
         const fails = priced.map((p) => p.res).filter((r) => !r.ok);
         if (fails.length > 0 && fails.every((f) => f.kind === 'party'))
-            return partyNeeds(guests, largestOf(fails));
+            return partyWhy(guests, largestOf(fails));
         if (fails.some((f) => f.kind === 'prepaid'))
-            return "This hotel's rooms by the hour are paid in advance, and this connector books rates paid at the hotel.";
+            return {
+                why: "This hotel's rooms by the hour are paid in advance, and this connector books rates paid at the hotel.",
+                code: 'prepaid-only',
+            };
         const said = (re) => fails
             .map((f) => (f.kind === 'closed' ? re.exec(f.why)?.[1] : undefined))
             .filter((t) => !!t)
             .sort();
         const opens = said(/on sale today from (\d\d:\d\d)/)[0];
         if (opens)
-            return `Rooms by the hour here go on sale today from ${opens}.`;
+            return {
+                why: `Rooms by the hour here go on sale today from ${opens}.`,
+                code: 'hourly-not-yet',
+                args: { opensAt: opens },
+            };
         const last = said(/the last start today was (\d\d:\d\d)/).pop();
         if (last)
-            return `No room by the hour is left here today: the last start today was ${last}.`;
-        return 'No room by the hour is left here today.';
+            return {
+                why: `No room by the hour is left here today: the last start today was ${last}.`,
+                code: 'hourly-over',
+                args: { lastStart: last },
+            };
+        return { why: 'No room by the hour is left here today.', code: 'sold-out' };
     };
     /** Why nothing here can be sold for these nights - the most useful reason first. */
     const noRoomsWhy = (priced, stay, rooms) => {
         if (priced.length === 0)
-            return 'This hotel has no rooms on sale through this connector.';
+            return {
+                why: 'This hotel has no rooms on sale through this connector.',
+                code: 'none-on-sale',
+            };
         const fails = priced.map((p) => p.res).filter((r) => !r.ok);
         const kinds = new Set(fails.map((f) => f.kind));
         const only = (k) => kinds.size === 1 && kinds.has(k);
         if (only('party'))
-            return partyNeeds(stay.guests, largestOf(fails));
+            return partyWhy(stay.guests, largestOf(fails));
         if (only('prepaid'))
-            return 'Every rate here for those nights is paid in advance, and this connector books rates paid at the hotel.';
+            return {
+                why: 'Every rate here for those nights is paid in advance, and this connector books rates paid at the hotel.',
+                code: 'prepaid-only',
+            };
         if (only('sold-out'))
             return rooms > 1
-                ? `No room type here has ${rooms} left for those nights.`
-                : 'Every room type here is taken for those nights.';
+                ? {
+                    why: `No room type here has ${rooms} left for those nights.`,
+                    code: 'sold-out',
+                    args: { rooms },
+                }
+                : { why: 'Every room type here is taken for those nights.', code: 'sold-out' };
         if (only('too-many-rooms'))
-            return `No rate here books ${rooms} rooms at once; ask for fewer.`;
+            return {
+                why: `No rate here books ${rooms} rooms at once; ask for fewer.`,
+                code: 'too-many-rooms',
+                args: { rooms },
+            };
         if (only('too-far'))
-            return `Not on sale yet: ${fails[0]?.why ?? 'rooms here are not sold that far ahead'}.`;
+            return {
+                why: `Not on sale yet: ${fails[0]?.why ?? 'rooms here are not sold that far ahead'}.`,
+                code: 'too-far',
+                ...(fails[0]?.args?.days ? { args: { days: fails[0].args.days } } : {}),
+            };
         const rule = fails.find((f) => f.kind === 'stay-rule');
         if (rule)
-            return `Not for those nights: ${rule.why}.`;
+            return {
+                why: `Not for those nights: ${rule.why}.`,
+                // Booked too far ahead for this rate is "too far", said with its days.
+                ...(rule.args?.days !== undefined && !rule.args.rule
+                    ? { code: 'too-far', args: { days: rule.args.days } }
+                    : { code: 'stay-rule', ...(rule.args ? { args: rule.args } : {}) }),
+            };
         if (kinds.has('closed'))
-            return 'Not on sale for those nights.';
-        return 'No room here can be booked for those nights.';
+            return { why: 'Not on sale for those nights.', code: 'closed' };
+        return { why: 'No room here can be booked for those nights.', code: 'unavailable' };
     };
     // --------------------------------------------------------------- quote ----
     const quoteLines = async (trip, fresh = false) => {
@@ -1976,6 +2028,19 @@ export const createHuazhuHotels = (opts) => {
                 [h.brand, raw?.brandName ?? ''].some((b) => b.trim().toLowerCase() === (over.brand ?? '').trim().toLowerCase())) &&
                 (over.facilities ?? []).every((k) => hasFacility(h.amenities, k));
             let matches = placed.filter(({ hotel, raw }) => passesStatic(hotel, f, raw));
+            // ⚠️ ONLY HOTELS THAT SELL ROOMS BY THE HOUR TODAY - read from their
+            // product lists, which carry no price (one call a hotel, kept for
+            // `productsTtl`). Past PRICE_ALL the list was paged unfiltered, and every
+            // hotel came back, most selling no room by the hour at all (robin,
+            // 2026-10-14: 35 listed, a dozen sold them). A hotel that sells them
+            // today and has none left, or none yet, stays - with why (`priceHotel`).
+            if (hourlyOnly) {
+                const scanned = matches.slice(0, HOURLY_SCAN);
+                const sells = await pool(scanned, PRICE_CONCURRENCY, ({ raw }) => sellsByTheHourToday(raw.hotelId).catch(() => true));
+                if (matches.length > HOURLY_SCAN)
+                    unapplied.push(`${matches.length} hotels matched - only the first ${HOURLY_SCAN} were asked whether they sell rooms by the hour. A district, a brand or a landmark narrows it.`);
+                matches = scanned.filter((_, i) => sells[i]);
+            }
             // ⚠️ PRICED WHEN THE NIGHTS ARE NAMED - but a city can hold hundreds of
             // these hotels and each one is two calls to Huazhu. Everything is priced
             // when there are few enough; past that, only the page, and the price
@@ -2020,11 +2085,14 @@ export const createHuazhuHotels = (opts) => {
                     }
                     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.');
+                        why.set(raw.hotelId, {
+                            why: 'Rooms by the hour could not be read from Huazhu just now; open the hotel for them.',
+                            code: 'unreachable',
+                        });
                     }
                     return;
                 }
-                const problem = stayProblem(stay, today());
+                const problem = stayProblemOf(stay, today());
                 if (problem) {
                     pricedRooms.set(raw.hotelId, []);
                     why.set(raw.hotelId, problem);
@@ -2038,9 +2106,12 @@ export const createHuazhuHotels = (opts) => {
                 }
                 catch (err) {
                     pricedRooms.set(raw.hotelId, []);
-                    why.set(raw.hotelId, err instanceof HuazhuRefusal && err.code === 2009
-                        ? 'Huazhu is answering slowly just now; open the hotel for its rooms.'
-                        : 'Prices could not be read from Huazhu just now; open the hotel for its rooms.');
+                    why.set(raw.hotelId, {
+                        why: err instanceof HuazhuRefusal && err.code === 2009
+                            ? 'Huazhu is answering slowly just now; open the hotel for its rooms.'
+                            : 'Prices could not be read from Huazhu just now; open the hotel for its rooms.',
+                        code: 'unreachable',
+                    });
                 }
             };
             const bestFor = (raw, over) => {
@@ -2140,11 +2211,18 @@ export const createHuazhuHotels = (opts) => {
                 if (!stay)
                     return m.hotel;
                 const b = bestFor(m.raw, f);
-                if (!b)
+                if (!b) {
+                    const w = why.get(m.raw.hotelId) ?? {
+                        why: 'No room here can be booked for those nights.',
+                        code: 'unavailable',
+                    };
                     return {
                         ...m.hotel,
-                        noRoomsForStay: why.get(m.raw.hotelId) ?? 'No room here can be booked for those nights.',
+                        noRoomsForStay: w.why,
+                        noRoomsForStayCode: w.code,
+                        ...(w.args ? { noRoomsForStayArgs: w.args } : {}),
                     };
+                }
                 return {
                     ...m.hotel,
                     forStay: {
@@ -2233,9 +2311,9 @@ export const createHuazhuHotels = (opts) => {
             const detail = { hotel: toHotel(raw, view, now()) };
             if (!stay)
                 return detail;
-            const problem = stayProblem(stay, today());
+            const problem = stayProblemOf(stay, today());
             if (problem)
-                return { ...detail, noRooms: problem };
+                return { ...detail, ...noRoomsOf(problem) };
             let priced;
             try {
                 priced = await priceStay(raw, stay, 1);
@@ -2244,7 +2322,10 @@ export const createHuazhuHotels = (opts) => {
                 return {
                     ...detail,
                     stay,
-                    noRooms: `Huazhu could not be asked for this hotel's rooms just now (${err instanceof HuazhuRefusal ? err.huazhuMessage : 'no answer'}). Try again in a moment.`,
+                    ...noRoomsOf({
+                        why: `Huazhu could not be asked for this hotel's rooms just now (${err instanceof HuazhuRefusal ? err.huazhuMessage : 'no answer'}). Try again in a moment.`,
+                        code: 'unreachable',
+                    }),
                 };
             }
             const rooms = priced
@@ -2255,7 +2336,7 @@ export const createHuazhuHotels = (opts) => {
                 ...detail,
                 stay,
                 rooms,
-                ...(rooms.length === 0 ? { noRooms: noRoomsWhy(priced, stay, 1) } : {}),
+                ...(rooms.length === 0 ? noRoomsOf(noRoomsWhy(priced, stay, 1)) : {}),
             };
         },
         async hourlyRooms(id, guests) {
@@ -2273,7 +2354,10 @@ export const createHuazhuHotels = (opts) => {
                 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.`,
+                    ...noRoomsOf({
+                        why: `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.`,
+                        code: 'unreachable',
+                    }),
                 };
             }
             const rooms = priced
@@ -2284,7 +2368,7 @@ export const createHuazhuHotels = (opts) => {
                 hotel,
                 stay,
                 rooms,
-                ...(rooms.length === 0 ? { noRooms: hourlyNoRoomsWhy(priced, guests) } : {}),
+                ...(rooms.length === 0 ? noRoomsOf(hourlyNoRoomsWhy(priced, guests)) : {}),
             };
         },
         async datesAround(id, stay, o) {