letsfg 2026.5.67 → 2026.5.69

package/README.md

@@ -86,6 +86,19 @@ and `idempotencyKey`).
 - `offerSummary(offer)` — One-line string summary
 - `cheapestOffer(result)` — Get cheapest offer from search
 
+## Starlink Wi-Fi
+
+Offers may carry `starlink`: `confirmed_all` / `confirmed_some` mean the carrier
+has **fully** fitted that aircraft type; `likely_all` / `likely_some` mean the
+rollout on that type is underway but incomplete. Segments carry `confirmed` or
+`likely`.
+
+Only `confirmed_*` is safe to state as fact — `likely_*` is a signal, not a
+promise. Anything ending `_some` has at least one leg without it. An **absent**
+field means no information, **not** an absence of Wi-Fi.
+
+Full semantics: [docs/api-search.md](https://github.com/LetsFG/LetsFG/blob/main/docs/api-search.md#starlink-wi-fi).
+
 ## Zero Dependencies
 
 Uses native `fetch` (Node 18+). No `axios`, no `node-fetch`, nothing. Safe for sandboxed environments.
@@ -138,14 +151,14 @@ print(booking["confirmation"], booking["pay_link"])
 
 ### How you pay
 
-**10% now, the rest to the hotel later.** At booking we charge 10% of the price
+**5% now, the rest to the hotel later.** At booking we charge 5% of the price
 to your card as a reservation fee. The remaining balance is paid **directly to
 the supplier** through a `pay_link` we return — we never hold it.
 
 `balance_due_by` is the supplier's own auto-cancellation date, not a date we
 invent. Miss it and the room is released.
 
-The 10% is **non-refundable**. Cancelling before `balance_due_by` costs nothing
+The 5% is **non-refundable**. Cancelling before `balance_due_by` costs nothing
 else; after it, the hotel's own cancellation ladder applies and can reach 100%.
 That ladder ships in the booking's `terms`, so you can always see the cost before
 you cancel.
@@ -171,7 +184,7 @@ is not metered, only the search call itself.
   hotel signup.
 - **Only free-cancellation, pay-later rates are sold.** Those are the rates where
   the balance can safely be settled with the supplier after booking, which is
-  what makes 10%-now/rest-later work at all. You will see fewer results than a
+  what makes 5%-now/rest-later work at all. You will see fewer results than a
   metasearch shows you. Every one of them can actually be booked.
 - **Booking is asynchronous.** `book_hotel` returns a `booking_job_id`, not a
   booking — the real thing takes minutes. Poll `hotel_booking(job_id)` until

package/dist/{chunk-2SNO3AGS.mjs → chunk-PW775XDB.mjs}

@@ -87,6 +87,23 @@ function collectFlightNumbers(offer) {
     offer.flight_number
   ]);
 }
