letsfg 1.6.0 → 1.7.0

package/README.md

@@ -1,6 +1,6 @@
 # LetsFG — Your AI agent just learned to book flights. (Node.js)
 
-**195 airlines. Real prices. One function call.** Search 400+ airlines at raw airline prices — **$20–$50 cheaper** than Booking.com, Kayak, and other OTAs. Zero dependencies. Built for AI agents.
+**200 airlines. Real prices. One function call.** Search 400+ airlines at raw airline prices — **$20–$50 cheaper** than Booking.com, Kayak, and other OTAs. Zero dependencies. Built for AI agents.
 
 > **Don't want to install anything?** [**Try it on Messenger**](https://m.me/61579557368989) — search flights instantly, no setup needed.
 
@@ -81,7 +81,7 @@ letsfg book off_xxx -p '{"id":"pas_xxx","given_name":"John",...}' -e john@exampl
 
 ### `searchLocal(origin, destination, dateFrom, options?)`
 
-Search 195 airline connectors locally (no API key needed). Requires Python + `letsfg` installed.
+Search 200 airline connectors locally (no API key needed). Requires Python + `letsfg` installed.
 
 ```typescript
 import { searchLocal } from 'letsfg';

package/dist/{chunk-GXEB2JO2.mjs → chunk-RLP7MSF6.mjs}

@@ -194,7 +194,10 @@ var LetsFG = class {
   }
   // ── Core methods ─────────────────────────────────────────────────────
   /**
-   * Search for flights — FREE, unlimited.
+   * Search for flights — FREE, unlimited, runs locally on your machine.
+   *
+   * Uses 200 airline connectors via Python subprocess. No backend call.
+   * Requires: pip install letsfg && playwright install chromium
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -202,32 +205,44 @@ var LetsFG = class {
    * @param options - Optional search parameters
    */
   async search(origin, destination, dateFrom, options = {}) {
-    this.requireApiKey();
-    const body = {
-      origin: origin.toUpperCase(),
-      destination: destination.toUpperCase(),
-      date_from: dateFrom,
-      adults: options.adults ?? 1,
-      children: options.children ?? 0,
-      infants: options.infants ?? 0,
-      max_stopovers: options.maxStopovers ?? 2,
-      currency: options.currency ?? "EUR",
-      limit: options.limit ?? 20,
-      sort: options.sort ?? "price"
-    };
-    if (options.returnDate) body.return_from = options.returnDate;
-    if (options.cabinClass) body.cabin_class = options.cabinClass;
-    return this.post("/api/v1/flights/search", body);
+    return searchLocal(origin, destination, dateFrom, options);
   }
   /**
-   * Resolve a city/airport name to IATA codes.
+   * Resolve a city/airport name to IATA codes — runs locally, no backend call.
    */
   async resolveLocation(query) {
-    this.requireApiKey();
-    const data = await this.get(`/api/v1/flights/locations/${encodeURIComponent(query)}`);
-    if (Array.isArray(data)) return data;
-    if (data && Array.isArray(data.locations)) return data.locations;
-    return data ? [data] : [];
+    const { spawn } = await import("child_process");
+    const params = JSON.stringify({ __resolve_location: true, query });
+    return new Promise((resolve, reject) => {
+      const pythonCmd = process.platform === "win32" ? "python" : "python3";
+      const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      child.stdout.on("data", (d) => {
+        stdout += d.toString();
+      });
+      child.stderr.on("data", (d) => {
+        stderr += d.toString();
+      });
+      child.on("close", (code) => {
+        try {
+          const data = JSON.parse(stdout);
+          if (data.error) reject(new LetsFGError(data.error));
+          else resolve(Array.isArray(data) ? data : data.locations || [data]);
+        } catch {
+          reject(new LetsFGError(
+            `Location resolution failed (code ${code}): ${stdout || stderr}`
+          ));
+        }
+      });
+      child.on("error", (err) => {
+        reject(new LetsFGError(`Cannot start Python: ${err.message}`));
+      });
+      child.stdin.write(params);
+      child.stdin.end();
+    });
   }
   /**
    * Unlock a flight offer — FREE with GitHub star.

package/dist/cli.js

@@ -147,6 +147,55 @@ function offerSummary(offer) {
   const airline = offer.owner_airline || offer.airlines[0] || "?";
   return `${offer.currency} ${offer.price.toFixed(2)} | ${airline} | ${route} | ${dur} | ${offer.outbound.stopovers} stop(s)`;
 }
+async function searchLocal(origin, destination, dateFrom, options = {}) {
+  const { spawn } = await import("child_process");
+  const params = JSON.stringify({
+    origin: origin.toUpperCase(),
+    destination: destination.toUpperCase(),
+    date_from: dateFrom,
+    adults: options.adults ?? 1,
+    children: options.children ?? 0,
+    currency: options.currency ?? "EUR",
+    limit: options.limit ?? 50,
+    return_date: options.returnDate,
+    cabin_class: options.cabinClass,
+    ...options.maxBrowsers != null && { max_browsers: options.maxBrowsers }
+  });
+  return new Promise((resolve, reject) => {
+    const pythonCmd = process.platform === "win32" ? "python" : "python3";
+    const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (d) => {
+      stdout += d.toString();
+    });
+    child.stderr.on("data", (d) => {
+      stderr += d.toString();
+    });
+    child.on("close", (code) => {
+      try {
+        const data = JSON.parse(stdout);
+        if (data.error) reject(new LetsFGError(data.error));
+        else resolve(data);
+      } catch {
+        reject(new LetsFGError(
+          `Python search failed (code ${code}): ${stdout || stderr}
+Make sure LetsFG is installed: pip install letsfg && playwright install chromium`
+        ));
+      }
+    });
+    child.on("error", (err) => {
+      reject(new LetsFGError(
+        `Cannot start Python: ${err.message}
+Install: pip install letsfg && playwright install chromium`
+      ));
+    });
+    child.stdin.write(params);
+    child.stdin.end();
+  });
+}
 var DEFAULT_BASE_URL = "https://api.letsfg.co";
 var LetsFG = class {
   apiKey;
@@ -166,7 +215,10 @@ var LetsFG = class {
   }
   // ── Core methods ─────────────────────────────────────────────────────
   /**
-   * Search for flights — FREE, unlimited.
+   * Search for flights — FREE, unlimited, runs locally on your machine.
+   *
+   * Uses 200 airline connectors via Python subprocess. No backend call.
+   * Requires: pip install letsfg && playwright install chromium
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -174,32 +226,44 @@ var LetsFG = class {
    * @param options - Optional search parameters
    */
   async search(origin, destination, dateFrom, options = {}) {
-    this.requireApiKey();
-    const body = {
-      origin: origin.toUpperCase(),
-      destination: destination.toUpperCase(),
-      date_from: dateFrom,
-      adults: options.adults ?? 1,
-      children: options.children ?? 0,
-      infants: options.infants ?? 0,
-      max_stopovers: options.maxStopovers ?? 2,
-      currency: options.currency ?? "EUR",
-      limit: options.limit ?? 20,
-      sort: options.sort ?? "price"
-    };
-    if (options.returnDate) body.return_from = options.returnDate;
-    if (options.cabinClass) body.cabin_class = options.cabinClass;
-    return this.post("/api/v1/flights/search", body);
+    return searchLocal(origin, destination, dateFrom, options);
   }
   /**
-   * Resolve a city/airport name to IATA codes.
+   * Resolve a city/airport name to IATA codes — runs locally, no backend call.
    */
   async resolveLocation(query) {
-    this.requireApiKey();
-    const data = await this.get(`/api/v1/flights/locations/${encodeURIComponent(query)}`);
-    if (Array.isArray(data)) return data;
-    if (data && Array.isArray(data.locations)) return data.locations;
-    return data ? [data] : [];
+    const { spawn } = await import("child_process");
+    const params = JSON.stringify({ __resolve_location: true, query });
+    return new Promise((resolve, reject) => {
+      const pythonCmd = process.platform === "win32" ? "python" : "python3";
+      const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      child.stdout.on("data", (d) => {
+        stdout += d.toString();
+      });
+      child.stderr.on("data", (d) => {
+        stderr += d.toString();
+      });
+      child.on("close", (code) => {
+        try {
+          const data = JSON.parse(stdout);
+          if (data.error) reject(new LetsFGError(data.error));
+          else resolve(Array.isArray(data) ? data : data.locations || [data]);
+        } catch {
+          reject(new LetsFGError(
+            `Location resolution failed (code ${code}): ${stdout || stderr}`
+          ));
+        }
+      });
+      child.on("error", (err) => {
+        reject(new LetsFGError(`Cannot start Python: ${err.message}`));
+      });
+      child.stdin.write(params);
+      child.stdin.end();
+    });
   }
   /**
    * Unlock a flight offer — FREE with GitHub star.

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -205,7 +205,10 @@ declare class LetsFG {
     constructor(config?: LetsFGConfig);
     private requireApiKey;
     /**
-     * Search for flights — FREE, unlimited.
+     * Search for flights — FREE, unlimited, runs locally on your machine.
+     *
+     * Uses 200 airline connectors via Python subprocess. No backend call.
+     * Requires: pip install letsfg && playwright install chromium
      *
      * @param origin - IATA code (e.g., "GDN", "LON")
      * @param destination - IATA code (e.g., "BER", "BCN")
@@ -214,7 +217,7 @@ declare class LetsFG {
      */
     search(origin: string, destination: string, dateFrom: string, options?: SearchOptions): Promise<FlightSearchResult>;
     /**
-     * Resolve a city/airport name to IATA codes.
+     * Resolve a city/airport name to IATA codes — runs locally, no backend call.
      */
     resolveLocation(query: string): Promise<Array<Record<string, unknown>>>;
     /**

package/dist/index.d.ts

@@ -205,7 +205,10 @@ declare class LetsFG {
     constructor(config?: LetsFGConfig);
     private requireApiKey;
     /**
-     * Search for flights — FREE, unlimited.
+     * Search for flights — FREE, unlimited, runs locally on your machine.
+     *
+     * Uses 200 airline connectors via Python subprocess. No backend call.
+     * Requires: pip install letsfg && playwright install chromium
      *
      * @param origin - IATA code (e.g., "GDN", "LON")
      * @param destination - IATA code (e.g., "BER", "BCN")
@@ -214,7 +217,7 @@ declare class LetsFG {
      */
     search(origin: string, destination: string, dateFrom: string, options?: SearchOptions): Promise<FlightSearchResult>;
     /**
-     * Resolve a city/airport name to IATA codes.
+     * Resolve a city/airport name to IATA codes — runs locally, no backend call.
      */
     resolveLocation(query: string): Promise<Array<Record<string, unknown>>>;
     /**

package/dist/index.js

@@ -244,7 +244,10 @@ var LetsFG = class {
   }
   // ── Core methods ─────────────────────────────────────────────────────
   /**
-   * Search for flights — FREE, unlimited.
+   * Search for flights — FREE, unlimited, runs locally on your machine.
+   *
+   * Uses 200 airline connectors via Python subprocess. No backend call.
+   * Requires: pip install letsfg && playwright install chromium
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -252,32 +255,44 @@ var LetsFG = class {
    * @param options - Optional search parameters
    */
   async search(origin, destination, dateFrom, options = {}) {
-    this.requireApiKey();
-    const body = {
-      origin: origin.toUpperCase(),
-      destination: destination.toUpperCase(),
-      date_from: dateFrom,
-      adults: options.adults ?? 1,
-      children: options.children ?? 0,
-      infants: options.infants ?? 0,
-      max_stopovers: options.maxStopovers ?? 2,
-      currency: options.currency ?? "EUR",
-      limit: options.limit ?? 20,
-      sort: options.sort ?? "price"
-    };
-    if (options.returnDate) body.return_from = options.returnDate;
-    if (options.cabinClass) body.cabin_class = options.cabinClass;
-    return this.post("/api/v1/flights/search", body);
+    return searchLocal(origin, destination, dateFrom, options);
   }
   /**
-   * Resolve a city/airport name to IATA codes.
+   * Resolve a city/airport name to IATA codes — runs locally, no backend call.
    */
   async resolveLocation(query) {
-    this.requireApiKey();
-    const data = await this.get(`/api/v1/flights/locations/${encodeURIComponent(query)}`);
-    if (Array.isArray(data)) return data;
-    if (data && Array.isArray(data.locations)) return data.locations;
-    return data ? [data] : [];
+    const { spawn } = await import("child_process");
+    const params = JSON.stringify({ __resolve_location: true, query });
+    return new Promise((resolve, reject) => {
+      const pythonCmd = process.platform === "win32" ? "python" : "python3";
+      const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      child.stdout.on("data", (d) => {
+        stdout += d.toString();
+      });
+      child.stderr.on("data", (d) => {
+        stderr += d.toString();
+      });
+      child.on("close", (code) => {
+        try {
+          const data = JSON.parse(stdout);
+          if (data.error) reject(new LetsFGError(data.error));
+          else resolve(Array.isArray(data) ? data : data.locations || [data]);
+        } catch {
+          reject(new LetsFGError(
+            `Location resolution failed (code ${code}): ${stdout || stderr}`
+          ));
+        }
+      });
+      child.on("error", (err) => {
+        reject(new LetsFGError(`Cannot start Python: ${err.message}`));
+      });
+      child.stdin.write(params);
+      child.stdin.end();
+    });
   }
   /**
    * Unlock a flight offer — FREE with GitHub star.

package/dist/index.mjs

@@ -14,7 +14,7 @@ import {
   offerSummary,
   searchLocal,
   systemInfo
-} from "./chunk-GXEB2JO2.mjs";
+} from "./chunk-RLP7MSF6.mjs";
 export {
   AuthenticationError,
   BoostedTravel,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "letsfg",
-  "version": "1.6.0",
-  "description": "Agent-native flight search & booking. 195 airline connectors run locally + enterprise GDS/NDC APIs. Built for autonomous AI agents.",
+  "version": "1.7.0",
+  "description": "Agent-native flight search & booking. 200 airline connectors run locally + enterprise GDS/NDC APIs. Built for autonomous AI agents.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",