letsfg 2026.5.64 → 2026.5.65

package/dist/{chunk-ZX2EIEN7.mjs → chunk-DEFFV47W.mjs}

@@ -1637,10 +1637,36 @@ var LetsFG = class {
     return this.postWithAuth(path, { offer_id: offerId });
   }
   /**
-   * Book a flight via Developer API — charges ticket price via Stripe, creates real PNR.
-   * Always provide idempotencyKey to prevent double-bookings on retry.
+   * Book a flight.
+   *
+   * PFS (Bearer token): POST /api/agent-book. Free — nothing charged beyond
+   * the ticket price. Pass searchId (from search()'s result). Returns either
+   * { ok, booked: true, order_id } or, when the booking genuinely could not
+   * complete, { ok, booked: false, booking_url } — hand the link to the user,
+   * nothing was charged.
+   *
+   * Developer API (X-API-Key): charges ticket price + service fee via Stripe,
+   * creates a real PNR. Requires unlock() first. Always provide
+   * idempotencyKey to prevent double-bookings on retry.
    */
-  async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "") {
+  async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "", searchId = "") {
+    this.requireAuth();
+    if (this.usingPFS) {
+      if (!searchId) {
+        throw new LetsFGError(
+          "searchId is required to book via PFS \u2014 pass the search_id from search()'s result.",
+          400
+        );
+      }
+      const passenger = { ...passengers[0] };
+      if (contactPhone && !passenger.phone_number) passenger.phone_number = contactPhone;
+      return this.postWithBearer("/api/agent-book", {
+        search_id: searchId,
+        offer_id: offerId,
+        passenger,
+        contact_email: contactEmail
+      });
+    }
     this.requireApiKey();
     const body = {
       offer_id: offerId,

package/dist/cli.js

@@ -392,10 +392,36 @@ var LetsFG = class {
     return this.postWithAuth(path, { offer_id: offerId });
   }
   /**
-   * Book a flight via Developer API — charges ticket price via Stripe, creates real PNR.
-   * Always provide idempotencyKey to prevent double-bookings on retry.
+   * Book a flight.
+   *
+   * PFS (Bearer token): POST /api/agent-book. Free — nothing charged beyond
+   * the ticket price. Pass searchId (from search()'s result). Returns either
+   * { ok, booked: true, order_id } or, when the booking genuinely could not
+   * complete, { ok, booked: false, booking_url } — hand the link to the user,
+   * nothing was charged.
+   *
+   * Developer API (X-API-Key): charges ticket price + service fee via Stripe,
+   * creates a real PNR. Requires unlock() first. Always provide
+   * idempotencyKey to prevent double-bookings on retry.
    */
-  async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "") {
+  async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "", searchId = "") {
+    this.requireAuth();
+    if (this.usingPFS) {
+      if (!searchId) {
+        throw new LetsFGError(
+          "searchId is required to book via PFS \u2014 pass the search_id from search()'s result.",
+          400
+        );
+      }
+      const passenger = { ...passengers[0] };
+      if (contactPhone && !passenger.phone_number) passenger.phone_number = contactPhone;
+      return this.postWithBearer("/api/agent-book", {
+        search_id: searchId,
+        offer_id: offerId,
+        passenger,
+        contact_email: contactEmail
+      });
+    }
     this.requireApiKey();
     const body = {
       offer_id: offerId,

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-ZX2EIEN7.mjs";
+} from "./chunk-DEFFV47W.mjs";
 
 // src/cli.ts
 function getFlag(args, flag, alias) {

package/dist/index.d.mts

@@ -476,10 +476,19 @@ declare class LetsFG {
      */
     unlock(offerId: string): Promise<UnlockResult>;
     /**
-     * Book a flight via Developer API — charges ticket price via Stripe, creates real PNR.
-     * Always provide idempotencyKey to prevent double-bookings on retry.
+     * Book a flight.
+     *
+     * PFS (Bearer token): POST /api/agent-book. Free — nothing charged beyond
+     * the ticket price. Pass searchId (from search()'s result). Returns either
+     * { ok, booked: true, order_id } or, when the booking genuinely could not
+     * complete, { ok, booked: false, booking_url } — hand the link to the user,
+     * nothing was charged.
+     *
+     * Developer API (X-API-Key): charges ticket price + service fee via Stripe,
+     * creates a real PNR. Requires unlock() first. Always provide
+     * idempotencyKey to prevent double-bookings on retry.
      */
-    book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string): Promise<BookingResult>;
+    book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string, searchId?: string): Promise<BookingResult | Record<string, unknown>>;
     /**
      * Resolve a place name to the city id that searchHotels() needs.
      *

package/dist/index.d.ts

@@ -476,10 +476,19 @@ declare class LetsFG {
      */
     unlock(offerId: string): Promise<UnlockResult>;
     /**
-     * Book a flight via Developer API — charges ticket price via Stripe, creates real PNR.
-     * Always provide idempotencyKey to prevent double-bookings on retry.
+     * Book a flight.
+     *
+     * PFS (Bearer token): POST /api/agent-book. Free — nothing charged beyond
+     * the ticket price. Pass searchId (from search()'s result). Returns either
+     * { ok, booked: true, order_id } or, when the booking genuinely could not
+     * complete, { ok, booked: false, booking_url } — hand the link to the user,
+     * nothing was charged.
+     *
+     * Developer API (X-API-Key): charges ticket price + service fee via Stripe,
+     * creates a real PNR. Requires unlock() first. Always provide
+     * idempotencyKey to prevent double-bookings on retry.
      */
-    book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string): Promise<BookingResult>;
+    book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string, searchId?: string): Promise<BookingResult | Record<string, unknown>>;
     /**
      * Resolve a place name to the city id that searchHotels() needs.
      *

package/dist/index.js

@@ -1685,10 +1685,36 @@ var LetsFG = class {
     return this.postWithAuth(path, { offer_id: offerId });
   }
   /**
-   * Book a flight via Developer API — charges ticket price via Stripe, creates real PNR.
-   * Always provide idempotencyKey to prevent double-bookings on retry.
+   * Book a flight.
+   *
+   * PFS (Bearer token): POST /api/agent-book. Free — nothing charged beyond
+   * the ticket price. Pass searchId (from search()'s result). Returns either
+   * { ok, booked: true, order_id } or, when the booking genuinely could not
+   * complete, { ok, booked: false, booking_url } — hand the link to the user,
+   * nothing was charged.
+   *
+   * Developer API (X-API-Key): charges ticket price + service fee via Stripe,
+   * creates a real PNR. Requires unlock() first. Always provide
+   * idempotencyKey to prevent double-bookings on retry.
    */
-  async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "") {
+  async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "", searchId = "") {
+    this.requireAuth();
+    if (this.usingPFS) {
+      if (!searchId) {
+        throw new LetsFGError(
+          "searchId is required to book via PFS \u2014 pass the search_id from search()'s result.",
+          400
+        );
+      }
+      const passenger = { ...passengers[0] };
+      if (contactPhone && !passenger.phone_number) passenger.phone_number = contactPhone;
+      return this.postWithBearer("/api/agent-book", {
+        search_id: searchId,
+        offer_id: offerId,
+        passenger,
+        contact_email: contactEmail
+      });
+    }
     this.requireApiKey();
     const body = {
       offer_id: offerId,

package/dist/index.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letsfg",
-  "version": "2026.5.64",
+  "version": "2026.5.65",
   "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",