letsfg 2026.5.56 → 2026.5.58

package/dist/{chunk-3GLZR3AT.mjs → chunk-I2JLOQPR.mjs}

@@ -1612,7 +1612,7 @@ var LetsFG = class {
       const result = await this.getNoAuth(
         `/api/results/${search_id}`
       );
-      if (result.status !== "pending") {
+      if (!["pending", "searching"].includes(result.status)) {
         return result;
       }
     }
@@ -1653,7 +1653,11 @@ var LetsFG = class {
     return this.post("/developers/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (required before unlock/booking).
+   * [Developer API only] Attach a card to a PAID prepaid Developer API account.
+   *
+   * Most agents should NOT call this. It is unrelated to authenticating for
+   * search and booking — for that, run `letsfg auth`, which puts a card on file
+   * through a zero-amount setup and creates no billing account.
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
@@ -1668,7 +1672,10 @@ var LetsFG = class {
   }
   // ── Static methods ───────────────────────────────────────────────────
   /**
-   * Register a new Developer API agent — no auth needed.
+   * [Developer API only] Create a PAID Developer API account with its own billing.
+   *
+   * Most agents should NOT call this — it creates a billing account you probably
+   * do not want. To search and book flights, run `letsfg auth` instead.
    */
   static async register(agentName, email, baseUrl, ownerName = "", description = "") {
     const url = (baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");

package/dist/cli.js

@@ -367,7 +367,7 @@ var LetsFG = class {
       const result = await this.getNoAuth(
         `/api/results/${search_id}`
       );
-      if (result.status !== "pending") {
+      if (!["pending", "searching"].includes(result.status)) {
         return result;
       }
     }
@@ -408,7 +408,11 @@ var LetsFG = class {
     return this.post("/developers/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (required before unlock/booking).
+   * [Developer API only] Attach a card to a PAID prepaid Developer API account.
+   *
+   * Most agents should NOT call this. It is unrelated to authenticating for
+   * search and booking — for that, run `letsfg auth`, which puts a card on file
+   * through a zero-amount setup and creates no billing account.
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
@@ -423,7 +427,10 @@ var LetsFG = class {
   }
   // ── Static methods ───────────────────────────────────────────────────
   /**
-   * Register a new Developer API agent — no auth needed.
+   * [Developer API only] Create a PAID Developer API account with its own billing.
+   *
+   * Most agents should NOT call this — it creates a billing account you probably
+   * do not want. To search and book flights, run `letsfg auth` instead.
    */
   static async register(agentName, email, baseUrl, ownerName = "", description = "") {
     const url = (baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
@@ -764,27 +771,31 @@ var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
 Search hundreds of airlines via the LetsFG cloud engine.
-Free search: authenticate once with Twitter/X, then search instantly.
+Authenticate once with letsfg auth \u2014 a zero-amount card setup, nothing is
+charged \u2014 then search and book.
 
 Commands:
+  auth                            Put a card on file -> 90-day token. Nothing charged
   search <origin> <dest> <date>   Search for flights (free)
   locations <query>               Resolve city name to IATA codes
-  unlock <offer_id>               Unlock offer \u2014 1% of ticket (min $3)
-  book <offer_id> --passenger ... Book flight \u2014 charges ticket price via Stripe
-  register --name ... --email ... Register for a Developer API key
-  setup-payment                   Attach Stripe payment method
+  book <offer_id> --passenger ... Book a flight. No LetsFG fee
   me                              Show agent profile
 
+Developer API only (a SEPARATE paid product \u2014 most agents should not use these;
+they create a billing account. Use auth above instead):
+  register --name ... --email ... Create a paid Developer API account
+  setup-payment                   Attach a card to that paid account
+  unlock <offer_id>               Unlock offer \u2014 1% of ticket (min $3)
+
 Options:
   --json, -j       Output raw JSON
   --api-key, -k    API key (or set LETSFG_API_KEY)
   --base-url       API URL (default: https://letsfg.co/developers)
 
 Examples:
-  letsfg register --name my-agent --email me@example.com
+  letsfg auth
   letsfg search GDN BER 2026-03-03 --sort price
-  letsfg unlock off_xxx
-  letsfg book off_xxx -p '{"id":"pas_xxx",...}' -e john@ex.com
+  letsfg book off_xxx -p '{"given_name":"Ada",...}' -e ada@example.com
 `;
 async function main() {
   const args = process.argv.slice(2);

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   LetsFG,
   LetsFGError,
   offerSummary
-} from "./chunk-3GLZR3AT.mjs";
+} from "./chunk-I2JLOQPR.mjs";
 
 // src/cli.ts
 function getFlag(args, flag, alias) {
@@ -274,27 +274,31 @@ var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
 Search hundreds of airlines via the LetsFG cloud engine.
-Free search: authenticate once with Twitter/X, then search instantly.
+Authenticate once with letsfg auth \u2014 a zero-amount card setup, nothing is
+charged \u2014 then search and book.
 
 Commands:
+  auth                            Put a card on file -> 90-day token. Nothing charged
   search <origin> <dest> <date>   Search for flights (free)
   locations <query>               Resolve city name to IATA codes
-  unlock <offer_id>               Unlock offer \u2014 1% of ticket (min $3)
-  book <offer_id> --passenger ... Book flight \u2014 charges ticket price via Stripe
-  register --name ... --email ... Register for a Developer API key
-  setup-payment                   Attach Stripe payment method
+  book <offer_id> --passenger ... Book a flight. No LetsFG fee
   me                              Show agent profile
 
+Developer API only (a SEPARATE paid product \u2014 most agents should not use these;
+they create a billing account. Use auth above instead):
+  register --name ... --email ... Create a paid Developer API account
+  setup-payment                   Attach a card to that paid account
+  unlock <offer_id>               Unlock offer \u2014 1% of ticket (min $3)
+
 Options:
   --json, -j       Output raw JSON
   --api-key, -k    API key (or set LETSFG_API_KEY)
   --base-url       API URL (default: https://letsfg.co/developers)
 
 Examples:
-  letsfg register --name my-agent --email me@example.com
+  letsfg auth
   letsfg search GDN BER 2026-03-03 --sort price
-  letsfg unlock off_xxx
-  letsfg book off_xxx -p '{"id":"pas_xxx",...}' -e john@ex.com
+  letsfg book off_xxx -p '{"given_name":"Ada",...}' -e ada@example.com
 `;
 async function main() {
   const args = process.argv.slice(2);

package/dist/index.d.mts

@@ -481,7 +481,11 @@ declare class LetsFG {
      */
     book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string): Promise<BookingResult>;
     /**
-     * Set up payment method (required before unlock/booking).
+     * [Developer API only] Attach a card to a PAID prepaid Developer API account.
+     *
+     * Most agents should NOT call this. It is unrelated to authenticating for
+     * search and booking — for that, run `letsfg auth`, which puts a card on file
+     * through a zero-amount setup and creates no billing account.
      */
     setupPayment(token?: string): Promise<Record<string, unknown>>;
     /**
@@ -489,7 +493,10 @@ declare class LetsFG {
      */
     me(): Promise<Record<string, unknown>>;
     /**
-     * Register a new Developer API agent — no auth needed.
+     * [Developer API only] Create a PAID Developer API account with its own billing.
+     *
+     * Most agents should NOT call this — it creates a billing account you probably
+     * do not want. To search and book flights, run `letsfg auth` instead.
      */
     static register(agentName: string, email: string, baseUrl?: string, ownerName?: string, description?: string): Promise<Record<string, unknown>>;
     private postWithBearer;

package/dist/index.d.ts

@@ -481,7 +481,11 @@ declare class LetsFG {
      */
     book(offerId: string, passengers: Passenger[], contactEmail: string, contactPhone?: string, idempotencyKey?: string): Promise<BookingResult>;
     /**
-     * Set up payment method (required before unlock/booking).
+     * [Developer API only] Attach a card to a PAID prepaid Developer API account.
+     *
+     * Most agents should NOT call this. It is unrelated to authenticating for
+     * search and booking — for that, run `letsfg auth`, which puts a card on file
+     * through a zero-amount setup and creates no billing account.
      */
     setupPayment(token?: string): Promise<Record<string, unknown>>;
     /**
@@ -489,7 +493,10 @@ declare class LetsFG {
      */
     me(): Promise<Record<string, unknown>>;
     /**
-     * Register a new Developer API agent — no auth needed.
+     * [Developer API only] Create a PAID Developer API account with its own billing.
+     *
+     * Most agents should NOT call this — it creates a billing account you probably
+     * do not want. To search and book flights, run `letsfg auth` instead.
      */
     static register(agentName: string, email: string, baseUrl?: string, ownerName?: string, description?: string): Promise<Record<string, unknown>>;
     private postWithBearer;

package/dist/index.js

@@ -1660,7 +1660,7 @@ var LetsFG = class {
       const result = await this.getNoAuth(
         `/api/results/${search_id}`
       );
-      if (result.status !== "pending") {
+      if (!["pending", "searching"].includes(result.status)) {
         return result;
       }
     }
@@ -1701,7 +1701,11 @@ var LetsFG = class {
     return this.post("/developers/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (required before unlock/booking).
+   * [Developer API only] Attach a card to a PAID prepaid Developer API account.
+   *
+   * Most agents should NOT call this. It is unrelated to authenticating for
+   * search and booking — for that, run `letsfg auth`, which puts a card on file
+   * through a zero-amount setup and creates no billing account.
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
@@ -1716,7 +1720,10 @@ var LetsFG = class {
   }
   // ── Static methods ───────────────────────────────────────────────────
   /**
-   * Register a new Developer API agent — no auth needed.
+   * [Developer API only] Create a PAID Developer API account with its own billing.
+   *
+   * Most agents should NOT call this — it creates a billing account you probably
+   * do not want. To search and book flights, run `letsfg auth` instead.
    */
   static async register(agentName, email, baseUrl, ownerName = "", description = "") {
     const url = (baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");

package/dist/index.mjs

@@ -22,7 +22,7 @@ import {
   offerSummary,
   rankOffers,
   selectDiverseTop
-} from "./chunk-3GLZR3AT.mjs";
+} from "./chunk-I2JLOQPR.mjs";
 export {
   AuthenticationError,
   BoostedTravel,

package/package.json

@@ -1,52 +1,52 @@
-{
-  "name": "letsfg",
-  "version": "2026.5.56",
-  "description": "Flight search & booking for AI agents. Server-side engine covers hundreds of airlines. Free search via Bearer token or prepaid Developer API. Includes open-source ranking engine.",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "letsfg": "dist/cli.js"
-  },
-  "files": [
-    "dist/",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean",
-    "test": "tsx --test src/index.test.ts",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "flights",
-    "travel",
-    "booking",
-    "agent",
-    "ai",
-    "cli",
-    "autonomous",
-    "mcp",
-    "openai",
-    "airline",
-    "ndc",
-    "search",
-    "ndc"
-  ],
-  "author": "LetsFG",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/LetsFG/LetsFG.git"
-  },
-  "homepage": "https://letsfg.co",
-  "devDependencies": {
-    "@types/node": "^25.3.3",
-    "tsup": "^8.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "letsfg",
+  "version": "2026.5.58",
+  "description": "Flight search & booking for AI agents. Server-side engine covers hundreds of airlines. Free search via Bearer token or prepaid Developer API. Includes open-source ranking engine.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "letsfg": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean",
+    "test": "tsx --test src/index.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "flights",
+    "travel",
+    "booking",
+    "agent",
+    "ai",
+    "cli",
+    "autonomous",
+    "mcp",
+    "openai",
+    "airline",
+    "ndc",
+    "search",
+    "ndc"
+  ],
+  "author": "LetsFG",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LetsFG/LetsFG.git"
+  },
+  "homepage": "https://letsfg.co",
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "tsup": "^8.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}