letsfg 2026.5.69 → 2026.5.71

package/README.md

@@ -11,7 +11,7 @@
 |---|---|---|
 | **Search cost** | Free (Bearer token via `letsfg auth` — zero-amount card setup) | Prepaid credits |
 | **Booking** | `POST /api/agent-book` — confirmed order or a booking link, no LetsFG fee | Direct airline URL (unlock required first) |
-| **Speed** | 60–90 s | 2–5 s (discover) · 60–90 s (full) |
+| **Speed** | 8–10 s to first results; longer on a split | 2–5 s (discover) · 8–10 s to first results (full) |
 | **Setup** | `npm install letsfg` then `letsfg auth` | [letsfg.co/developers](https://letsfg.co/developers) |
 
 > **Want direct airline URLs without any per-booking fee?** Use the [Developer API](https://letsfg.co/developers) — prepaid credits, results in seconds, no checkout step.

package/dist/{chunk-PW775XDB.mjs → chunk-GO3FXQXC.mjs}

@@ -1558,8 +1558,12 @@ function cheapestOffer(result) {
   return result.offers.reduce((min, o) => o.price < min.price ? o : min, result.offers[0]);
 }
 var DEFAULT_BASE_URL = "https://letsfg.co";
-var PFS_POLL_INTERVAL_MS = 1e4;
+var PFS_POLL_INTERVAL_MS = 2e3;
 var PFS_POLL_TIMEOUT_MS = 12e4;
+var LATE_MERGE_POLL_MS = 3e3;
+var LATE_MERGE_GRACE_MS = 9e4;
+var WAIT_FOR_SPLIT = (process.env.LETSFG_WAIT_FOR_SPLIT || "").trim() !== "0";
+var NON_TERMINAL = ["pending", "searching"];
 var LetsFG = class {
   bearerToken;
   apiKey;
@@ -1595,7 +1599,7 @@ var LetsFG = class {
    *
    * Uses PFS (Bearer token) or Developer API (X-API-Key) depending on config.
    * PFS: async polling (POST /api/search -> poll /api/results/<id> every 10s).
-   * Developer API: synchronous 60-90s call.
+   * Developer API: synchronous call.
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -1627,31 +1631,49 @@ var LetsFG = class {
   /** PFS path: POST /api/search -> poll /api/results/<id> */
   async searchPFS(body) {
     const { search_id } = await this.postWithBearer("/api/search", body);
+    const poll = () => this.getNoAuth(`/api/results/${search_id}`);
+    const inbound = (r) => Boolean(r.split_ticket_pending || r.gf_enrich_pending);
     const deadline = Date.now() + PFS_POLL_TIMEOUT_MS;
+    let terminal = null;
     while (Date.now() < deadline) {
-      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
-      const result = await this.getNoAuth(
-        `/api/results/${search_id}`
-      );
-      if (!["pending", "searching"].includes(result.status)) {
-        return result;
+      const result = await poll();
+      if (!NON_TERMINAL.includes(result.status)) {
+        terminal = result;
+        break;
       }
+      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
+    }
+    if (!terminal) {
+      throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
     }
-    throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
+    const lateDeadline = Date.now() + LATE_MERGE_GRACE_MS;
+    while (WAIT_FOR_SPLIT && inbound(terminal) && Date.now() < lateDeadline) {
+      await new Promise((r) => setTimeout(r, LATE_MERGE_POLL_MS));
+      const merged = await poll();
+      if (!NON_TERMINAL.includes(merged.status)) terminal = merged;
+    }
+    return terminal;
   }
   /**
    * Resolve a city/airport name to IATA codes.
+   *
+   * Developer API key only. There is no location endpoint on the PFS Bearer
+   * lane — the same dead end `unlock()` documents below. This used to send
+   * PFS callers to `/api/locations?q=`, a route that has never existed on
+   * letsfg.co (verified 2026-08-16: 404, text/html), so they got a JSON parse
+   * error off the 404 page instead of an answer. Pass an IATA code directly
+   * on the PFS lane; a city code expands to every airport in that city.
    */
   async resolveLocation(query) {
-    this.requireAuth();
-    const path = this.usingPFS ? `/api/locations?q=${encodeURIComponent(query)}` : `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
+    this.requireApiKey();
+    const path = `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
     const data = await this.getWithAuth(path);
     return Array.isArray(data) ? data : data.locations || [];
   }
   /**
    * Unlock a flight offer — confirms live price, reveals direct airline booking URL.
-   * Cost: 1% of ticket price, min $3. Developer API only — there is no unlock
-   * endpoint on a PFS Bearer token, so PFS callers use book() directly.
+   * Developer API only, legacy — there is no unlock endpoint on a PFS Bearer
+   * token, so PFS callers use book() directly.
    */
   async unlock(offerId) {
     this.requireApiKey();

package/dist/cli.js

@@ -454,8 +454,12 @@ function offerSummary(offer) {
   return `${offer.currency} ${offer.price.toFixed(2)} | ${airline} | ${route} | ${dur} | ${offer.outbound.stopovers} stop(s)`;
 }
 var DEFAULT_BASE_URL = "https://letsfg.co";
-var PFS_POLL_INTERVAL_MS = 1e4;
+var PFS_POLL_INTERVAL_MS = 2e3;
 var PFS_POLL_TIMEOUT_MS = 12e4;
+var LATE_MERGE_POLL_MS = 3e3;
+var LATE_MERGE_GRACE_MS = 9e4;
+var WAIT_FOR_SPLIT = (process.env.LETSFG_WAIT_FOR_SPLIT || "").trim() !== "0";
+var NON_TERMINAL = ["pending", "searching"];
 var LetsFG = class {
   bearerToken;
   apiKey;
@@ -491,7 +495,7 @@ var LetsFG = class {
    *
    * Uses PFS (Bearer token) or Developer API (X-API-Key) depending on config.
    * PFS: async polling (POST /api/search -> poll /api/results/<id> every 10s).
-   * Developer API: synchronous 60-90s call.
+   * Developer API: synchronous call.
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -523,31 +527,49 @@ var LetsFG = class {
   /** PFS path: POST /api/search -> poll /api/results/<id> */
   async searchPFS(body) {
     const { search_id } = await this.postWithBearer("/api/search", body);
+    const poll = () => this.getNoAuth(`/api/results/${search_id}`);
+    const inbound = (r) => Boolean(r.split_ticket_pending || r.gf_enrich_pending);
     const deadline = Date.now() + PFS_POLL_TIMEOUT_MS;
+    let terminal = null;
     while (Date.now() < deadline) {
-      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
-      const result = await this.getNoAuth(
-        `/api/results/${search_id}`
-      );
-      if (!["pending", "searching"].includes(result.status)) {
-        return result;
+      const result = await poll();
+      if (!NON_TERMINAL.includes(result.status)) {
+        terminal = result;
+        break;
       }
+      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
+    }
+    if (!terminal) {
+      throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
     }
-    throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
+    const lateDeadline = Date.now() + LATE_MERGE_GRACE_MS;
+    while (WAIT_FOR_SPLIT && inbound(terminal) && Date.now() < lateDeadline) {
+      await new Promise((r) => setTimeout(r, LATE_MERGE_POLL_MS));
+      const merged = await poll();
+      if (!NON_TERMINAL.includes(merged.status)) terminal = merged;
+    }
+    return terminal;
   }
   /**
    * Resolve a city/airport name to IATA codes.
+   *
+   * Developer API key only. There is no location endpoint on the PFS Bearer
+   * lane — the same dead end `unlock()` documents below. This used to send
+   * PFS callers to `/api/locations?q=`, a route that has never existed on
+   * letsfg.co (verified 2026-08-16: 404, text/html), so they got a JSON parse
+   * error off the 404 page instead of an answer. Pass an IATA code directly
+   * on the PFS lane; a city code expands to every airport in that city.
    */
   async resolveLocation(query) {
-    this.requireAuth();
-    const path = this.usingPFS ? `/api/locations?q=${encodeURIComponent(query)}` : `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
+    this.requireApiKey();
+    const path = `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
     const data = await this.getWithAuth(path);
     return Array.isArray(data) ? data : data.locations || [];
   }
   /**
    * Unlock a flight offer — confirms live price, reveals direct airline booking URL.
-   * Cost: 1% of ticket price, min $3. Developer API only — there is no unlock
-   * endpoint on a PFS Bearer token, so PFS callers use book() directly.
+   * Developer API only, legacy — there is no unlock endpoint on a PFS Bearer
+   * token, so PFS callers use book() directly.
    */
   async unlock(offerId) {
     this.requireApiKey();
@@ -1184,7 +1206,7 @@ Developer API only (a SEPARATE paid product \u2014 most agents should not use th
 they create a billing account. Use auth above instead):
   register --name ... --email ... Create a paid Developer API account
   setup-payment                   Attach a card to that paid account
-  unlock <offer_id>               [Developer API only] Unlock offer \u2014 1% of ticket (min $3)
+  unlock <offer_id>               [Developer API only] Unlock offer (legacy)
 
 Options:
   --json, -j          Output raw JSON

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-PW775XDB.mjs";
+} from "./chunk-GO3FXQXC.mjs";
 import {
   BearerTokenError,
   getBearerToken,
@@ -348,7 +348,7 @@ Developer API only (a SEPARATE paid product \u2014 most agents should not use th
 they create a billing account. Use auth above instead):
   register --name ... --email ... Create a paid Developer API account
   setup-payment                   Attach a card to that paid account
-  unlock <offer_id>               [Developer API only] Unlock offer \u2014 1% of ticket (min $3)
+  unlock <offer_id>               [Developer API only] Unlock offer (legacy)
 
 Options:
   --json, -j          Output raw JSON

package/dist/index.d.mts

@@ -283,7 +283,7 @@ declare function getOfferDetailPromptNotes(offer: OfferDetailLike): string[];
  * const flights = await bt.search('GDN', 'BER', '2026-03-03');
  *
  * // Developer API (prepaid credits)
- * const bt2 = new LetsFG({ apiKey: 'trav_...' });
+ * const bt2 = new LetsFG({ apiKey: 'letsfg_...' });
  * const flights2 = await bt2.search('LHR', 'JFK', '2026-04-15');
  * ```
  */
@@ -473,7 +473,7 @@ declare class LetsFG {
      *
      * Uses PFS (Bearer token) or Developer API (X-API-Key) depending on config.
      * PFS: async polling (POST /api/search -> poll /api/results/<id> every 10s).
-     * Developer API: synchronous 60-90s call.
+     * Developer API: synchronous call.
      *
      * @param origin - IATA code (e.g., "GDN", "LON")
      * @param destination - IATA code (e.g., "BER", "BCN")
@@ -485,12 +485,19 @@ declare class LetsFG {
     private searchPFS;
     /**
      * Resolve a city/airport name to IATA codes.
+     *
+     * Developer API key only. There is no location endpoint on the PFS Bearer
+     * lane — the same dead end `unlock()` documents below. This used to send
+     * PFS callers to `/api/locations?q=`, a route that has never existed on
+     * letsfg.co (verified 2026-08-16: 404, text/html), so they got a JSON parse
+     * error off the 404 page instead of an answer. Pass an IATA code directly
+     * on the PFS lane; a city code expands to every airport in that city.
      */
     resolveLocation(query: string): Promise<Array<Record<string, unknown>>>;
     /**
      * Unlock a flight offer — confirms live price, reveals direct airline booking URL.
-     * Cost: 1% of ticket price, min $3. Developer API only — there is no unlock
-     * endpoint on a PFS Bearer token, so PFS callers use book() directly.
+     * Developer API only, legacy — there is no unlock endpoint on a PFS Bearer
+     * token, so PFS callers use book() directly.
      */
     unlock(offerId: string): Promise<UnlockResult>;
     /**

package/dist/index.d.ts

@@ -283,7 +283,7 @@ declare function getOfferDetailPromptNotes(offer: OfferDetailLike): string[];
  * const flights = await bt.search('GDN', 'BER', '2026-03-03');
  *
  * // Developer API (prepaid credits)
- * const bt2 = new LetsFG({ apiKey: 'trav_...' });
+ * const bt2 = new LetsFG({ apiKey: 'letsfg_...' });
  * const flights2 = await bt2.search('LHR', 'JFK', '2026-04-15');
  * ```
  */
@@ -473,7 +473,7 @@ declare class LetsFG {
      *
      * Uses PFS (Bearer token) or Developer API (X-API-Key) depending on config.
      * PFS: async polling (POST /api/search -> poll /api/results/<id> every 10s).
-     * Developer API: synchronous 60-90s call.
+     * Developer API: synchronous call.
      *
      * @param origin - IATA code (e.g., "GDN", "LON")
      * @param destination - IATA code (e.g., "BER", "BCN")
@@ -485,12 +485,19 @@ declare class LetsFG {
     private searchPFS;
     /**
      * Resolve a city/airport name to IATA codes.
+     *
+     * Developer API key only. There is no location endpoint on the PFS Bearer
+     * lane — the same dead end `unlock()` documents below. This used to send
+     * PFS callers to `/api/locations?q=`, a route that has never existed on
+     * letsfg.co (verified 2026-08-16: 404, text/html), so they got a JSON parse
+     * error off the 404 page instead of an answer. Pass an IATA code directly
+     * on the PFS lane; a city code expands to every airport in that city.
      */
     resolveLocation(query: string): Promise<Array<Record<string, unknown>>>;
     /**
      * Unlock a flight offer — confirms live price, reveals direct airline booking URL.
-     * Cost: 1% of ticket price, min $3. Developer API only — there is no unlock
-     * endpoint on a PFS Bearer token, so PFS callers use book() directly.
+     * Developer API only, legacy — there is no unlock endpoint on a PFS Bearer
+     * token, so PFS callers use book() directly.
      */
     unlock(offerId: string): Promise<UnlockResult>;
     /**

package/dist/index.js

@@ -1606,8 +1606,12 @@ function cheapestOffer(result) {
   return result.offers.reduce((min, o) => o.price < min.price ? o : min, result.offers[0]);
 }
 var DEFAULT_BASE_URL = "https://letsfg.co";
-var PFS_POLL_INTERVAL_MS = 1e4;
+var PFS_POLL_INTERVAL_MS = 2e3;
 var PFS_POLL_TIMEOUT_MS = 12e4;
+var LATE_MERGE_POLL_MS = 3e3;
+var LATE_MERGE_GRACE_MS = 9e4;
+var WAIT_FOR_SPLIT = (process.env.LETSFG_WAIT_FOR_SPLIT || "").trim() !== "0";
+var NON_TERMINAL = ["pending", "searching"];
 var LetsFG = class {
   bearerToken;
   apiKey;
@@ -1643,7 +1647,7 @@ var LetsFG = class {
    *
    * Uses PFS (Bearer token) or Developer API (X-API-Key) depending on config.
    * PFS: async polling (POST /api/search -> poll /api/results/<id> every 10s).
-   * Developer API: synchronous 60-90s call.
+   * Developer API: synchronous call.
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -1675,31 +1679,49 @@ var LetsFG = class {
   /** PFS path: POST /api/search -> poll /api/results/<id> */
   async searchPFS(body) {
     const { search_id } = await this.postWithBearer("/api/search", body);
+    const poll = () => this.getNoAuth(`/api/results/${search_id}`);
+    const inbound = (r) => Boolean(r.split_ticket_pending || r.gf_enrich_pending);
     const deadline = Date.now() + PFS_POLL_TIMEOUT_MS;
+    let terminal = null;
     while (Date.now() < deadline) {
-      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
-      const result = await this.getNoAuth(
-        `/api/results/${search_id}`
-      );
-      if (!["pending", "searching"].includes(result.status)) {
-        return result;
+      const result = await poll();
+      if (!NON_TERMINAL.includes(result.status)) {
+        terminal = result;
+        break;
       }
+      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
+    }
+    if (!terminal) {
+      throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
     }
-    throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
+    const lateDeadline = Date.now() + LATE_MERGE_GRACE_MS;
+    while (WAIT_FOR_SPLIT && inbound(terminal) && Date.now() < lateDeadline) {
+      await new Promise((r) => setTimeout(r, LATE_MERGE_POLL_MS));
+      const merged = await poll();
+      if (!NON_TERMINAL.includes(merged.status)) terminal = merged;
+    }
+    return terminal;
   }
   /**
    * Resolve a city/airport name to IATA codes.
+   *
+   * Developer API key only. There is no location endpoint on the PFS Bearer
+   * lane — the same dead end `unlock()` documents below. This used to send
+   * PFS callers to `/api/locations?q=`, a route that has never existed on
+   * letsfg.co (verified 2026-08-16: 404, text/html), so they got a JSON parse
+   * error off the 404 page instead of an answer. Pass an IATA code directly
+   * on the PFS lane; a city code expands to every airport in that city.
    */
   async resolveLocation(query) {
-    this.requireAuth();
-    const path = this.usingPFS ? `/api/locations?q=${encodeURIComponent(query)}` : `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
+    this.requireApiKey();
+    const path = `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
     const data = await this.getWithAuth(path);
     return Array.isArray(data) ? data : data.locations || [];
   }
   /**
    * Unlock a flight offer — confirms live price, reveals direct airline booking URL.
-   * Cost: 1% of ticket price, min $3. Developer API only — there is no unlock
-   * endpoint on a PFS Bearer token, so PFS callers use book() directly.
+   * Developer API only, legacy — there is no unlock endpoint on a PFS Bearer
+   * token, so PFS callers use book() directly.
    */
   async unlock(offerId) {
     this.requireApiKey();

package/dist/index.mjs

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

package/package.json

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