+function buildStarlinkNote(offer) {
+  const segments = collectOfferSegments(offer);
+  const label = (s) => s.origin && s.destination ? `${s.origin}\u2192${s.destination}` : (s.flight_number || "").trim();
+  const confirmed = segments.filter((s) => s.starlink === "confirmed");
+  const likely = segments.filter((s) => s.starlink === "likely");
+  if (confirmed.length === 0 && likely.length === 0) return void 0;
+  const parts = [];
+  if (confirmed.length > 0) {
+    const where = confirmed.length === segments.length ? "every leg" : confirmed.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink Wi-Fi on ${where}`);
+  }
+  if (likely.length > 0) {
+    const where = likely.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink being installed on this aircraft type${where ? ` (${where})` : ""}, not guaranteed`);
+  }
+  return parts.join("; ");
+}
 function collectAircraftTypes(offer) {
   return collectUniqueDetailValues(
     collectOfferSegments(offer).map((segment) => segment.aircraft?.replace(/\s*\([^)]*\)/g, "").trim())
@@ -428,6 +445,10 @@ function getOfferDetailPromptNotes(offer) {
   if (aircraftTypes.length > 0) {
     pushUniqueNote(notes, `Aircraft shown: ${aircraftTypes.join(", ")}`);
   }
+  const starlinkNote = buildStarlinkNote(offer);
+  if (starlinkNote) {
+    pushUniqueNote(notes, starlinkNote);
+  }
   const operatingCarriers = collectOperatingCarriers(offer);
   const normalizedOfferAirline = typeof offer.airline === "string" ? offer.airline.trim().toLowerCase() : "";
   if (operatingCarriers.length === 1 && operatingCarriers[0].toLowerCase() !== normalizedOfferAirline) {
@@ -1688,7 +1709,7 @@ var LetsFG = class {
   //
   // Only free-cancellation, pay-later rates are sold. Those are the rates where
   // the guest's balance can safely be settled with the supplier after booking,
-  // which is what makes 10%-now/rest-later work. The result set is smaller than
+  // which is what makes 5%-now/rest-later work. The result set is smaller than
   // a metasearch's, and every row in it can actually be booked.
   /**
    * Resolve a place name to the city id that searchHotels() needs.
@@ -1711,7 +1732,7 @@ var LetsFG = class {
    * — so this gets its own generous timeout rather than the client default.
    *
    * Each offer carries `price` (what the guest pays), `reservation_fee_now`
-   * (the 10% taken at booking), `balance_to_supplier`, `balance_due_by` and
+   * (the 5% taken at booking), `balance_to_supplier`, `balance_due_by` and
    * `free_cancellation_until`. There is no wholesale figure to quote by mistake.
    *
    * Keep `session_id` and the chosen offer's `combination_id_v2`: together they
@@ -1737,7 +1758,7 @@ var LetsFG = class {
    * Start a booking. Returns a job immediately — it does NOT book inline.
    *
    * A booking takes minutes: the rate is re-blocked at the supplier, every
-   * price and date rail is checked, the 10% reservation fee is charged to your
+   * price and date rail is checked, the 5% reservation fee is charged to your
    * card, and only then is the room committed. No proxy holds a connection that
    * long, so this returns at once and you poll hotelBooking() for the outcome.
    * Use bookHotelAndWait() if you would rather block.
@@ -1819,7 +1840,7 @@ var LetsFG = class {
    *
    * Free until `balance_due_by`; after that the hotel's own cancellation ladder
    * applies and can reach 100%. The ladder ships in the booking's `terms`, so
-   * you can see the cost before calling this. The 10% reservation fee is NOT
+   * you can see the cost before calling this. The 5% reservation fee is NOT
    * refunded.
    *
    * This drives a browser at the supplier and takes over a minute. If it times

package/dist/cli.js

@@ -605,7 +605,7 @@ var LetsFG = class {
   //
   // Only free-cancellation, pay-later rates are sold. Those are the rates where
   // the guest's balance can safely be settled with the supplier after booking,
-  // which is what makes 10%-now/rest-later work. The result set is smaller than
+  // which is what makes 5%-now/rest-later work. The result set is smaller than
   // a metasearch's, and every row in it can actually be booked.
   /**
    * Resolve a place name to the city id that searchHotels() needs.
@@ -628,7 +628,7 @@ var LetsFG = class {
    * — so this gets its own generous timeout rather than the client default.
    *
    * Each offer carries `price` (what the guest pays), `reservation_fee_now`
-   * (the 10% taken at booking), `balance_to_supplier`, `balance_due_by` and
+   * (the 5% taken at booking), `balance_to_supplier`, `balance_due_by` and
    * `free_cancellation_until`. There is no wholesale figure to quote by mistake.
    *
    * Keep `session_id` and the chosen offer's `combination_id_v2`: together they
@@ -654,7 +654,7 @@ var LetsFG = class {
    * Start a booking. Returns a job immediately — it does NOT book inline.
    *
    * A booking takes minutes: the rate is re-blocked at the supplier, every
-   * price and date rail is checked, the 10% reservation fee is charged to your
+   * price and date rail is checked, the 5% reservation fee is charged to your
    * card, and only then is the room committed. No proxy holds a connection that
    * long, so this returns at once and you poll hotelBooking() for the outcome.
    * Use bookHotelAndWait() if you would rather block.
@@ -736,7 +736,7 @@ var LetsFG = class {
    *
    * Free until `balance_due_by`; after that the hotel's own cancellation ladder
    * applies and can reach 100%. The ladder ships in the booking's `terms`, so
-   * you can see the cost before calling this. The 10% reservation fee is NOT
+   * you can see the cost before calling this. The 5% reservation fee is NOT
    * refunded.
    *
    * This drives a browser at the supplier and takes over a minute. If it times

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-2SNO3AGS.mjs";
+} from "./chunk-PW775XDB.mjs";
 import {
   BearerTokenError,
   getBearerToken,

package/dist/index.d.mts

@@ -212,6 +212,10 @@ interface OfferDetailSegmentLike {
     airline?: string;
     flight_number?: string;
     aircraft?: string;
+    origin?: string;
+    destination?: string;
+    /** Per-leg Starlink verdict; see StarlinkSegmentVerdict in index.ts. */
+    starlink?: 'confirmed' | 'likely';
 }
 interface OfferDetailLegLike {
     segments?: OfferDetailSegmentLike[];
@@ -296,7 +300,17 @@ interface FlightSegment {
     duration_seconds: number;
     cabin_class: string;
     aircraft: string;
+    /** Starlink Wi-Fi on this leg. 'confirmed' = the carrier has fitted every
+     *  aircraft of this type. 'likely' = installation on this type is underway
+     *  but incomplete, so this airframe may not have it. Undefined means no
+     *  information — NOT an absence of Wi-Fi. */
+    starlink?: StarlinkSegmentVerdict;
 }
+type StarlinkSegmentVerdict = 'confirmed' | 'likely';
+/** Itinerary-level Starlink verdict. '*_some' means at least one leg has none;
+ *  'likely_*' means the rollout on that subfleet is underway but incomplete.
+ *  Only 'confirmed_*' should be shown to an end user as a fact. */
+type StarlinkOfferVerdict = 'confirmed_all' | 'confirmed_some' | 'likely_all' | 'likely_some';
 interface FlightRoute {
     segments: FlightSegment[];
     total_duration_seconds: number;
@@ -312,6 +326,9 @@ interface FlightOffer {
     airlines: string[];
     owner_airline: string;
     bags_price: Record<string, number>;
+    /** Starlink Wi-Fi across the whole itinerary; per-leg detail is on each
+     *  segment's `starlink`. Undefined when no leg has any information. */
+    starlink?: StarlinkOfferVerdict;
     availability_seats: number | null;
     conditions: Record<string, string>;
     is_locked: boolean;
@@ -503,7 +520,7 @@ declare class LetsFG {
      * — so this gets its own generous timeout rather than the client default.
      *
      * Each offer carries `price` (what the guest pays), `reservation_fee_now`
-     * (the 10% taken at booking), `balance_to_supplier`, `balance_due_by` and
+     * (the 5% taken at booking), `balance_to_supplier`, `balance_due_by` and
      * `free_cancellation_until`. There is no wholesale figure to quote by mistake.
      *
      * Keep `session_id` and the chosen offer's `combination_id_v2`: together they
@@ -526,7 +543,7 @@ declare class LetsFG {
      * Start a booking. Returns a job immediately — it does NOT book inline.
      *
      * A booking takes minutes: the rate is re-blocked at the supplier, every
-     * price and date rail is checked, the 10% reservation fee is charged to your
+     * price and date rail is checked, the 5% reservation fee is charged to your
      * card, and only then is the room committed. No proxy holds a connection that
      * long, so this returns at once and you poll hotelBooking() for the outcome.
      * Use bookHotelAndWait() if you would rather block.
@@ -589,7 +606,7 @@ declare class LetsFG {
      *
      * Free until `balance_due_by`; after that the hotel's own cancellation ladder
      * applies and can reach 100%. The ladder ships in the booking's `terms`, so
-     * you can see the cost before calling this. The 10% reservation fee is NOT
+     * you can see the cost before calling this. The 5% reservation fee is NOT
      * refunded.
      *
      * This drives a browser at the supplier and takes over a minute. If it times
@@ -628,4 +645,4 @@ declare const BoostedTravel: typeof LetsFG;
 declare const BoostedTravelError: typeof LetsFGError;
 type BoostedTravelConfig = LetsFGConfig;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, type StarlinkOfferVerdict, type StarlinkSegmentVerdict, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };

package/dist/index.d.ts

@@ -212,6 +212,10 @@ interface OfferDetailSegmentLike {
     airline?: string;
     flight_number?: string;
     aircraft?: string;
+    origin?: string;
+    destination?: string;
+    /** Per-leg Starlink verdict; see StarlinkSegmentVerdict in index.ts. */
+    starlink?: 'confirmed' | 'likely';
 }
 interface OfferDetailLegLike {
     segments?: OfferDetailSegmentLike[];
@@ -296,7 +300,17 @@ interface FlightSegment {
     duration_seconds: number;
     cabin_class: string;
     aircraft: string;
+    /** Starlink Wi-Fi on this leg. 'confirmed' = the carrier has fitted every
+     *  aircraft of this type. 'likely' = installation on this type is underway
+     *  but incomplete, so this airframe may not have it. Undefined means no
+     *  information — NOT an absence of Wi-Fi. */
+    starlink?: StarlinkSegmentVerdict;
 }
+type StarlinkSegmentVerdict = 'confirmed' | 'likely';
+/** Itinerary-level Starlink verdict. '*_some' means at least one leg has none;
+ *  'likely_*' means the rollout on that subfleet is underway but incomplete.
+ *  Only 'confirmed_*' should be shown to an end user as a fact. */
+type StarlinkOfferVerdict = 'confirmed_all' | 'confirmed_some' | 'likely_all' | 'likely_some';
 interface FlightRoute {
     segments: FlightSegment[];
     total_duration_seconds: number;
@@ -312,6 +326,9 @@ interface FlightOffer {
     airlines: string[];
     owner_airline: string;
     bags_price: Record<string, number>;
+    /** Starlink Wi-Fi across the whole itinerary; per-leg detail is on each
+     *  segment's `starlink`. Undefined when no leg has any information. */
+    starlink?: StarlinkOfferVerdict;
     availability_seats: number | null;
     conditions: Record<string, string>;
     is_locked: boolean;
@@ -503,7 +520,7 @@ declare class LetsFG {
      * — so this gets its own generous timeout rather than the client default.
      *
      * Each offer carries `price` (what the guest pays), `reservation_fee_now`
-     * (the 10% taken at booking), `balance_to_supplier`, `balance_due_by` and
+     * (the 5% taken at booking), `balance_to_supplier`, `balance_due_by` and
      * `free_cancellation_until`. There is no wholesale figure to quote by mistake.
      *
      * Keep `session_id` and the chosen offer's `combination_id_v2`: together they
@@ -526,7 +543,7 @@ declare class LetsFG {
      * Start a booking. Returns a job immediately — it does NOT book inline.
      *
      * A booking takes minutes: the rate is re-blocked at the supplier, every
-     * price and date rail is checked, the 10% reservation fee is charged to your
+     * price and date rail is checked, the 5% reservation fee is charged to your
      * card, and only then is the room committed. No proxy holds a connection that
      * long, so this returns at once and you poll hotelBooking() for the outcome.
      * Use bookHotelAndWait() if you would rather block.
@@ -589,7 +606,7 @@ declare class LetsFG {
      *
      * Free until `balance_due_by`; after that the hotel's own cancellation ladder
      * applies and can reach 100%. The ladder ships in the booking's `terms`, so
-     * you can see the cost before calling this. The 10% reservation fee is NOT
+     * you can see the cost before calling this. The 5% reservation fee is NOT
      * refunded.
      *
      * This drives a browser at the supplier and takes over a minute. If it times
@@ -628,4 +645,4 @@ declare const BoostedTravel: typeof LetsFG;
 declare const BoostedTravelError: typeof LetsFGError;
 type BoostedTravelConfig = LetsFGConfig;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, type OfferDetailSignals, OfferExpiredError, type Passenger, PaymentRequiredError, type RankOffer, type RankedOffer, type RankingContext, type ScoreBreakdown, type SearchOptions, type StarlinkOfferVerdict, type StarlinkSegmentVerdict, TRIP_PURPOSES, type TripPurpose, type TripPurposeOptions, type UnlockResult, ValidationError, cheapestOffer, deduplicateOffers, LetsFG as default, extractOfferDetailSignals, getOfferDetailBadges, getOfferDetailPromptNotes, getPrimaryTripPurpose, getProfileLabel, normalizeTripPurposes, offerSummary, rankOffers, selectDiverseTop };

package/dist/index.js

@@ -135,6 +135,23 @@ function collectFlightNumbers(offer) {
     offer.flight_number
   ]);
 }
+function buildStarlinkNote(offer) {
+  const segments = collectOfferSegments(offer);
+  const label = (s) => s.origin && s.destination ? `${s.origin}\u2192${s.destination}` : (s.flight_number || "").trim();
+  const confirmed = segments.filter((s) => s.starlink === "confirmed");
+  const likely = segments.filter((s) => s.starlink === "likely");
+  if (confirmed.length === 0 && likely.length === 0) return void 0;
+  const parts = [];
+  if (confirmed.length > 0) {
+    const where = confirmed.length === segments.length ? "every leg" : confirmed.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink Wi-Fi on ${where}`);
+  }
+  if (likely.length > 0) {
+    const where = likely.map(label).filter(Boolean).join(", ");
+    parts.push(`Starlink being installed on this aircraft type${where ? ` (${where})` : ""}, not guaranteed`);
+  }
+  return parts.join("; ");
+}
 function collectAircraftTypes(offer) {
   return collectUniqueDetailValues(
     collectOfferSegments(offer).map((segment) => segment.aircraft?.replace(/\s*\([^)]*\)/g, "").trim())
@@ -476,6 +493,10 @@ function getOfferDetailPromptNotes(offer) {
   if (aircraftTypes.length > 0) {
     pushUniqueNote(notes, `Aircraft shown: ${aircraftTypes.join(", ")}`);
   }
+  const starlinkNote = buildStarlinkNote(offer);
+  if (starlinkNote) {
+    pushUniqueNote(notes, starlinkNote);
+  }
   const operatingCarriers = collectOperatingCarriers(offer);
   const normalizedOfferAirline = typeof offer.airline === "string" ? offer.airline.trim().toLowerCase() : "";
   if (operatingCarriers.length === 1 && operatingCarriers[0].toLowerCase() !== normalizedOfferAirline) {
@@ -1736,7 +1757,7 @@ var LetsFG = class {
   //
   // Only free-cancellation, pay-later rates are sold. Those are the rates where
   // the guest's balance can safely be settled with the supplier after booking,
-  // which is what makes 10%-now/rest-later work. The result set is smaller than
+  // which is what makes 5%-now/rest-later work. The result set is smaller than
   // a metasearch's, and every row in it can actually be booked.
   /**
    * Resolve a place name to the city id that searchHotels() needs.
@@ -1759,7 +1780,7 @@ var LetsFG = class {
    * — so this gets its own generous timeout rather than the client default.
    *
    * Each offer carries `price` (what the guest pays), `reservation_fee_now`
-   * (the 10% taken at booking), `balance_to_supplier`, `balance_due_by` and
+   * (the 5% taken at booking), `balance_to_supplier`, `balance_due_by` and
    * `free_cancellation_until`. There is no wholesale figure to quote by mistake.
    *
    * Keep `session_id` and the chosen offer's `combination_id_v2`: together they
@@ -1785,7 +1806,7 @@ var LetsFG = class {
    * Start a booking. Returns a job immediately — it does NOT book inline.
    *
    * A booking takes minutes: the rate is re-blocked at the supplier, every
-   * price and date rail is checked, the 10% reservation fee is charged to your
+   * price and date rail is checked, the 5% reservation fee is charged to your
    * card, and only then is the room committed. No proxy holds a connection that
    * long, so this returns at once and you poll hotelBooking() for the outcome.
    * Use bookHotelAndWait() if you would rather block.
@@ -1867,7 +1888,7 @@ var LetsFG = class {
    *
    * Free until `balance_due_by`; after that the hotel's own cancellation ladder
    * applies and can reach 100%. The ladder ships in the booking's `terms`, so
-   * you can see the cost before calling this. The 10% reservation fee is NOT
+   * you can see the cost before calling this. The 5% reservation fee is NOT
    * refunded.
    *
    * This drives a browser at the supplier and takes over a minute. If it times

package/dist/index.mjs

@@ -22,7 +22,7 @@ import {
   offerSummary,
   rankOffers,
   selectDiverseTop
-} from "./chunk-2SNO3AGS.mjs";
+} from "./chunk-PW775XDB.mjs";
 export {
   AuthenticationError,
   BoostedTravel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letsfg",
-  "version": "2026.5.67",
+  "version": "2026.5.69",
   "description": "Flights and hotels for AI agents. Server-side engine covers hundreds of airlines; hotels are real bookable inventory with free cancellation and pay-later terms. Includes open-source ranking engine.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",