@curless/hotel-storefront 0.28.0 → 0.29.0

package/dist/tools.js

@@ -208,7 +208,9 @@ const forCapabilities = (tools, n, v, caps) => {
                     // itself: the instructions carried "test environment" while this
                     // line still promised "the hotel's own reservation" (2026-09-30).
                     description: v.sandbox
-                        ? `Makes a booking in a simulated copy of ${v.brand}'s booking system, for testing: each stay gets its own confirmation code there, and none of it is a ${v.brand} reservation or holds a real room. No payment is taken and no card is collected. All of the trip is booked or none of it. Preferences - a bed type, a floor, a late arrival - ride along on the booking as requests.`
+                        ? `Makes a booking in a simulated copy of ${v.brand}'s booking system, for testing: each stay gets its own confirmation code there, and none of it is a ${v.brand} reservation or holds a real room. ${caps.prepaid
+                            ? 'A rate marked paid in advance is booked on its own, and not at once: the answer gives a card page in test mode and the time it is paid by, and the stay is booked once it is paid - no card is collected here. Every other rate is paid by nobody.'
+                            : 'No payment is taken and no card is collected.'} All of the trip is booked or none of it. Preferences - a bed type, a floor, a late arrival - ride along on the booking as requests.`
                         : `Books the trip's rooms with ${v.brand} for a named guest: each stay becomes the hotel's own reservation, with its own confirmation code, paid at the hotel. No payment is taken here and no card is collected. All of the trip is booked or none of it. Preferences - a bed type, a floor, a late arrival - ride along on the booking as requests the desk tries to meet.`,
                 };
             }
