us-gov-open-data-mcp 1.0.0

package/dist/sdk/noaa.js

@@ -0,0 +1,64 @@
+/**
+ * NOAA Climate Data Online SDK — weather, temperature, precipitation data.
+ *
+ * API docs: https://www.ncei.noaa.gov/cdo-web/webservices/v2
+ * Get key: https://www.ncei.noaa.gov/cdo-web/token
+ * Rate limit: 5 req/sec, 10,000 req/day
+ *
+ * Usage:
+ *   import { getClimateData, searchStations } from "us-gov-open-data-mcp/sdk/noaa";
+ *   const data = await getClimateData({ datasetId: "GHCND", stationId: "GHCND:USW00094728", startDate: "2025-01-01", endDate: "2025-12-31" });
+ */
+import { createClient } from "../client.js";
+const api = createClient({
+    baseUrl: "https://www.ncei.noaa.gov/cdo-web/api/v2",
+    name: "noaa",
+    auth: { type: "header", key: "token", envVar: "NOAA_API_KEY" },
+    rateLimit: { perSecond: 5, burst: 5 },
+    cacheTtlMs: 24 * 60 * 60 * 1000, // 24 hours — historical weather doesn't change
+});
+// ─── Public API ──────────────────────────────────────────────────────
+/** List available datasets (GHCND, GSOM, GSOY, etc.) */
+export async function listDatasets() {
+    const data = await api.get("/datasets", { limit: 50 });
+    return data.results ?? [];
+}
+/** Search for weather stations by location or dataset. */
+export async function searchStations(opts) {
+    const data = await api.get("/stations", {
+        datasetid: opts.datasetId,
+        locationid: opts.locationId,
+        extent: opts.extent,
+        limit: opts.limit ?? 25,
+    });
+    return data.results ?? [];
+}
+/** Get climate observations. */
+export async function getClimateData(opts) {
+    const data = await api.get("/data", {
+        datasetid: opts.datasetId,
+        startdate: opts.startDate,
+        enddate: opts.endDate,
+        stationid: opts.stationId,
+        locationid: opts.locationId,
+        datatypeid: opts.datatypeId,
+        limit: opts.limit ?? 1000,
+        units: "standard",
+    });
+    return {
+        count: data.metadata?.resultset?.count ?? 0,
+        data: data.results ?? [],
+    };
+}
+/** Search locations (states, cities, countries, etc.) */
+export async function searchLocations(opts) {
+    const data = await api.get("/locations", {
+        locationcategoryid: opts.categoryId,
+        datasetid: opts.datasetId,
+        limit: opts.limit ?? 50,
+        sortfield: "name",
+    });
+    return data.results ?? [];
+}
+export function clearCache() { api.clearCache(); }
+//# sourceMappingURL=noaa.js.map

package/dist/sdk/noaa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noaa.js","sourceRoot":"","sources":["../../src/sdk/noaa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC;IACvB,OAAO,EAAE,0CAA0C;IACnD,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE;IAC9D,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;IACrC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,+CAA+C;CACjF,CAAC,CAAC;AAqCH,wEAAwE;AAExE,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAA4B,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAKpC;IACC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAA4B,WAAW,EAAE;QACjE,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAQpC;IACC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAA8B,OAAO,EAAE;QAC/D,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,KAAK,EAAE,UAAU;KAClB,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;QAC3C,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAIrC;IACC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAoB,YAAY,EAAE;QAC1D,kBAAkB,EAAE,IAAI,CAAC,UAAU;QACnC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU,KAAW,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC"}

package/dist/sdk/nrel.d.ts

