/** * @module BEA — Bureau of Economic Analysis * * Typed API client for BEA's economic statistics: GDP, personal income, * international transactions, fixed assets, and industry accounts. * * Standalone — no MCP server required. Usage: * * import { getNationalGdp, getGdpByState } from "us-gov-open-data-mcp/sdk/bea"; * * const gdp = await getNationalGdp({ year: "2023" }); * console.log(gdp.series); * * Requires `BEA_API_KEY` env var. Register at {@link https://apps.bea.gov/API/signup/}. * API docs: {@link https://apps.bea.gov/api/_pdf/bea_web_service_api_user_guide.pdf}. */ import type { BeaNationalGdpResult, BeaStateGdpResult, BeaPersonalIncomeResult, BeaIndustryGdpResult, BeaDatasetInfo, BeaParameterInfo, BeaParamValue, BeaGenericResult, BeaItaResult, BeaIipResult, BeaIntlServTradeResult } from "./types.js"; /** NIPA table codes — use as `tableName` in getNationalGdp(). */ export declare const nipaTables: { readonly T10101: "Real GDP percent change"; readonly T10105: "Nominal GDP"; readonly T10106: "Real GDP (chained dollars)"; readonly T10111: "GDP percent change contributions"; readonly T20100: "Personal income and its disposition"; readonly T20600: "Personal income (monthly)"; readonly T30100: "Government receipts and expenditures"; readonly T30200: "Federal government receipts and expenditures"; readonly T30300: "State/local government receipts and expenditures"; }; /** GDP by industry table IDs — use as `tableId` in getGdpByIndustry(). */ export declare const gdpIndustryTables: { readonly 1: "Value added by industry"; readonly 5: "Contributions to percent change in real GDP"; readonly 6: "Value added as percentage of GDP"; readonly 25: "Real value added by industry"; }; /** BEA Regional table codes — use as `tableName` in getGdpByState() and getPersonalIncome(). */ export declare const regionalTables: { readonly SAGDP1: "State annual GDP summary"; readonly SAGDP9: "Real GDP by state"; readonly SQGDP1: "State quarterly GDP summary"; readonly SAINC1: "Personal income, population, per capita income"; readonly SAINC3: "Per capita personal income"; readonly SAINC4: "Personal income by major component"; readonly SAINC5N: "Personal income by NAICS industry"; readonly SAINC30: "Economic profile"; }; /** List all BEA datasets. */ export declare function getDatasetList(): Promise; /** List parameters for a dataset. */ export declare function getParameterList(datasetName: string): Promise; /** Get valid values for a parameter. */ export declare function getParameterValues(datasetName: string, parameterName: string): Promise; /** Get filtered parameter values. Not all datasets support this; Regional is the primary one. */ export declare function getParameterValuesFiltered(datasetName: string, targetParameter: string, filters: Record): Promise; /** Get national GDP data from NIPA tables. */ export declare function getNationalGdp(opts?: { /** NIPA table (default: "T10101"). See nipaTables in types.ts. */ tableName?: string; /** A=annual, Q=quarterly, M=monthly. Multiple: "A,Q". */ frequency?: string; /** Year(s) or special: "LAST5", "LAST10", "ALL", "X", or comma-separated like "2020,2021". */ year?: string; }): Promise; /** Get GDP by state from BEA Regional dataset. */ export declare function getGdpByState(opts?: { /** Regional table (default: "SAGDP1"). See regionalTables in types.ts. */ tableName?: string; /** "STATE", "COUNTY", "MSA", state abbreviation ("NY"), or 5-digit FIPS ("06000"). */ geoFips?: string; /** Numeric line code as string, or "ALL". */ lineCode?: string; /** "LAST5" (default), "LAST10", "ALL", or comma-separated years. */ year?: string; }): Promise; /** Get personal income data by state from BEA Regional dataset. */ export declare function getPersonalIncome(opts?: { /** Income table (default: "SAINC1"). See regionalTables in types.ts. */ tableName?: string; /** "STATE", "COUNTY", "MSA", state abbreviation, or 5-digit FIPS. */ geoFips?: string; /** e.g. "3" for per capita, "1" for total. */ lineCode?: string; /** "LAST5" (default), "ALL", or comma-separated years. */ year?: string; }): Promise; /** Get GDP contribution by industry from BEA GDPbyIndustry dataset. */ export declare function getGdpByIndustry(opts?: { /** Table ID ("1", "5", "25") or "ALL". See gdpIndustryTables in types.ts. */ tableId?: string; /** A=annual or Q=quarterly (not all tables support quarterly). */ frequency?: string; /** Comma-separated years or "ALL". Defaults to last 3 complete years. */ year?: string; /** NAICS code ("11", "21") or "ALL". */ industry?: string; }): Promise; /** NIPA Underlying Detail — more granular, lower quality than published aggregates. */ export declare function getNipaUnderlyingDetail(opts?: { tableName?: string; /** A=annual, Q=quarterly, or M=monthly. */ frequency?: string; /** "LAST5", "ALL", "X", or comma-separated years. */ year?: string; }): Promise; /** Fixed Assets — net stock, depreciation, investment. Annual only. */ export declare function getFixedAssets(opts?: { tableName?: string; /** "LAST5", "ALL", "X", or comma-separated years. */ year?: string; }): Promise; /** ITA — U.S. international transactions (balance of payments). */ export declare function getInternationalTransactions(opts?: { /** BEA indicator code: "BalGds", "BalServ", "ExpGds", etc. Use bea_dataset_info to discover. */ indicator?: string; /** Country name ("China"), "AllCountries" (total), or "All" (all breakdowns). */ areaOrCountry?: string; /** A=annual, QSA=quarterly seasonally adjusted, QNSA=quarterly not adjusted. */ frequency?: string; /** Comma-separated years or "ALL". */ year?: string; }): Promise; /** IIP — U.S. international investment position (assets and liabilities). */ export declare function getInternationalInvestment(opts?: { /** "FinAssetsExclFinDeriv", "DirInvAssets", etc. Use bea_dataset_info to discover. */ typeOfInvestment?: string; /** "Pos" (position), "ChgPosTrans", "ChgPosPrice", "ChgPosXRate". */ component?: string; /** A=annual or QNSA=quarterly not seasonally adjusted. */ frequency?: string; /** Comma-separated years or "ALL". */ year?: string; }): Promise; /** IntlServTrade — annual U.S. trade in services. */ export declare function getIntlServTrade(opts?: { typeOfService?: string; tradeDirection?: string; affiliation?: string; areaOrCountry?: string; year?: string; }): Promise; /** MNE — Direct Investment (DI) and Activities of Multinational Enterprises (AMNE). * For AMNE, ownershipLevel and nonBankAffiliatesOnly are required. */ export declare function getMultinationalEnterprises(opts: { directionOfInvestment: string; classification: string; year: string; ownershipLevel?: string; nonBankAffiliatesOnly?: string; seriesId?: string; country?: string; industry?: string; state?: string; getFootnotes?: string; }): Promise; /** InputOutput — Make, Use, and Requirements tables. */ export declare function getInputOutput(opts: { tableId: string; year: string; }): Promise; /** Underlying GDP by Industry — more detail than getGdpByIndustry. Annual only, from 1997. */ export declare function getUnderlyingGdpByIndustry(opts?: { /** Numeric table ID as string or "ALL". */ tableId?: string; /** A=annual only — no quarterly data available for this dataset. */ frequency?: string; /** Comma-separated years or "ALL". Defaults to last 3 complete years. */ year?: string; /** NAICS code or "ALL". */ industry?: string; }): Promise; /** Clear cached responses. */ export declare function clearCache(): void; //# sourceMappingURL=sdk.d.ts.map