@curless/hotel-storefront 0.1.0

package/dist/card.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.generated.js","sourceRoot":"","sources":["../src/card.generated.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,wEAAwE;AACxE,gFAAgF;AAChF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAW,MAAM,CAAC,IAAI,CAChD,0ykTAA0ykT,EAC1ykT,QAAQ,CACT,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAEnB,2FAA2F;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAChC,kEAAkE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,122 @@
+/**
+ * One hotel group's identity, vocabulary and wiring.
+ *
+ * Same bargain as the shopping connector's `StorefrontConfig`: a second brand
+ * is a JSON file, never a fork. What differs is the seam - a shop config points
+ * at a Shopify domain, this one points at a `HotelBackend`, because the group's
+ * own booking API is coming and the demo data has to step aside without the
+ * config shape changing.
+ *
+ * Secrets never live here. They arrive through the environment.
+ */
+export type HotelConfig = {
+    /** Deployment id, and the path segment it is served under: hotels.curless.ai/<id>. */
+    id: string;
+    /** The group whose rooms these are - printed on the card and in the legal pages. */
+    brand: string;
+    /** MCP `serverInfo`, passed to the host verbatim. */
+    server: {
+        name: string;
+        title: string;
+        websiteUrl?: string;
+        /**
+         * The group's own artwork, as files beside the config. Files rather than
+         * bytes in the package: the shopping connector once served the first
+         * merchant's logo to a merchant who had supplied none, which named the
+         * wrong party on someone else's connector. Resolved against the config
+         * file's directory; absent, the routes 404 and no icon is claimed.
+         */
+        iconFile?: string;
+        logoFile?: string;
+    };
+    /**
+     * How the tools are named: `list_shangrila_hotels` rather than `list_hotels`.
+     *
+     * A model choosing between a Shangri-La connector and a Marriott one picks by
+     * name, and a specific name is harder to pick wrong. Leave `prefix` unset and
+     * the tools are generic - right for a single listed app, wrong for a machine
+     * that serves several groups.
+     */
+    naming?: {
+        prefix?: string;
+        /** 'hotel' / 'hotels'. A group that calls them resorts or residences says so here. */
+        noun?: string;
+        nounPlural?: string;
+    };
+    /** Where the rooms come from. */
+    data: {
+        /**
+         * `demo` - read `file` and price it ourselves. Every rate it answers with is
+         * marked as a demonstration value, in the tool output and on the card, so
+         * nobody can mistake it for a rate they could book.
+         * `api` - the group's own booking API. Not implemented yet; named here so
+         * the config does not have to change when it lands.
+         */
+        source: 'demo' | 'api';
+        /** Demo only: the hotels file, resolved against the config file's directory. */
+        file?: string;
+        /** api only: where it answers. The key comes from the environment. */
+        baseUrl?: string;
+    };
+    /**
+     * Taking money. Absent - and it IS absent today, by decision - the connector
+     * goes as far as a booking REQUEST: the rooms are held, the guest gets a
+     * confirmation code, and the card says in as many words that nothing has been
+     * charged. The wallet step slots in here, between request and confirmed.
+     */
+    payment?: {
+        mode: 'none' | 'wallet';
+    };
+    /** Where this deployment answers. `publicUrl` differs when the group fronts it with their own hostname. */
+    urls: {
+        appUrl: string;
+        publicUrl?: string;
+    };
+    /**
+     * Group-specific facts, appended verbatim to the tool they belong to.
+     *
+     * Only facts a generic connector cannot know: that a Horizon Club rate
+     * includes the lounge, that one city has four properties under three brands.
+     * Behavioural guidance does NOT go here - it goes in the server instructions,
+     * which is the line the shopping connector had to redraw on 2026-09-17 to
+     * satisfy the directory's attestation about tool descriptions.
+     */
+    hints?: {
+        search?: string;
+        hotel?: string;
+        booking?: string;
+        /** One real hotel name, shown in an argument's description as an example. */
+        example?: string;
+    };
+    legal: {
+        operator?: string;
+        operatorContact?: string;
+        /** The address the group publishes in their own privacy policy. */
+        brandContact?: string;
+        region?: string;
+        updated?: string;
+    };
+};
+/**
+ * The tool names this config produces.
+ *
+ * Built in one place because the names are a contract: the card addresses
+ * tools by name, the server instructions name them in prose, and the OpenAI
+ * directory freezes them at submission. Two lists that drift are two lists that
+ * disagree in front of a reviewer.
+ */
+export declare const toolNames: (config: Pick<HotelConfig, "naming">) => {
+    readonly listHotels: `list_${string}${string}`;
+    readonly getHotel: `get_${string}${string}`;
+    readonly listExtras: `list_${string}extras`;
+    readonly addToTrip: `add_to_${string}trip`;
+    readonly viewTrip: `view_${string}trip`;
+    readonly clearTrip: `clear_${string}trip`;
+    readonly requestBooking: `request_${string}booking`;
+    readonly listBookings: `list_my_${string}bookings`;
+    readonly previewCancellation: `preview_${string}cancellation`;
+    readonly cancelBooking: `cancel_${string}booking`;
+    readonly policies: `get_${string}${string}_policies`;
+};
+export type ToolNames = ReturnType<typeof toolNames>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAC;IAEX,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IAEd,qDAAqD;IACrD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB;;;;;;WAMG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,sFAAsF;QACtF,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,iCAAiC;IACjC,IAAI,EAAE;QACJ;;;;;;WAMG;QACH,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QACvB,gFAAgF;QAChF,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,sEAAsE;QACtE,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;KACzB,CAAC;IAEF,2GAA2G;IAC3G,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,6EAA6E;QAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,KAAK,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,mEAAmE;QACnE,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAQF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;;;;;;;;;;;;CAiB5D,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,42 @@
+/**
+ * One hotel group's identity, vocabulary and wiring.
+ *
+ * Same bargain as the shopping connector's `StorefrontConfig`: a second brand
+ * is a JSON file, never a fork. What differs is the seam - a shop config points
+ * at a Shopify domain, this one points at a `HotelBackend`, because the group's
+ * own booking API is coming and the demo data has to step aside without the
+ * config shape changing.
+ *
+ * Secrets never live here. They arrive through the environment.
+ */
+const slug = (s) => s
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '_')
+    .replace(/^_|_$/g, '');
+/**
+ * The tool names this config produces.
+ *
+ * Built in one place because the names are a contract: the card addresses
+ * tools by name, the server instructions name them in prose, and the OpenAI
+ * directory freezes them at submission. Two lists that drift are two lists that
+ * disagree in front of a reviewer.
+ */
+export const toolNames = (config) => {
+    const prefix = config.naming?.prefix ? `${slug(config.naming.prefix)}_` : '';
+    const noun = slug(config.naming?.noun ?? 'hotel');
+    const plural = slug(config.naming?.nounPlural ?? `${noun}s`);
+    return {
+        listHotels: `list_${prefix}${plural}`,
+        getHotel: `get_${prefix}${noun}`,
+        listExtras: `list_${prefix}extras`,
+        addToTrip: `add_to_${prefix}trip`,
+        viewTrip: `view_${prefix}trip`,
+        clearTrip: `clear_${prefix}trip`,
+        requestBooking: `request_${prefix}booking`,
+        listBookings: `list_my_${prefix}bookings`,
+        previewCancellation: `preview_${prefix}cancellation`,
+        cancelBooking: `cancel_${prefix}booking`,
+        policies: `get_${prefix}${noun}_policies`,
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmGH,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CACjC,CAAC;KACE,WAAW,EAAE;KACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;KAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAmC,EAAE,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IAC7D,OAAO;QACL,UAAU,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE;QACrC,QAAQ,EAAE,OAAO,MAAM,GAAG,IAAI,EAAE;QAChC,UAAU,EAAE,QAAQ,MAAM,QAAQ;QAClC,SAAS,EAAE,UAAU,MAAM,MAAM;QACjC,QAAQ,EAAE,QAAQ,MAAM,MAAM;QAC9B,SAAS,EAAE,SAAS,MAAM,MAAM;QAChC,cAAc,EAAE,WAAW,MAAM,SAAS;QAC1C,YAAY,EAAE,WAAW,MAAM,UAAU;QACzC,mBAAmB,EAAE,WAAW,MAAM,cAAc;QACpD,aAAa,EAAE,UAAU,MAAM,SAAS;QACxC,QAAQ,EAAE,OAAO,MAAM,GAAG,IAAI,WAAW;KACjC,CAAC;AACb,CAAC,CAAC"}

package/dist/data.d.ts

@@ -0,0 +1,5 @@
+import type { RawHotelData } from './demo-hotels.js';
+export declare const parseHotelData: (raw: unknown) => RawHotelData;
+/** Read a brand's hotels file. `from` is the config file it was named in. */
+export declare const loadHotelData: (file: string, from?: string) => RawHotelData;
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,YAAY,EAAW,MAAM,kBAAkB,CAAC;AA0KlF,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,KAAG,YAU7C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,YAS3D,CAAC"}

package/dist/data.js

@@ -0,0 +1,183 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+/**
+ * Reading a brand's hotels file, and refusing a bad one loudly.
+ *
+ * The file is hand-written per brand and nothing else checks it, so a missing
+ * `currency` or a `taxRate` someone wrote as 16 instead of 0.16 would otherwise
+ * surface as a wrong price on a card - which is the one failure mode a booking
+ * connector cannot have. Every check below exists because the wrong version of
+ * it prints a plausible number rather than an error.
+ */
+const KINDS = ['transfer', 'dining', 'experience', 'family', 'wellness'];
+const TOPICS = [
+    'cancellation',
+    'check-in',
+    'children',
+    'pets',
+    'deposit',
+    'accessibility',
+];
+class DataError extends Error {
+    constructor(where, what) {
+        super(`${where}: ${what}`);
+        this.name = 'HotelDataError';
+    }
+}
+const str = (v, where, what) => {
+    if (typeof v !== 'string' || v.trim() === '')
+        throw new DataError(where, `${what} must be a non-empty string`);
+    return v;
+};
+const num = (v, where, what, min, max) => {
+    if (typeof v !== 'number' || !Number.isFinite(v))
+        throw new DataError(where, `${what} must be a number`);
+    if (v < min || v > max)
+        throw new DataError(where, `${what} is ${v}, outside ${min}..${max}`);
+    return v;
+};
+const time = (v, where, what) => {
+    if (v === undefined)
+        return undefined;
+    const s = str(v, where, what);
+    if (!/^\d{2}:\d{2}$/.test(s))
+        throw new DataError(where, `${what} must look like 15:00`);
+    return s;
+};
+const parseRoom = (raw, where) => {
+    const r = raw;
+    const id = str(r.id, where, 'room id');
+    const at = `${where} room ${id}`;
+    const refundable = r.refundable === true;
+    if (refundable && r.freeCancelHours === undefined)
+        throw new DataError(at, 'a refundable rate must say freeCancelHours - "free to cancel" with no deadline is not a policy');
+    if (!refundable && r.freeCancelHours !== undefined)
+        throw new DataError(at, 'freeCancelHours on a non-refundable rate would print a free window that does not exist');
+    return {
+        id,
+        name: str(r.name, at, 'name'),
+        sleeps: num(r.sleeps, at, 'sleeps', 1, 8),
+        sizeSqm: r.sizeSqm === undefined ? undefined : num(r.sizeSqm, at, 'sizeSqm', 5, 500),
+        beds: r.beds === undefined ? undefined : str(r.beds, at, 'beds'),
+        view: r.view === undefined ? undefined : str(r.view, at, 'view'),
+        breakfast: r.breakfast === true,
+        // A rate is in whole currency units, the way the hotel writes it. 380000
+        // would be a rate typed in minor units by mistake, and it would look like a
+        // real - if eye-watering - price on the card.
+        nightly: num(r.nightly, at, 'nightly', 1, 200_000),
+        roomsLeft: num(r.roomsLeft, at, 'roomsLeft', 0, 500),
+        refundable,
+        freeCancelHours: refundable ? num(r.freeCancelHours, at, 'freeCancelHours', 0, 720) : undefined,
+    };
+};
+const parseExtra = (raw, where) => {
+    const e = raw;
+    const id = str(e.id, where, 'extra id');
+    const at = `${where} extra ${id}`;
+    const kind = str(e.kind, at, 'kind');
+    if (!KINDS.includes(kind))
+        throw new DataError(at, `kind ${kind} is not one of ${KINDS.join(', ')}`);
+    const per = str(e.per, at, 'per');
+    if (per !== 'stay' && per !== 'person' && per !== 'night')
+        throw new DataError(at, 'per must be stay, person or night');
+    const when = e.when === undefined ? undefined : str(e.when, at, 'when');
+    if (when !== undefined && when !== 'arrival' && when !== 'departure' && when !== 'any')
+        throw new DataError(at, 'when must be arrival, departure or any');
+    return {
+        id,
+        name: str(e.name, at, 'name'),
+        kind,
+        description: str(e.description, at, 'description'),
+        price: num(e.price, at, 'price', 1, 200_000),
+        per,
+        when,
+    };
+};
+const parseHotel = (raw, index) => {
+    const h = raw;
+    const where = `hotel[${index}]`;
+    const id = str(h.id, where, 'id');
+    const at = `hotel ${id}`;
+    const rooms = Array.isArray(h.rooms) ? h.rooms.map((r) => parseRoom(r, at)) : [];
+    if (rooms.length === 0)
+        throw new DataError(at, 'a hotel with no room types cannot be booked; leave it out instead');
+    const seen = new Set();
+    for (const r of rooms) {
+        if (seen.has(r.id))
+            throw new DataError(at, `two room types share the id ${r.id}`);
+        seen.add(r.id);
+    }
+    const policies = {};
+    const rawPolicies = (h.policies ?? {});
+    for (const [topic, text] of Object.entries(rawPolicies)) {
+        if (!TOPICS.includes(topic))
+            throw new DataError(at, `policy topic ${topic} is not one we show`);
+        policies[topic] = str(text, at, `policy ${topic}`);
+    }
+    const currency = str(h.currency, at, 'currency');
+    if (!/^[A-Z]{3}$/.test(currency))
+        throw new DataError(at, `currency ${currency} must be a 3-letter code like HKD`);
+    return {
+        id,
+        name: str(h.name, at, 'name'),
+        brand: str(h.brand, at, 'brand'),
+        city: str(h.city, at, 'city'),
+        cityId: str(h.cityId, at, 'cityId'),
+        area: h.area === undefined ? undefined : str(h.area, at, 'area'),
+        summary: str(h.summary, at, 'summary'),
+        amenities: Array.isArray(h.amenities)
+            ? h.amenities.map((a, i) => str(a, at, `amenity ${i}`))
+            : [],
+        address: h.address === undefined ? undefined : str(h.address, at, 'address'),
+        url: h.url === undefined ? undefined : str(h.url, at, 'url'),
+        imageUrl: h.imageUrl === undefined ? undefined : str(h.imageUrl, at, 'imageUrl'),
+        checkInFrom: time(h.checkInFrom, at, 'checkInFrom'),
+        checkOutBy: time(h.checkOutBy, at, 'checkOutBy'),
+        currency,
+        // Fractions, not percentages. 16 instead of 0.16 is a 1600% tax that still
+        // renders as a number, so it is rejected rather than trusted.
+        taxRate: num(h.taxRate, at, 'taxRate', 0, 0.5),
+        weekendUplift: num(h.weekendUplift, at, 'weekendUplift', 0, 2),
+        utcOffset: h.utcOffset === undefined ? undefined : str(h.utcOffset, at, 'utcOffset'),
+        rating: h.rating === undefined ? undefined : parseRating(h.rating, at),
+        rooms,
+        extras: Array.isArray(h.extras) ? h.extras.map((e) => parseExtra(e, at)) : [],
+        policies,
+    };
+};
+const parseRating = (raw, where) => {
+    const r = raw;
+    const scaleMax = num(r.scaleMax, where, 'rating.scaleMax', 1, 100);
+    return {
+        value: num(r.value, where, 'rating.value', 0, scaleMax),
+        scaleMax,
+        // A rating with no count behind it is a number nobody can check.
+        count: num(r.count, where, 'rating.count', 1, 10_000_000),
+    };
+};
+export const parseHotelData = (raw) => {
+    const d = raw;
+    const hotels = Array.isArray(d.hotels) ? d.hotels.map(parseHotel) : [];
+    if (hotels.length === 0)
+        throw new DataError('hotels file', 'has no hotels');
+    const ids = new Set();
+    for (const h of hotels) {
+        if (ids.has(h.id))
+            throw new DataError('hotels file', `two hotels share the id ${h.id}`);
+        ids.add(h.id);
+    }
+    return { brand: str(d.brand, 'hotels file', 'brand'), hotels };
+};
+/** Read a brand's hotels file. `from` is the config file it was named in. */
+export const loadHotelData = (file, from) => {
+    const path = from ? resolve(dirname(from), file) : resolve(file);
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        throw new DataError('hotels file', `cannot read ${path} - ${err.message}`);
+    }
+    return parseHotelData(JSON.parse(text));
+};
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"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"}

