us-gov-open-data-mcp 1.0.0

package/dist/sdk/cdc.js

@@ -0,0 +1,222 @@
+/**
+ * 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 });
+ */
+import { createClient } from "../client.js";
+const api = createClient({
+    baseUrl: "https://data.cdc.gov/resource",
+    name: "cdc",
+    rateLimit: { perSecond: 2, burst: 5 },
+    cacheTtlMs: 24 * 60 * 60 * 1000, // 24 hours — CDC data updates slowly
+});
+// ─── Dataset IDs ─────────────────────────────────────────────────────
+export const DATASETS = {
+    leading_death: { id: "bi63-dtpu", name: "Leading Causes of Death", description: "U.S. leading causes of death by state and year (1999–present)" },
+    life_expectancy: { id: "w9j2-ggv5", name: "Life Expectancy", description: "Life expectancy at birth by race (All Races, Black, White) and sex (1900–2018)" },
+    mortality_rates: { id: "489q-934x", name: "Provisional Mortality Rates", description: "Quarterly age-adjusted death rates by cause, sex, and state (2020–present)" },
+    places_county: { id: "swc5-untb", name: "PLACES: County Health", description: "County-level health indicators: obesity, diabetes, smoking, depression, sleep, etc. (BRFSS-based)" },
+    places_city: { id: "dxpw-cm5u", name: "PLACES: City Health", description: "City-level health indicators: obesity, diabetes, smoking, depression, sleep, etc. (BRFSS-based)" },
+    covid_cases: { id: "pwn4-m3yp", name: "COVID-19 Cases & Deaths", description: "COVID-19 weekly cases and deaths by state (through early 2023)" },
+    covid_conditions: { id: "hk9y-quqm", name: "COVID-19 Conditions", description: "COVID-19 deaths by contributing condition, age group, and state" },
+    weekly_deaths: { id: "r8kw-7aab", name: "Weekly Death Surveillance", description: "Provisional weekly death counts by state: COVID-19, pneumonia, influenza, total deaths (updated weekly, 2020–present)" },
+    disability: { id: "s2qv-b27b", name: "Disability Prevalence", description: "Disability status and types by state: mobility, cognitive, hearing, vision, self-care (BRFSS)" },
+    weekly_deaths_by_cause: { id: "muzy-jte6", name: "Weekly Deaths by Cause", description: "Weekly deaths by state and cause: heart disease, cancer, diabetes, stroke, COVID, respiratory (2020–2023)" },
+    drug_overdose_state: { id: "xbxb-epbu", name: "Drug Poisoning Mortality by State", description: "Drug poisoning/overdose death rates by state, sex, race, and age (1999–2016)" },
+    nutrition_obesity: { id: "hn4x-zwk7", name: "Nutrition, Physical Activity & Obesity", description: "Adult obesity, physical inactivity, and fruit/vegetable consumption by state from BRFSS" },
+    death_rates_historical: { id: "6rkc-nb2q", name: "Historical Death Rates by Cause", description: "Age-adjusted death rates for major causes (heart disease, cancer, stroke, etc.) since 1900" },
+    birth_indicators: { id: "76vv-a7x8", name: "Quarterly Birth Indicators", description: "Provisional quarterly birth rates, teen births, preterm births, cesarean rates by race/ethnicity" },
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/** Generic Socrata SODA query against any CDC dataset. */
+export async function queryDataset(datasetId, opts = {}) {
+    return api.get(`/${datasetId}.json`, {
+        "$where": opts.where,
+        "$select": opts.select,
+        "$group": opts.group,
+        "$order": opts.order,
+        "$limit": opts.limit ?? 1000,
+    });
+}
+/** Leading causes of death by state/year. */
+export async function getLeadingCausesOfDeath(opts) {
+    const clauses = [];
+    if (opts?.state)
+        clauses.push(`state = '${opts.state}'`);
+    if (opts?.year)
+        clauses.push(`year = '${opts.year}'`);
+    return queryDataset(DATASETS.leading_death.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "deaths DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Life expectancy at birth by race and sex (dataset w9j2-ggv5, 1900–2018). */
+export async function getLifeExpectancy(opts) {
+    const clauses = [];
+    if (opts?.year)
+        clauses.push(`year = '${opts.year}'`);
+    if (opts?.race)
+        clauses.push(`race = '${opts.race}'`);
+    if (opts?.sex)
+        clauses.push(`sex = '${opts.sex}'`);
+    return queryDataset(DATASETS.life_expectancy.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "year DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Provisional mortality rates by cause, sex, and state (dataset 489q-934x, quarterly, 2020–present). */
+export async function getMortalityRates(opts) {
+    const clauses = [];
+    if (opts?.quarter)
+        clauses.push(`year_and_quarter = '${opts.quarter}'`);
+    if (opts?.cause)
+        clauses.push(`cause_of_death = '${opts.cause}'`);
+    if (opts?.rateType)
+        clauses.push(`rate_type = '${opts.rateType}'`);
+    else
+        clauses.push(`rate_type = 'Age-adjusted'`);
+    clauses.push(`time_period = '12 months ending with quarter'`);
+    return queryDataset(DATASETS.mortality_rates.id, {
+        where: clauses.join(" AND "),
+        order: "year_and_quarter DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** PLACES county-level health indicators (obesity, diabetes, smoking, depression, etc.). */
+export async function getPlacesHealth(opts) {
+    const clauses = [];
+    if (opts?.state)
+        clauses.push(`stateabbr = '${opts.state.toUpperCase()}'`);
+    if (opts?.measure)
+        clauses.push(`measureid = '${opts.measure.toUpperCase()}'`);
+    return queryDataset(DATASETS.places_county.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        select: "stateabbr, statedesc, locationname, measureid, short_question_text, data_value, data_value_type, totalpopulation, category",
+        order: "data_value DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** PLACES city-level health indicators (obesity, diabetes, smoking, depression, etc.). */
+export async function getPlacesCityHealth(opts) {
+    const clauses = [];
+    if (opts?.state)
+        clauses.push(`stateabbr = '${opts.state.toUpperCase()}'`);
+    if (opts?.measure)
+        clauses.push(`${opts.measure.toLowerCase()}_crudeprev IS NOT NULL`);
+    if (opts?.city)
+        clauses.push(`upper(placename) LIKE '%${opts.city.toUpperCase()}%'`);
+    return queryDataset(DATASETS.places_city.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "stateabbr, placename",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** COVID-19 weekly cases and deaths by state. */
+export async function getCovidData(opts) {
+    const clauses = [];
+    if (opts?.state)
+        clauses.push(`state = '${opts.state.toUpperCase()}'`);
+    return queryDataset(DATASETS.covid_cases.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "date_updated DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Weekly provisional death counts by state — COVID, pneumonia, influenza, total. Updated weekly. */
+export async function getWeeklyDeaths(opts) {
+    const clauses = [];
+    clauses.push(`group = 'By Week'`);
+    if (opts?.state)
+        clauses.push(`state = '${opts.state}'`);
+    if (opts?.year)
+        clauses.push(`year = '${opts.year}'`);
+    return queryDataset(DATASETS.weekly_deaths.id, {
+        where: clauses.join(" AND "),
+        order: "end_date DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Disability prevalence by state and type from BRFSS. */
+export async function getDisabilityData(opts) {
+    const clauses = [];
+    clauses.push(`stratificationcategoryid1 = 'CAT1'`); // Overall (not by age/race subgroup)
+    if (opts?.state)
+        clauses.push(`locationabbr = '${opts.state.toUpperCase()}'`);
+    if (opts?.disabilityType)
+        clauses.push(`response = '${opts.disabilityType}'`);
+    return queryDataset(DATASETS.disability.id, {
+        where: clauses.join(" AND "),
+        select: "locationabbr, locationdesc, response, data_value, data_value_type, year, number, weightednumber",
+        order: "year DESC, locationabbr",
+        limit: opts?.limit ?? 200,
+    });
+}
+export function clearCache() { api.clearCache(); }
+// ─── Additional high-value SDK functions ─────────────────────────────
+/** Drug overdose/poisoning mortality by state (1999–2016). */
+export async function getDrugOverdoseData(opts) {
+    const clauses = [];
+    if (opts?.state)
+        clauses.push(`state = '${opts.state}'`);
+    if (opts?.year)
+        clauses.push(`year = '${opts.year}'`);
+    if (opts?.sex)
+        clauses.push(`sex = '${opts.sex}'`);
+    return queryDataset(DATASETS.drug_overdose_state.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "year DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Nutrition, physical activity, and obesity by state from BRFSS. */
+export async function getNutritionObesityData(opts) {
+    const clauses = [];
+    clauses.push(`data_value IS NOT NULL`);
+    if (opts?.state)
+        clauses.push(`locationabbr = '${opts.state.toUpperCase()}'`);
+    if (opts?.topic)
+        clauses.push(`class LIKE '%${opts.topic}%'`);
+    return queryDataset(DATASETS.nutrition_obesity.id, {
+        where: clauses.join(" AND "),
+        select: "yearstart, yearend, locationabbr, locationdesc, class, topic, question, data_value, data_value_unit, stratificationcategory1, stratification1",
+        order: "yearend DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Historical age-adjusted death rates for major causes since 1900. */
+export async function getHistoricalDeathRates(opts) {
+    const clauses = [];
+    if (opts?.cause)
+        clauses.push(`leading_causes = '${opts.cause}'`);
+    if (opts?.startYear)
+        clauses.push(`year >= '${opts.startYear}'`);
+    if (opts?.endYear)
+        clauses.push(`year <= '${opts.endYear}'`);
+    return queryDataset(DATASETS.death_rates_historical.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "year DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+/** Quarterly provisional birth indicators (birth rates, teen births, preterm, cesarean). */
+export async function getBirthIndicators(opts) {
+    const clauses = [];
+    if (opts?.topic)
+        clauses.push(`topic_subgroup LIKE '%${opts.topic}%'`);
+    if (opts?.raceEthnicity)
+        clauses.push(`race_ethnicity = '${opts.raceEthnicity}'`);
+    return queryDataset(DATASETS.birth_indicators.id, {
+        where: clauses.length ? clauses.join(" AND ") : undefined,
+        order: "year_and_quarter DESC",
+        limit: opts?.limit ?? 200,
+    });
+}
+//# sourceMappingURL=cdc.js.map

package/dist/sdk/cdc.js.map

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

package/dist/sdk/census.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Census SDK — typed API client for the U.S. Census Bureau Data API.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { queryCensus, searchVariables } from "us-gov-open-data/sdk/census";
+ *
+ *   const data = await queryCensus("2023/acs/acs1", "NAME,B01001_001E", "state:*");
+ *   console.log(data.headers, data.rows);
+ *
+ * Requires CENSUS_API_KEY env var. Get one at https://api.census.gov/data/key_signup.html
+ */
+/** Transformed Census query result: first row becomes headers, rest becomes rows. */
+export interface CensusQueryResult {
+    headers: string[];
+    rows: string[][];
+}
+export interface CensusVariable {
+    label?: string;
+    concept?: string;
+    predicateType?: string;
+}
+export interface CensusVariableMatch {
+    id: string;
+    label: string;
+    concept: string;
+}
+export interface CensusDataset {
+    path: string;
+    name: string;
+    description: string;
+}
+export declare const commonVariables: Record<string, string>;
+export declare const datasets: CensusDataset[];
+/**
+ * Query the Census Bureau Data API.
+ * The raw API returns a 2D string array; this transforms it into { headers, rows }.
+ */
+export declare function queryCensus(dataset: string, variables: string, forGeo: string, inGeo?: string, extra?: Record<string, string>): Promise<CensusQueryResult>;
+/**
+ * Search for Census variable names/codes by keyword within a dataset.
+ * Fetches the dataset's variables.json and filters locally.
+ */
+export declare function searchVariables(dataset: string, keyword: string, maxResults?: number): Promise<CensusVariableMatch[]>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=census.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"census.d.ts","sourceRoot":"","sources":["../../src/sdk/census.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqBlD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,aAAa,EASnC,CAAC;AAIF;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,SAAK,GACd,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAmBhC;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/sdk/census.js

@@ -0,0 +1,99 @@
+/**
+ * Census SDK — typed API client for the U.S. Census Bureau Data API.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { queryCensus, searchVariables } from "us-gov-open-data/sdk/census";
+ *
+ *   const data = await queryCensus("2023/acs/acs1", "NAME,B01001_001E", "state:*");
+ *   console.log(data.headers, data.rows);
+ *
+ * Requires CENSUS_API_KEY env var. Get one at https://api.census.gov/data/key_signup.html
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.census.gov/data",
+    name: "census",
+    auth: { type: "query", key: "key", envVar: "CENSUS_API_KEY" },
+    rateLimit: { perSecond: 3, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour — Census data updates annually
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+export const commonVariables = {
+    NAME: "Geographic area name",
+    B01001_001E: "Total population",
+    B01002_001E: "Median age",
+    B02001_002E: "White alone population",
+    B02001_003E: "Black/African American alone",
+    B03003_003E: "Hispanic/Latino population",
+    B19013_001E: "Median household income",
+    B19001_001E: "Household income distribution (total)",
+    B19301_001E: "Per capita income",
+    B25077_001E: "Median home value (owner-occupied)",
+    B25064_001E: "Median gross rent",
+    B25003_001E: "Housing tenure (total occupied)",
+    B25003_002E: "Owner-occupied housing units",
+    B25003_003E: "Renter-occupied housing units",
+    B17001_002E: "Population below poverty level",
+    B15003_022E: "Bachelor's degree",
+    B15003_023E: "Master's degree",
+    B15003_025E: "Doctorate degree",
+    B23025_002E: "In labor force",
+    B23025_005E: "Unemployed",
+};
+export const datasets = [
+    { path: "2023/acs/acs1", name: "ACS 1-Year (2023)", description: "American Community Survey 1-year estimates — larger areas only" },
+    { path: "2023/acs/acs5", name: "ACS 5-Year (2023)", description: "American Community Survey 5-year estimates — all geographies" },
+    { path: "2022/acs/acs1", name: "ACS 1-Year (2022)", description: "ACS 1-year 2022" },
+    { path: "2020/dec/pl", name: "Decennial 2020 PL", description: "2020 Census redistricting data" },
+    { path: "2020/dec/dhc", name: "Decennial 2020 DHC", description: "2020 Census demographic and housing characteristics" },
+    { path: "2010/dec/sf1", name: "Decennial 2010 SF1", description: "2010 Census Summary File 1" },
+    { path: "2023/pep/population", name: "Population Estimates (2023)", description: "Annual population estimates" },
+    { path: "2017/ecnbasic", name: "Economic Census (2017)", description: "Economic Census basic data" },
+];
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Query the Census Bureau Data API.
+ * The raw API returns a 2D string array; this transforms it into { headers, rows }.
+ */
+export async function queryCensus(dataset, variables, forGeo, inGeo, extra) {
+    const norm = dataset.startsWith("/") ? dataset : `/${dataset}`;
+    const params = { get: variables, for: forGeo };
+    if (inGeo)
+        params.in = inGeo;
+    if (extra)
+        Object.assign(params, extra);
+    const raw = await api.get(norm, params);
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw new Error("census: empty response — no data returned");
+    }
+    return { headers: raw[0], rows: raw.slice(1) };
+}
+/**
+ * Search for Census variable names/codes by keyword within a dataset.
+ * Fetches the dataset's variables.json and filters locally.
+ */
+export async function searchVariables(dataset, keyword, maxResults = 20) {
+    const norm = dataset.startsWith("/") ? dataset : `/${dataset}`;
+    const data = await api.get(`${norm}/variables.json`);
+    const kw = keyword.toLowerCase();
+    const matches = [];
+    for (const [id, info] of Object.entries(data.variables)) {
+        const label = info.label || "";
+        const concept = info.concept || "";
+        if (label.toLowerCase().includes(kw) ||
+            concept.toLowerCase().includes(kw) ||
+            id.toLowerCase().includes(kw)) {
+            matches.push({ id, label, concept });
+            if (matches.length >= maxResults)
+                break;
+        }
+    }
+    return matches;
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=census.js.map

package/dist/sdk/census.js.map

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

package/dist/sdk/cfpb.d.ts

@@ -0,0 +1,148 @@
+/**
+ * CFPB SDK — typed API client for the Consumer Financial Protection Bureau
+ * Consumer Complaint Database.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchComplaints, getCompanyComplaints, getComplaintTrends } from "us-gov-open-data/sdk/cfpb";
+ *
+ *   const data = await searchComplaints({ product: "Mortgage", state: "CA" });
+ *   console.log(data);
+ *
+ * No API key required.
+ * Docs: https://cfpb.github.io/api/ccdb/
+ * Database: https://www.consumerfinance.gov/data-research/consumer-complaints/
+ */
+export interface Complaint {
+    complaint_id?: number;
+    date_received?: string;
+    product?: string;
+    sub_product?: string;
+    issue?: string;
+    sub_issue?: string;
+    company?: string;
+    state?: string;
+    zip_code?: string;
+    company_response?: string;
+    company_public_response?: string;
+    consumer_consent_provided?: string;
+    consumer_disputed?: string;
+    consumer_complaint_narrative?: string;
+    timely?: string;
+    date_sent_to_company?: string;
+    submitted_via?: string;
+    tags?: string;
+    has_narrative?: boolean;
+    [key: string]: unknown;
+}
+export interface ComplaintSearchResult {
+    hits: {
+        total: number | {
+            value: number;
+            relation: string;
+        };
+        hits: Array<{
+            _source: Complaint;
+            [key: string]: unknown;
+        }>;
+    };
+    _meta?: {
+        total_record_count?: number;
+        last_updated?: string;
+        last_indexed?: string;
+        license?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface AggregationBucket {
+    key: string;
+    doc_count: number;
+    [key: string]: unknown;
+}
+export interface SuggestResult {
+    suggest: Array<{
+        text: string;
+        options: Array<{
+            text: string;
+            [key: string]: unknown;
+        }>;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+}
+/** Financial product categories tracked by CFPB. */
+export declare const PRODUCTS: Record<string, string>;
+/** Fields available for aggregation. */
+export declare const AGG_FIELDS: Record<string, string>;
+/**
+ * Search consumer complaints with filters.
+ *
+ * Example:
+ *   const data = await searchComplaints({ product: "Mortgage", state: "CA", size: 25 });
+ *   const recent = await searchComplaints({ company: "Wells Fargo", sort: "created_date_desc" });
+ */
+export declare function searchComplaints(opts: {
+    search_term?: string;
+    product?: string;
+    company?: string;
+    state?: string;
+    issue?: string;
+    date_received_min?: string;
+    date_received_max?: string;
+    company_response?: string;
+    consumer_disputed?: string;
+    has_narrative?: boolean;
+    tags?: string;
+    size?: number;
+    frm?: number;
+    sort?: string;
+    field?: string;
+    no_aggs?: boolean;
+}): Promise<ComplaintSearchResult>;
+/**
+ * Get complaint aggregations/counts grouped by a field.
+ * Uses the search endpoint with size=0 to return only aggregations.
+ *
+ * Example:
+ *   const byProduct = await getComplaintAggregations({ field: "product" });
+ *   const byCompany = await getComplaintAggregations({ field: "company", state: "TX", size: 20 });
+ */
+export declare function getComplaintAggregations(opts: {
+    field: string;
+    search_term?: string;
+    product?: string;
+    company?: string;
+    state?: string;
+    issue?: string;
+    date_received_min?: string;
+    date_received_max?: string;
+    tags?: string;
+    size?: number;
+}): Promise<ComplaintSearchResult>;
+/**
+ * Get complaint trends over time.
+ * Returns complaint data with date-based aggregations for trend analysis.
+ *
+ * Example:
+ *   const trends = await getComplaintTrends({ product: "Mortgage", date_received_min: "2020-01-01" });
+ */
+export declare function getComplaintTrends(opts: {
+    product?: string;
+    company?: string;
+    state?: string;
+    issue?: string;
+    date_received_min?: string;
+    date_received_max?: string;
+    trend_interval?: string;
+}): Promise<ComplaintSearchResult>;
+/**
+ * Get company name suggestions/autocomplete.
+ *
+ * Example:
+ *   const suggestions = await suggestCompany("wells");
+ */
+export declare function suggestCompany(text: string, size?: number): Promise<SuggestResult>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=cfpb.d.ts.map

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

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