us-gov-open-data-mcp 1.0.0

package/dist/sdk/bls.js

@@ -0,0 +1,203 @@
+/**
+ * BLS SDK — typed API client for the Bureau of Labor Statistics Public Data API v2.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getSeriesData, searchPopularSeries } from "us-gov-open-data/sdk/bls";
+ *
+ * Optional BLS_API_KEY env var — get one at https://www.bls.gov/developers/home.htm
+ * Without key: 25 req/day, 10yr max range, no calculations.
+ * With key: 500 req/day, 20yr range, calculations enabled.
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.bls.gov/publicAPI/v2",
+    name: "bls",
+    auth: {
+        type: "body",
+        key: "registrationkey",
+        envVar: "BLS_API_KEY",
+        extraParams: { calculations: "true", annualaverage: "true" },
+    },
+    rateLimit: { perSecond: 2, burst: 5 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour — BLS data updates monthly
+    checkError: (data) => {
+        const d = data;
+        return d?.status === "REQUEST_NOT_PROCESSED" ? (d.message?.join("; ") ?? "Error") : null;
+    },
+});
+// ─── Reference data ──────────────────────────────────────────────────
+export const seriesPrefixes = {
+    CES: "Current Employment Statistics (establishment survey — jobs by industry)",
+    LNS: "Labor Force Statistics, seasonally adjusted (household survey)",
+    LNU: "Labor Force Statistics, not seasonally adjusted",
+    CU: "Consumer Price Index (CPI-U, urban consumers)",
+    CW: "Consumer Price Index (CPI-W, wage earners)",
+    WP: "Producer Price Index (PPI)",
+    OE: "Occupational Employment and Wages (OES)",
+    JT: "Job Openings and Labor Turnover Survey (JOLTS)",
+    LA: "Local Area Unemployment Statistics (LAUS)",
+    SM: "State and Metro Area Employment (CES)",
+    EN: "Quarterly Census of Employment and Wages (QCEW)",
+    PR: "Productivity and Costs",
+    EI: "Employment Cost Index (ECI)",
+    AP: "Average Price Data",
+};
+export const popularSeries = [
+    // Employment
+    { id: "CES0000000001", name: "Total nonfarm employment (thousands)", category: "employment" },
+    { id: "CES0500000001", name: "Total private employment (thousands)", category: "employment" },
+    { id: "CES1000000001", name: "Mining and logging", category: "employment" },
+    { id: "CES2000000001", name: "Construction", category: "employment" },
+    { id: "CES3000000001", name: "Manufacturing", category: "employment" },
+    { id: "CES4000000001", name: "Trade, transportation, utilities", category: "employment" },
+    { id: "CES5000000001", name: "Information", category: "employment" },
+    { id: "CES5500000001", name: "Financial activities", category: "employment" },
+    { id: "CES6000000001", name: "Professional and business services", category: "employment" },
+    { id: "CES6500000001", name: "Education and health services", category: "employment" },
+    { id: "CES7000000001", name: "Leisure and hospitality", category: "employment" },
+    { id: "CES8000000001", name: "Other services", category: "employment" },
+    { id: "CES9000000001", name: "Government", category: "employment" },
+    // Unemployment
+    { id: "LNS14000000", name: "Unemployment rate (seasonally adjusted)", category: "unemployment" },
+    { id: "LNS14000003", name: "Unemployment rate - White", category: "unemployment" },
+    { id: "LNS14000006", name: "Unemployment rate - Black/African American", category: "unemployment" },
+    { id: "LNS14000009", name: "Unemployment rate - Hispanic/Latino", category: "unemployment" },
+    { id: "LNS11300000", name: "Labor force participation rate", category: "unemployment" },
+    { id: "LNS12300000", name: "Employment-population ratio", category: "unemployment" },
+    { id: "LNS13023621", name: "U-6 (broader unemployment measure)", category: "unemployment" },
+    // Wages
+    { id: "CES0500000003", name: "Average hourly earnings, total private", category: "wages" },
+    { id: "CES0500000011", name: "Average weekly earnings, total private", category: "wages" },
+    { id: "CES0500000008", name: "Average hourly earnings, production workers", category: "wages" },
+    { id: "CES3000000003", name: "Average hourly earnings, manufacturing", category: "wages" },
+    { id: "CES6562000003", name: "Average hourly earnings, healthcare", category: "wages" },
+    // CPI
+    { id: "CUUR0000SA0", name: "CPI-U All Items", category: "cpi" },
+    { id: "CUUR0000SA0L1E", name: "CPI-U All items less food and energy (core)", category: "cpi" },
+    { id: "CUUR0000SAF1", name: "CPI-U Food", category: "cpi_components" },
+    { id: "CUUR0000SAH1", name: "CPI-U Shelter/Housing", category: "cpi_components" },
+    { id: "CUUR0000SETB01", name: "CPI-U Gasoline", category: "cpi_components" },
+    { id: "CUUR0000SAM", name: "CPI-U Medical Care", category: "cpi_components" },
+    { id: "CUUR0000SAE", name: "CPI-U Education & Communication", category: "cpi_components" },
+    { id: "CUUR0000SAT", name: "CPI-U Transportation", category: "cpi_components" },
+    { id: "CUUR0000SAR", name: "CPI-U Recreation", category: "cpi_components" },
+    { id: "CUUR0000SAA", name: "CPI-U Apparel", category: "cpi_components" },
+    // PPI
+    { id: "WPUFD4", name: "PPI - Finished goods", category: "ppi" },
+    { id: "WPUFD49104", name: "PPI - Finished consumer foods", category: "ppi" },
+    { id: "WPSSOP3000", name: "PPI - Total services", category: "ppi" },
+    // Productivity
+    { id: "PRS85006092", name: "Nonfarm business labor productivity", category: "productivity" },
+    { id: "PRS85006112", name: "Nonfarm business unit labor costs", category: "productivity" },
+    // JOLTS
+    { id: "JTS000000000000000JOR", name: "Job openings rate", category: "jolts" },
+    { id: "JTS000000000000000HIR", name: "Hires rate", category: "jolts" },
+    { id: "JTS000000000000000TSR", name: "Total separations rate", category: "jolts" },
+    { id: "JTS000000000000000QUR", name: "Quits rate", category: "jolts" },
+    { id: "JTS000000000000000LDR", name: "Layoffs and discharges rate", category: "jolts" },
+];
+/** State FIPS codes for constructing LAUS series IDs. */
+export const stateFips = {
+    AL: "01", AK: "02", AZ: "04", AR: "05", CA: "06", CO: "08", CT: "09",
+    DE: "10", DC: "11", FL: "12", GA: "13", HI: "15", ID: "16", IL: "17",
+    IN: "18", IA: "19", KS: "20", KY: "21", LA: "22", ME: "23", MD: "24",
+    MA: "25", MI: "26", MN: "27", MS: "28", MO: "29", MT: "30", NE: "31",
+    NV: "32", NH: "33", NJ: "34", NM: "35", NY: "36", NC: "37", ND: "38",
+    OH: "39", OK: "40", OR: "41", PA: "42", RI: "44", SC: "45", SD: "46",
+    TN: "47", TX: "48", UT: "49", VT: "50", VA: "51", WA: "53", WV: "54",
+    WI: "55", WY: "56", PR: "72", VI: "78", GU: "66", AS: "60", MP: "69",
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/** Fetch time series data from BLS. Posts to /timeseries/data/ with series IDs. */
+export async function getSeriesData(seriesIds, opts = {}) {
+    const body = {
+        seriesid: seriesIds,
+    };
+    if (opts.startYear)
+        body.startyear = String(opts.startYear);
+    if (opts.endYear)
+        body.endyear = String(opts.endYear);
+    return api.post("/timeseries/data/", body);
+}
+/** Local lookup — search popular series by topic. No API call. */
+export function searchPopularSeries(topic) {
+    const t = topic.toLowerCase();
+    return popularSeries.filter(s => s.category === t);
+}
+/** Get state employment series IDs constructed from FIPS codes. */
+export function getStateEmploymentSeries(stateCode) {
+    const fips = stateFips[stateCode.toUpperCase()];
+    if (!fips)
+        return null;
+    const st = stateCode.toUpperCase();
+    return [
+        { id: `LASST${fips}0000000000003`, name: `${st} unemployment rate`, category: "state_employment" },
+        { id: `LASST${fips}0000000000005`, name: `${st} employment`, category: "state_employment" },
+        { id: `LASST${fips}0000000000006`, name: `${st} labor force`, category: "state_employment" },
+        { id: `SMS${fips}000000000000001`, name: `${st} total nonfarm employment`, category: "state_employment" },
+    ];
+}
+/** Get available topic categories. */
+export function getAvailableTopics() {
+    const cats = new Set(popularSeries.map(s => s.category));
+    return [...cats, "state_employment"];
+}
+// ─── CPI component series IDs + labels (used by cpi_breakdown tool) ──
+export const cpiComponents = [
+    "CUUR0000SA0", // All Items
+    "CUUR0000SAF1", // Food
+    "CUUR0000SAH1", // Shelter
+    "CUUR0000SETB01", // Gasoline
+    "CUUR0000SAM", // Medical Care
+    "CUUR0000SAE", // Education & Communication
+    "CUUR0000SAT", // Transportation
+    "CUUR0000SAR", // Recreation
+    "CUUR0000SAA", // Apparel
+];
+export const cpiLabels = {
+    "CUUR0000SA0": "All Items",
+    "CUUR0000SAF1": "Food",
+    "CUUR0000SAH1": "Shelter/Housing",
+    "CUUR0000SETB01": "Gasoline",
+    "CUUR0000SAM": "Medical Care",
+    "CUUR0000SAE": "Education & Communication",
+    "CUUR0000SAT": "Transportation",
+    "CUUR0000SAR": "Recreation",
+    "CUUR0000SAA": "Apparel",
+};
+// ─── Employment by industry series IDs + labels ──────────────────────
+export const industryComponents = [
+    "CES0000000001", // Total nonfarm
+    "CES1000000001", // Mining & logging
+    "CES2000000001", // Construction
+    "CES3000000001", // Manufacturing
+    "CES4000000001", // Trade, transportation, utilities
+    "CES5000000001", // Information
+    "CES5500000001", // Financial activities
+    "CES6000000001", // Professional & business services
+    "CES6500000001", // Education & health
+    "CES7000000001", // Leisure & hospitality
+    "CES8000000001", // Other services
+    "CES9000000001", // Government
+];
+export const industryLabels = {
+    "CES0000000001": "Total Nonfarm",
+    "CES1000000001": "Mining & Logging",
+    "CES2000000001": "Construction",
+    "CES3000000001": "Manufacturing",
+    "CES4000000001": "Trade/Transport/Utilities",
+    "CES5000000001": "Information",
+    "CES5500000001": "Financial Activities",
+    "CES6000000001": "Professional & Business Services",
+    "CES6500000001": "Education & Health",
+    "CES7000000001": "Leisure & Hospitality",
+    "CES8000000001": "Other Services",
+    "CES9000000001": "Government",
+};
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=bls.js.map

package/dist/sdk/bls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bls.js","sourceRoot":"","sources":["../../src/sdk/bls.ts"],"names":[],"mappings":"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"}

package/dist/sdk/bts.d.ts

@@ -0,0 +1,108 @@
+/**
+ * BTS SDK — typed API client for Bureau of Transportation Statistics data.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getTransportStats, getBorderCrossings } from "us-gov-open-data/sdk/bts";
+ *
+ *   const stats = await getTransportStats({ limit: 12 });
+ *   const border = await getBorderCrossings({ state: "Texas", measure: "Trucks" });
+ *
+ * No API key required (uses Socrata SODA API at data.bts.gov).
+ * Docs: https://data.bts.gov/
+ */
+export interface TransportStatsRecord {
+    index?: string;
+    date?: string;
+    u_s_airline_traffic_total_non_seasonally_adjusted?: string;
+    u_s_airline_traffic_domestic_non_seasonally_adjusted?: string;
+    u_s_airline_traffic_international_non_seasonally_adjusted?: string;
+    u_s_marketing_air_carriers_on_time_performance_percent?: string;
+    u_s_air_carrier_cargo_millions_of_revenue_ton_miles_domestic?: string;
+    u_s_air_carrier_cargo_millions_of_revenue_ton_miles_international?: string;
+    system_use_transit_ridership?: string;
+    system_use_highway_vehicle?: string;
+    system_use_freight_rail?: string;
+    passenger_rail_passengers?: string;
+    passenger_rail_passenger_miles?: string;
+    amtrak_on_time_performance?: string;
+    safety_general_aviation?: string;
+    air_safety_air_carrier_fatalities?: string;
+    rail_fatalities?: string;
+    transportation_services_index_freight?: string;
+    transportation_services_index_passenger?: string;
+    transportation_services_index_combined?: string;
+    u_s_canada_incoming_person_crossings?: string;
+    u_s_canada_incoming_truck_crossings?: string;
+    u_s_mexico_incoming_person_crossings?: string;
+    u_s_mexico_incoming_truck_crossings?: string;
+    auto_sales?: string;
+    auto_sales_saar_millions?: string;
+    light_truck_sales?: string;
+    heavy_truck_sales?: string;
+    highway_fuel_prices_regular?: string;
+    truck_tonnage_index?: string;
+    u_s_waterway_tonnage?: string;
+    general_economic_indicators?: string;
+    transportation_economic?: string;
+    [key: string]: unknown;
+}
+export interface BorderCrossingRecord {
+    port_name?: string;
+    state?: string;
+    port_code?: string;
+    border?: string;
+    date?: string;
+    measure?: string;
+    value?: string;
+    latitude?: string;
+    longitude?: string;
+    [key: string]: unknown;
+}
+/** Key fields in the Monthly Transportation Statistics dataset. */
+export declare const TRANSPORT_FIELDS: Record<string, string>;
+/** Border crossing measures. */
+export declare const BORDER_MEASURES: Record<string, string>;
+/** Socrata dataset IDs. */
+export declare const DATASETS: Record<string, {
+    id: string;
+    description: string;
+}>;
+/**
+ * Get Monthly Transportation Statistics (50+ time series in one dataset).
+ * Covers airline traffic, on-time %, transit ridership, rail freight, truck tonnage,
+ * fuel prices, vehicle sales, safety fatalities, Transportation Services Index,
+ * and border crossing summaries.
+ *
+ * Example:
+ *   const data = await getTransportStats({ limit: 24 }); // latest 2 years (monthly)
+ *   const data = await getTransportStats({ startDate: "2020-01-01", endDate: "2023-12-31" });
+ */
+export declare function getTransportStats(opts?: {
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+    order?: string;
+    where?: string;
+}): Promise<TransportStatsRecord[]>;
+/**
+ * Get border crossing data (vehicles, passengers, containers at U.S. ports of entry).
+ *
+ * Example:
+ *   const data = await getBorderCrossings({ state: "Texas", measure: "Trucks" });
+ *   const data = await getBorderCrossings({ border: "US-Mexico Border" });
+ */
+export declare function getBorderCrossings(opts?: {
+    state?: string;
+    border?: string;
+    portName?: string;
+    measure?: string;
+    limit?: number;
+    offset?: number;
+    order?: string;
+    where?: string;
+}): Promise<BorderCrossingRecord[]>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=bts.d.ts.map

package/dist/sdk/bts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bts.d.ts","sourceRoot":"","sources":["../../src/sdk/bts.ts"],"names":[],"mappings":"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"}

package/dist/sdk/bts.js

@@ -0,0 +1,121 @@
+/**
+ * BTS SDK — typed API client for Bureau of Transportation Statistics data.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getTransportStats, getBorderCrossings } from "us-gov-open-data/sdk/bts";
+ *
+ *   const stats = await getTransportStats({ limit: 12 });
+ *   const border = await getBorderCrossings({ state: "Texas", measure: "Trucks" });
+ *
+ * No API key required (uses Socrata SODA API at data.bts.gov).
+ * Docs: https://data.bts.gov/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://data.bts.gov/resource",
+    name: "bts",
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+/** Key fields in the Monthly Transportation Statistics dataset. */
+export const TRANSPORT_FIELDS = {
+    u_s_airline_traffic_total_non_seasonally_adjusted: "U.S. airline passenger traffic (total, not SA)",
+    u_s_marketing_air_carriers_on_time_performance_percent: "Airline on-time performance (%)",
+    system_use_transit_ridership: "Transit ridership",
+    transportation_services_index_freight: "Transportation Services Index — Freight",
+    transportation_services_index_passenger: "Transportation Services Index — Passenger",
+    transportation_services_index_combined: "Transportation Services Index — Combined",
+    truck_tonnage_index: "Truck Tonnage Index",
+    amtrak_on_time_performance: "Amtrak on-time performance",
+    highway_fuel_prices_regular: "Regular gasoline price ($/gallon)",
+    auto_sales_saar_millions: "Auto sales (SAAR, millions)",
+    rail_fatalities: "Rail fatalities",
+    air_safety_air_carrier_fatalities: "Air carrier fatalities",
+};
+/** Border crossing measures. */
+export const BORDER_MEASURES = {
+    Trucks: "Commercial trucks",
+    "Personal Vehicles": "Personal vehicles (cars)",
+    Pedestrians: "Foot traffic",
+    "Train Passengers": "Rail passengers",
+    "Rail Containers Loaded": "Rail freight containers (loaded)",
+    "Rail Containers Empty": "Rail freight containers (empty)",
+    Buses: "Bus crossings",
+};
+/** Socrata dataset IDs. */
+export const DATASETS = {
+    monthly_stats: {
+        id: "crem-w557",
+        description: "Monthly Transportation Statistics: 50+ indicators on airlines, transit, rail, safety, fuel, vehicle sales",
+    },
+    border_crossings: {
+        id: "keg4-3bc2",
+        description: "Border crossing data: vehicles, passengers, containers at U.S. ports of entry (monthly)",
+    },
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Get Monthly Transportation Statistics (50+ time series in one dataset).
+ * Covers airline traffic, on-time %, transit ridership, rail freight, truck tonnage,
+ * fuel prices, vehicle sales, safety fatalities, Transportation Services Index,
+ * and border crossing summaries.
+ *
+ * Example:
+ *   const data = await getTransportStats({ limit: 24 }); // latest 2 years (monthly)
+ *   const data = await getTransportStats({ startDate: "2020-01-01", endDate: "2023-12-31" });
+ */
+export async function getTransportStats(opts) {
+    const params = {
+        $limit: opts?.limit ?? 24,
+        $offset: opts?.offset,
+        $order: opts?.order ?? "date DESC",
+    };
+    const wheres = [];
+    if (opts?.startDate)
+        wheres.push(`date >= '${opts.startDate}'`);
+    if (opts?.endDate)
+        wheres.push(`date <= '${opts.endDate}'`);
+    // Filter out empty placeholder rows
+    wheres.push("general_economic_indicators IS NOT NULL");
+    if (opts?.where)
+        wheres.push(opts.where);
+    if (wheres.length)
+        params.$where = wheres.join(" AND ");
+    return api.get(`/${DATASETS.monthly_stats.id}.json`, params);
+}
+/**
+ * Get border crossing data (vehicles, passengers, containers at U.S. ports of entry).
+ *
+ * Example:
+ *   const data = await getBorderCrossings({ state: "Texas", measure: "Trucks" });
+ *   const data = await getBorderCrossings({ border: "US-Mexico Border" });
+ */
+export async function getBorderCrossings(opts) {
+    const params = {
+        $limit: opts?.limit ?? 20,
+        $offset: opts?.offset,
+        $order: opts?.order ?? "date DESC",
+    };
+    const wheres = [];
+    if (opts?.state)
+        wheres.push(`state='${opts.state}'`);
+    if (opts?.border)
+        wheres.push(`border='${opts.border}'`);
+    if (opts?.portName)
+        wheres.push(`port_name='${opts.portName}'`);
+    if (opts?.measure)
+        wheres.push(`measure='${opts.measure}'`);
+    if (opts?.where)
+        wheres.push(opts.where);
+    if (wheres.length)
+        params.$where = wheres.join(" AND ");
+    return api.get(`/${DATASETS.border_crossings.id}.json`, params);
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=bts.js.map

package/dist/sdk/bts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bts.js","sourceRoot":"","sources":["../../src/sdk/bts.ts"],"names":[],"mappings":"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"}

package/dist/sdk/cdc.d.ts

@@ -0,0 +1,105 @@
+/**
+ * CDC Open Data SDK — health statistics from data.cdc.gov (Socrata SODA API).
+ *
+ * API docs: https://dev.socrata.com/foundry/data.cdc.gov/
+ * No auth required (optional app token for higher rate limits).
+ * Rate limit: 1,000 req/hour without token, 20x with token.
+ *
+ * Usage:
+ *   import { queryDataset, getLeadingCausesOfDeath } from "us-gov-open-data-mcp/sdk/cdc";
+ *   const data = await getLeadingCausesOfDeath({ state: "New York", year: 2021 });
+ */
+export declare const DATASETS: Record<string, {
+    id: string;
+    name: string;
+    description: string;
+}>;
+export interface CdcRecord {
+    [key: string]: string | number | null;
+}
+/** Generic Socrata SODA query against any CDC dataset. */
+export declare function queryDataset(datasetId: string, opts?: {
+    where?: string;
+    select?: string;
+    group?: string;
+    order?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Leading causes of death by state/year. */
+export declare function getLeadingCausesOfDeath(opts?: {
+    state?: string;
+    year?: number;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Life expectancy at birth by race and sex (dataset w9j2-ggv5, 1900–2018). */
+export declare function getLifeExpectancy(opts?: {
+    year?: number;
+    race?: string;
+    sex?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Provisional mortality rates by cause, sex, and state (dataset 489q-934x, quarterly, 2020–present). */
+export declare function getMortalityRates(opts?: {
+    quarter?: string;
+    cause?: string;
+    rateType?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** PLACES county-level health indicators (obesity, diabetes, smoking, depression, etc.). */
+export declare function getPlacesHealth(opts?: {
+    state?: string;
+    measure?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** PLACES city-level health indicators (obesity, diabetes, smoking, depression, etc.). */
+export declare function getPlacesCityHealth(opts?: {
+    state?: string;
+    measure?: string;
+    city?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** COVID-19 weekly cases and deaths by state. */
+export declare function getCovidData(opts?: {
+    state?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Weekly provisional death counts by state — COVID, pneumonia, influenza, total. Updated weekly. */
+export declare function getWeeklyDeaths(opts?: {
+    state?: string;
+    year?: number;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Disability prevalence by state and type from BRFSS. */
+export declare function getDisabilityData(opts?: {
+    state?: string;
+    disabilityType?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+export declare function clearCache(): void;
+/** Drug overdose/poisoning mortality by state (1999–2016). */
+export declare function getDrugOverdoseData(opts?: {
+    state?: string;
+    year?: number;
+    sex?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Nutrition, physical activity, and obesity by state from BRFSS. */
+export declare function getNutritionObesityData(opts?: {
+    state?: string;
+    topic?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Historical age-adjusted death rates for major causes since 1900. */
+export declare function getHistoricalDeathRates(opts?: {
+    cause?: string;
+    startYear?: number;
+    endYear?: number;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+/** Quarterly provisional birth indicators (birth rates, teen births, preterm, cesarean). */
+export declare function getBirthIndicators(opts?: {
+    topic?: string;
+    raceEthnicity?: string;
+    limit?: number;
+}): Promise<CdcRecord[]>;
+//# sourceMappingURL=cdc.d.ts.map

package/dist/sdk/cdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdc.d.ts","sourceRoot":"","sources":["../../src/sdk/cdc.ts"],"names":[],"mappings":"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"}