letsfg 1.0.2 → 1.0.4

package/dist/{chunk-LKAF7U4R.mjs → chunk-ES56QTBU.mjs}

@@ -230,7 +230,7 @@ var LetsFG = class {
     return data ? [data] : [];
   }
   /**
-   * Unlock a flight offer — $1 fee.
+   * Unlock a flight offer — FREE with GitHub star.
    * Confirms price, reserves for 30 minutes.
    */
   async unlock(offerId) {
@@ -256,7 +256,7 @@ var LetsFG = class {
     return this.post("/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (payment token).
+   * Set up payment method (legacy — use linkGithub instead).
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
@@ -265,7 +265,7 @@ var LetsFG = class {
   /**
    * Start automated checkout — drives to payment page, NEVER submits payment.
    *
-   * Requires unlock first ($1 fee). Returns progress with screenshot and
+   * Requires unlock first. Returns progress with screenshot and
    * booking URL for manual completion.
    *
    * @param offerId - Offer ID from search results
@@ -328,6 +328,16 @@ var LetsFG = class {
       child.stdin.end();
     });
   }
+  /**
+   * Link GitHub account for FREE unlimited access.
+   *
+   * Star https://github.com/LetsFG/LetsFG, then call this with your username.
+   * Once verified, access is permanent.
+   */
+  async linkGithub(githubUsername) {
+    this.requireApiKey();
+    return this.post(`/api/v1/agents/link-github?github_username=${encodeURIComponent(githubUsername)}`, {});
+  }
   /**
    * Get current agent profile and usage stats.
    */

package/dist/cli.js

@@ -202,7 +202,7 @@ var LetsFG = class {
     return data ? [data] : [];
   }
   /**
-   * Unlock a flight offer — $1 fee.
+   * Unlock a flight offer — FREE with GitHub star.
    * Confirms price, reserves for 30 minutes.
    */
   async unlock(offerId) {
@@ -228,7 +228,7 @@ var LetsFG = class {
     return this.post("/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (payment token).
+   * Set up payment method (legacy — use linkGithub instead).
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
@@ -237,7 +237,7 @@ var LetsFG = class {
   /**
    * Start automated checkout — drives to payment page, NEVER submits payment.
    *
-   * Requires unlock first ($1 fee). Returns progress with screenshot and
+   * Requires unlock first. Returns progress with screenshot and
    * booking URL for manual completion.
    *
    * @param offerId - Offer ID from search results
@@ -300,6 +300,16 @@ var LetsFG = class {
       child.stdin.end();
     });
   }
+  /**
+   * Link GitHub account for FREE unlimited access.
+   *
+   * Star https://github.com/LetsFG/LetsFG, then call this with your username.
+   * Once verified, access is permanent.
+   */
+  async linkGithub(githubUsername) {
+    this.requireApiKey();
+    return this.post(`/api/v1/agents/link-github?github_username=${encodeURIComponent(githubUsername)}`, {});
+  }
   /**
    * Get current agent profile and usage stats.
    */
@@ -493,7 +503,6 @@ async function cmdUnlock(args) {
   \u2713 Offer unlocked!`);
     console.log(`    Confirmed price: ${result.confirmed_currency} ${result.confirmed_price?.toFixed(2)}`);
     console.log(`    Expires at: ${result.offer_expires_at}`);
-    console.log(`    $1 unlock fee charged`);
     console.log(`
     Next: letsfg book ${offerId} --passenger '{...}' --email you@example.com
 `);
@@ -588,9 +597,50 @@ async function cmdRegister(args) {
     Save your API key:`);
   console.log(`    export LETSFG_API_KEY=${result.api_key}`);
   console.log(`
-    Next: LetsFG setup-payment --token tok_visa
+    Next: Star the repo and link your GitHub:`);
+  console.log(`    1. Star https://github.com/LetsFG/LetsFG`);
+  console.log(`    2. letsfg star --github <your-github-username>
 `);
 }
+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 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");
   const apiKey = getFlag(args, "--api-key", "-k");
@@ -627,7 +677,16 @@ async function cmdMe(args) {
   Agent: ${p.agent_name} (${p.agent_id})`);
   console.log(`  Email: ${p.email}`);
   console.log(`  Tier:  ${p.tier}`);
-  console.log(`  Payment: ${p.payment_ready ? "\u2713 Ready" : "\u2717 Not set up"}`);
+  const gh = p.github_username || "";
+  const starOk = p.github_star_verified || false;
+  if (starOk) {
+    console.log(`  GitHub:  \u2713 ${gh} (star verified \u2014 unlimited access)`);
+  } else if (gh) {
+    console.log(`  GitHub:  ${gh} (star not verified)`);
+  } else {
+    console.log(`  GitHub:  Not linked \u2014 run: letsfg star --github <username>`);
+  }
+  console.log(`  Payment: ${p.payment_ready ? "\u2713 Ready" : "\u2014"}`);
   console.log(`  Searches: ${u.total_searches || 0}`);
   console.log(`  Unlocks:  ${u.total_unlocks || 0}`);
   console.log(`  Bookings: ${u.total_bookings || 0}`);
@@ -638,15 +697,16 @@ var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
 Search 400+ airlines at raw airline prices \u2014 $20-50 cheaper than OTAs.
-Search is FREE. Unlock: $1. Book: FREE after unlock.
+100% FREE \u2014 just star our GitHub repo for unlimited access.
 
 Commands:
   search <origin> <dest> <date>   Search for flights (FREE)
   locations <query>               Resolve city name to IATA codes
-  unlock <offer_id>               Unlock offer ($1)
+  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                   Set up payment card
+  setup-payment                   Legacy payment setup
   me                              Show agent profile
 
 Options:
@@ -655,10 +715,11 @@ 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 search LON BCN 2026-04-01 --return 2026-04-08 --json
   letsfg unlock off_xxx
-  letsfg book off_xxx -p '{"id":"pas_xxx","given_name":"John","family_name":"Doe","born_on":"1990-01-15"}' -e john@ex.com
+  letsfg book off_xxx -p '{"id":"pas_xxx",...}' -e john@ex.com
 `;
 async function main() {
   const args = process.argv.slice(2);
@@ -680,6 +741,9 @@ async function main() {
       case "register":
         await cmdRegister(args);
         break;
+      case "star":
+        await cmdStar(args);
+        break;
       case "setup-payment":
         await cmdSetupPayment(args);
         break;

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-LKAF7U4R.mjs";
+} from "./chunk-ES56QTBU.mjs";
 
 // src/cli.ts
 function getFlag(args, flag, alias) {
@@ -124,7 +124,6 @@ async function cmdUnlock(args) {
   \u2713 Offer unlocked!`);
     console.log(`    Confirmed price: ${result.confirmed_currency} ${result.confirmed_price?.toFixed(2)}`);
     console.log(`    Expires at: ${result.offer_expires_at}`);
-    console.log(`    $1 unlock fee charged`);
     console.log(`
     Next: letsfg book ${offerId} --passenger '{...}' --email you@example.com
 `);
@@ -219,9 +218,50 @@ async function cmdRegister(args) {
     Save your API key:`);
   console.log(`    export LETSFG_API_KEY=${result.api_key}`);
   console.log(`
-    Next: LetsFG setup-payment --token tok_visa
+    Next: Star the repo and link your GitHub:`);
+  console.log(`    1. Star https://github.com/LetsFG/LetsFG`);
+  console.log(`    2. letsfg star --github <your-github-username>
 `);
 }
+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 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");
   const apiKey = getFlag(args, "--api-key", "-k");
@@ -258,7 +298,16 @@ async function cmdMe(args) {
   Agent: ${p.agent_name} (${p.agent_id})`);
   console.log(`  Email: ${p.email}`);
   console.log(`  Tier:  ${p.tier}`);
-  console.log(`  Payment: ${p.payment_ready ? "\u2713 Ready" : "\u2717 Not set up"}`);
+  const gh = p.github_username || "";
+  const starOk = p.github_star_verified || false;
+  if (starOk) {
+    console.log(`  GitHub:  \u2713 ${gh} (star verified \u2014 unlimited access)`);
+  } else if (gh) {
+    console.log(`  GitHub:  ${gh} (star not verified)`);
+  } else {
+    console.log(`  GitHub:  Not linked \u2014 run: letsfg star --github <username>`);
+  }
+  console.log(`  Payment: ${p.payment_ready ? "\u2713 Ready" : "\u2014"}`);
   console.log(`  Searches: ${u.total_searches || 0}`);
   console.log(`  Unlocks:  ${u.total_unlocks || 0}`);
   console.log(`  Bookings: ${u.total_bookings || 0}`);
@@ -269,15 +318,16 @@ var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
 Search 400+ airlines at raw airline prices \u2014 $20-50 cheaper than OTAs.
-Search is FREE. Unlock: $1. Book: FREE after unlock.
+100% FREE \u2014 just star our GitHub repo for unlimited access.
 
 Commands:
   search <origin> <dest> <date>   Search for flights (FREE)
   locations <query>               Resolve city name to IATA codes
-  unlock <offer_id>               Unlock offer ($1)
+  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                   Set up payment card
+  setup-payment                   Legacy payment setup
   me                              Show agent profile
 
 Options:
@@ -286,10 +336,11 @@ 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 search LON BCN 2026-04-01 --return 2026-04-08 --json
   letsfg unlock off_xxx
-  letsfg book off_xxx -p '{"id":"pas_xxx","given_name":"John","family_name":"Doe","born_on":"1990-01-15"}' -e john@ex.com
+  letsfg book off_xxx -p '{"id":"pas_xxx",...}' -e john@ex.com
 `;
 async function main() {
   const args = process.argv.slice(2);
@@ -311,6 +362,9 @@ async function main() {
       case "register":
         await cmdRegister(args);
         break;
+      case "star":
+        await cmdStar(args);
+        break;
       case "setup-payment":
         await cmdSetupPayment(args);
         break;

package/dist/index.d.mts

@@ -218,7 +218,7 @@ declare class LetsFG {
      */
     resolveLocation(query: string): Promise<Array<Record<string, unknown>>>;
     /**
-     * Unlock a flight offer — $1 fee.
+     * Unlock a flight offer — FREE with GitHub star.
      * Confirms price, reserves for 30 minutes.
      */
     unlock(offerId: string): Promise<UnlockResult>;
@@ -230,13 +230,13 @@ declare class LetsFG {
      */
     book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string): Promise<BookingResult>;
     /**
-     * Set up payment method (payment token).
+     * Set up payment method (legacy — use linkGithub instead).
      */
     setupPayment(token?: string): Promise<Record<string, unknown>>;
     /**
      * Start automated checkout — drives to payment page, NEVER submits payment.
      *
-     * Requires unlock first ($1 fee). Returns progress with screenshot and
+     * Requires unlock first. Returns progress with screenshot and
      * booking URL for manual completion.
      *
      * @param offerId - Offer ID from search results
@@ -253,6 +253,13 @@ declare class LetsFG {
      * @param checkoutToken - Token from unlock()
      */
     startCheckoutLocal(offer: FlightOffer, passengers: Passenger[], checkoutToken: string): Promise<CheckoutProgress>;
+    /**
+     * Link GitHub account for FREE unlimited access.
+     *
+     * Star https://github.com/LetsFG/LetsFG, then call this with your username.
+     * Once verified, access is permanent.
+     */
+    linkGithub(githubUsername: string): Promise<Record<string, unknown>>;
     /**
      * Get current agent profile and usage stats.
      */

package/dist/index.d.ts

@@ -218,7 +218,7 @@ declare class LetsFG {
      */
     resolveLocation(query: string): Promise<Array<Record<string, unknown>>>;
     /**
-     * Unlock a flight offer — $1 fee.
+     * Unlock a flight offer — FREE with GitHub star.
      * Confirms price, reserves for 30 minutes.
      */
     unlock(offerId: string): Promise<UnlockResult>;
@@ -230,13 +230,13 @@ declare class LetsFG {
      */
     book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string): Promise<BookingResult>;
     /**
-     * Set up payment method (payment token).
+     * Set up payment method (legacy — use linkGithub instead).
      */
     setupPayment(token?: string): Promise<Record<string, unknown>>;
     /**
      * Start automated checkout — drives to payment page, NEVER submits payment.
      *
-     * Requires unlock first ($1 fee). Returns progress with screenshot and
+     * Requires unlock first. Returns progress with screenshot and
      * booking URL for manual completion.
      *
      * @param offerId - Offer ID from search results
@@ -253,6 +253,13 @@ declare class LetsFG {
      * @param checkoutToken - Token from unlock()
      */
     startCheckoutLocal(offer: FlightOffer, passengers: Passenger[], checkoutToken: string): Promise<CheckoutProgress>;
+    /**
+     * Link GitHub account for FREE unlimited access.
+     *
+     * Star https://github.com/LetsFG/LetsFG, then call this with your username.
+     * Once verified, access is permanent.
+     */
+    linkGithub(githubUsername: string): Promise<Record<string, unknown>>;
     /**
      * Get current agent profile and usage stats.
      */

package/dist/index.js

@@ -280,7 +280,7 @@ var LetsFG = class {
     return data ? [data] : [];
   }
   /**
-   * Unlock a flight offer — $1 fee.
+   * Unlock a flight offer — FREE with GitHub star.
    * Confirms price, reserves for 30 minutes.
    */
   async unlock(offerId) {
@@ -306,7 +306,7 @@ var LetsFG = class {
     return this.post("/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (payment token).
+   * Set up payment method (legacy — use linkGithub instead).
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
@@ -315,7 +315,7 @@ var LetsFG = class {
   /**
    * Start automated checkout — drives to payment page, NEVER submits payment.
    *
-   * Requires unlock first ($1 fee). Returns progress with screenshot and
+   * Requires unlock first. Returns progress with screenshot and
    * booking URL for manual completion.
    *
    * @param offerId - Offer ID from search results
@@ -378,6 +378,16 @@ var LetsFG = class {
       child.stdin.end();
     });
   }
+  /**
+   * Link GitHub account for FREE unlimited access.
+   *
+   * Star https://github.com/LetsFG/LetsFG, then call this with your username.
+   * Once verified, access is permanent.
+   */
+  async linkGithub(githubUsername) {
+    this.requireApiKey();
+    return this.post(`/api/v1/agents/link-github?github_username=${encodeURIComponent(githubUsername)}`, {});
+  }
   /**
    * Get current agent profile and usage stats.
    */

package/dist/index.mjs

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

package/package.json

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