us-gov-open-data-mcp 1.0.0

package/dist/sdk/eia.d.ts

@@ -0,0 +1,91 @@
+/**
+ * EIA SDK — typed API client for the U.S. Energy Information Administration API v2.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { queryEia } from "us-gov-open-data/sdk/eia";
+ *
+ * Requires EIA_API_KEY env var — register at https://www.eia.gov/opendata/register.php
+ */
+export interface EiaResponse {
+    response: {
+        total: number;
+        data: EiaObservation[];
+        description?: string;
+        dateFormat?: string;
+        frequency?: string;
+    };
+    request?: Record<string, unknown>;
+}
+export interface EiaObservation {
+    period: string;
+    value: number | string | null;
+    units?: string;
+    unit?: string;
+    "series-description"?: string;
+    seriesDescription?: string;
+    series?: string;
+    stateDescription?: string;
+    stateid?: string;
+    stateId?: string;
+    sectorName?: string;
+    sectorid?: string;
+    msn?: string;
+    process?: string;
+    [key: string]: unknown;
+}
+export interface EiaRoute {
+    path: string;
+    description: string;
+    frequency: string[];
+    facets?: string[];
+}
+export declare const sedsMsnCodes: Record<string, string>;
+export declare const routes: EiaRoute[];
+/**
+ * Query the EIA API v2.
+ * Uses bracket-style params: data[0], facets[series][], sort[0][column], etc.
+ * String arrays produce repeated keys automatically via createClient.
+ */
+export declare function queryEia(route: string, params?: Record<string, string | number | string[] | undefined>): Promise<EiaResponse>;
+/** Get petroleum data (spot prices, gasoline, diesel). */
+export declare function getPetroleum(opts?: {
+    product?: string;
+    frequency?: string;
+    start?: string;
+    end?: string;
+    length?: number;
+}): Promise<EiaResponse>;
+/** Get electricity data (retail sales, prices, etc.). */
+export declare function getElectricity(opts?: {
+    state?: string;
+    sector?: string;
+    dataType?: string;
+    frequency?: string;
+    start?: string;
+    length?: number;
+}): Promise<EiaResponse>;
+/** Get natural gas prices. */
+export declare function getNaturalGas(opts?: {
+    process?: string;
+    frequency?: string;
+    start?: string;
+    length?: number;
+}): Promise<EiaResponse>;
+/** Get state energy profile data (SEDS). */
+export declare function getStateEnergy(opts?: {
+    state?: string;
+    msn?: string;
+    start?: string;
+    length?: number;
+}): Promise<EiaResponse>;
+/** Get total energy overview. */
+export declare function getTotalEnergy(opts?: {
+    msn?: string;
+    frequency?: string;
+    start?: string;
+    length?: number;
+}): Promise<EiaResponse>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=eia.d.ts.map

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

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

package/dist/sdk/eia.js

