letsfg 1.4.2 → 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-7LYR3CHE.mjs → chunk-RLP7MSF6.mjs}

@@ -106,12 +106,6 @@ var ValidationError = class extends LetsFGError {
     this.name = "ValidationError";
   }
 };
-var StarRequiredError = class extends LetsFGError {
-  constructor(message = "GitHub star required. Run: letsfg star --github <your-username>") {
-    super(message, 403, {}, "STAR_REQUIRED");
-    this.name = "StarRequiredError";
-  }
-};
 function routeStr(route) {
   if (!route.segments.length) return "";
   const codes = [route.segments[0].origin, ...route.segments.map((s) => s.destination)];
@@ -162,13 +156,8 @@ async function searchLocal(origin, destination, dateFrom, options = {}) {
     child.on("close", (code) => {
       try {
         const data = JSON.parse(stdout);
-        if (data.error) {
-          if (data.error.includes("GitHub star required") || data.error.includes("star required")) {
-            reject(new StarRequiredError(data.error));
-          } else {
-            reject(new LetsFGError(data.error));
-          }
-        } else resolve(data);
+        if (data.error) reject(new LetsFGError(data.error));
+        else resolve(data);
       } catch {
         reject(new LetsFGError(
           `Python search failed (code ${code}): ${stdout || stderr}
@@ -205,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")
@@ -213,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.
@@ -402,6 +406,7 @@ var LetsFG = class {
           "Content-Type": "application/json",
           "X-API-Key": this.apiKey,
           "User-Agent": "LetsFG-js/0.1.0",
+          "X-Client-Type": "js-sdk",
           ...init.headers || {}
         },
         signal: controller.signal
@@ -470,7 +475,6 @@ export {
   PaymentRequiredError,
   OfferExpiredError,
   ValidationError,
-  StarRequiredError,
   offerSummary,
   cheapestOffer,
   searchLocal,

package/dist/cli.js

@@ -131,12 +131,6 @@ var ValidationError = class extends LetsFGError {
     this.name = "ValidationError";
   }
 };
-var StarRequiredError = class extends LetsFGError {
-  constructor(message = "GitHub star required. Run: letsfg star --github <your-username>") {
-    super(message, 403, {}, "STAR_REQUIRED");
-    this.name = "StarRequiredError";
-  }
-};
 function routeStr(route) {
   if (!route.segments.length) return "";
   const codes = [route.segments[0].origin, ...route.segments.map((s) => s.destination)];
@@ -153,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;
@@ -172,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")
@@ -180,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.
@@ -369,6 +427,7 @@ var LetsFG = class {
           "Content-Type": "application/json",
           "X-API-Key": this.apiKey,
           "User-Agent": "LetsFG-js/0.1.0",
+          "X-Client-Type": "js-sdk",
           ...init.headers || {}
         },
         signal: controller.signal
@@ -610,44 +669,42 @@ async function cmdRegister(args) {
 }
 async function cmdStar(args) {
   const jsonOut = hasFlag(args, "--json") || hasFlag(args, "-j");
+  const apiKey = getFlag(args, "--api-key", "-k");
+  const baseUrl = getFlag(args, "--base-url");
   const github = getFlag(args, "--github", "-g");
   if (!github) {
     console.error("Usage: letsfg star --github <your-github-username>");
     process.exit(1);
   }
-  const { spawn } = await import("child_process");
-  const pythonCmd = process.platform === "win32" ? "python" : "python3";
-  return new Promise((resolve, reject) => {
-    const child = spawn(pythonCmd, ["-m", "letsfg.cli", "star", "--github", github], {
-      stdio: ["inherit", "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) => {
-      if (jsonOut) {
-        const verified = code === 0;
-        console.log(JSON.stringify({ status: verified ? "verified" : "star_required", github_username: github }));
-      } else {
-        if (stdout) console.log(stdout);
-        if (stderr && code !== 0) console.error(stderr);
-      }
-      if (code !== 0) {
-        process.exit(1);
-      }
-      resolve();
-    });
-    child.on("error", (err) => {
-      console.error(`Cannot start Python: ${err.message}`);
-      console.error("Install: pip install letsfg");
-      process.exit(1);
-    });
-  });
+  const bt = new LetsFG({ apiKey, baseUrl });
+  const result = await bt.linkGithub(github);
+  if (jsonOut) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const status = result.status;
+  if (status === "verified") {
+    console.log(`
+  \u2713 GitHub star verified! Unlimited access granted.`);
+    console.log(`    Username: ${result.github_username}`);
+    console.log(`
+    You're all set \u2014 search, unlock, and book for free.
+`);
+  } else if (status === "already_verified") {
+    console.log(`
+  \u2713 Already verified! You have unlimited access.`);
+    console.log(`    Username: ${result.github_username}
+`);
+  } else if (status === "star_required") {
+    console.log(`
+  \u2717 Star not found for '${github}'.`);
+    console.log(`    1. Star the repo: https://github.com/LetsFG/LetsFG`);
+    console.log(`    2. Run this command again.
+`);
+  } else {
+    console.error(`  \u2717 Unexpected status: ${status}`);
+    process.exit(1);
+  }
 }
 async function cmdSetupPayment(args) {
   const jsonOut = hasFlag(args, "--json") || hasFlag(args, "-j");
@@ -705,19 +762,16 @@ var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
 Search 400+ airlines at raw airline prices \u2014 $20-50 cheaper than OTAs.
-
-**GitHub Star Required!**
-Before using, you must:
-1. Star https://github.com/LetsFG/LetsFG
-2. Run: letsfg star --github <your-username>
+100% FREE \u2014 just star our GitHub repo for unlimited access.
 
 Commands:
-  star --github <username>        Verify GitHub star (required first!)
-  search <origin> <dest> <date>   Search for flights (FREE with star)
+  search <origin> <dest> <date>   Search for flights (FREE)
   locations <query>               Resolve city name to IATA codes
-  unlock <offer_id>               Unlock offer (hosted mode only)
-  book <offer_id> --passenger ... Book flight
+  star --github <username>        Link GitHub \u2014 star repo for free access
+  unlock <offer_id>               Unlock offer (FREE with GitHub star)
+  book <offer_id> --passenger ... Book flight (FREE after unlock)
   register --name ... --email ... Register new agent
+  setup-payment                   Legacy payment setup
   me                              Show agent profile
 
 Options:
@@ -726,6 +780,7 @@ Options:
   --base-url       API URL (default: https://api.letsfg.co)
 
 Examples:
+  letsfg register --name my-agent --email me@example.com
   letsfg star --github octocat
   letsfg search GDN BER 2026-03-03 --sort price
   letsfg unlock off_xxx
@@ -772,17 +827,6 @@ async function main() {
         process.exit(1);
     }
   } catch (e) {
-    if (e instanceof StarRequiredError) {
-      console.error(`
-  \u2B50 GitHub star required to use LetsFG!
-`);
-      console.error(`  1. Star the repo: https://github.com/LetsFG/LetsFG`);
-      console.error(`  2. Run: letsfg star --github <your-username>
-`);
-      console.error(`  This is completely FREE \u2014 just a star to help us grow!
-`);
-      process.exit(1);
-    }
     if (e instanceof LetsFGError) {
       console.error(`Error: ${e.message}`);
       process.exit(1);

package/dist/cli.mjs

@@ -2,9 +2,8 @@
 import {
   LetsFG,
   LetsFGError,
-  StarRequiredError,
   offerSummary
-} from "./chunk-7LYR3CHE.mjs";
+} from "./chunk-RLP7MSF6.mjs";
 
 // src/cli.ts
 function getFlag(args, flag, alias) {
@@ -226,44 +225,42 @@ async function cmdRegister(args) {
 }
 async function cmdStar(args) {
   const jsonOut = hasFlag(args, "--json") || hasFlag(args, "-j");
+  const apiKey = getFlag(args, "--api-key", "-k");
+  const baseUrl = getFlag(args, "--base-url");
   const github = getFlag(args, "--github", "-g");
   if (!github) {
     console.error("Usage: letsfg star --github <your-github-username>");
     process.exit(1);
   }
-  const { spawn } = await import("child_process");
-  const pythonCmd = process.platform === "win32" ? "python" : "python3";
-  return new Promise((resolve, reject) => {
-    const child = spawn(pythonCmd, ["-m", "letsfg.cli", "star", "--github", github], {
-      stdio: ["inherit", "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) => {
-      if (jsonOut) {
-        const verified = code === 0;
-        console.log(JSON.stringify({ status: verified ? "verified" : "star_required", github_username: github }));
-      } else {
-        if (stdout) console.log(stdout);
-        if (stderr && code !== 0) console.error(stderr);
-      }
-      if (code !== 0) {
-        process.exit(1);
-      }
-      resolve();
-    });
-    child.on("error", (err) => {
-      console.error(`Cannot start Python: ${err.message}`);
-      console.error("Install: pip install letsfg");
-      process.exit(1);
-    });
-  });
+  const bt = new LetsFG({ apiKey, baseUrl });
+  const result = await bt.linkGithub(github);
+  if (jsonOut) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const status = result.status;
+  if (status === "verified") {
+    console.log(`
+  \u2713 GitHub star verified! Unlimited access granted.`);
+    console.log(`    Username: ${result.github_username}`);
+    console.log(`
+    You're all set \u2014 search, unlock, and book for free.
+`);
+  } else if (status === "already_verified") {
+    console.log(`
+  \u2713 Already verified! You have unlimited access.`);
+    console.log(`    Username: ${result.github_username}
+`);
+  } else if (status === "star_required") {
+    console.log(`
+  \u2717 Star not found for '${github}'.`);
+    console.log(`    1. Star the repo: https://github.com/LetsFG/LetsFG`);
+    console.log(`    2. Run this command again.
+`);
+  } else {
+    console.error(`  \u2717 Unexpected status: ${status}`);
+    process.exit(1);
+  }
 }
 async function cmdSetupPayment(args) {
   const jsonOut = hasFlag(args, "--json") || hasFlag(args, "-j");
@@ -321,19 +318,16 @@ var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
 Search 400+ airlines at raw airline prices \u2014 $20-50 cheaper than OTAs.
-
-**GitHub Star Required!**
-Before using, you must:
-1. Star https://github.com/LetsFG/LetsFG
-2. Run: letsfg star --github <your-username>
+100% FREE \u2014 just star our GitHub repo for unlimited access.
 
 Commands:
-  star --github <username>        Verify GitHub star (required first!)
-  search <origin> <dest> <date>   Search for flights (FREE with star)
+  search <origin> <dest> <date>   Search for flights (FREE)
   locations <query>               Resolve city name to IATA codes
-  unlock <offer_id>               Unlock offer (hosted mode only)
-  book <offer_id> --passenger ... Book flight
+  star --github <username>        Link GitHub \u2014 star repo for free access
+  unlock <offer_id>               Unlock offer (FREE with GitHub star)
+  book <offer_id> --passenger ... Book flight (FREE after unlock)
   register --name ... --email ... Register new agent
+  setup-payment                   Legacy payment setup
   me                              Show agent profile
 
 Options:
@@ -342,6 +336,7 @@ Options:
   --base-url       API URL (default: https://api.letsfg.co)
 
 Examples:
+  letsfg register --name my-agent --email me@example.com
   letsfg star --github octocat
   letsfg search GDN BER 2026-03-03 --sort price
   letsfg unlock off_xxx
@@ -388,17 +383,6 @@ async function main() {
         process.exit(1);
     }
   } catch (e) {
-    if (e instanceof StarRequiredError) {
-      console.error(`
-  \u2B50 GitHub star required to use LetsFG!
-`);
-      console.error(`  1. Star the repo: https://github.com/LetsFG/LetsFG`);
-      console.error(`  2. Run: letsfg star --github <your-username>
-`);
-      console.error(`  This is completely FREE \u2014 just a star to help us grow!
-`);
-      process.exit(1);
-    }
     if (e instanceof LetsFGError) {
       console.error(`Error: ${e.message}`);
       process.exit(1);

package/dist/index.d.mts

@@ -1,19 +1,14 @@
 /**
  * LetsFG — Agent-native flight search & booking SDK for Node.js/TypeScript.
  *
- * 195 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
+ * 75 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
  * Zero external JS dependencies. Uses native fetch (Node 18+).
  *
- * **GitHub Star Required!**
- * Before using, you must:
- * 1. Star https://github.com/LetsFG/LetsFG
- * 2. Run: letsfg star --github <your-username>
- *
  * @example
  * ```ts
  * import { LetsFG, searchLocal } from 'letsfg';
  *
- * // Local search — FREE with GitHub star
+ * // Local search — FREE, no API key
  * const local = await searchLocal('SHA', 'CTU', '2026-03-20');
  *
  * // Full API — search + unlock + book
@@ -188,25 +183,12 @@ declare class OfferExpiredError extends LetsFGError {
 declare class ValidationError extends LetsFGError {
     constructor(message: string, statusCode?: number, response?: Record<string, unknown>, errorCode?: string);
 }
-/**
- * Thrown when GitHub star verification is required.
- * Users must star https://github.com/LetsFG/LetsFG and run:
- *   letsfg star --github <username>
- */
-declare class StarRequiredError extends LetsFGError {
-    constructor(message?: string);
-}
 /** One-line offer summary */
 declare function offerSummary(offer: FlightOffer): string;
 /** Get cheapest offer from search results */
 declare function cheapestOffer(result: FlightSearchResult): FlightOffer | null;
 /**
- * Search flights using 195 local airline connectors — FREE with GitHub star!
- *
- * **GitHub Star Required!**
- * Before using, you must:
- * 1. Star https://github.com/LetsFG/LetsFG
- * 2. Run: letsfg star --github <your-username>
+ * Search flights using 73 local airline connectors — FREE, no API key needed.
  *
  * Requires: pip install letsfg && playwright install chromium
  *
@@ -214,7 +196,6 @@ declare function cheapestOffer(result: FlightSearchResult): FlightOffer | null;
  * @param destination - IATA code (e.g., "CTU")
  * @param dateFrom - Departure date "YYYY-MM-DD"
  * @param options - Optional: currency, adults, limit, etc.
- * @throws {StarRequiredError} If GitHub star not verified
  */
 declare function searchLocal(origin: string, destination: string, dateFrom: string, options?: Partial<SearchOptions>): Promise<FlightSearchResult>;
 declare class LetsFG {
@@ -224,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")
@@ -233,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>>>;
     /**
@@ -301,4 +285,4 @@ declare const BoostedTravel: typeof LetsFG;
 declare const BoostedTravelError: typeof LetsFGError;
 type BoostedTravelConfig = LetsFGConfig;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, type CheckoutProgress, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, StarRequiredError, type UnlockResult, ValidationError, cheapestOffer, LetsFG as default, systemInfo as getSystemInfo, searchLocal as localSearch, offerSummary, searchLocal, systemInfo };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, type CheckoutProgress, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, type UnlockResult, ValidationError, cheapestOffer, LetsFG as default, systemInfo as getSystemInfo, searchLocal as localSearch, offerSummary, searchLocal, systemInfo };

package/dist/index.d.ts

@@ -1,19 +1,14 @@
 /**
  * LetsFG — Agent-native flight search & booking SDK for Node.js/TypeScript.
  *
- * 195 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
+ * 75 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
  * Zero external JS dependencies. Uses native fetch (Node 18+).
  *
- * **GitHub Star Required!**
- * Before using, you must:
- * 1. Star https://github.com/LetsFG/LetsFG
- * 2. Run: letsfg star --github <your-username>
- *
  * @example
  * ```ts
  * import { LetsFG, searchLocal } from 'letsfg';
  *
- * // Local search — FREE with GitHub star
+ * // Local search — FREE, no API key
  * const local = await searchLocal('SHA', 'CTU', '2026-03-20');
  *
  * // Full API — search + unlock + book
@@ -188,25 +183,12 @@ declare class OfferExpiredError extends LetsFGError {
 declare class ValidationError extends LetsFGError {
     constructor(message: string, statusCode?: number, response?: Record<string, unknown>, errorCode?: string);
 }
-/**
- * Thrown when GitHub star verification is required.
- * Users must star https://github.com/LetsFG/LetsFG and run:
- *   letsfg star --github <username>
- */
-declare class StarRequiredError extends LetsFGError {
-    constructor(message?: string);
-}
 /** One-line offer summary */
 declare function offerSummary(offer: FlightOffer): string;
 /** Get cheapest offer from search results */
 declare function cheapestOffer(result: FlightSearchResult): FlightOffer | null;
 /**
- * Search flights using 195 local airline connectors — FREE with GitHub star!
- *
- * **GitHub Star Required!**
- * Before using, you must:
- * 1. Star https://github.com/LetsFG/LetsFG
- * 2. Run: letsfg star --github <your-username>
+ * Search flights using 73 local airline connectors — FREE, no API key needed.
  *
  * Requires: pip install letsfg && playwright install chromium
  *
@@ -214,7 +196,6 @@ declare function cheapestOffer(result: FlightSearchResult): FlightOffer | null;
  * @param destination - IATA code (e.g., "CTU")
  * @param dateFrom - Departure date "YYYY-MM-DD"
  * @param options - Optional: currency, adults, limit, etc.
- * @throws {StarRequiredError} If GitHub star not verified
  */
 declare function searchLocal(origin: string, destination: string, dateFrom: string, options?: Partial<SearchOptions>): Promise<FlightSearchResult>;
 declare class LetsFG {
@@ -224,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")
@@ -233,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>>>;
     /**
@@ -301,4 +285,4 @@ declare const BoostedTravel: typeof LetsFG;
 declare const BoostedTravelError: typeof LetsFGError;
 type BoostedTravelConfig = LetsFGConfig;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, type CheckoutProgress, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, StarRequiredError, type UnlockResult, ValidationError, cheapestOffer, LetsFG as default, systemInfo as getSystemInfo, searchLocal as localSearch, offerSummary, searchLocal, systemInfo };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, type CheckoutProgress, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, LetsFG, type LetsFGConfig, LetsFGError, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, type UnlockResult, ValidationError, cheapestOffer, LetsFG as default, systemInfo as getSystemInfo, searchLocal as localSearch, offerSummary, searchLocal, systemInfo };

package/dist/index.js

@@ -39,7 +39,6 @@ __export(index_exports, {
   LetsFGError: () => LetsFGError,
   OfferExpiredError: () => OfferExpiredError,
   PaymentRequiredError: () => PaymentRequiredError,
-  StarRequiredError: () => StarRequiredError,
   ValidationError: () => ValidationError,
   cheapestOffer: () => cheapestOffer,
   default: () => index_default,
@@ -157,12 +156,6 @@ var ValidationError = class extends LetsFGError {
     this.name = "ValidationError";
   }
 };
-var StarRequiredError = class extends LetsFGError {
-  constructor(message = "GitHub star required. Run: letsfg star --github <your-username>") {
-    super(message, 403, {}, "STAR_REQUIRED");
-    this.name = "StarRequiredError";
-  }
-};
 function routeStr(route) {
   if (!route.segments.length) return "";
   const codes = [route.segments[0].origin, ...route.segments.map((s) => s.destination)];
@@ -213,13 +206,8 @@ async function searchLocal(origin, destination, dateFrom, options = {}) {
     child.on("close", (code) => {
       try {
         const data = JSON.parse(stdout);
-        if (data.error) {
-          if (data.error.includes("GitHub star required") || data.error.includes("star required")) {
-            reject(new StarRequiredError(data.error));
-          } else {
-            reject(new LetsFGError(data.error));
-          }
-        } else resolve(data);
+        if (data.error) reject(new LetsFGError(data.error));
+        else resolve(data);
       } catch {
         reject(new LetsFGError(
           `Python search failed (code ${code}): ${stdout || stderr}
@@ -256,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")
@@ -264,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.
@@ -453,6 +456,7 @@ var LetsFG = class {
           "Content-Type": "application/json",
           "X-API-Key": this.apiKey,
           "User-Agent": "LetsFG-js/0.1.0",
+          "X-Client-Type": "js-sdk",
           ...init.headers || {}
         },
         signal: controller.signal
@@ -523,7 +527,6 @@ var BoostedTravelError = LetsFGError;
   LetsFGError,
   OfferExpiredError,
   PaymentRequiredError,
-  StarRequiredError,
   ValidationError,
   cheapestOffer,
   getSystemInfo,

package/dist/index.mjs

@@ -8,14 +8,13 @@ import {
   LetsFGError,
   OfferExpiredError,
   PaymentRequiredError,
-  StarRequiredError,
   ValidationError,
   cheapestOffer,
   index_default,
   offerSummary,
   searchLocal,
   systemInfo
-} from "./chunk-7LYR3CHE.mjs";
+} from "./chunk-RLP7MSF6.mjs";
 export {
   AuthenticationError,
   BoostedTravel,
@@ -26,7 +25,6 @@ export {
   LetsFGError,
   OfferExpiredError,
   PaymentRequiredError,
-  StarRequiredError,
   ValidationError,
   cheapestOffer,
   index_default as default,

package/package.json

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