@@ -0,0 +1,145 @@
+/**
+ * NREL SDK — typed API client for the National Renewable Energy Laboratory APIs.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchAltFuelStations, getSolarResource, getUtilityRates } from "us-gov-open-data/sdk/nrel";
+ *
+ *   const stations = await searchAltFuelStations({ state: "CA", fuel_type: "ELEC", limit: 10 });
+ *   console.log(stations.total_results, stations.fuel_stations);
+ *
+ *   const solar = await getSolarResource(40.7128, -74.006);
+ *   console.log(solar.outputs.avg_ghi);
+ *
+ *   const rates = await getUtilityRates(40.7128, -74.006);
+ *   console.log(rates.outputs.residential, rates.outputs.utility_name);
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://developer.nrel.gov/docs/
+ */
+export interface FuelStation {
+    id: number;
+    station_name: string;
+    street_address: string;
+    city: string;
+    state: string;
+    zip: string;
+    country: string;
+    fuel_type_code: string;
+    status_code: string;
+    access_code: string;
+    latitude: number;
+    longitude: number;
+    ev_level1_evse_num: number | null;
+    ev_level2_evse_num: number | null;
+    ev_dc_fast_num: number | null;
+    ev_connector_types: string[] | null;
+    ev_network: string | null;
+    ev_network_web: string | null;
+    station_phone: string | null;
+    distance?: number;
+    distance_km?: number;
+    [key: string]: unknown;
+}
+export interface AltFuelStationsResult {
+    total_results: number;
+    station_locator_url: string;
+    fuel_stations: FuelStation[];
+}
+export interface UtilityRatesOutputs {
+    residential: number;
+    commercial: number;
+    industrial: number;
+    utility_name: string;
+    utility_info: {
+        utility_name: string;
+        company_id: number;
+        state_abbr: string;
+    }[];
+    [key: string]: unknown;
+}
+export interface UtilityRatesResult {
+    inputs: {
+        lat: string;
+        lon: string;
+    };
+    errors: string[];
+    warnings: string[];
+    version: string;
+    metadata: Record<string, unknown>;
+    outputs: UtilityRatesOutputs;
+}
+export interface SolarResourceMonthly {
+    jan: number;
+    feb: number;
+    mar: number;
+    apr: number;
+    may: number;
+    jun: number;
+    jul: number;
+    aug: number;
+    sep: number;
+    oct: number;
+    nov: number;
+    dec: number;
+    annual: number;
+}
+export interface SolarResourceOutputs {
+    avg_ghi: SolarResourceMonthly;
+    avg_dni: SolarResourceMonthly;
+    avg_lat_tilt: SolarResourceMonthly;
+    [key: string]: unknown;
+}
+export interface SolarResourceResult {
+    inputs: {
+        lat: string;
+        lon: string;
+    };
+    errors: string[];
+    warnings: string[];
+    version: string;
+    metadata: Record<string, unknown>;
+    outputs: SolarResourceOutputs;
+}
+/** Alternative fuel type codes used in the AFDC Stations API. */
+export declare const FUEL_TYPES: Record<string, string>;
+/** Station status codes. */
+export declare const STATUS_CODES: Record<string, string>;
+/**
+ * Search alternative fuel stations (EV chargers, CNG, biodiesel, hydrogen, etc.).
+ *
+ * Example:
+ *   const result = await searchAltFuelStations({ state: "CA", fuel_type: "ELEC", limit: 20 });
+ */
+export declare function searchAltFuelStations(opts?: {
+    state?: string;
+    zip?: string;
+    fuel_type?: string;
+    limit?: number;
+    radius?: number;
+    status?: string;
+    city?: string;
+    ev_network?: string;
+    latitude?: number;
+    longitude?: number;
+}): Promise<AltFuelStationsResult>;
+/**
+ * Get electricity utility rates by latitude/longitude.
+ *
+ * Example:
+ *   const rates = await getUtilityRates(40.7128, -74.006);
+ *   console.log(`Residential: $${rates.outputs.residential}/kWh`);
+ */
+export declare function getUtilityRates(lat: number, lon: number): Promise<UtilityRatesResult>;
+/**
+ * Get solar resource data (irradiance) by latitude/longitude.
+ * Returns GHI, DNI, and tilt-at-latitude monthly/annual averages.
+ *
+ * Example:
+ *   const solar = await getSolarResource(34.0522, -118.2437);
+ *   console.log(`Annual GHI: ${solar.outputs.avg_ghi.annual} kWh/m²/day`);
+ */
+export declare function getSolarResource(lat: number, lon: number): Promise<SolarResourceResult>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=nrel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nrel.d.ts","sourceRoot":"","sources":["../../src/sdk/nrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgBH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IACnD,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IACnD,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,YAAY,EAAE,oBAAoB,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAID,iEAAiE;AACjE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS7C,CAAC;AAEF,4BAA4B;AAC5B,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI/C,CAAC;AAIF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,GAAE;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAatC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE3F;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE7F;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/sdk/nrel.js