package/dist/dates.d.ts

@@ -0,0 +1,32 @@
+export declare const DAY_MS = 86400000;
+export declare const isDay: (s: unknown) => s is string;
+export declare const toDay: (ms: number) => string;
+export declare const addDays: (day: string, n: number) => string;
+/** Check-out exclusive: `nights('2026-10-12','2026-10-14')` is 2. */
+export declare const nights: (checkIn: string, checkOut: string) => number;
+/** Every night of the stay, as its own date. The check-out day is not a night. */
+export declare const eachNight: (checkIn: string, checkOut: string) => string[];
+/** Friday and Saturday nights - the ones hotels charge more for. */
+export declare const isWeekendNight: (day: string) => boolean;
+/** The hotel's own today, in its own timezone offset (`+08:00`). */
+export declare const todayAt: (now: number, utcOffset: string) => string;
+/** The moment a guest can walk in, as an instant. */
+export declare const arrivalInstant: (checkIn: string, checkInFrom: string, utcOffset: string) => number;
+export declare const MAX_NIGHTS = 30;
+export declare const MAX_GUESTS = 8;
+/** How far ahead the demo data is willing to quote. A real API decides this itself. */
+export declare const MAX_DAYS_AHEAD = 365;
+/**
+ * Why these dates cannot be used, in words a guest can act on - or null.
+ *
+ * Returned rather than thrown because "you asked for last Tuesday" is an answer
+ * to give the guest, not a crash. Never guesses a fix: a connector that
+ * silently rolls a past date forward to today books someone a room on the
+ * wrong night.
+ */
+export declare const stayProblem: (stay: {
+    checkIn?: unknown;
+    checkOut?: unknown;
+    guests?: unknown;
+}, today: string) => string | null;
+//# sourceMappingURL=dates.d.ts.map

