Add ADS-B.lol connector for real-time aircraft tracking

[Copilot]

Closes: #[issue_number]

Description

Implements a TypeScript connector for the ADS-B.lol API, providing real-time aircraft position and telemetry data from ADS-B transponders. The API is public (no authentication), returns all tracked aircraft in a single response (client-side pagination), and is licensed under ODbL 1.0.

Changes

Connector Implementation

• Aircraft resource with list() and get(icao) methods
• 25+ telemetry fields: position (lat/lon), altitude (barometric/GPS), speed, heading, vertical rate, squawk, transponder data
• Filtering: military and interesting aircraft flags
• Client-side pagination: configurable pageSize and maxItems since API returns full dataset

Configuration

• No authentication required (public API)
• Optional: logging (request/response) and metrics collection
• Configurable base URL (defaults to https://api.adsb.lol)

Schema & Documentation

• JSON schema for aircraft endpoint with field descriptions
• Getting started guide, configuration docs, API limits
• 8 tests covering pagination, filtering, ICAO lookups, observability

Example Usage

import { createConnector } from '@workspace/connector-ads-b-dot-lol'

const conn = createConnector()
conn.init() // No auth needed

// List all aircraft with pagination
for await (const page of conn.aircraft.list({ pageSize: 100 })) {
  page.forEach(a => console.log(`${a.flight}: ${a.lat},${a.lon} @ ${a.alt_baro}ft`))
}

// Get specific aircraft by ICAO hex
const aircraft = await conn.aircraft.get('ABC123')

// Filter military aircraft
for await (const page of conn.aircraft.list({ military: true })) {
  // ...
}

Tradeoffs

• Client-side pagination only: API returns all aircraft in one response. Implemented client-side chunking for large result sets since server-side pagination isn't available.
• Minimal error handling: API has no published error codes. Relies on core connector retry/error mechanisms.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Connector request: ADS-B data (from ADSB.lol) (ads-b-dot-lol)</issue_title>
<issue_description>Identifier: ads-b-dot-lol
Name: ADS-B data (from ADSB.lol)
Category: api
Tags: events, telemetry, aviation
Homepage: https://api.adsb.lol/docs

Description:
Aircraft data

{
  "kind": "connector-request",
  "identifier": "ads-b-dot-lol",
  "name": "ADS-B data (from ADSB.lol)",
  "category": "api",
  "tags": [
    "events",
    "telemetry",
    "aviation"
  ],
  "homepage": "https://api.adsb.lol/docs",
  "description": "Aircraft data"
}

Comments on the Issue (you are @copilot in this section)

Custom agent used: connector-implementer
Use this agent when the user is creating a new connector for the 514 Labs Registry, needs guidance on implementing connector resources, or is working on connector scaffolding, testing, or schema definition.

• Fixes Connector request: ADS-B data (from ADSB.lol) (ads-b-dot-lol) #97

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
registry	Error			Nov 5, 2025 11:46pm