@@ -0,0 +1,156 @@
+/**
+ * EIA SDK — typed API client for the U.S. Energy Information Administration API v2.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { queryEia } from "us-gov-open-data/sdk/eia";
+ *
+ * Requires EIA_API_KEY env var — register at https://www.eia.gov/opendata/register.php
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.eia.gov/v2",
+    name: "eia",
+    auth: {
+        type: "query",
+        key: "api_key",
+        envVar: "EIA_API_KEY",
+    },
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour — EIA data updates infrequently
+    checkError: (data) => data?.error ?? null,
+});
+// ─── Reference data ──────────────────────────────────────────────────
+export const sedsMsnCodes = {
+    TETCB: "Total energy consumption (trillion BTU)",
+    TETCD: "Total energy consumption per capita",
+    TEPRB: "Total energy production (trillion BTU)",
+    ESTCB: "Electricity total consumption",
+    CLTCB: "Coal consumption",
+    NNTCB: "Natural gas consumption",
+    PATCB: "Petroleum consumption (all products)",
+    RETCB: "Renewable energy consumption",
+    NUETB: "Nuclear energy consumption",
+    ELISB: "Electricity interstate flow",
+    TETXB: "Total energy expenditures",
+};
+export const routes = [
+    { path: "/petroleum/pri/spt/data", description: "Petroleum spot prices (WTI, Brent)", frequency: ["daily", "weekly", "monthly", "annual"], facets: ["series"] },
+    { path: "/petroleum/pri/gnd/data", description: "Retail gasoline and diesel prices", frequency: ["weekly", "monthly", "annual"], facets: ["series", "product", "duoarea"] },
+    { path: "/petroleum/crd/crpdn/data", description: "Crude oil production", frequency: ["monthly", "annual"], facets: ["duoarea", "product"] },
+    { path: "/petroleum/sum/snd/data", description: "Petroleum supply and disposition", frequency: ["weekly", "monthly", "annual"] },
+    { path: "/petroleum/stoc/wstk/data", description: "Weekly petroleum stocks", frequency: ["weekly"], facets: ["product", "duoarea"] },
+    { path: "/petroleum/move/imp/data", description: "Petroleum imports", frequency: ["monthly", "annual"], facets: ["product", "originCountry"] },
+    { path: "/electricity/retail-sales/data", description: "Electricity retail sales, revenue, prices, customers", frequency: ["monthly", "annual"], facets: ["stateid", "sectorid"] },
+    { path: "/electricity/electric-power-operational-data/data", description: "Power plant operational data", frequency: ["monthly", "annual"], facets: ["stateid", "sectorid", "fueltypeid"] },
+    { path: "/electricity/state-electricity-profiles/emissions-by-state-by-fuel/data", description: "CO2 emissions by state and fuel", frequency: ["annual"], facets: ["stateid"] },
+    { path: "/natural-gas/pri/sum/data", description: "Natural gas prices summary", frequency: ["monthly", "annual"], facets: ["process", "duoarea"] },
+    { path: "/natural-gas/sum/snd/data", description: "Natural gas supply and disposition", frequency: ["monthly", "annual"] },
+    { path: "/natural-gas/prod/sum/data", description: "Natural gas production", frequency: ["monthly", "annual"] },
+    { path: "/coal/production/data", description: "Coal production", frequency: ["quarterly", "annual"] },
+    { path: "/coal/consumption-and-quality/data", description: "Coal consumption", frequency: ["quarterly", "annual"] },
+    { path: "/seds/data", description: "State energy profiles (SEDS)", frequency: ["annual"], facets: ["stateId", "msn"] },
+    { path: "/total-energy/data", description: "Monthly Energy Review — total US energy overview", frequency: ["monthly", "annual"], facets: ["msn"] },
+    { path: "/aeo/data", description: "Annual Energy Outlook projections", frequency: ["annual"] },
+    { path: "/international/data", description: "International energy data", frequency: ["monthly", "annual"] },
+    { path: "/nuclear/status-operable-units/data", description: "Nuclear power plant status", frequency: ["monthly"] },
+];
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Query the EIA API v2.
+ * Uses bracket-style params: data[0], facets[series][], sort[0][column], etc.
+ * String arrays produce repeated keys automatically via createClient.
+ */
+export async function queryEia(route, params = {}) {
+    const normalizedRoute = route.startsWith("/") ? route : `/${route}`;
+    return api.get(`${normalizedRoute}`, params);
+}
+/** Get petroleum data (spot prices, gasoline, diesel). */
+export async function getPetroleum(opts = {}) {
+    const productMap = {
+        crude: "/petroleum/pri/spt/data",
+        gasoline: "/petroleum/pri/gnd/data",
+        diesel: "/petroleum/pri/gnd/data",
+        all: "/petroleum/pri/spt/data",
+    };
+    const prod = (opts.product || "crude").toLowerCase();
+    const route = productMap[prod] || "/petroleum/pri/spt/data";
+    const params = {
+        frequency: opts.frequency || "monthly",
+        "data[0]": "value",
+        start: opts.start || `${new Date().getFullYear() - 2}-01`,
+        length: opts.length || 60,
+        "sort[0][column]": "period",
+        "sort[0][direction]": "desc",
+    };
+    if (opts.end)
+        params.end = opts.end;
+    if (prod === "crude")
+        params["facets[product][]"] = "EPCWTI";
+    return queryEia(route, params);
+}
+/** Get electricity data (retail sales, prices, etc.). */
+export async function getElectricity(opts = {}) {
+    const params = {
+        frequency: opts.frequency || "monthly",
+        "data[0]": opts.dataType || "price",
+        start: opts.start || `${new Date().getFullYear() - 2}-01`,
+        length: opts.length || 60,
+        "sort[0][column]": "period",
+        "sort[0][direction]": "desc",
+    };
+    if (opts.state)
+        params["facets[stateid][]"] = opts.state.toUpperCase();
+    if (opts.sector)
+        params["facets[sectorid][]"] = opts.sector.toUpperCase();
+    return queryEia("/electricity/retail-sales/data", params);
+}
+/** Get natural gas prices. */
+export async function getNaturalGas(opts = {}) {
+    const params = {
+        frequency: opts.frequency || "monthly",
+        "data[0]": "value",
+        start: opts.start || `${new Date().getFullYear() - 2}-01`,
+        length: opts.length || 60,
+        "sort[0][column]": "period",
+        "sort[0][direction]": "desc",
+    };
+    if (opts.process)
+        params["facets[process][]"] = opts.process.toUpperCase();
+    return queryEia("/natural-gas/pri/sum/data", params);
+}
+/** Get state energy profile data (SEDS). */
+export async function getStateEnergy(opts = {}) {
+    const params = {
+        frequency: "annual",
+        "data[0]": "value",
+        start: opts.start || String(new Date().getFullYear() - 5),
+        length: opts.length || 60,
+        "sort[0][column]": "period",
+        "sort[0][direction]": "desc",
+    };
+    if (opts.state)
+        params["facets[stateId][]"] = opts.state.toUpperCase();
+    params["facets[msn][]"] = (opts.msn || "TETCB").toUpperCase();
+    return queryEia("/seds/data", params);
+}
+/** Get total energy overview. */
+export async function getTotalEnergy(opts = {}) {
+    const params = {
+        frequency: opts.frequency || "monthly",
+        "data[0]": "value",
+        start: opts.start || `${new Date().getFullYear() - 2}-01`,
+        length: opts.length || 60,
+        "sort[0][column]": "period",
+        "sort[0][direction]": "desc",
+    };
+    if (opts.msn)
+        params["facets[msn][]"] = opts.msn.toUpperCase();
+    return queryEia("/total-energy/data", params);
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=eia.js.map

package/dist/sdk/eia.js.map

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

package/dist/sdk/epa.d.ts

@@ -0,0 +1,128 @@
+/**
+ * EPA SDK — typed API client for EPA Envirofacts and ECHO (Enforcement & Compliance) APIs.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getAirQuality, searchFacilities, getUVIndex } from "us-gov-open-data/sdk/epa";
+ *
+ *   const aq = await getAirQuality({ state: "CA" });
+ *   console.log(aq);
+ *
+ *   const facilities = await searchFacilities({ state: "NY", mediaType: "air", majorOnly: true });
+ *   console.log(facilities);
+ *
+ *   const uv = await getUVIndex("10001");
+ *   console.log(uv);
+ *
+ * No API key required.
+ * Docs:
+ *   Envirofacts: https://www.epa.gov/enviro/web-services
+ *   ECHO: https://echo.epa.gov/tools/web-services
+ */
+export interface AirQualityMeasure {
+    STATE_ABBR?: string;
+    STATE_NAME?: string;
+    COUNTY_NAME?: string;
+    CBSA_NAME?: string;
+    MEASURE_NAME?: string;
+    MEASURE_ID?: number;
+    UNIT_OF_MEASURE?: string;
+    VALUE?: number;
+    YEAR?: number;
+    [key: string]: unknown;
+}
+export interface EchoFacility {
+    CWPName?: string;
+    RegistryID?: string;
+    FacName?: string;
+    FacStreet?: string;
+    FacCity?: string;
+    FacState?: string;
+    FacZip?: string;
+    FacLat?: number;
+    FacLong?: number;
+    FacSICCodes?: string;
+    FacNAICSCodes?: string;
+    CurrSvFlag?: string;
+    CurrVioFlag?: string;
+    Src?: string;
+    [key: string]: unknown;
+}
+export interface EchoSearchResult {
+    Results: {
+        Message: string;
+        TotalPenalties?: string;
+        FEAFlag?: string;
+        CVRows?: string;
+        Facilities?: EchoFacility[];
+        [key: string]: unknown;
+    };
+}
+export interface EchoFacilityDetail {
+    Results: {
+        Message: string;
+        Permits?: Record<string, unknown>[];
+        Violations?: Record<string, unknown>[];
+        Actions?: Record<string, unknown>[];
+        [key: string]: unknown;
+    };
+}
+export interface UVForecast {
+    ZIP?: string;
+    DATE_TIME?: string;
+    UV_INDEX?: number;
+    UV_ALERT?: number;
+    ORDER?: number;
+    [key: string]: unknown;
+}
+/** Common Envirofacts tables for air quality data. */
+export declare const AIR_TABLES: Record<string, string>;
+/** ECHO media types for facility searches. */
+export declare const MEDIA_TYPES: Record<string, string>;
+/** UV Index scale descriptions. */
+export declare const UV_INDEX_SCALE: Record<string, string>;
+/**
+ * Get air quality measures from EPA Envirofacts.
+ *
+ * Example:
+ *   const data = await getAirQuality({ state: "CA" });
+ *   const data = await getAirQuality({ state: "NY", rows: "0:49" });
+ */
+export declare function getAirQuality(opts: {
+    state: string;
+    rows?: string;
+    table?: string;
+}): Promise<AirQualityMeasure[]>;
+/**
+ * Search EPA-regulated facilities via ECHO (Enforcement & Compliance History Online).
+ *
+ * Example:
+ *   const air = await searchFacilities({ state: "TX", mediaType: "air", majorOnly: true });
+ *   const water = await searchFacilities({ state: "CA", mediaType: "water", activeOnly: true });
+ */
+export declare function searchFacilities(opts: {
+    state: string;
+    mediaType?: "air" | "water";
+    majorOnly?: boolean;
+    activeOnly?: boolean;
+    responseset?: number;
+    zip?: string;
+    penaltyRange?: string;
+}): Promise<EchoSearchResult>;
+/**
+ * Get detailed facility report from ECHO including permits, violations, and enforcement actions.
+ *
+ * Example:
+ *   const detail = await getFacilityDetail("110000350016");
+ */
+export declare function getFacilityDetail(registryId: string): Promise<EchoFacilityDetail>;
+/**
+ * Get UV index forecast by ZIP code from EPA Envirofacts.
+ *
+ * Example:
+ *   const forecast = await getUVIndex("90210");
+ */
+export declare function getUVIndex(zip: string): Promise<UVForecast[]>;
+/** Clear cached responses from both clients. */
+export declare function clearCache(): void;
+//# sourceMappingURL=epa.d.ts.map

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

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

package/dist/sdk/epa.js

@@ -0,0 +1,120 @@
+/**
+ * EPA SDK — typed API client for EPA Envirofacts and ECHO (Enforcement & Compliance) APIs.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getAirQuality, searchFacilities, getUVIndex } from "us-gov-open-data/sdk/epa";
+ *
+ *   const aq = await getAirQuality({ state: "CA" });
+ *   console.log(aq);
+ *
+ *   const facilities = await searchFacilities({ state: "NY", mediaType: "air", majorOnly: true });
+ *   console.log(facilities);
+ *
+ *   const uv = await getUVIndex("10001");
+ *   console.log(uv);
+ *
+ * No API key required.
+ * Docs:
+ *   Envirofacts: https://www.epa.gov/enviro/web-services
+ *   ECHO: https://echo.epa.gov/tools/web-services
+ */
+import { createClient } from "../client.js";
+// ─── Clients ─────────────────────────────────────────────────────────
+const envirofacts = createClient({
+    baseUrl: "https://enviro.epa.gov/enviro/efservice",
+    name: "epa-envirofacts",
+    rateLimit: { perSecond: 3, burst: 8 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+const echo = createClient({
+    baseUrl: "https://echo.epa.gov/api",
+    name: "epa-echo",
+    rateLimit: { perSecond: 3, burst: 8 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+/** Common Envirofacts tables for air quality data. */
+export const AIR_TABLES = {
+    AIR_QUALITY_MEASURES: "County-level air quality summary measures",
+    GETGISAIR: "GIS-enabled air facility data",
+};
+/** ECHO media types for facility searches. */
+export const MEDIA_TYPES = {
+    air: "Clean Air Act (CAA) facilities",
+    water: "Clean Water Act (CWA) facilities",
+};
+/** UV Index scale descriptions. */
+export const UV_INDEX_SCALE = {
+    "0-2": "Low — minimal danger for average person",
+    "3-5": "Moderate — take precautions (hat, sunscreen)",
+    "6-7": "High — protection required, reduce sun exposure",
+    "8-10": "Very High — extra protection, avoid midday sun",
+    "11+": "Extreme — unprotected skin can burn in minutes",
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Get air quality measures from EPA Envirofacts.
+ *
+ * Example:
+ *   const data = await getAirQuality({ state: "CA" });
+ *   const data = await getAirQuality({ state: "NY", rows: "0:49" });
+ */
+export async function getAirQuality(opts) {
+    const table = opts.table ?? "AIR_QUALITY_MEASURES";
+    const rows = opts.rows ?? "0:99";
+    return envirofacts.get(`/${table}/STATE_ABBR/${opts.state.toUpperCase()}/ROWS/${rows}/JSON`);
+}
+/**
+ * Search EPA-regulated facilities via ECHO (Enforcement & Compliance History Online).
+ *
+ * Example:
+ *   const air = await searchFacilities({ state: "TX", mediaType: "air", majorOnly: true });
+ *   const water = await searchFacilities({ state: "CA", mediaType: "water", activeOnly: true });
+ */
+export async function searchFacilities(opts) {
+    const endpoint = opts.mediaType === "water"
+        ? "/cwa-facility-search"
+        : "/air-facility-search";
+    const params = {
+        output: "JSON",
+        p_st: opts.state.toUpperCase(),
+        responseset: opts.responseset ?? 20,
+    };
+    if (opts.majorOnly)
+        params.p_pc = "MAJOR";
+    if (opts.activeOnly)
+        params.p_act = "Y";
+    if (opts.zip)
+        params.p_zip = opts.zip;
+    if (opts.penaltyRange)
+        params.p_penalty = opts.penaltyRange;
+    return echo.get(endpoint, params);
+}
+/**
+ * Get detailed facility report from ECHO including permits, violations, and enforcement actions.
+ *
+ * Example:
+ *   const detail = await getFacilityDetail("110000350016");
+ */
+export async function getFacilityDetail(registryId) {
+    return echo.get("/detailed-facility-report", {
+        p_id: registryId,
+        output: "JSON",
+    });
+}
+/**
+ * Get UV index forecast by ZIP code from EPA Envirofacts.
+ *
+ * Example:
+ *   const forecast = await getUVIndex("90210");
+ */
+export async function getUVIndex(zip) {
+    return envirofacts.get(`/getEnvirofactsUVDAILY/ZIP/${zip}/JSON`);
+}
+/** Clear cached responses from both clients. */
+export function clearCache() {
+    envirofacts.clearCache();
+    echo.clearCache();
+}
+//# sourceMappingURL=epa.js.map

package/dist/sdk/epa.js.map

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

package/dist/sdk/fbi.d.ts

@@ -0,0 +1,48 @@
+/**
+ * FBI Crime Data Explorer SDK — typed API client.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getCrimeByState, getNationalCrime } from "us-gov-open-data/sdk/fbi";
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://crime-data-explorer.fr.cloud.gov/pages/docApi
+ */
+export interface CrimeEstimate {
+    year?: number;
+    data_year?: number;
+    population?: number;
+    violent_crime?: number;
+    property_crime?: number;
+    homicide?: number;
+    robbery?: number;
+    aggravated_assault?: number;
+    burglary?: number;
+    larceny?: number;
+    motor_vehicle_theft?: number;
+    rape?: number;
+    arson?: number;
+    [key: string]: unknown;
+}
+export interface ArrestRecord {
+    year?: number;
+    data_year?: number;
+    total_arrests?: number;
+    value?: number;
+    arrest_count?: number;
+    [key: string]: unknown;
+}
+/** Get crime estimates for a U.S. state. */
+export declare function getCrimeByState(state: string, startYear?: number, endYear?: number): Promise<CrimeEstimate[]>;
+/** Get national crime estimates. */
+export declare function getNationalCrime(startYear?: number, endYear?: number): Promise<CrimeEstimate[]>;
+/** Get arrest statistics. Optionally filter by state and/or offense. */
+export declare function getArrestData(opts?: {
+    state?: string;
+    offense?: string;
+    startYear?: number;
+    endYear?: number;
+}): Promise<ArrestRecord[]>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=fbi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fbi.d.ts","sourceRoot":"","sources":["../../src/sdk/fbi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBD,4CAA4C;AAC5C,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1B;AAED,oCAAoC;AACpC,wBAAsB,gBAAgB,CACpC,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAK1B;AAED,wEAAwE;AACxE,wBAAsB,aAAa,CAAC,IAAI,GAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAe/B;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/sdk/fbi.js

@@ -0,0 +1,69 @@
+/**
+ * FBI Crime Data Explorer SDK — typed API client.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getCrimeByState, getNationalCrime } from "us-gov-open-data/sdk/fbi";
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://crime-data-explorer.fr.cloud.gov/pages/docApi
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.usa.gov/crime/fbi/sapi",
+    name: "fbi",
+    auth: { type: "query", key: "API_KEY", envVar: "DATA_GOV_API_KEY" },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour — crime data updates infrequently
+});
+// ─── Internal: extract results from inconsistent response shapes ─────
+function extractResults(res) {
+    if (Array.isArray(res))
+        return res;
+    if (typeof res === "object" && res !== null) {
+        const obj = res;
+        if (Array.isArray(obj.results))
+            return obj.results;
+        if (Array.isArray(obj.data))
+            return obj.data;
+    }
+    return [];
+}
+// ─── Public API ──────────────────────────────────────────────────────
+/** Get crime estimates for a U.S. state. */
+export async function getCrimeByState(state, startYear, endYear) {
+    const stateAbbr = state.toUpperCase();
+    const start = startYear ?? new Date().getFullYear() - 5;
+    const end = endYear ?? new Date().getFullYear();
+    const res = await api.get(`/api/estimates/states/${stateAbbr}/${start}/${end}`);
+    return extractResults(res);
+}
+/** Get national crime estimates. */
+export async function getNationalCrime(startYear, endYear) {
+    const start = startYear ?? new Date().getFullYear() - 5;
+    const end = endYear ?? new Date().getFullYear();
+    const res = await api.get(`/api/estimates/national/${start}/${end}`);
+    return extractResults(res);
+}
+/** Get arrest statistics. Optionally filter by state and/or offense. */
+export async function getArrestData(opts = {}) {
+    const start = opts.startYear ?? new Date().getFullYear() - 5;
+    const end = opts.endYear ?? new Date().getFullYear();
+    let path;
+    if (opts.state && opts.offense) {
+        path = `/api/arrest/states/offense/${opts.state.toUpperCase()}/${opts.offense}/${start}/${end}`;
+    }
+    else if (opts.state) {
+        path = `/api/arrest/states/${opts.state.toUpperCase()}/${start}/${end}`;
+    }
+    else {
+        path = `/api/arrest/national/${start}/${end}`;
+    }
+    const res = await api.get(path);
+    return extractResults(res);
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=fbi.js.map

package/dist/sdk/fbi.js.map

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