@@ -0,0 +1,93 @@
+/**
+ * NREL SDK — typed API client for the National Renewable Energy Laboratory APIs.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchAltFuelStations, getSolarResource, getUtilityRates } from "us-gov-open-data/sdk/nrel";
+ *
+ *   const stations = await searchAltFuelStations({ state: "CA", fuel_type: "ELEC", limit: 10 });
+ *   console.log(stations.total_results, stations.fuel_stations);
+ *
+ *   const solar = await getSolarResource(40.7128, -74.006);
+ *   console.log(solar.outputs.avg_ghi);
+ *
+ *   const rates = await getUtilityRates(40.7128, -74.006);
+ *   console.log(rates.outputs.residential, rates.outputs.utility_name);
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://developer.nrel.gov/docs/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://developer.nrel.gov/api",
+    name: "nrel",
+    auth: { type: "query", key: "api_key", envVar: "DATA_GOV_API_KEY" },
+    rateLimit: { perSecond: 5, burst: 15 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+/** Alternative fuel type codes used in the AFDC Stations API. */
+export const FUEL_TYPES = {
+    ELEC: "Electric",
+    E85: "Ethanol (E85)",
+    CNG: "Compressed Natural Gas",
+    LPG: "Propane (LPG)",
+    BD: "Biodiesel (B20 and above)",
+    HY: "Hydrogen",
+    LNG: "Liquefied Natural Gas",
+    RD: "Renewable Diesel",
+};
+/** Station status codes. */
+export const STATUS_CODES = {
+    E: "Open (available)",
+    P: "Planned (not yet open)",
+    T: "Temporarily unavailable",
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search alternative fuel stations (EV chargers, CNG, biodiesel, hydrogen, etc.).
+ *
+ * Example:
+ *   const result = await searchAltFuelStations({ state: "CA", fuel_type: "ELEC", limit: 20 });
+ */
+export async function searchAltFuelStations(opts = {}) {
+    return api.get("/alt-fuel-stations/v1.json", {
+        state: opts.state,
+        zip: opts.zip,
+        fuel_type: opts.fuel_type,
+        limit: opts.limit,
+        radius: opts.radius,
+        status: opts.status,
+        city: opts.city,
+        ev_network: opts.ev_network,
+        latitude: opts.latitude,
+        longitude: opts.longitude,
+    });
+}
+/**
+ * Get electricity utility rates by latitude/longitude.
+ *
+ * Example:
+ *   const rates = await getUtilityRates(40.7128, -74.006);
+ *   console.log(`Residential: $${rates.outputs.residential}/kWh`);
+ */
+export async function getUtilityRates(lat, lon) {
+    return api.get("/utility_rates/v3.json", { lat, lon });
+}
+/**
+ * Get solar resource data (irradiance) by latitude/longitude.
+ * Returns GHI, DNI, and tilt-at-latitude monthly/annual averages.
+ *
+ * Example:
+ *   const solar = await getSolarResource(34.0522, -118.2437);
+ *   console.log(`Annual GHI: ${solar.outputs.avg_ghi.annual} kWh/m²/day`);
+ */
+export async function getSolarResource(lat, lon) {
+    return api.get("/solar/solar_resource/v1.json", { lat, lon });
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=nrel.js.map

package/dist/sdk/nrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nrel.js","sourceRoot":"","sources":["../../src/sdk/nrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,wEAAwE;AAExE,MAAM,GAAG,GAAG,YAAY,CAAC;IACvB,OAAO,EAAE,gCAAgC;IACzC,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACnE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACtC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;CACtC,CAAC,CAAC;AA4EH,wEAAwE;AAExE,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,eAAe;IACpB,EAAE,EAAE,2BAA2B;IAC/B,EAAE,EAAE,UAAU;IACd,GAAG,EAAE,uBAAuB;IAC5B,EAAE,EAAE,kBAAkB;CACvB,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,CAAC,EAAE,kBAAkB;IACrB,CAAC,EAAE,wBAAwB;IAC3B,CAAC,EAAE,yBAAyB;CAC7B,CAAC;AAEF,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAWxC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAwB,4BAA4B,EAAE;QAClE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,GAAW;IAC5D,OAAO,GAAG,CAAC,GAAG,CAAqB,wBAAwB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,GAAW;IAC7D,OAAO,GAAG,CAAC,GAAG,CAAsB,+BAA+B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,UAAU;IACxB,GAAG,CAAC,UAAU,EAAE,CAAC;AACnB,CAAC"}

package/dist/sdk/regulations.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Regulations.gov SDK — typed API client for the Regulations.gov API (v4).
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchDocuments, searchComments, searchDockets } from "us-gov-open-data/sdk/regulations";
+ *
+ *   const docs = await searchDocuments({ searchTerm: "water", agencyId: "EPA", pageSize: 10 });
+ *   console.log(docs.data);
+ *
+ *   const comments = await searchComments({ searchTerm: "climate", pageSize: 5 });
+ *   console.log(comments.data);
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://open.gsa.gov/api/regulationsgov/
+ */
+export interface RegulationsDocument {
+    id: string;
+    type: string;
+    attributes: {
+        agencyId: string;
+        commentEndDate?: string;
+        commentStartDate?: string;
+        docketId: string;
+        documentType: string;
+        frDocNum?: string;
+        lastModifiedDate: string;
+        objectId: string;
+        postedDate: string;
+        subtype?: string;
+        title: string;
+        withdrawn: boolean;
+        [key: string]: unknown;
+    };
+    links?: {
+        self: string;
+    };
+}
+export interface RegulationsComment {
+    id: string;
+    type: string;
+    attributes: {
+        agencyId: string;
+        comment?: string;
+        docketId: string;
+        documentType: string;
+        lastModifiedDate: string;
+        objectId: string;
+        postedDate: string;
+        title: string;
+        withdrawn: boolean;
+        [key: string]: unknown;
+    };
+    links?: {
+        self: string;
+    };
+}
+export interface RegulationsDocket {
+    id: string;
+    type: string;
+    attributes: {
+        agencyId: string;
+        docketType: string;
+        lastModifiedDate: string;
+        objectId: string;
+        title: string;
+        [key: string]: unknown;
+    };
+    links?: {
+        self: string;
+    };
+}
+export interface RegulationsListResponse<T> {
+    data: T[];
+    meta?: {
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+        numberOfElements: number;
+        pageNumber: number;
+        pageSize: number;
+        totalElements: number;
+        totalPages: number;
+        firstPage: boolean;
+        lastPage: boolean;
+    };
+}
+export interface RegulationsDetailResponse<T> {
+    data: T;
+}
+export declare const DOCUMENT_TYPES: Record<string, string>;
+/**
+ * Search for regulatory documents (proposed rules, final rules, supporting materials).
+ */
+export declare function searchDocuments(opts?: {
+    searchTerm?: string;
+    agencyId?: string;
+    docketId?: string;
+    documentType?: string;
+    postedDate?: string;
+    postedDateGe?: string;
+    postedDateLe?: string;
+    sort?: string;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<RegulationsListResponse<RegulationsDocument>>;
+/**
+ * Get detailed information for a single document by its document ID.
+ */
+export declare function getDocument(documentId: string): Promise<RegulationsDetailResponse<RegulationsDocument>>;
+/**
+ * Search for public comments on regulatory documents.
+ */
+export declare function searchComments(opts?: {
+    searchTerm?: string;
+    agencyId?: string;
+    docketId?: string;
+    commentOnId?: string;
+    postedDate?: string;
+    postedDateGe?: string;
+    postedDateLe?: string;
+    sort?: string;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<RegulationsListResponse<RegulationsComment>>;
+/**
+ * Get detailed information for a single comment.
+ */
+export declare function getComment(commentId: string): Promise<RegulationsDetailResponse<RegulationsComment>>;
+/**
+ * Search for regulatory dockets.
+ */
+export declare function searchDockets(opts?: {
+    searchTerm?: string;
+    agencyId?: string;
+    docketType?: string;
+    sort?: string;
+    pageSize?: number;
+    pageNumber?: number;
+}): Promise<RegulationsListResponse<RegulationsDocket>>;
+/**
+ * Get detailed information for a single docket.
+ */
+export declare function getDocket(docketId: string): Promise<RegulationsDetailResponse<RegulationsDocket>>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=regulations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regulations.d.ts","sourceRoot":"","sources":["../../src/sdk/regulations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgBH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,CAAC,EAAE;QACL,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC;CACT;AAID,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKjD,CAAC;AAIF;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,CAAC,CAa7D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC,CAE7G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,CAAC,CAa5D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC,CAE1G;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAS3D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,CAAC,CAEvG;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/sdk/regulations.js

@@ -0,0 +1,103 @@
+/**
+ * Regulations.gov SDK — typed API client for the Regulations.gov API (v4).
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchDocuments, searchComments, searchDockets } from "us-gov-open-data/sdk/regulations";
+ *
+ *   const docs = await searchDocuments({ searchTerm: "water", agencyId: "EPA", pageSize: 10 });
+ *   console.log(docs.data);
+ *
+ *   const comments = await searchComments({ searchTerm: "climate", pageSize: 5 });
+ *   console.log(comments.data);
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://open.gsa.gov/api/regulationsgov/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.regulations.gov/v4",
+    name: "regulations",
+    auth: { type: "query", key: "api_key", envVar: "DATA_GOV_API_KEY" },
+    rateLimit: { perSecond: 3, burst: 10 },
+    cacheTtlMs: 30 * 60 * 1000, // 30 min
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+export const DOCUMENT_TYPES = {
+    "Proposed Rule": "Proposed Rule",
+    "Rule": "Final Rule",
+    "Supporting & Related Material": "Supporting & Related Material",
+    "Other": "Other",
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search for regulatory documents (proposed rules, final rules, supporting materials).
+ */
+export async function searchDocuments(opts = {}) {
+    return api.get("/documents", {
+        "filter[searchTerm]": opts.searchTerm,
+        "filter[agencyId]": opts.agencyId,
+        "filter[docketId]": opts.docketId,
+        "filter[documentType]": opts.documentType,
+        "filter[postedDate]": opts.postedDate,
+        "filter[postedDate][ge]": opts.postedDateGe,
+        "filter[postedDate][le]": opts.postedDateLe,
+        sort: opts.sort,
+        "page[size]": opts.pageSize,
+        "page[number]": opts.pageNumber,
+    });
+}
+/**
+ * Get detailed information for a single document by its document ID.
+ */
+export async function getDocument(documentId) {
+    return api.get(`/documents/${encodeURIComponent(documentId)}`);
+}
+/**
+ * Search for public comments on regulatory documents.
+ */
+export async function searchComments(opts = {}) {
+    return api.get("/comments", {
+        "filter[searchTerm]": opts.searchTerm,
+        "filter[agencyId]": opts.agencyId,
+        "filter[docketId]": opts.docketId,
+        "filter[commentOnId]": opts.commentOnId,
+        "filter[postedDate]": opts.postedDate,
+        "filter[postedDate][ge]": opts.postedDateGe,
+        "filter[postedDate][le]": opts.postedDateLe,
+        sort: opts.sort,
+        "page[size]": opts.pageSize,
+        "page[number]": opts.pageNumber,
+    });
+}
+/**
+ * Get detailed information for a single comment.
+ */
+export async function getComment(commentId) {
+    return api.get(`/comments/${encodeURIComponent(commentId)}`);
+}
+/**
+ * Search for regulatory dockets.
+ */
+export async function searchDockets(opts = {}) {
+    return api.get("/dockets", {
+        "filter[searchTerm]": opts.searchTerm,
+        "filter[agencyId]": opts.agencyId,
+        "filter[docketType]": opts.docketType,
+        sort: opts.sort,
+        "page[size]": opts.pageSize,
+        "page[number]": opts.pageNumber,
+    });
+}
+/**
+ * Get detailed information for a single docket.
+ */
+export async function getDocket(docketId) {
+    return api.get(`/dockets/${encodeURIComponent(docketId)}`);
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=regulations.js.map

package/dist/sdk/regulations.js.map

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