Module @squawk/fix-data

@squawk/fix-data

Pre-processed snapshot of fix/waypoint data from the 2026-05-14 FAA NASR cycle. Data only - no query logic, no dependency on @squawk/fixes.

Documentation

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

Coverage

All non-CNF named fixes and waypoints the FAA publishes: US-domestic waypoints, reporting points, VFR waypoints, NRS waypoints, military waypoints/reporting points, and radar fixes, plus selected Canadian, Mexican, Caribbean, and Pacific fixes that participate in US operations
Geographic coordinates (decimal degrees)
Usage category (WP, RP, VFR, NRS, MW, MR, RADAR)
ARTCC assignment (low and high altitude)
Compulsory reporting designation
Operational flags (pitch, catch, SUA/ATCAA)
Minimum reception altitude where published
Chart type associations (IAP, STAR, SID, ENROUTE, etc.)
Navaid associations with bearing and distance

Installation

npm install @squawk/fix-data

Usage

import { usBundledFixes } from '@squawk/fix-data';

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

// Use with @squawk/fixes for zero-config fix queries
import { createFixResolver } from '@squawk/fixes';

const resolver = createFixResolver({ data: usBundledFixes.records });

Consumers who have their own data pipeline can use @squawk/fixes alone and pass any compatible Fix 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 { loadUsBundledFixes } from '@squawk/fix-data/browser';
import { createFixResolver } from '@squawk/fixes/browser';

const dataset = await loadUsBundledFixes();
const resolver = createFixResolver({ 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 { loadUsBundledFixes } from '@squawk/fix-data/browser';

const dataset = await loadUsBundledFixes({
  url: 'https://your-cdn.example/fixes.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 Fix object from @squawk/types. Key fields:

Property	Type	Description
`identifier`	string	Fix identifier (e.g. "MERIT", "BOSCO")
`icaoRegionCode`	string	ICAO region code (e.g. "K6", "K7", "CY" for Canada)
`lat`, `lon`	number	Decimal degrees
`country`	string	Two-letter country code
`state`	string or undefined	Two-letter code for US fixes, absent for foreign
`useCode`	FixUseCode	WP, RP, VFR, NRS, MW, MR, or RADAR
`highArtccId`	string or undefined	High-altitude ARTCC (e.g. "ZNY")
`lowArtccId`	string or undefined	Low-altitude ARTCC
`compulsory`	FixCompulsory or undefined	HIGH, LOW, or LOW/HIGH
`pitch`	boolean	Pitch designation
`catch`	boolean	Catch designation
`suaAtcaa`	boolean	Special Use Airspace / ATCAA association
`minimumReceptionAltitudeFt`	number or undefined	MRA in feet
`chartTypes`	string[]	Charts the fix appears on (IAP, STAR, ENROUTE, etc.)
`navaidAssociations`	FixNavaidAssociation[]	Bearing/distance from nearby navaids

Data source

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

Modules


browser