@@ -864,13 +866,13 @@ const CHANGE_SCHEMA = {
  * policies, and every trip a member badge and saving (2026-10-05 audit) -
  * fields no answer there ever carries.
  */
-export const outputSchemasFor = (schemas, caps) => {
+export const outputSchemasFor = (schemas, caps, lang, also = {}) => {
     const gone = [
         ...(caps.members ? [] : ['member', 'memberSaving']),
         ...(caps.extras ? [] : ['extras']),
         ...(caps.policies === false ? ['policies'] : []),
     ];
-    if (!gone.length && !caps.hourly)
+    if (!gone.length && !caps.hourly && !lang && !also.logoDark && !also.accent)
         return schemas;
     return Object.fromEntries(Object.entries(schemas).map(([name, schema]) => {
         const s = schema;
@@ -882,6 +884,15 @@ export const outputSchemasFor = (schemas, caps) => {
         // On every answer, as `common` puts it: rooms by the hour are sold here.
         if (caps.hourly)
             properties.hourly = BOOL;
+        // On every answer too: the language the card draws its own words in.
+        if (lang)
+            properties.lang = { enum: ['zh', 'en'] };
+        // And the dark page's logo, where the group gave one.
+        if (also.logoDark)
+            properties.logoDarkUrl = STR;
+        // And the group's own colour, where its deployment gives one.
+        if (also.accent)
+            properties.accent = { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' };
         return [name, { ...s, properties }];
     }));
 };
@@ -1189,7 +1200,48 @@ const holderOf = (deps, supplier) => {
  * room - and a booking whose confirmation has not come back yet is neither,
  * and is said as exactly that.
  */
+/**
+ * A booking as the card is given it: its money as strings, like every other
+ * price - the card never does arithmetic, and an amount sent as
+ * `{ minor, currency }` was drawn as "[object Object]" (香格里拉, 2026-10-12).
+ */
+const bookingForCard = (b) => ({
+    ...b,
+    quote: quoteForCard(b.quote),
+    ...(b.payment ? { payment: { ...b.payment, amount: formatMoney(b.payment.amount) } } : {}),
+});
+/**
+ * A booking paid here in advance, as the guest is told it - by where its
+ * money stands. Undefined for any other booking.
+ */
+const paidLine = (deps, b) => {
+    const p = b.payment;
+    if (!p)
+        return undefined;
+    const h = holderOf(deps, b.supplier);
+    const amount = formatMoney(p.amount);
+    const test = h.sandbox
+        ? ' This is a test: the card page is in test mode, no real money moves, and the booking is in the simulated system.'
+        : '';
+    switch (p.status) {
+        case 'awaiting':
+            return `**Not booked yet, and nothing paid.** ${amount} is paid on the card page by ${p.payByLocal ?? p.payBy} hotel time: ${p.url}. Once it is paid the stay is booked with ${h.name}, and ${deps.tools.listBookings} shows it; unpaid by then, the page closes and nothing is booked or charged.${test}`;
+        case 'paid':
+            return b.status === 'confirmed'
+                ? `${amount} paid in advance by card, and booked with ${h.name}: nothing more is paid at the hotel.${test}`
+                : `${amount} paid in advance by card. ${h.name} has not confirmed the booking yet - ${deps.tools.listBookings} shows when it has; if it does not take it, all ${amount} goes back.${test}`;
+        case 'lapsed':
+            return `Not paid in time: nothing was booked and nothing was charged.${test}`;
+        case 'refunding':
+            return `All ${amount} is going back to the card it was paid with${p.refundReason ? ` - ${p.refundReason}` : ''}.${test}`;
+        case 'refunded':
+            return `All ${amount} has gone back to the card it was paid with${p.refundReason ? ` - ${p.refundReason}` : ''}.${test}`;
+    }
+};
 const bookedLine = (deps, b) => {
+    const paid = paidLine(deps, b);
+    if (paid)
+        return paid;
     const total = formatMoney(b.quote.total);
     const h = holderOf(deps, b.supplier);
     if (h.caps.booking === 'pay-at-hotel') {
@@ -1224,6 +1276,8 @@ const common = (deps, key) => {
     return {
         brand: deps.vocab.brand,
         ...(deps.logoUrl ? { logoUrl: deps.logoUrl } : {}),
+        ...(deps.logoDarkUrl ? { logoDarkUrl: deps.logoDarkUrl } : {}),
+        ...(deps.accent ? { accent: deps.accent } : {}),
         ...(deps.showName ? { showName: true } : {}),
         toolNames: deps.offered
             ? Object.fromEntries(Object.entries(deps.tools).filter(([, name]) => deps.offered?.has(name)))
@@ -1245,8 +1299,19 @@ const common = (deps, key) => {
         vocab: { noun: deps.vocab.noun, nounPlural: deps.vocab.nounPlural },
         ...(deps.vocab.demo ? { demo: true, demoNote: DEMO_NOTE } : { demo: false }),
         ...(key ? memberBadge(deps, key) : {}),
+        ...(langOf(deps, key) ? { lang: langOf(deps, key) } : {}),
     };
 };
+/**
+ * The language the CARD speaks to this guest - its own buttons, labels and
+ * dates. What the server writes for the model stays English.
+ *
+ * ⚠️ PER TRIP, NOT ONLY PER BRAND (总线程, 2026-10-12): today it is the
+ * deployment's (Huazhu's single store is Chinese), and a guest's own choice -
+ * as the market's \`set_language\` keeps one per buyer - is meant to come in
+ * HERE, by \`key\`, without the card or the schema changing.
+ */
+const langOf = (deps, _key) => deps.lang;
 /**
  * When a room stops being free to cancel, the way a guest reads it: the
  * hotel's own clock when the backend knows it, else the instant in UTC - never
@@ -1278,6 +1343,12 @@ const quoteForCard = (quote, groupOf) => ({
         total: formatMoney(l.total),
         refundable: l.refundable,
         freeCancellationUntil: l.freeCancellationUntil,
+        // The deadline on the hotel's clock, where the backend knows it - the
+        // review restates the terms beside the total (round-2 jury).
+        ...(l.freeCancellationLocal ? { freeCancellationLocal: l.freeCancellationLocal } : {}),
+        // Paid in advance: the review says so, and its button leads to the
+        // payment page rather than to a booking (香格里拉's card, 2026-10-12).
+        ...(l.payment ? { payment: l.payment } : {}),
         day: l.day,
     })),
     subtotal: formatMoney(quote.subtotal),
@@ -1541,6 +1612,13 @@ const labelWords = (r) => {
     ];
     return words.length ? ` [${words.join(', ')}]` : '';
 };
+const PAYMENT_WORDS = {
+    awaiting: 'to be paid on the card page',
+    paid: 'paid in advance by card',
+    lapsed: 'not paid in time - nothing booked or charged',
+    refunding: 'refund in full under way',
+    refunded: 'refunded in full',
+};
 const bookingLine = (b) => {
     const kinds = b.requests?.kinds ?? [];
     return [
@@ -1550,6 +1628,9 @@ const bookingLine = (b) => {
             ? 'unconfirmed: whether it was made is not known yet, and a person is confirming it'
             : b.status}`,
         kinds.length ? ` · asked for ${kinds.map(bare).join(', ')}` : '',
+        b.payment
+            ? ` · ${PAYMENT_WORDS[b.payment.status]}${b.payment.status === 'awaiting' && b.payment.url ? ` by ${b.payment.payByLocal ?? b.payment.payBy}: ${b.payment.url}` : ''}`
+            : '',
     ].join('');
 };
 /**
@@ -1594,6 +1675,13 @@ const dateFlex = (dates, stay) => {
     // the other two are worse, which is a claim about prices that are equal.
     const beats = best?.from && chosen?.from && best.from.minor < chosen.from.minor ? best : undefined;
     const beatsBy = beats?.from?.minor;
+    // The cheapest of the window - the chosen date too - when two or more are
+    // priced in one currency; ties all marked. `best` stays what it was: a date
+    // that beats the guest's own.
+    const priced = dates.filter((d) => d.from);
+    const lowest = priced.length >= 2 && new Set(priced.map((d) => d.from?.currency)).size === 1
+        ? Math.min(...priced.map((d) => d.from?.minor ?? Number.POSITIVE_INFINITY))
+        : undefined;
     const structured = {
         dates: dates.map((d) => ({
             checkIn: d.checkIn,
@@ -1602,6 +1690,7 @@ const dateFlex = (dates, stay) => {
             ...(d.chosen ? { chosen: true } : {}),
             // The chosen date cannot match: `beatsBy` is a price strictly below it.
             ...(beatsBy !== undefined && d.from?.minor === beatsBy ? { best: true } : {}),
+            ...(lowest !== undefined && d.from?.minor === lowest ? { lowest: true } : {}),
         })),
     };
     if (!best?.from)
@@ -2434,8 +2523,19 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
                     .join(' '),
             };
         }
+        // ⚠️ THE CHEAPEST, SAID BY US - the card never compares two prices it was
+        // handed as text. Only on named nights, in one currency, with two or more
+        // priced to compare; every hotel that ties is marked (总线程, 2026-10-12).
+        // A room by the hour is priced for its own hours, and is not in the race.
+        const stays = hotels.filter((h) => h.forStay && !h.forStay.hours);
+        const lowest = stays.length >= 2 && new Set(stays.map((h) => h.forStay?.total.currency)).size === 1
+            ? Math.min(...stays.map((h) => h.forStay?.total.minor ?? Number.POSITIVE_INFINITY))
+            : undefined;
         const forCard = hotels.map((h) => ({
             ...h,
+            ...(lowest !== undefined && h.forStay && !h.forStay.hours && h.forStay.total.minor === lowest
+                ? { lowest: true }
+                : {}),
             summary: hotelText('description', h.name, h.summary, DESCRIPTION_MAX).text,
             fromNightly: h.fromNightly ? formatMoney(h.fromNightly) : undefined,
             ...(h.forStay
@@ -3037,6 +3137,10 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
                     error: 'no-such-room',
                     query: roomRef,
                     rooms: dated.rooms.map((r) => ({ id: r.id, name: r.name })),
+                    // The hotel and the nights, so the card can take the guest straight
+                    // back to its rooms rather than to the start (round-2 jury).
+                    hotel: { id: detail.hotel.id, name: detail.hotel.name },
+                    stay,
                 },
                 text: `${detail.hotel.name} has no room type by that name for those nights. It has: ${dated.rooms.map((r) => r.name).join(', ')}.`,
             };
@@ -3192,16 +3296,20 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
             const several = booked.length > 1;
             return {
                 structured: {
+                    // ⚠️ 'booking' EVEN WHEN IT IS AWAITING PAYMENT: the card draws a view
+                    // only once it knows it, and the card-contract test holds every view
+                    // here to that. 香格里拉's card turns this into its own 'payment' step
+                    // (booking.status 'awaiting-payment', booking.payment) - and moves the
+                    // view with it.
                     view: 'booking',
                     ...common(deps, key),
-                    booking: { ...first.booking, quote: quoteForCard(first.booking.quote) },
+                    booking: bookingForCard(first.booking),
                     // ⚠️ ONE PER STAY - see `requestBooking`. The card draws each with its
                     // own code; `booking` stays the first, for a host that reads one.
                     ...(several
                         ? {
                             bookings: booked.map(({ booking, asked }) => ({
-                                ...booking,
-                                quote: quoteForCard(booking.quote),
+                                ...bookingForCard(booking),
                                 total: formatMoney(booking.quote.total),
                                 ...(asked.length ? { requested: asked } : {}),
                                 // Each its own warning colour - it rode on the first alone.
@@ -3290,7 +3398,7 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
             structured: {
                 view: 'bookings',
                 ...common(deps, key),
-                bookings: bookings.map((b) => ({ ...b, quote: quoteForCard(b.quote) })),
+                bookings: bookings.map(bookingForCard),
                 count: bookings.length,
                 // What was looked for, so a card can say THAT did not match rather
                 // than "nothing in this conversation".
@@ -3424,7 +3532,7 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
                 structured: {
                     view: 'changed',
                     ...common(deps, key),
-                    booking: { ...changed, quote: quoteForCard(changed.quote) },
+                    booking: bookingForCard(changed),
                     hotelName: preview.hotelName,
                     from: stayOf(preview.from),
                     ...(preview.to ? { to: stayOf(preview.to) } : {}),
@@ -3525,19 +3633,22 @@ const answerTool = async (deps, name, rawArgs, ctx) => {
             structured: {
                 view: 'cancelled',
                 ...common(deps, key),
-                booking: { ...cancelled, quote: quoteForCard(cancelled.quote) },
+                booking: bookingForCard(cancelled),
                 fee: formatMoney(charged),
                 rule: preview.rule,
                 cancellable: false,
             },
             text: [
-                h.sandbox
-                    ? // A test booking cancelled in the simulation: no hotel, no charge (2026-10-05 audit, P2).
-                        `${cancelled.confirmationCode} is cancelled in the simulated system. ${charged.minor === 0 ? 'No fee.' : `A real booking on this rate would be charged ${formatMoney(charged)}; this one is a test, and nothing is charged.`}`
-                    : h.demo
-                        ? // Nobody charges a demonstration anything (2026-10-05 audit, P2).
-                            `${cancelled.confirmationCode} is cancelled. ${charged.minor === 0 ? 'No fee.' : `A real booking on this rate would be charged ${formatMoney(charged)}; this is a demonstration, and nothing is charged.`}`
-                        : `${cancelled.confirmationCode} is cancelled. ${charged.minor === 0 ? 'No fee.' : `The hotel charges ${formatMoney(charged)}.`}`,
+                cancelled.payment
+                    ? // Paid here in advance: what becomes of the money is the answer.
+                        `${cancelled.confirmationCode} is ${cancelled.status === 'expired' ? 'called off before it was paid' : 'cancelled'}. ${paidLine(deps, cancelled)}`
+                    : h.sandbox
+                        ? // A test booking cancelled in the simulation: no hotel, no charge (2026-10-05 audit, P2).
+                            `${cancelled.confirmationCode} is cancelled in the simulated system. ${charged.minor === 0 ? 'No fee.' : `A real booking on this rate would be charged ${formatMoney(charged)}; this one is a test, and nothing is charged.`}`
+                        : h.demo
+                            ? // Nobody charges a demonstration anything (2026-10-05 audit, P2).
+                                `${cancelled.confirmationCode} is cancelled. ${charged.minor === 0 ? 'No fee.' : `A real booking on this rate would be charged ${formatMoney(charged)}; this is a demonstration, and nothing is charged.`}`
+                            : `${cancelled.confirmationCode} is cancelled. ${charged.minor === 0 ? 'No fee.' : `The hotel charges ${formatMoney(charged)}.`}`,
                 demoBookingNote(deps, cancelled.supplier),
                 deps.vocab.demo ? DEMO_NOTE : '',
             ]