/** * 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-mcp/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. */ /** Bls Observation. */ export interface BlsObservation { year: string; period: string; periodName: string; latest: string; value: string; footnotes: { code: string; text: string; }[]; calculations?: { net_changes?: Record; pct_changes?: Record; }; } /** Bls Series. */ export interface BlsSeries { seriesID: string; data: BlsObservation[]; } /** Bls Response. */ export interface BlsResponse { status: string; responseTime: number; message: string[]; Results: { series: BlsSeries[]; }; } /** Bls Popular Series. */ export interface BlsPopularSeries { id: string; name: string; category: string; } /** BLS series ID prefix codes — identifies the survey/program a series belongs to. */ export declare const seriesPrefixes: { readonly CES: "Current Employment Statistics (establishment survey — jobs by industry)"; readonly LNS: "Labor Force Statistics, seasonally adjusted (household survey)"; readonly LNU: "Labor Force Statistics, not seasonally adjusted"; readonly CU: "Consumer Price Index (CPI-U, urban consumers)"; readonly CW: "Consumer Price Index (CPI-W, wage earners)"; readonly WP: "Producer Price Index (PPI)"; readonly OE: "Occupational Employment and Wages (OES)"; readonly JT: "Job Openings and Labor Turnover Survey (JOLTS)"; readonly LA: "Local Area Unemployment Statistics (LAUS)"; readonly SM: "State and Metro Area Employment (CES)"; readonly EN: "Quarterly Census of Employment and Wages (QCEW)"; readonly PR: "Productivity and Costs"; readonly EI: "Employment Cost Index (ECI)"; readonly AP: "Average Price Data"; }; /** Curated catalog of popular BLS series IDs with names and topic categories. Used by `searchPopularSeries()`. */ export declare const popularSeries: BlsPopularSeries[]; /** State abbreviation to FIPS code mapping — used to construct LAUS employment series IDs. */ export declare const stateFips: { readonly AL: "01"; readonly AK: "02"; readonly AZ: "04"; readonly AR: "05"; readonly CA: "06"; readonly CO: "08"; readonly CT: "09"; readonly DE: "10"; readonly DC: "11"; readonly FL: "12"; readonly GA: "13"; readonly HI: "15"; readonly ID: "16"; readonly IL: "17"; readonly IN: "18"; readonly IA: "19"; readonly KS: "20"; readonly KY: "21"; readonly LA: "22"; readonly ME: "23"; readonly MD: "24"; readonly MA: "25"; readonly MI: "26"; readonly MN: "27"; readonly MS: "28"; readonly MO: "29"; readonly MT: "30"; readonly NE: "31"; readonly NV: "32"; readonly NH: "33"; readonly NJ: "34"; readonly NM: "35"; readonly NY: "36"; readonly NC: "37"; readonly ND: "38"; readonly OH: "39"; readonly OK: "40"; readonly OR: "41"; readonly PA: "42"; readonly RI: "44"; readonly SC: "45"; readonly SD: "46"; readonly TN: "47"; readonly TX: "48"; readonly UT: "49"; readonly VT: "50"; readonly VA: "51"; readonly WA: "53"; readonly WV: "54"; readonly WI: "55"; readonly WY: "56"; readonly PR: "72"; readonly VI: "78"; readonly GU: "66"; readonly AS: "60"; readonly MP: "69"; }; /** Fetch time series data from BLS. Posts to /timeseries/data/ with series IDs. */ export declare function getSeriesData(seriesIds: string[], opts?: { startYear?: number; endYear?: number; }): Promise; /** Local lookup — search popular series by topic. No API call. */ export declare function searchPopularSeries(topic: string): BlsPopularSeries[]; /** Get state employment series IDs constructed from FIPS codes. */ export declare function getStateEmploymentSeries(stateCode: string): BlsPopularSeries[] | null; /** Get available topic categories. */ export declare function getAvailableTopics(): string[]; /** CPI component series — series ID to human-readable label. Use `Object.keys()` for the ID list. */ export declare const cpiSeries: { readonly CUUR0000SA0: "All Items"; readonly CUUR0000SAF1: "Food"; readonly CUUR0000SAH1: "Shelter/Housing"; readonly CUUR0000SETB01: "Gasoline"; readonly CUUR0000SAM: "Medical Care"; readonly CUUR0000SAE: "Education & Communication"; readonly CUUR0000SAT: "Transportation"; readonly CUUR0000SAR: "Recreation"; readonly CUUR0000SAA: "Apparel"; }; /** Employment-by-industry series — series ID to sector label. Use `Object.keys()` for the ID list. */ export declare const industrySeries: { readonly CES0000000001: "Total Nonfarm"; readonly CES1000000001: "Mining & Logging"; readonly CES2000000001: "Construction"; readonly CES3000000001: "Manufacturing"; readonly CES4000000001: "Trade/Transport/Utilities"; readonly CES5000000001: "Information"; readonly CES5500000001: "Financial Activities"; readonly CES6000000001: "Professional & Business Services"; readonly CES6500000001: "Education & Health"; readonly CES7000000001: "Leisure & Hospitality"; readonly CES8000000001: "Other Services"; readonly CES9000000001: "Government"; }; /** Clear cached responses. */ export declare function clearCache(): void; //# sourceMappingURL=sdk.d.ts.map