boostedtravel 0.1.0

package/README.md

@@ -0,0 +1,81 @@
+# BoostedTravel — Agent-Native Flight Search & Booking (Node.js)
+
+Search 300+ airlines at prices **$10-30 cheaper** than booking.com, Kayak, and other OTAs. Zero dependencies. Built for autonomous AI agents.
+
+## Install
+
+```bash
+npm install boostedtravel
+```
+
+## Quick Start (SDK)
+
+```typescript
+import { BoostedTravel, cheapestOffer, offerSummary } from 'boostedtravel';
+
+// Register (one-time)
+const creds = await BoostedTravel.register('my-agent', 'agent@example.com');
+console.log(creds.api_key); // Save this
+
+// Use
+const bt = new BoostedTravel({ apiKey: 'trav_...' });
+
+// Search — FREE
+const flights = await bt.search('GDN', 'BER', '2026-03-03');
+const best = cheapestOffer(flights);
+console.log(offerSummary(best));
+
+// Unlock — $1
+const unlock = await bt.unlock(best.id);
+
+// Book — 2.5% fee
+const booking = await bt.book(
+  best.id,
+  [{
+    id: flights.passenger_ids[0],
+    given_name: 'John',
+    family_name: 'Doe',
+    born_on: '1990-01-15',
+    gender: 'm',
+    title: 'mr',
+    email: 'john@example.com',
+  }],
+  'john@example.com'
+);
+console.log(`PNR: ${booking.booking_reference}`);
+```
+
+## Quick Start (CLI)
+
+```bash
+export BOOSTEDTRAVEL_API_KEY=trav_...
+
+boostedtravel search GDN BER 2026-03-03 --sort price
+boostedtravel search LON BCN 2026-04-01 --json  # Machine-readable
+boostedtravel unlock off_xxx
+boostedtravel book off_xxx -p '{"id":"pas_xxx","given_name":"John",...}' -e john@example.com
+```
+
+## API
+
+### `new BoostedTravel({ apiKey, baseUrl?, timeout? })`
+
+### `bt.search(origin, destination, dateFrom, options?)`
+### `bt.resolveLocation(query)`
+### `bt.unlock(offerId)`
+### `bt.book(offerId, passengers, contactEmail, contactPhone?)`
+### `bt.setupPayment(token?)`
+### `bt.me()`
+### `BoostedTravel.register(agentName, email, baseUrl?, ownerName?, description?)`
+
+### Helpers
+- `offerSummary(offer)` — One-line string summary
+- `cheapestOffer(result)` — Get cheapest offer from search
+
+## Zero Dependencies
+
+Uses native `fetch` (Node 18+). No `axios`, no `node-fetch`, nothing. Safe for sandboxed environments.
+
+## License
+
+MIT

package/dist/chunk-GIJTJ3JU.mjs

