letsfg 1.4.1 → 1.6.0

package/dist/{chunk-7LYR3CHE.mjs → chunk-GXEB2JO2.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}
@@ -402,6 +391,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 +460,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)];
@@ -369,6 +363,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 +605,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 +698,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 +716,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 +763,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-GXEB2JO2.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 {
@@ -301,4 +282,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 {
@@ -301,4 +282,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}
@@ -453,6 +441,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 +512,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-GXEB2JO2.mjs";
 export {
   AuthenticationError,
   BoostedTravel,
@@ -26,7 +25,6 @@ export {
   LetsFGError,
   OfferExpiredError,
   PaymentRequiredError,
-  StarRequiredError,
   ValidationError,
   cheapestOffer,
   index_default as default,

package/package.json

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