Module @squawk/navaid-data

@squawk/navaid-data

Pre-processed snapshot of navaid data from the 2026-05-14 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.

Modules


browser