@@ -0,0 +1,199 @@
+// src/index.ts
+var BoostedTravelError = class extends Error {
+  statusCode;
+  response;
+  constructor(message, statusCode = 0, response = {}) {
+    super(message);
+    this.name = "BoostedTravelError";
+    this.statusCode = statusCode;
+    this.response = response;
+  }
+};
+var AuthenticationError = class extends BoostedTravelError {
+  constructor(message, response = {}) {
+    super(message, 401, response);
+    this.name = "AuthenticationError";
+  }
+};
+var PaymentRequiredError = class extends BoostedTravelError {
+  constructor(message, response = {}) {
+    super(message, 402, response);
+    this.name = "PaymentRequiredError";
+  }
+};
+function routeStr(route) {
+  if (!route.segments.length) return "";
+  const codes = [route.segments[0].origin, ...route.segments.map((s) => s.destination)];
+  return codes.join(" \u2192 ");
+}
+function durationHuman(seconds) {
+  const h = Math.floor(seconds / 3600);
+  const m = Math.floor(seconds % 3600 / 60);
+  return `${h}h${m.toString().padStart(2, "0")}m`;
+}
+function offerSummary(offer) {
+  const route = routeStr(offer.outbound);
+  const dur = durationHuman(offer.outbound.total_duration_seconds);
+  const airline = offer.owner_airline || offer.airlines[0] || "?";
+  return `${offer.currency} ${offer.price.toFixed(2)} | ${airline} | ${route} | ${dur} | ${offer.outbound.stopovers} stop(s)`;
+}
+function cheapestOffer(result) {
+  if (!result.offers.length) return null;
+  return result.offers.reduce((min, o) => o.price < min.price ? o : min, result.offers[0]);
+}
+var DEFAULT_BASE_URL = "https://api.boostedchat.com";
+var BoostedTravel = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config = {}) {
+    this.apiKey = config.apiKey || process.env.BOOSTEDTRAVEL_API_KEY || "";
+    this.baseUrl = (config.baseUrl || process.env.BOOSTEDTRAVEL_BASE_URL || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeout = config.timeout || 3e4;
+    if (!this.apiKey) {
+      throw new AuthenticationError(
+        "API key required. Set apiKey in config or BOOSTEDTRAVEL_API_KEY env var. Get one: POST /api/v1/agents/register"
+      );
+    }
+  }
+  // ── Core methods ─────────────────────────────────────────────────────
+  /**
+   * Search for flights — FREE, unlimited.
+   *
+   * @param origin - IATA code (e.g., "GDN", "LON")
+   * @param destination - IATA code (e.g., "BER", "BCN")
+   * @param dateFrom - Departure date "YYYY-MM-DD"
+   * @param options - Optional search parameters
+   */
+  async search(origin, destination, dateFrom, options = {}) {
+    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);
+  }
+  /**
+   * Resolve a city/airport name to IATA codes.
+   */
+  async resolveLocation(query) {
+    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] : [];
+  }
+  /**
+   * Unlock a flight offer — $1 fee.
+   * Confirms price, reserves for 30 minutes.
+   */
+  async unlock(offerId) {
+    return this.post("/api/v1/bookings/unlock", { offer_id: offerId });
+  }
+  /**
+   * Book a flight — 2.5% service fee.
+   * Creates a real airline reservation with PNR.
+   */
+  async book(offerId, passengers, contactEmail, contactPhone = "") {
+    return this.post("/api/v1/bookings/book", {
+      offer_id: offerId,
+      booking_type: "flight",
+      passengers,
+      contact_email: contactEmail,
+      contact_phone: contactPhone
+    });
+  }
+  /**
+   * Set up payment method (payment token).
+   */
+  async setupPayment(token = "tok_visa") {
+    return this.post("/api/v1/agents/setup-payment", { token });
+  }
+  /**
+   * Get current agent profile and usage stats.
+   */
+  async me() {
+    return this.get("/api/v1/agents/me");
+  }
+  // ── Static methods ───────────────────────────────────────────────────
+  /**
+   * Register a new agent — no API key needed.
+   */
+  static async register(agentName, email, baseUrl, ownerName = "", description = "") {
+    const url = (baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const resp = await fetch(`${url}/api/v1/agents/register`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        agent_name: agentName,
+        email,
+        owner_name: ownerName,
+        description
+      })
+    });
+    const data = await resp.json();
+    if (!resp.ok) {
+      throw new BoostedTravelError(
+        data.detail || `Registration failed (${resp.status})`,
+        resp.status,
+        data
+      );
+    }
+    return data;
+  }
+  // ── Internal ────────────────────────────────────────────────────────
+  async post(path, body) {
+    return this.request(path, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  async get(path) {
+    return this.request(path, { method: "GET" });
+  }
+  async request(path, init) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const resp = await fetch(`${this.baseUrl}${path}`, {
+        ...init,
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.apiKey,
+          "User-Agent": "boostedtravel-js/0.1.0",
+          ...init.headers || {}
+        },
+        signal: controller.signal
+      });
+      const data = await resp.json();
+      if (!resp.ok) {
+        const detail = data.detail || `API error (${resp.status})`;
+        if (resp.status === 401) throw new AuthenticationError(detail, data);
+        if (resp.status === 402) throw new PaymentRequiredError(detail, data);
+        throw new BoostedTravelError(detail, resp.status, data);
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+var index_default = BoostedTravel;
+
+export {
+  BoostedTravelError,
+  AuthenticationError,
+  PaymentRequiredError,
+  offerSummary,
+  cheapestOffer,
+  BoostedTravel,
+  index_default
+};

package/dist/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node