boostedtravel 0.1.0

package/dist/index.js

@@ -0,0 +1,228 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthenticationError: () => AuthenticationError,
+  BoostedTravel: () => BoostedTravel,
+  BoostedTravelError: () => BoostedTravelError,
+  PaymentRequiredError: () => PaymentRequiredError,
+  cheapestOffer: () => cheapestOffer,
+  default: () => index_default,
+  offerSummary: () => offerSummary
+});
+module.exports = __toCommonJS(index_exports);
+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;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  BoostedTravel,
+  BoostedTravelError,
+  PaymentRequiredError,
+  cheapestOffer,
+  offerSummary
+});

package/dist/index.mjs

@@ -0,0 +1,18 @@
+import {
+  AuthenticationError,
+  BoostedTravel,
+  BoostedTravelError,
+  PaymentRequiredError,
+  cheapestOffer,
+  index_default,
+  offerSummary
+} from "./chunk-GIJTJ3JU.mjs";
+export {
+  AuthenticationError,
+  BoostedTravel,
+  BoostedTravelError,
+  PaymentRequiredError,
+  cheapestOffer,
+  index_default as default,
+  offerSummary
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "boostedtravel",
+  "version": "0.1.0",
+  "description": "Agent-native flight search & booking. 300+ airlines, cheaper than OTAs. Built for autonomous AI agents.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "boostedtravel": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "flights",
+    "travel",
+    "booking",
+    "agent",
+    "ai",
+    "cli",
+    "autonomous",
+    "mcp",
+    "openai",
+    "airline",
+    "ndc",
+    "search",
+    "ndc"
+  ],
+  "author": "BoostedTravel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boostedtravel/boostedtravel-js"
+  },
+  "homepage": "https://boostedchat.com",
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}