letsfg 2026.4.51 → 2026.5.54

package/README.md

@@ -1,13 +1,20 @@
 # LetsFG — Your AI agent just learned to book flights. (Node.js)
 
-**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.
+**200+ airline connectors. 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.
 
 [![GitHub stars](https://img.shields.io/github/stars/LetsFG/LetsFG?style=social)](https://github.com/LetsFG/LetsFG)
 [![npm](https://img.shields.io/npm/v/letsfg)](https://www.npmjs.com/package/letsfg)
 
-> ⭐ **[Star the repo](https://github.com/LetsFG/LetsFG) → register → unlimited access forever.** First 1,000 stars only.
+## Three ways to use LetsFG
+
+| | **Local** (this SDK) | **letsfg.co** (website / agent API) | **Developer API** |
+|---|---|---|---|
+| **Search cost** | Free | Free | Prepaid credits |
+| **Booking URL** | 1% concierge fee (min $3) via letsfg.co | 1% concierge fee (min $3) via letsfg.co | Direct airline URL, no fee |
+| **Speed** | 1–15 min (local browsers) | Seconds | Seconds |
+| **Setup** | `npm install letsfg` | [letsfg.co](https://letsfg.co) | [letsfg.co/developers](https://letsfg.co/developers) |
+
+> **Want direct airline URLs without any per-booking fee?** Use the [Developer API](https://letsfg.co/developers) — prepaid credits, results in seconds, no checkout step.
 
 ## Install
 
@@ -86,6 +93,8 @@ letsfg book off_xxx -p '{"id":"pas_xxx","given_name":"John",...}' -e john@exampl
 
 Search 200 airline connectors locally (no API key needed). Requires Python + `letsfg` installed.
 
+> **Note:** Local search results return masked booking links by default. Each offer includes `offer_ref` and `payment_token` fields. To get a direct airline booking URL, use the **concierge unlock flow** (1% fee, min $3 — no API key needed) or sign up for the **Developer API** at [letsfg.co/developers](https://letsfg.co/developers) for fee-free direct links.
+
 ```typescript
 import { searchLocal } from 'letsfg';
 
@@ -96,6 +105,52 @@ console.log(result.total_results);
 const result2 = await searchLocal('GDN', 'BCN', '2026-06-15', { maxBrowsers: 4 });
 ```
 
+### Unlocking offer results
+
+Local search results include `offer_ref` and `payment_token` on each offer. Use these to retrieve the direct airline booking URL via the concierge flow (no API key required):
+
+```typescript
+import { searchLocal } from 'letsfg';
+
+const result = await searchLocal('GDN', 'BCN', '2026-06-15');
+const offer = result.offers[0];
+
+// 1. Initiate checkout — fee = max(price × 1%, $3.00). No API key needed.
+const checkoutRes = await fetch('https://letsfg.co/api/developers/checkout', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    offer_id:      offer.id,
+    offer_ref:     offer.offer_ref,
+    payment_token: offer.payment_token,
+    currency:      offer.currency,
+    price:         String(offer.price),
+  }),
+});
+const { checkout_url } = await checkoutRes.json();
+
+// 2. Present checkout_url to the user (or open it programmatically)
+console.log(`Pay here: ${checkout_url}`);
+
+// 3. Poll until payment is confirmed
+async function pollVerify(token: string): Promise<string> {
+  while (true) {
+    await new Promise(r => setTimeout(r, 3000));
+    const res = await fetch(
+      `https://letsfg.co/api/developers/payment-verify?token=${token}`
+    );
+    const data = await res.json();
+    if (data.verified) return data.booking_url;
+  }
+}
+
+// 4. booking_url is the direct airline link — no further fees
+const bookingUrl = await pollVerify(offer.payment_token);
+console.log(`Book here: ${bookingUrl}`);
+```
+
+To skip the per-booking fee entirely, use the [Developer API](https://letsfg.co/developers) — it returns direct airline booking URLs on every search result.
+
 ### `systemInfo()`
 
 Get system resource profile and recommended concurrency settings.
@@ -128,10 +183,10 @@ Or set the `LETSFG_MAX_BROWSERS` environment variable globally.
 
 - **MCP Server**: `npx letsfg-mcp` — [npm](https://www.npmjs.com/package/letsfg-mcp)
 - **Python SDK + CLI**: `pip install letsfg` — [PyPI](https://pypi.org/project/letsfg/)
-- **Try without installing**: [Message us on Messenger](https://m.me/61579557368989)
+- **Try without installing**: [letsfg.co](https://letsfg.co) — search instantly in your browser
 - **GitHub**: [LetsFG/LetsFG](https://github.com/LetsFG/LetsFG)
 
-> ⭐ **[Star the repo](https://github.com/LetsFG/LetsFG)** to unlock free access. First 1,000 stars only.
+> ⭐ **[Star the repo](https://github.com/LetsFG/LetsFG)** — we appreciate the support.
 
 ## License
 

package/dist/{chunk-AUXPORRU.mjs → chunk-LBHJ4GE4.mjs}

@@ -176,7 +176,7 @@ Install: pip install letsfg && playwright install chromium`
     child.stdin.end();
   });
 }
-var DEFAULT_BASE_URL = "https://api.letsfg.co";
+var DEFAULT_BASE_URL = "https://letsfg.co/developers";
 var LetsFG = class {
   apiKey;
   baseUrl;

package/dist/cli.js

@@ -197,7 +197,7 @@ Install: pip install letsfg && playwright install chromium`
     child.stdin.end();
   });
 }
-var DEFAULT_BASE_URL = "https://api.letsfg.co";
+var DEFAULT_BASE_URL = "https://letsfg.co/developers";
 var LetsFG = class {
   apiKey;
   baseUrl;
@@ -780,7 +780,7 @@ Commands:
 Options:
   --json, -j       Output raw JSON
   --api-key, -k    API key (or set LETSFG_API_KEY)
-  --base-url       API URL (default: https://api.letsfg.co)
+  --base-url       API URL (default: https://letsfg.co/developers)
 
 Examples:
   letsfg register --name my-agent --email me@example.com

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-AUXPORRU.mjs";
+} from "./chunk-LBHJ4GE4.mjs";
 
 // src/cli.ts
 function getFlag(args, flag, alias) {
@@ -335,7 +335,7 @@ Commands:
 Options:
   --json, -j       Output raw JSON
   --api-key, -k    API key (or set LETSFG_API_KEY)
-  --base-url       API URL (default: https://api.letsfg.co)
+  --base-url       API URL (default: https://letsfg.co/developers)
 
 Examples:
   letsfg register --name my-agent --email me@example.com

package/dist/index.js

@@ -226,7 +226,7 @@ Install: pip install letsfg && playwright install chromium`
     child.stdin.end();
   });
 }
-var DEFAULT_BASE_URL = "https://api.letsfg.co";
+var DEFAULT_BASE_URL = "https://letsfg.co/developers";
 var LetsFG = class {
   apiKey;
   baseUrl;

package/dist/index.mjs

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "letsfg",
-  "version": "2026.4.51",
-  "description": "Agent-native flight search & booking. 200 airline connectors run locally + enterprise GDS/NDC APIs. Built for autonomous AI agents.",
+  "version": "2026.5.54",
+  "description": "Flight search & booking for AI agents. 200+ airline connectors run locally. Free search — get direct booking URLs via letsfg.co or the Developer API.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",