@hazardprep/core

Multi-hazard personal risk assessment engine using federal open data (FEMA, USGS, NOAA).

Enter any US address and get a composite risk profile covering floods, earthquakes, wildfires, hurricanes, tornadoes, and more.

Install

npm install @hazardprep/core

Quick Start

import { HazardScorer } from '@hazardprep/core';

const scorer = new HazardScorer();
const profile = await scorer.assess('1600 Pennsylvania Ave, Washington, DC');

console.log(profile.overallScore);    // 45
console.log(profile.overallLevel);    // 'moderate'
console.log(profile.topRisks);        // [{ type: 'flood', score: 68, ... }, ...]
console.log(profile.recommendations); // [{ title: 'Flood Preparedness', ... }]

Data Sources

All data comes from free, public US federal government APIs:

| Provider | Data | API | |----------|------|-----| | FEMA | Disaster declarations, National Risk Index | OpenFEMA | | USGS | Earthquake history & seismic hazard | USGS Earthquake Hazards | | NOAA | Active weather alerts, severe storms | NWS API | | NIFC | Active wildfires, fire perimeters | NIFC Open Data |

No API keys required.

Custom Providers

Extend BaseProvider to add your own data source:

import { BaseProvider, HazardType, scoreToLevel } from '@hazardprep/core';
import type { HazardScore, Location } from '@hazardprep/core';

class MyCustomProvider extends BaseProvider {
  readonly id = 'my-provider';
  readonly name = 'My Custom Data Source';
  readonly hazardTypes = [HazardType.Flood];

  protected async assess(location: Location): Promise<HazardScore[]> {
    // Fetch from your data source
    const score = 42;
    return [{
      type: HazardType.Flood,
      score,
      level: scoreToLevel(score),
      description: 'Custom flood risk assessment',
      source: { name: 'My Source', url: 'https://example.com' },
    }];
  }
}

const scorer = new HazardScorer({ providers: [new MyCustomProvider()] });

License

Apache 2.0