package/dist/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM,WAAa,CAAC;AAEjC,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAIpB,CAAC;AAErB,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,MAAiD,CAAC;AAErF,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,GAAG,MAAM,KAAG,MAAqC,CAAC;AAEvF,qEAAqE;AACrE,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,MACR,CAAC;AAEpD,kFAAkF;AAClF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,MAAM,EAKnE,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,OAG5C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,WAAW,MAAM,KAAG,MAMxD,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,aAAa,MAAM,EAAE,WAAW,MAAM,KAAG,MACI,CAAC;AAE9F,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,uFAAuF;AACvF,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EACjE,OAAO,MAAM,KACZ,MAAM,GAAG,IAiBX,CAAC"}

package/dist/dates.js

@@ -0,0 +1,75 @@
+// Dates, the way a hotel means them.
+//
+// A night is a calendar day, not 24 hours, and check-out is exclusive: 12th to
+// the 14th is two nights. Everything here works on `YYYY-MM-DD` strings in the
+// HOTEL's calendar, never on the machine's local time - a server in Frankfurt
+// must not decide that a Hong Kong guest's "tonight" is yesterday.
+/** Parsed as UTC noon, so a timezone can never tip the date over a day boundary. */
+const at = (day) => Date.parse(`${day}T12:00:00Z`);
+export const DAY_MS = 86_400_000;
+export const isDay = (s) => typeof s === 'string' &&
+    /^\d{4}-\d{2}-\d{2}$/.test(s) &&
+    !Number.isNaN(at(s)) &&
+    toDay(at(s)) === s;
+export const toDay = (ms) => new Date(ms).toISOString().slice(0, 10);
+export const addDays = (day, n) => toDay(at(day) + n * DAY_MS);
+/** Check-out exclusive: `nights('2026-10-12','2026-10-14')` is 2. */
+export const nights = (checkIn, checkOut) => Math.round((at(checkOut) - at(checkIn)) / DAY_MS);
+/** Every night of the stay, as its own date. The check-out day is not a night. */
+export const eachNight = (checkIn, checkOut) => {
+    const out = [];
+    if (nights(checkIn, checkOut) <= 0)
+        return out;
+    for (let d = checkIn; d !== checkOut; d = addDays(d, 1))
+        out.push(d);
+    return out;
+};
+/** Friday and Saturday nights - the ones hotels charge more for. */
+export const isWeekendNight = (day) => {
+    const dow = new Date(at(day)).getUTCDay();
+    return dow === 5 || dow === 6;
+};
+/** The hotel's own today, in its own timezone offset (`+08:00`). */
+export const todayAt = (now, utcOffset) => {
+    const m = /^([+-])(\d{2}):(\d{2})$/.exec(utcOffset);
+    const shift = m
+        ? (m[1] === '-' ? -1 : 1) * (Number(m[2] ?? 0) * 60 + Number(m[3] ?? 0)) * 60_000
+        : 0;
+    return new Date(now + shift).toISOString().slice(0, 10);
+};
+/** The moment a guest can walk in, as an instant. */
+export const arrivalInstant = (checkIn, checkInFrom, utcOffset) => Date.parse(`${checkIn}T${checkInFrom.length === 5 ? checkInFrom : '15:00'}:00${utcOffset}`);
+export const MAX_NIGHTS = 30;
+export const MAX_GUESTS = 8;
+/** How far ahead the demo data is willing to quote. A real API decides this itself. */
+export const MAX_DAYS_AHEAD = 365;
+/**
+ * Why these dates cannot be used, in words a guest can act on - or null.
+ *
+ * Returned rather than thrown because "you asked for last Tuesday" is an answer
+ * to give the guest, not a crash. Never guesses a fix: a connector that
+ * silently rolls a past date forward to today books someone a room on the
+ * wrong night.
+ */
+export const stayProblem = (stay, today) => {
+    if (!isDay(stay.checkIn))
+        return 'Check-in must be a date like 2026-10-12.';
+    if (!isDay(stay.checkOut))
+        return 'Check-out must be a date like 2026-10-14.';
+    const n = nights(stay.checkIn, stay.checkOut);
+    if (n <= 0)
+        return 'Check-out has to be after check-in. One night means checking out the next day.';
+    if (n > MAX_NIGHTS)
+        return `This connector quotes up to ${MAX_NIGHTS} nights at a time; that stay is ${n}.`;
+    if (stay.checkIn < today)
+        return `Check-in ${stay.checkIn} is in the past - today is ${today}.`;
+    if (nights(today, stay.checkIn) > MAX_DAYS_AHEAD)
+        return `Rooms are only quoted ${MAX_DAYS_AHEAD} days ahead; ${stay.checkIn} is further out.`;
+    const guests = stay.guests;
+    if (typeof guests !== 'number' || !Number.isInteger(guests) || guests < 1)
+        return 'Say how many guests are in the room, as a whole number.';
+    if (guests > MAX_GUESTS)
+        return `More than ${MAX_GUESTS} guests in one room needs the hotel directly.`;
+    return null;
+};
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"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"}

