@squawk/navaid-data

  @squawk/navaid-data

Pre-processed snapshot of navaid data from the 2026-04-16 FAA NASR cycle. Data only - no query logic, no dependency on @squawk/navaids.

Documentation

Part of the @squawk aviation library suite. See all packages on npm.

Coverage

• All non-shutdown navigational aids the FAA publishes: US-domestic VOR, VORTAC, VOR/DME, TACAN, DME, NDB, NDB/DME, fan markers, marine NDBs, and VOTs, plus selected Canadian, Mexican, and Caribbean navaids that participate in US operations
• Frequencies (MHz for VOR-family, kHz for NDB-family) and TACAN channels
• Elevation, magnetic variation, and service volume classification
• ARTCC assignment (low and high altitude)
• Power output, NDB class, operating hours, and simultaneous voice capability
• DME/TACAN component position when different from the main navaid

Installation

npm install @squawk/navaid-data

Usage

import { usBundledNavaids } from '@squawk/navaid-data';

// Inspect metadata
console.log(usBundledNavaids.properties.nasrCycleDate); // YYYY-MM-DD
console.log(usBundledNavaids.properties.recordCount);

// Use with @squawk/navaids for zero-config navaid queries
import { createNavaidResolver } from '@squawk/navaids';

const resolver = createNavaidResolver({ data: usBundledNavaids.records });

Consumers who have their own data pipeline can use @squawk/navaids alone and pass any compatible Navaid array at initialization.

Browser / SPA usage

For browsers, edge runtimes (Cloudflare Workers, Deno Deploy), and any other environment without node:fs, import the async loader from the /browser subpath. It fetches and decompresses the bundled .gz using Web Streams (DecompressionStream) and the global fetch.

import { loadUsBundledNavaids } from '@squawk/navaid-data/browser';
import { createNavaidResolver } from '@squawk/navaids/browser';

const dataset = await loadUsBundledNavaids();
const resolver = createNavaidResolver({ data: dataset.records });

The default URL is resolved relative to this module's import.meta.url, which works under any modern ESM bundler when the package is installed normally.

To host the asset on your own CDN, to use a bundler-resolved (hashed) asset URL, or to override the URL for any other reason, pass an explicit url:

import { loadUsBundledNavaids } from '@squawk/navaid-data/browser';

const dataset = await loadUsBundledNavaids({
  url: 'https://your-cdn.example/navaids.json.gz',
});

The loader also accepts a custom fetch implementation, which is useful in tests or in edge environments that need a configured fetcher.

Data format

Each record is a full Navaid object from @squawk/types. Key fields:

Property	Type	Description
identifier	string	Navaid identifier (e.g. "BOS", "JFK")
name	string	Official facility name (e.g. "BOSTON")
type	NavaidType	VOR, VORTAC, VOR/DME, TACAN, DME, NDB, NDB/DME, etc.
status	NavaidStatus	OPERATIONAL_IFR, OPERATIONAL_RESTRICTED, or OPERATIONAL_VFR
lat, lon	number	Decimal degrees
country	string	Two-letter country code
state	string or undefined	Two-letter code for US navaids, absent for foreign
city	string or undefined	Associated city
elevationFt	number or undefined	Elevation in feet MSL
frequencyMhz	number or undefined	VOR-family frequency in MHz (108.0-117.95)
frequencyKhz	number or undefined	NDB-family frequency in kHz
tacanChannel	string or undefined	TACAN/DME channel (e.g. "84X")
magneticVariationDeg	number or undefined	Magnetic variation in degrees
magneticVariationDirection	string or undefined	"E" or "W"
lowArtccId	string or undefined	Low-altitude ARTCC (e.g. "ZBW")
highArtccId	string or undefined	High-altitude ARTCC
navaidClass	string or undefined	Service volume class (e.g. "VH", "VL", "H", "L", "T")
dmeServiceVolume	string or undefined	DME service volume class
powerOutputWatts	number or undefined	Transmitter power in watts
simultaneousVoice	boolean or undefined	Whether voice is carried on the frequency
ndbClass	string or undefined	NDB classification (e.g. "HH", "MHW", "LOM")

Data source

All data is derived from the FAA National Airspace System Resource (NASR) 28-day subscription, which is public domain. Navaid data comes from NAV_BASE.csv. The build pipeline that produces this dataset lives in tools/build-navaid-data.