package/dist/demo-hotels.d.ts

@@ -0,0 +1,96 @@
+import type { HotelBackend } from './backend.js';
+import type { Booking, ExtraKind, HotelPolicyTopic } from './types.js';
+/**
+ * The hotels, out of a JSON file, priced by us.
+ *
+ * THIS IS THE DEMONSTRATION BACKEND. The group's own booking API is coming
+ * (robin, 2026-09-18); when it does it arrives as a second `HotelBackend` and
+ * nothing above this file changes. Until then every number this answers with is
+ * invented, and the honest handling of that is not a disclaimer in the docs -
+ * it is `demo: true` on every price-bearing answer, which the tools and the
+ * card are required to show.
+ *
+ * Three things it refuses to fake, because faking them is how a demo turns into
+ * a lie a guest acts on:
+ *  - availability it does not have: a held room comes off the count,
+ *  - a date nobody gave: no stay, no price,
+ *  - a cancellation fee: previewed with its rule before anything is cancelled.
+ */
+export type RawRoom = {
+    id: string;
+    name: string;
+    sleeps: number;
+    sizeSqm?: number;
+    beds?: string;
+    view?: string;
+    breakfast: boolean;
+    /** Written the way a human writes it - 3800, not 380000. */
+    nightly: number;
+    roomsLeft: number;
+    refundable: boolean;
+    /** Hours before arrival that cancelling is still free. Absent on a non-refundable rate. */
+    freeCancelHours?: number;
+};
+export type RawExtra = {
+    id: string;
+    name: string;
+    kind: ExtraKind;
+    description: string;
+    price: number;
+    per: 'stay' | 'person' | 'night';
+    when?: 'arrival' | 'departure' | 'any';
+};
+export type RawHotel = {
+    id: string;
+    name: string;
+    brand: string;
+    city: string;
+    cityId: string;
+    area?: string;
+    summary: string;
+    amenities: string[];
+    address?: string;
+    url?: string;
+    imageUrl?: string;
+    checkInFrom?: string;
+    checkOutBy?: string;
+    currency: string;
+    /** Taxes and service charge, as a fraction. Applied to rooms and add-ons alike. */
+    taxRate: number;
+    /** How much more a Friday or Saturday night costs, as a fraction. */
+    weekendUplift: number;
+    /** The hotel's own clock. Everything in this demo is +08:00. */
+    utcOffset?: string;
+    rating?: {
+        value: number;
+        scaleMax: number;
+        count: number;
+    };
+    rooms: RawRoom[];
+    extras?: RawExtra[];
+    policies?: Partial<Record<HotelPolicyTopic, string>>;
+};
+export type RawHotelData = {
+    brand: string;
+    hotels: RawHotel[];
+};
+export type DemoError = Error & {
+    code: 'not-found' | 'bad-stay' | 'unavailable' | 'mixed-currency' | 'empty-trip';
+};
+export declare const demoError: (code: DemoError["code"], message: string) => DemoError;
+export type DemoHotelsOptions = {
+    data: RawHotelData;
+    /** Injected so tests do not depend on the day they run. */
+    now?: () => number;
+    rng?: () => number;
+};
+type StoredBooking = Booking & {
+    sessionId: string;
+};
+export declare const createDemoHotels: (opts: DemoHotelsOptions) => HotelBackend & {
+    /** For the tools: the same clock the prices were computed against. */
+    today(hotelId?: string): string;
+    bookingsForTest(): StoredBooking[];
+};
+export {};
+//# sourceMappingURL=demo-hotels.d.ts.map

package/dist/demo-hotels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-hotels.d.ts","sourceRoot":"","sources":["../src/demo-hotels.ts"],"names":[],"mappings":"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"}