data-analyst-mcp 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +262 -3
- package/dist/adapters/_acf_tidy.d.ts +18 -0
- package/dist/adapters/_acf_tidy.js +432 -0
- package/dist/adapters/_acf_tidy.js.map +1 -0
- package/dist/adapters/_actuaries_read.d.ts +38 -0
- package/dist/adapters/_actuaries_read.js +728 -0
- package/dist/adapters/_actuaries_read.js.map +1 -0
- package/dist/adapters/_census_micro.d.ts +70 -0
- package/dist/adapters/_census_micro.js +622 -0
- package/dist/adapters/_census_micro.js.map +1 -0
- package/dist/adapters/_census_util.d.ts +40 -0
- package/dist/adapters/_census_util.js +275 -0
- package/dist/adapters/_census_util.js.map +1 -0
- package/dist/adapters/_dol_states.d.ts +6 -0
- package/dist/adapters/_dol_states.js +58 -0
- package/dist/adapters/_dol_states.js.map +1 -0
- package/dist/adapters/_govinfo_entities.d.ts +4 -0
- package/dist/adapters/_govinfo_entities.js +6 -0
- package/dist/adapters/_govinfo_entities.js.map +1 -0
- package/dist/adapters/_govinfo_json.d.ts +13 -0
- package/dist/adapters/_govinfo_json.js +107 -0
- package/dist/adapters/_govinfo_json.js.map +1 -0
- package/dist/adapters/_govinfo_py.d.ts +22 -0
- package/dist/adapters/_govinfo_py.js +272 -0
- package/dist/adapters/_govinfo_py.js.map +1 -0
- package/dist/adapters/_govinfo_xml.d.ts +22 -0
- package/dist/adapters/_govinfo_xml.js +233 -0
- package/dist/adapters/_govinfo_xml.js.map +1 -0
- package/dist/adapters/_hud_excel.d.ts +2 -0
- package/dist/adapters/_hud_excel.js +166 -0
- package/dist/adapters/_hud_excel.js.map +1 -0
- package/dist/adapters/_omb_grid.d.ts +17 -0
- package/dist/adapters/_omb_grid.js +132 -0
- package/dist/adapters/_omb_grid.js.map +1 -0
- package/dist/adapters/_omb_util.d.ts +40 -0
- package/dist/adapters/_omb_util.js +192 -0
- package/dist/adapters/_omb_util.js.map +1 -0
- package/dist/adapters/_usaspending_state.d.ts +6 -0
- package/dist/adapters/_usaspending_state.js +54 -0
- package/dist/adapters/_usaspending_state.js.map +1 -0
- package/dist/adapters/_usda-fna_book.d.ts +59 -0
- package/dist/adapters/_usda-fna_book.js +869 -0
- package/dist/adapters/_usda-fna_book.js.map +1 -0
- package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
- package/dist/adapters/_usda-fna_pdf.js +361 -0
- package/dist/adapters/_usda-fna_pdf.js.map +1 -0
- package/dist/adapters/_usda-outlook_read.d.ts +70 -0
- package/dist/adapters/_usda-outlook_read.js +362 -0
- package/dist/adapters/_usda-outlook_read.js.map +1 -0
- package/dist/adapters/acf.d.ts +3 -0
- package/dist/adapters/acf.js +187 -0
- package/dist/adapters/acf.js.map +1 -0
- package/dist/adapters/actuaries.d.ts +3 -0
- package/dist/adapters/actuaries.js +293 -0
- package/dist/adapters/actuaries.js.map +1 -0
- package/dist/adapters/bts.d.ts +3 -0
- package/dist/adapters/bts.js +26 -0
- package/dist/adapters/bts.js.map +1 -0
- package/dist/adapters/census-geocoder.d.ts +10 -0
- package/dist/adapters/census-geocoder.js +47 -0
- package/dist/adapters/census-geocoder.js.map +1 -0
- package/dist/adapters/census.d.ts +17 -0
- package/dist/adapters/census.js +983 -0
- package/dist/adapters/census.js.map +1 -0
- package/dist/adapters/cfpb.d.ts +7 -0
- package/dist/adapters/cfpb.js +348 -0
- package/dist/adapters/cfpb.js.map +1 -0
- package/dist/adapters/clinical-trials.d.ts +3 -0
- package/dist/adapters/clinical-trials.js +135 -0
- package/dist/adapters/clinical-trials.js.map +1 -0
- package/dist/adapters/cms.d.ts +3 -0
- package/dist/adapters/cms.js +292 -0
- package/dist/adapters/cms.js.map +1 -0
- package/dist/adapters/college-scorecard.d.ts +3 -0
- package/dist/adapters/college-scorecard.js +122 -0
- package/dist/adapters/college-scorecard.js.map +1 -0
- package/dist/adapters/congress.d.ts +33 -0
- package/dist/adapters/congress.js +589 -0
- package/dist/adapters/congress.js.map +1 -0
- package/dist/adapters/dhs-ohss.d.ts +13 -0
- package/dist/adapters/dhs-ohss.js +598 -0
- package/dist/adapters/dhs-ohss.js.map +1 -0
- package/dist/adapters/doj-news.d.ts +7 -0
- package/dist/adapters/doj-news.js +286 -0
- package/dist/adapters/doj-news.js.map +1 -0
- package/dist/adapters/dol.d.ts +4 -0
- package/dist/adapters/dol.js +634 -0
- package/dist/adapters/dol.js.map +1 -0
- package/dist/adapters/eia.d.ts +15 -0
- package/dist/adapters/eia.js +456 -0
- package/dist/adapters/eia.js.map +1 -0
- package/dist/adapters/epa-aqs.d.ts +3 -0
- package/dist/adapters/epa-aqs.js +357 -0
- package/dist/adapters/epa-aqs.js.map +1 -0
- package/dist/adapters/epa.d.ts +3 -0
- package/dist/adapters/epa.js +298 -0
- package/dist/adapters/epa.js.map +1 -0
- package/dist/adapters/fbi.d.ts +3 -0
- package/dist/adapters/fbi.js +192 -0
- package/dist/adapters/fbi.js.map +1 -0
- package/dist/adapters/fda.d.ts +5 -0
- package/dist/adapters/fda.js +184 -0
- package/dist/adapters/fda.js.map +1 -0
- package/dist/adapters/fdic.d.ts +4 -0
- package/dist/adapters/fdic.js +95 -0
- package/dist/adapters/fdic.js.map +1 -0
- package/dist/adapters/fec.d.ts +3 -0
- package/dist/adapters/fec.js +142 -0
- package/dist/adapters/fec.js.map +1 -0
- package/dist/adapters/fed-board.d.ts +12 -0
- package/dist/adapters/fed-board.js +581 -0
- package/dist/adapters/fed-board.js.map +1 -0
- package/dist/adapters/federal-register.d.ts +11 -0
- package/dist/adapters/federal-register.js +43 -0
- package/dist/adapters/federal-register.js.map +1 -0
- package/dist/adapters/fhfa.d.ts +3 -0
- package/dist/adapters/fhfa.js +253 -0
- package/dist/adapters/fhfa.js.map +1 -0
- package/dist/adapters/fsa.d.ts +9 -0
- package/dist/adapters/fsa.js +335 -0
- package/dist/adapters/fsa.js.map +1 -0
- package/dist/adapters/govinfo.d.ts +30 -0
- package/dist/adapters/govinfo.js +636 -0
- package/dist/adapters/govinfo.js.map +1 -0
- package/dist/adapters/gsa-calc.d.ts +10 -0
- package/dist/adapters/gsa-calc.js +318 -0
- package/dist/adapters/gsa-calc.js.map +1 -0
- package/dist/adapters/hud.d.ts +3 -0
- package/dist/adapters/hud.js +200 -0
- package/dist/adapters/hud.js.map +1 -0
- package/dist/adapters/index.d.ts +3 -0
- package/dist/adapters/index.js +25 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/irs-soi.d.ts +6 -0
- package/dist/adapters/irs-soi.js +576 -0
- package/dist/adapters/irs-soi.js.map +1 -0
- package/dist/adapters/naep.d.ts +15 -0
- package/dist/adapters/naep.js +341 -0
- package/dist/adapters/naep.js.map +1 -0
- package/dist/adapters/nhtsa.d.ts +10 -0
- package/dist/adapters/nhtsa.js +239 -0
- package/dist/adapters/nhtsa.js.map +1 -0
- package/dist/adapters/nih.d.ts +5 -0
- package/dist/adapters/nih.js +196 -0
- package/dist/adapters/nih.js.map +1 -0
- package/dist/adapters/noaa.d.ts +3 -0
- package/dist/adapters/noaa.js +148 -0
- package/dist/adapters/noaa.js.map +1 -0
- package/dist/adapters/nrel.d.ts +3 -0
- package/dist/adapters/nrel.js +186 -0
- package/dist/adapters/nrel.js.map +1 -0
- package/dist/adapters/nws.d.ts +3 -0
- package/dist/adapters/nws.js +119 -0
- package/dist/adapters/nws.js.map +1 -0
- package/dist/adapters/omb.d.ts +15 -0
- package/dist/adapters/omb.js +517 -0
- package/dist/adapters/omb.js.map +1 -0
- package/dist/adapters/open-payments.d.ts +5 -0
- package/dist/adapters/open-payments.js +149 -0
- package/dist/adapters/open-payments.js.map +1 -0
- package/dist/adapters/pbgc.d.ts +13 -0
- package/dist/adapters/pbgc.js +283 -0
- package/dist/adapters/pbgc.js.map +1 -0
- package/dist/adapters/philfed.d.ts +12 -0
- package/dist/adapters/philfed.js +59 -0
- package/dist/adapters/philfed.js.map +1 -0
- package/dist/adapters/regulations.d.ts +6 -0
- package/dist/adapters/regulations.js +58 -0
- package/dist/adapters/regulations.js.map +1 -0
- package/dist/adapters/sec.d.ts +13 -0
- package/dist/adapters/sec.js +504 -0
- package/dist/adapters/sec.js.map +1 -0
- package/dist/adapters/senate-lobbying.d.ts +3 -0
- package/dist/adapters/senate-lobbying.js +181 -0
- package/dist/adapters/senate-lobbying.js.map +1 -0
- package/dist/adapters/snapqc.d.ts +32 -0
- package/dist/adapters/snapqc.js +701 -0
- package/dist/adapters/snapqc.js.map +1 -0
- package/dist/adapters/treasury-yields.d.ts +3 -0
- package/dist/adapters/treasury-yields.js +170 -0
- package/dist/adapters/treasury-yields.js.map +1 -0
- package/dist/adapters/usaspending.d.ts +3 -0
- package/dist/adapters/usaspending.js +340 -0
- package/dist/adapters/usaspending.js.map +1 -0
- package/dist/adapters/usda-fna.d.ts +7 -0
- package/dist/adapters/usda-fna.js +707 -0
- package/dist/adapters/usda-fna.js.map +1 -0
- package/dist/adapters/usda-fooddata.d.ts +3 -0
- package/dist/adapters/usda-fooddata.js +101 -0
- package/dist/adapters/usda-fooddata.js.map +1 -0
- package/dist/adapters/usda-nass.d.ts +3 -0
- package/dist/adapters/usda-nass.js +108 -0
- package/dist/adapters/usda-nass.js.map +1 -0
- package/dist/adapters/usda-outlook.d.ts +12 -0
- package/dist/adapters/usda-outlook.js +696 -0
- package/dist/adapters/usda-outlook.js.map +1 -0
- package/dist/adapters/usgs.d.ts +9 -0
- package/dist/adapters/usgs.js +265 -0
- package/dist/adapters/usgs.js.map +1 -0
- package/dist/adapters/usitc.d.ts +18 -0
- package/dist/adapters/usitc.js +170 -0
- package/dist/adapters/usitc.js.map +1 -0
- package/dist/adapters/uspto.d.ts +3 -0
- package/dist/adapters/uspto.js +47 -0
- package/dist/adapters/uspto.js.map +1 -0
- package/dist/adapters/world-bank.d.ts +3 -0
- package/dist/adapters/world-bank.js +163 -0
- package/dist/adapters/world-bank.js.map +1 -0
- package/dist/analysis/cite.d.ts +31 -0
- package/dist/analysis/cite.js +229 -0
- package/dist/analysis/cite.js.map +1 -0
- package/dist/analysis/combine.d.ts +27 -0
- package/dist/analysis/combine.js +198 -0
- package/dist/analysis/combine.js.map +1 -0
- package/dist/analysis/compute.d.ts +62 -0
- package/dist/analysis/compute.js +583 -0
- package/dist/analysis/compute.js.map +1 -0
- package/dist/analysis/expr.d.ts +69 -0
- package/dist/analysis/expr.js +780 -0
- package/dist/analysis/expr.js.map +1 -0
- package/dist/analysis/factfmt.d.ts +16 -0
- package/dist/analysis/factfmt.js +187 -0
- package/dist/analysis/factfmt.js.map +1 -0
- package/dist/analysis/facts.d.ts +63 -0
- package/dist/analysis/facts.js +355 -0
- package/dist/analysis/facts.js.map +1 -0
- package/dist/analysis/handoff.d.ts +58 -0
- package/dist/analysis/handoff.js +208 -0
- package/dist/analysis/handoff.js.map +1 -0
- package/dist/analysis/pyfmt.d.ts +16 -0
- package/dist/analysis/pyfmt.js +156 -0
- package/dist/analysis/pyfmt.js.map +1 -0
- package/dist/analysis/rerun.d.ts +13 -0
- package/dist/analysis/rerun.js +125 -0
- package/dist/analysis/rerun.js.map +1 -0
- package/dist/analysis/table.d.ts +18 -0
- package/dist/analysis/table.js +109 -0
- package/dist/analysis/table.js.map +1 -0
- package/dist/analysis/tools.d.ts +67 -0
- package/dist/analysis/tools.js +217 -0
- package/dist/analysis/tools.js.map +1 -0
- package/dist/analysis/write_table.d.ts +13 -0
- package/dist/analysis/write_table.js +59 -0
- package/dist/analysis/write_table.js.map +1 -0
- package/dist/bin/cli.d.ts +10 -0
- package/dist/bin/cli.js +177 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/core/cache.d.ts +14 -0
- package/dist/core/cache.js +90 -0
- package/dist/core/cache.js.map +1 -0
- package/dist/core/context.d.ts +12 -0
- package/dist/core/context.js +15 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/env.d.ts +14 -0
- package/dist/core/env.js +52 -0
- package/dist/core/env.js.map +1 -0
- package/dist/core/generic-rest.d.ts +61 -0
- package/dist/core/generic-rest.js +639 -0
- package/dist/core/generic-rest.js.map +1 -0
- package/dist/core/http.d.ts +120 -0
- package/dist/core/http.js +514 -0
- package/dist/core/http.js.map +1 -0
- package/dist/core/keys.d.ts +43 -0
- package/dist/core/keys.js +174 -0
- package/dist/core/keys.js.map +1 -0
- package/dist/core/manual.d.ts +41 -0
- package/dist/core/manual.js +218 -0
- package/dist/core/manual.js.map +1 -0
- package/dist/core/package.d.ts +58 -0
- package/dist/core/package.js +228 -0
- package/dist/core/package.js.map +1 -0
- package/dist/core/packs.d.ts +139 -0
- package/dist/core/packs.js +173 -0
- package/dist/core/packs.js.map +1 -0
- package/dist/core/policy.d.ts +69 -0
- package/dist/core/policy.js +189 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/py.d.ts +40 -0
- package/dist/core/py.js +171 -0
- package/dist/core/py.js.map +1 -0
- package/dist/core/routing.d.ts +10 -0
- package/dist/core/routing.js +39 -0
- package/dist/core/routing.js.map +1 -0
- package/dist/core/tabular.d.ts +21 -0
- package/dist/core/tabular.js +229 -0
- package/dist/core/tabular.js.map +1 -0
- package/dist/deep/_bea_api.d.ts +102 -0
- package/dist/deep/_bea_api.js +457 -0
- package/dist/deep/_bea_api.js.map +1 -0
- package/dist/deep/_bea_fetch.d.ts +151 -0
- package/dist/deep/_bea_fetch.js +1274 -0
- package/dist/deep/_bea_fetch.js.map +1 -0
- package/dist/deep/_bea_util.d.ts +14 -0
- package/dist/deep/_bea_util.js +156 -0
- package/dist/deep/_bea_util.js.map +1 -0
- package/dist/deep/_bls_api.d.ts +84 -0
- package/dist/deep/_bls_api.js +231 -0
- package/dist/deep/_bls_api.js.map +1 -0
- package/dist/deep/_bls_ids.d.ts +43 -0
- package/dist/deep/_bls_ids.js +188 -0
- package/dist/deep/_bls_ids.js.map +1 -0
- package/dist/deep/_bls_lib.d.ts +61 -0
- package/dist/deep/_bls_lib.js +442 -0
- package/dist/deep/_bls_lib.js.map +1 -0
- package/dist/deep/_fred_api.d.ts +148 -0
- package/dist/deep/_fred_api.js +545 -0
- package/dist/deep/_fred_api.js.map +1 -0
- package/dist/deep/_fred_pack.d.ts +162 -0
- package/dist/deep/_fred_pack.js +1027 -0
- package/dist/deep/_fred_pack.js.map +1 -0
- package/dist/deep/_fred_py.d.ts +40 -0
- package/dist/deep/_fred_py.js +199 -0
- package/dist/deep/_fred_py.js.map +1 -0
- package/dist/deep/_ipums_bundle.d.ts +29 -0
- package/dist/deep/_ipums_bundle.js +194 -0
- package/dist/deep/_ipums_bundle.js.map +1 -0
- package/dist/deep/_ipums_ddi.d.ts +23 -0
- package/dist/deep/_ipums_ddi.js +162 -0
- package/dist/deep/_ipums_ddi.js.map +1 -0
- package/dist/deep/_opm_io.d.ts +26 -0
- package/dist/deep/_opm_io.js +383 -0
- package/dist/deep/_opm_io.js.map +1 -0
- package/dist/deep/_opm_parquet.d.ts +31 -0
- package/dist/deep/_opm_parquet.js +744 -0
- package/dist/deep/_opm_parquet.js.map +1 -0
- package/dist/deep/_opm_py.d.ts +6 -0
- package/dist/deep/_opm_py.js +74 -0
- package/dist/deep/_opm_py.js.map +1 -0
- package/dist/deep/_treasury_api.d.ts +48 -0
- package/dist/deep/_treasury_api.js +221 -0
- package/dist/deep/_treasury_api.js.map +1 -0
- package/dist/deep/_treasury_context.d.ts +34 -0
- package/dist/deep/_treasury_context.js +142 -0
- package/dist/deep/_treasury_context.js.map +1 -0
- package/dist/deep/_treasury_lib.d.ts +109 -0
- package/dist/deep/_treasury_lib.js +686 -0
- package/dist/deep/_treasury_lib.js.map +1 -0
- package/dist/deep/bea.d.ts +3 -0
- package/dist/deep/bea.js +248 -0
- package/dist/deep/bea.js.map +1 -0
- package/dist/deep/bls.d.ts +3 -0
- package/dist/deep/bls.js +220 -0
- package/dist/deep/bls.js.map +1 -0
- package/dist/deep/fred.d.ts +3 -0
- package/dist/deep/fred.js +325 -0
- package/dist/deep/fred.js.map +1 -0
- package/dist/deep/ipums.d.ts +59 -0
- package/dist/deep/ipums.js +744 -0
- package/dist/deep/ipums.js.map +1 -0
- package/dist/deep/opm.d.ts +56 -0
- package/dist/deep/opm.js +1033 -0
- package/dist/deep/opm.js.map +1 -0
- package/dist/deep/treasury.d.ts +3 -0
- package/dist/deep/treasury.js +218 -0
- package/dist/deep/treasury.js.map +1 -0
- package/dist/envelope.d.ts +47 -0
- package/dist/envelope.js +88 -0
- package/dist/envelope.js.map +1 -0
- package/dist/index.d.ts +277 -0
- package/dist/index.js +106 -0
- package/dist/index.js.map +1 -0
- package/dist/remote/app.d.ts +21 -0
- package/dist/remote/app.js +218 -0
- package/dist/remote/app.js.map +1 -0
- package/dist/remote/oauth.d.ts +14 -0
- package/dist/remote/oauth.js +90 -0
- package/dist/remote/oauth.js.map +1 -0
- package/dist/remote/pages.d.ts +8 -0
- package/dist/remote/pages.js +56 -0
- package/dist/remote/pages.js.map +1 -0
- package/dist/remote/sign.d.ts +4 -0
- package/dist/remote/sign.js +40 -0
- package/dist/remote/sign.js.map +1 -0
- package/dist/remote/store.d.ts +31 -0
- package/dist/remote/store.js +129 -0
- package/dist/remote/store.js.map +1 -0
- package/dist/report/audit_answer.d.ts +94 -0
- package/dist/report/audit_answer.js +1349 -0
- package/dist/report/audit_answer.js.map +1 -0
- package/dist/report/audit_report.d.ts +23 -0
- package/dist/report/audit_report.js +637 -0
- package/dist/report/audit_report.js.map +1 -0
- package/dist/report/build_report.d.ts +27 -0
- package/dist/report/build_report.js +1168 -0
- package/dist/report/build_report.js.map +1 -0
- package/dist/report/method_audit.d.ts +47 -0
- package/dist/report/method_audit.js +710 -0
- package/dist/report/method_audit.js.map +1 -0
- package/dist/report/policyset.d.ts +50 -0
- package/dist/report/policyset.js +421 -0
- package/dist/report/policyset.js.map +1 -0
- package/dist/report/py.d.ts +58 -0
- package/dist/report/py.js +311 -0
- package/dist/report/py.js.map +1 -0
- package/dist/report/scan_secrets.d.ts +21 -0
- package/dist/report/scan_secrets.js +234 -0
- package/dist/report/scan_secrets.js.map +1 -0
- package/dist/report/style_check.d.ts +29 -0
- package/dist/report/style_check.js +173 -0
- package/dist/report/style_check.js.map +1 -0
- package/dist/report/tools.d.ts +87 -0
- package/dist/report/tools.js +167 -0
- package/dist/report/tools.js.map +1 -0
- package/dist/server.d.ts +5 -0
- package/dist/server.js +246 -0
- package/dist/server.js.map +1 -0
- package/dist/session.d.ts +47 -0
- package/dist/session.js +107 -0
- package/dist/session.js.map +1 -0
- package/dist/toolkit.d.ts +21 -0
- package/dist/toolkit.js +2 -0
- package/dist/toolkit.js.map +1 -0
- package/dist/tools.d.ts +299 -0
- package/dist/tools.js +491 -0
- package/dist/tools.js.map +1 -0
- package/guide/WORKFLOW.md +134 -0
- package/guide/assets/disclaimer.txt +1 -0
- package/guide/assets/download_data.ps1 +162 -0
- package/guide/assets/download_data.sh +143 -0
- package/guide/assets/report_template.html +597 -0
- package/guide/references/report_patterns.md +199 -0
- package/guide/references/routing.md +171 -0
- package/guide/references/style_guide.md +398 -0
- package/package.json +56 -6
- package/packs/acf/endpoints.json +114 -0
- package/packs/acf/policy.json +104 -0
- package/packs/acf/source.md +138 -0
- package/packs/actuaries/endpoints.json +82 -0
- package/packs/actuaries/policy.json +109 -0
- package/packs/actuaries/source.md +137 -0
- package/packs/bea/assets/download_bea.ps1 +182 -0
- package/packs/bea/assets/download_bea.sh +144 -0
- package/packs/bea/docs/bea_api.md +461 -0
- package/packs/bea/docs/datasets.md +157 -0
- package/packs/bea/docs/report_patterns.md +112 -0
- package/packs/bea/policy.json +170 -0
- package/packs/bea/source.md +152 -0
- package/packs/bls/assets/download_bls.ps1 +152 -0
- package/packs/bls/assets/download_bls.sh +167 -0
- package/packs/bls/docs/analysis_patterns.md +108 -0
- package/packs/bls/docs/bls_api.md +73 -0
- package/packs/bls/docs/series_ids.md +149 -0
- package/packs/bls/policy.json +238 -0
- package/packs/bls/series_ids.json +1375 -0
- package/packs/bls/source.md +156 -0
- package/packs/bts/endpoints.json +347 -0
- package/packs/bts/policy.json +94 -0
- package/packs/bts/source.md +97 -0
- package/packs/cdc/endpoints.json +197 -0
- package/packs/cdc/policy.json +83 -0
- package/packs/cdc/source.md +74 -0
- package/packs/census/endpoints.json +99 -0
- package/packs/census/policy.json +238 -0
- package/packs/census/source.md +304 -0
- package/packs/census-geocoder/endpoints.json +70 -0
- package/packs/census-geocoder/policy.json +80 -0
- package/packs/census-geocoder/source.md +53 -0
- package/packs/cfpb/endpoints.json +327 -0
- package/packs/cfpb/policy.json +119 -0
- package/packs/cfpb/source.md +96 -0
- package/packs/clinical-trials/endpoints.json +167 -0
- package/packs/clinical-trials/policy.json +84 -0
- package/packs/clinical-trials/source.md +82 -0
- package/packs/cms/endpoints.json +69 -0
- package/packs/cms/policy.json +96 -0
- package/packs/cms/source.md +112 -0
- package/packs/college-scorecard/endpoints.json +253 -0
- package/packs/college-scorecard/policy.json +106 -0
- package/packs/college-scorecard/source.md +92 -0
- package/packs/congress/endpoints.json +1701 -0
- package/packs/congress/policy.json +117 -0
- package/packs/congress/source.md +190 -0
- package/packs/dhs-ohss/endpoints.json +66 -0
- package/packs/dhs-ohss/policy.json +107 -0
- package/packs/dhs-ohss/source.md +120 -0
- package/packs/doj-news/endpoints.json +59 -0
- package/packs/doj-news/policy.json +96 -0
- package/packs/doj-news/source.md +99 -0
- package/packs/dol/endpoints.json +818 -0
- package/packs/dol/policy.json +135 -0
- package/packs/dol/source.md +181 -0
- package/packs/eia/endpoints.json +718 -0
- package/packs/eia/policy.json +112 -0
- package/packs/eia/source.md +112 -0
- package/packs/epa/endpoints.json +292 -0
- package/packs/epa/policy.json +99 -0
- package/packs/epa/source.md +99 -0
- package/packs/epa-aqs/endpoints.json +174 -0
- package/packs/epa-aqs/policy.json +96 -0
- package/packs/epa-aqs/source.md +97 -0
- package/packs/fbi/endpoints.json +1842 -0
- package/packs/fbi/policy.json +118 -0
- package/packs/fbi/source.md +108 -0
- package/packs/fda/endpoints.json +238 -0
- package/packs/fda/policy.json +121 -0
- package/packs/fda/source.md +117 -0
- package/packs/fdic/endpoints.json +417 -0
- package/packs/fdic/policy.json +83 -0
- package/packs/fdic/source.md +92 -0
- package/packs/fec/endpoints.json +708 -0
- package/packs/fec/policy.json +93 -0
- package/packs/fec/source.md +90 -0
- package/packs/fed-board/endpoints.json +89 -0
- package/packs/fed-board/policy.json +136 -0
- package/packs/fed-board/source.md +118 -0
- package/packs/federal-register/endpoints.json +143 -0
- package/packs/federal-register/policy.json +86 -0
- package/packs/federal-register/source.md +98 -0
- package/packs/fema/endpoints.json +646 -0
- package/packs/fema/policy.json +103 -0
- package/packs/fema/source.md +103 -0
- package/packs/fhfa/endpoints.json +105 -0
- package/packs/fhfa/policy.json +109 -0
- package/packs/fhfa/source.md +108 -0
- package/packs/fred/assets/download_fred.ps1 +122 -0
- package/packs/fred/assets/download_fred.sh +123 -0
- package/packs/fred/docs/analysis_patterns.md +124 -0
- package/packs/fred/docs/fred_api.md +94 -0
- package/packs/fred/docs/series.md +188 -0
- package/packs/fred/policy.json +253 -0
- package/packs/fred/source.md +142 -0
- package/packs/fsa/endpoints.json +150 -0
- package/packs/fsa/policy.json +99 -0
- package/packs/fsa/source.md +102 -0
- package/packs/govinfo/endpoints.json +520 -0
- package/packs/govinfo/policy.json +116 -0
- package/packs/govinfo/source.md +241 -0
- package/packs/gsa-calc/endpoints.json +93 -0
- package/packs/gsa-calc/policy.json +97 -0
- package/packs/gsa-calc/source.md +108 -0
- package/packs/hud/endpoints.json +147 -0
- package/packs/hud/policy.json +84 -0
- package/packs/hud/source.md +97 -0
- package/packs/ipums/assets/download_ipums.ps1 +215 -0
- package/packs/ipums/assets/download_ipums.sh +192 -0
- package/packs/ipums/docs/ipums_api.md +67 -0
- package/packs/ipums/docs/report_patterns.md +117 -0
- package/packs/ipums/docs/variables.md +284 -0
- package/packs/ipums/lib/fetch_text.json +112 -0
- package/packs/ipums/policy.json +215 -0
- package/packs/ipums/source.md +169 -0
- package/packs/irs-soi/endpoints.json +114 -0
- package/packs/irs-soi/policy.json +107 -0
- package/packs/irs-soi/source.md +124 -0
- package/packs/medicaid/endpoints.json +412 -0
- package/packs/medicaid/policy.json +108 -0
- package/packs/medicaid/source.md +136 -0
- package/packs/naep/endpoints.json +217 -0
- package/packs/naep/policy.json +100 -0
- package/packs/naep/source.md +120 -0
- package/packs/nhtsa/endpoints.json +132 -0
- package/packs/nhtsa/policy.json +93 -0
- package/packs/nhtsa/source.md +109 -0
- package/packs/nih/endpoints.json +453 -0
- package/packs/nih/policy.json +86 -0
- package/packs/nih/source.md +108 -0
- package/packs/noaa/endpoints.json +432 -0
- package/packs/noaa/policy.json +95 -0
- package/packs/noaa/source.md +88 -0
- package/packs/nrel/endpoints.json +328 -0
- package/packs/nrel/policy.json +96 -0
- package/packs/nrel/source.md +91 -0
- package/packs/nws/endpoints.json +272 -0
- package/packs/nws/policy.json +82 -0
- package/packs/nws/source.md +81 -0
- package/packs/nyfed/endpoints.json +80 -0
- package/packs/nyfed/policy.json +92 -0
- package/packs/nyfed/source.md +89 -0
- package/packs/omb/endpoints.json +460 -0
- package/packs/omb/policy.json +106 -0
- package/packs/omb/source.md +130 -0
- package/packs/open-payments/endpoints.json +298 -0
- package/packs/open-payments/policy.json +101 -0
- package/packs/open-payments/source.md +99 -0
- package/packs/opm/assets/download_opm.ps1 +125 -0
- package/packs/opm/assets/download_opm.sh +85 -0
- package/packs/opm/docs/fields.md +184 -0
- package/packs/opm/docs/opm_api.md +71 -0
- package/packs/opm/docs/report_patterns.md +83 -0
- package/packs/opm/lib/data_dictionary.csv +73 -0
- package/packs/opm/policy.json +142 -0
- package/packs/opm/source.md +137 -0
- package/packs/pbgc/endpoints.json +483 -0
- package/packs/pbgc/policy.json +94 -0
- package/packs/pbgc/source.md +95 -0
- package/packs/philfed/endpoints.json +85 -0
- package/packs/philfed/policy.json +94 -0
- package/packs/philfed/source.md +125 -0
- package/packs/port.json +287 -0
- package/packs/regulations/endpoints.json +288 -0
- package/packs/regulations/policy.json +86 -0
- package/packs/regulations/source.md +84 -0
- package/packs/sec/endpoints.json +237 -0
- package/packs/sec/policy.json +86 -0
- package/packs/sec/source.md +101 -0
- package/packs/senate-lobbying/endpoints.json +554 -0
- package/packs/senate-lobbying/policy.json +99 -0
- package/packs/senate-lobbying/source.md +100 -0
- package/packs/snapqc/endpoints.json +1426 -0
- package/packs/snapqc/policy.json +92 -0
- package/packs/snapqc/source.md +96 -0
- package/packs/treasury/catalog.json +2267 -0
- package/packs/treasury/docs/api_guide.md +245 -0
- package/packs/treasury/docs/datasets.md +56 -0
- package/packs/treasury/docs/report_patterns.md +126 -0
- package/packs/treasury/policy.json +159 -0
- package/packs/treasury/source.md +165 -0
- package/packs/treasury-yields/endpoints.json +226 -0
- package/packs/treasury-yields/policy.json +86 -0
- package/packs/treasury-yields/source.md +80 -0
- package/packs/usaspending/endpoints.json +1316 -0
- package/packs/usaspending/policy.json +109 -0
- package/packs/usaspending/source.md +103 -0
- package/packs/usda-fna/endpoints.json +427 -0
- package/packs/usda-fna/policy.json +133 -0
- package/packs/usda-fna/source.md +217 -0
- package/packs/usda-fooddata/endpoints.json +181 -0
- package/packs/usda-fooddata/policy.json +94 -0
- package/packs/usda-fooddata/source.md +105 -0
- package/packs/usda-nass/endpoints.json +324 -0
- package/packs/usda-nass/policy.json +95 -0
- package/packs/usda-nass/source.md +85 -0
- package/packs/usda-outlook/endpoints.json +86 -0
- package/packs/usda-outlook/policy.json +109 -0
- package/packs/usda-outlook/source.md +144 -0
- package/packs/usgs/endpoints.json +313 -0
- package/packs/usgs/policy.json +95 -0
- package/packs/usgs/source.md +96 -0
- package/packs/usitc/endpoints.json +74 -0
- package/packs/usitc/policy.json +111 -0
- package/packs/usitc/source.md +90 -0
- package/packs/uspto/endpoints.json +141 -0
- package/packs/uspto/policy.json +95 -0
- package/packs/uspto/source.md +101 -0
- package/packs/va/endpoints.json +414 -0
- package/packs/va/policy.json +101 -0
- package/packs/va/source.md +129 -0
- package/packs/world-bank/endpoints.json +122 -0
- package/packs/world-bank/policy.json +101 -0
- package/packs/world-bank/source.md +93 -0
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* BLS Public Data API client for the bls deep pack (port of sources/bls/bls_api.py).
|
|
3
|
+
*
|
|
4
|
+
* The key comes from core keys (BLS_API_KEY, home "bls") and is never printed. Without a key the client uses API v1
|
|
5
|
+
* (no registration, lower limits); with a key, v2.
|
|
6
|
+
*
|
|
7
|
+
* Limits (https://www.bls.gov/developers/api_faqs.htm, read 2026-10-19):
|
|
8
|
+
* v2 (registered) v1 (no key)
|
|
9
|
+
* queries per day 500 25
|
|
10
|
+
* series per query 50 25
|
|
11
|
+
* years per query 20 10
|
|
12
|
+
* BLS answers HTTP 200 even for most errors: the outcome is in "status" and "message". A rejected key is echoed
|
|
13
|
+
* in the message, so the pack registers a 32-hex redaction pattern.
|
|
14
|
+
*/
|
|
15
|
+
import { Client, DataError } from "../core/http.js";
|
|
16
|
+
import * as keys from "../core/keys.js";
|
|
17
|
+
import { sleep } from "../core/py.js";
|
|
18
|
+
export const URLS = { v1: "https://api.bls.gov/publicAPI/v1/timeseries/data/",
|
|
19
|
+
v2: "https://api.bls.gov/publicAPI/v2/timeseries/data/" };
|
|
20
|
+
export const LIMITS = { v2: { series: 50, years: 20, daily: 500 }, v1: { series: 25, years: 10, daily: 25 } };
|
|
21
|
+
export const REGISTER_URL = "https://data.bls.gov/registrationEngine/";
|
|
22
|
+
export const AUTH = { env: "BLS_API_KEY", home: "bls", placement: "body", param: "registrationkey" };
|
|
23
|
+
const UA = "data-analyst/1.0 (bls pack; Node.js)";
|
|
24
|
+
// BLS echoes a rejected key inside its error message: scrub every 32-hex token as well as known keys.
|
|
25
|
+
keys.addPattern(/(?<![0-9a-fA-F])[0-9a-fA-F]{32}(?![0-9a-fA-F])/, "bls");
|
|
26
|
+
export const findApiKey = () => keys.findKey("BLS_API_KEY", "bls");
|
|
27
|
+
const KIND = { auth: "auth", quota: "rate", network: "network", http: "http", request: "api",
|
|
28
|
+
unavailable: "http" };
|
|
29
|
+
export class BlsError extends DataError {
|
|
30
|
+
blsKind;
|
|
31
|
+
constructor(msg, blsKind = "request") {
|
|
32
|
+
super(msg, KIND[blsKind]);
|
|
33
|
+
this.blsKind = blsKind;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/** Split a request into queries that respect the per-query limits: [(series_chunk, y0, y1), ...]. */
|
|
37
|
+
export function planQueries(series, start, end, version) {
|
|
38
|
+
const lim = LIMITS[version];
|
|
39
|
+
const windows = [];
|
|
40
|
+
for (let y = start; y <= end; y += lim.years)
|
|
41
|
+
windows.push([y, Math.min(end, y + lim.years - 1)]);
|
|
42
|
+
const chunks = [];
|
|
43
|
+
for (let i = 0; i < series.length; i += lim.series)
|
|
44
|
+
chunks.push(series.slice(i, i + lim.series));
|
|
45
|
+
return windows.flatMap(([y0, y1]) => chunks.map((c) => [c, y0, y1]));
|
|
46
|
+
}
|
|
47
|
+
export class BlsClient {
|
|
48
|
+
key;
|
|
49
|
+
keySource;
|
|
50
|
+
version;
|
|
51
|
+
queriesSent = 0;
|
|
52
|
+
http;
|
|
53
|
+
constructor(o = {}) {
|
|
54
|
+
if (o.apiKey) {
|
|
55
|
+
keys.remember(o.apiKey);
|
|
56
|
+
[this.key, this.keySource] = [o.apiKey, "argument"];
|
|
57
|
+
}
|
|
58
|
+
else if (o.useKey !== false)
|
|
59
|
+
[this.key, this.keySource] = findApiKey();
|
|
60
|
+
else
|
|
61
|
+
[this.key, this.keySource] = [null, null];
|
|
62
|
+
this.version = this.key ? "v2" : "v1";
|
|
63
|
+
// v1 sends no key at all; v2 puts it in the JSON body as registrationkey
|
|
64
|
+
this.http = new Client(URLS[this.version], { name: "bls", auth: this.key ? AUTH : {}, key: this.key, rps: 4, burst: 5,
|
|
65
|
+
retries: 3, timeout: o.timeout ?? 60, userAgent: UA });
|
|
66
|
+
}
|
|
67
|
+
toString() {
|
|
68
|
+
return `BlsClient(version=${this.version}, key=[REDACTED])`;
|
|
69
|
+
}
|
|
70
|
+
toJSON() {
|
|
71
|
+
return this.toString();
|
|
72
|
+
}
|
|
73
|
+
async post(body, retries) {
|
|
74
|
+
if (retries !== undefined)
|
|
75
|
+
this.http.retries = retries;
|
|
76
|
+
let r;
|
|
77
|
+
try {
|
|
78
|
+
r = await this.http.request("POST", URLS[this.version], null, { jsonBody: body }); // full URL: keep the trailing /
|
|
79
|
+
}
|
|
80
|
+
catch (e) {
|
|
81
|
+
if (!(e instanceof DataError))
|
|
82
|
+
throw e;
|
|
83
|
+
if (e.status && [500, 502, 503, 504].includes(e.status)) { // "The BLS website is busy" (HTML page)
|
|
84
|
+
throw new BlsError(`BLS API: HTTP ${e.status}: the BLS site is busy or down (after retries)`, "unavailable");
|
|
85
|
+
}
|
|
86
|
+
const kind = { network: "network", rate: "quota", auth: "auth", key_missing: "auth" }[e.kind] ?? "http";
|
|
87
|
+
throw new BlsError(`BLS API: ${e.message}`, kind);
|
|
88
|
+
}
|
|
89
|
+
let out;
|
|
90
|
+
try {
|
|
91
|
+
out = r.body.length ? JSON.parse(r.body.toString("utf8")) : {};
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
throw new BlsError(`BLS API answered with something that is not JSON: ${r.text().slice(0, 200)}`, "http");
|
|
95
|
+
}
|
|
96
|
+
this.queriesSent++;
|
|
97
|
+
const status = out.status ?? "";
|
|
98
|
+
const msgs = (out.message || []).map((m) => keys.withPackScope("bls", () => keys.redact(m)));
|
|
99
|
+
if (status !== "REQUEST_SUCCEEDED") {
|
|
100
|
+
const text = msgs.join(" ") || status;
|
|
101
|
+
const low = text.toLowerCase();
|
|
102
|
+
const kind = low.includes("key") && (low.includes("invalid") || low.includes("expired") || low.includes("not valid")) ? "auth"
|
|
103
|
+
: low.includes("threshold") || low.includes("daily") || low.includes("limit") ? "quota" : "request";
|
|
104
|
+
throw new BlsError(`BLS refused the request (${status}): ${text}`, kind);
|
|
105
|
+
}
|
|
106
|
+
out.message = msgs;
|
|
107
|
+
return out;
|
|
108
|
+
}
|
|
109
|
+
/** Download every series for start..end, split into as many queries as the limits require. v2-only options are
|
|
110
|
+
* dropped on v1. Returns [bySeries, messages, raw (request bodies without the key, and responses)]. */
|
|
111
|
+
async fetch(series0, start, end, o = {}) {
|
|
112
|
+
const series = series0.map((s) => s.trim().toUpperCase());
|
|
113
|
+
const plan = planQueries(series, start, end, this.version);
|
|
114
|
+
const extras = {};
|
|
115
|
+
if (this.version === "v2") {
|
|
116
|
+
for (const [k, v] of [["catalog", o.catalog], ["annualaverage", o.annualaverage], ["calculations", o.calculations],
|
|
117
|
+
["aspects", o.aspects]])
|
|
118
|
+
if (v)
|
|
119
|
+
extras[k] = true;
|
|
120
|
+
}
|
|
121
|
+
const by = new Map(series.map((s) => [s, { data: [], catalog: null }]));
|
|
122
|
+
const messages = [];
|
|
123
|
+
const raw = [];
|
|
124
|
+
for (let i = 0; i < plan.length; i++) {
|
|
125
|
+
const [chunk, y0, y1] = plan[i];
|
|
126
|
+
const body = { seriesid: chunk, startyear: String(y0), endyear: String(y1), ...extras };
|
|
127
|
+
const out = await this.post(body);
|
|
128
|
+
raw.push({ request: body, response: out });
|
|
129
|
+
for (const m of out.message || []) {
|
|
130
|
+
if (m.toLowerCase().includes("reduced to the system-allowed limit")) {
|
|
131
|
+
throw new BlsError(`BLS truncated the year range (${m}); the query plan is wrong`, "request");
|
|
132
|
+
}
|
|
133
|
+
messages.push(m);
|
|
134
|
+
}
|
|
135
|
+
for (const s of out.Results?.series || []) {
|
|
136
|
+
const sid = String(s.seriesID ?? "").toUpperCase();
|
|
137
|
+
if (!by.has(sid))
|
|
138
|
+
by.set(sid, { data: [], catalog: null });
|
|
139
|
+
const rec = by.get(sid);
|
|
140
|
+
rec.data.push(...(s.data || []));
|
|
141
|
+
if (s.catalog && !rec.catalog)
|
|
142
|
+
rec.catalog = s.catalog;
|
|
143
|
+
}
|
|
144
|
+
if (i < plan.length - 1 && !process.env.DATA_ANALYST_FIXTURES)
|
|
145
|
+
await sleep(250); // far below 50 requests per 10 s
|
|
146
|
+
}
|
|
147
|
+
return [by, messages, raw];
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
// ------------------------------------------------------------------ series metadata without a key
|
|
151
|
+
export const DESCRIBE_URL = (sid) => `https://data.bls.gov/timeseries/${sid}`;
|
|
152
|
+
let describeClient = null;
|
|
153
|
+
const ENT = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'", nbsp: " ", ndash: "–",
|
|
154
|
+
mdash: "—", rsquo: "’", lsquo: "‘", rdquo: "”", ldquo: "“", copy: "©", reg: "®" };
|
|
155
|
+
/** html.unescape for the entities BLS pages use. */
|
|
156
|
+
export function unescapeHtml(s) {
|
|
157
|
+
return s.replace(/&(#x[0-9a-fA-F]+|#\d+|[A-Za-z]+);/g, (all, e) => {
|
|
158
|
+
if (e[0] === "#")
|
|
159
|
+
return String.fromCodePoint(e[1] === "x" || e[1] === "X" ? parseInt(e.slice(2), 16) : parseInt(e.slice(1), 10));
|
|
160
|
+
return ENT[e] ?? all;
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
164
|
+
const OEWS_TYPES = { "01": "employment", "02": "employment percent relative standard error",
|
|
165
|
+
"03": "hourly mean wage", "04": "annual mean wage", "05": "wage percent relative standard error",
|
|
166
|
+
"06": "hourly 10th percentile wage", "07": "hourly 25th percentile wage", "08": "hourly median wage",
|
|
167
|
+
"09": "hourly 75th percentile wage", "10": "hourly 90th percentile wage", "11": "annual 10th percentile wage",
|
|
168
|
+
"12": "annual 25th percentile wage", "13": "annual median wage", "14": "annual 75th percentile wage",
|
|
169
|
+
"15": "annual 90th percentile wage", "16": "employment per 1,000 jobs", "17": "location quotient" };
|
|
170
|
+
/** OEWS IDs read by their layout: OE + seasonal + area type + area (7) + industry (6) + SOC (6) + data type (2). */
|
|
171
|
+
function oewsDecoded(sid, url) {
|
|
172
|
+
const [areaType, area, ind, soc, dt] = [sid[3], sid.slice(4, 11), sid.slice(11, 17), sid.slice(17, 23), sid.slice(23, 25)];
|
|
173
|
+
const where = { N: "national", S: "state", M: "metropolitan or nonmetropolitan area" }[areaType];
|
|
174
|
+
const fields = { "Area type": where, "Area code": area, "Industry code": ind,
|
|
175
|
+
"Occupation code (SOC)": soc !== "000000" ? `${soc.slice(0, 2)}-${soc.slice(2)}` : "00-0000 (all occupations)",
|
|
176
|
+
"Data type": OEWS_TYPES[dt] ?? `code ${dt} (unknown)` };
|
|
177
|
+
return { series_id: sid, title: `OEWS ${fields["Data type"]}, SOC ${fields["Occupation code (SOC)"]}, ${where} area ${area}`,
|
|
178
|
+
fields, url, note: "decoded from the ID layout: data.bls.gov has no catalog page for OEWS series, so the ID is not " +
|
|
179
|
+
"verified here. A wrong OEWS ID returns no data at fetch time; check the SOC code against the OEWS occupation list (bls.gov/oes)." };
|
|
180
|
+
}
|
|
181
|
+
/** The describe result from a data.bls.gov series page. */
|
|
182
|
+
export function describePage(sid, url, page) {
|
|
183
|
+
const m = /<table[^>]*catalog[\s\S]*?<\/table>/.exec(page);
|
|
184
|
+
const seg = m ? m[0] : "";
|
|
185
|
+
let cells = [...seg.matchAll(/<t[hd][^>]*>([\s\S]*?)<\/t[hd]>/g)].map((x) => unescapeHtml(x[1].replace(/<[^>]+>/g, " ")).trim());
|
|
186
|
+
cells = cells.filter((c) => c.trim()).map((c) => c.replace(/\s+/g, " "));
|
|
187
|
+
cells = cells.map((c) => c.replace(new RegExp(`^(${esc(sid)})\\s*\\(\\w{1,2}\\)$`), "$1")); // "ID (3)": footnote
|
|
188
|
+
const fields = {};
|
|
189
|
+
let seasonal = "";
|
|
190
|
+
cells.forEach((c, i) => {
|
|
191
|
+
if (c.endsWith(":") && i + 1 < cells.length)
|
|
192
|
+
fields[c.slice(0, -1).trim()] = cells[i + 1];
|
|
193
|
+
if (["seasonally adjusted", "not seasonally adjusted"].includes(c.toLowerCase()))
|
|
194
|
+
seasonal = c;
|
|
195
|
+
});
|
|
196
|
+
const none = !Object.keys(fields).length;
|
|
197
|
+
if (none && /^OE[US][NSM]\d{7}\d{6}\d{6}\d{2}$/.test(sid))
|
|
198
|
+
return oewsDecoded(sid, url);
|
|
199
|
+
if (none && /^C[UW][US][RS]A\d{3}\w+$/.test(sid)) {
|
|
200
|
+
// FRED keeps BLS's pre-2018 metro area codes in its CPI IDs (CUURA101SA0); BLS now uses S-codes
|
|
201
|
+
return { series_id: sid, url, error: "series not found. If the ID came from FRED: FRED keeps " +
|
|
202
|
+
"pre-2018 metro area codes in many CPI IDs (FRED CUURA101SA0 = BLS CUURS12ASA0, New York; " +
|
|
203
|
+
"CUURA207SA0 = CUURS23ASA0, Chicago); take the current area code (here " + sid.slice(4, 8) + ") from " +
|
|
204
|
+
"https://download.bls.gov/pub/time.series/cu/cu.area and check the title" };
|
|
205
|
+
}
|
|
206
|
+
if (none)
|
|
207
|
+
return { series_id: sid, url, error: "series not found, or the page layout changed" };
|
|
208
|
+
let title = Object.entries(fields).find(([k]) => k.toLowerCase() === "series title")?.[1] ?? "";
|
|
209
|
+
if (!title)
|
|
210
|
+
title = Object.entries(fields).filter(([k]) => k.toLowerCase() !== "series id").map(([k, v]) => `${k}: ${v}`).join("; ");
|
|
211
|
+
return { series_id: sid, title, seasonal, fields, url };
|
|
212
|
+
}
|
|
213
|
+
/** Series title and dimensions from https://data.bls.gov/timeseries/<id> (no key, no API query). */
|
|
214
|
+
export async function describe(seriesId) {
|
|
215
|
+
const sid = seriesId.trim().toUpperCase();
|
|
216
|
+
const url = DESCRIBE_URL(sid);
|
|
217
|
+
describeClient ??= new Client("https://data.bls.gov", { name: "bls-describe", rps: 2, burst: 3, retries: 1, timeout: 30,
|
|
218
|
+
userAgent: "Mozilla/5.0 (data-analyst bls pack)" });
|
|
219
|
+
let page;
|
|
220
|
+
try {
|
|
221
|
+
page = (await describeClient.get(url)).text();
|
|
222
|
+
}
|
|
223
|
+
catch (e) {
|
|
224
|
+
if (!(e instanceof DataError))
|
|
225
|
+
throw e;
|
|
226
|
+
const err = e.kind === "not_found" ? "series not found" : `${e.kind}: ${e.message}`;
|
|
227
|
+
return { series_id: sid, url, error: err.slice(0, 200) };
|
|
228
|
+
}
|
|
229
|
+
return describePage(sid, url, page);
|
|
230
|
+
}
|
|
231
|
+
//# sourceMappingURL=_bls_api.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_bls_api.js","sourceRoot":"","sources":["../../src/deep/_bls_api.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
type Data = {
|
|
2
|
+
verified: string;
|
|
3
|
+
surveys: [string, string, boolean][];
|
|
4
|
+
catalog: [string, string, string][];
|
|
5
|
+
laus_measures: [string, string][];
|
|
6
|
+
oews_measures: [string, string][];
|
|
7
|
+
jolts_industries: [string, string][];
|
|
8
|
+
jolts_elements: [string, string][];
|
|
9
|
+
builders: string[];
|
|
10
|
+
states: [string, string, string][];
|
|
11
|
+
};
|
|
12
|
+
export declare function D(): Data;
|
|
13
|
+
/** A ValueError of the Python builders (a spec problem). */
|
|
14
|
+
export declare class SpecError extends Error {
|
|
15
|
+
}
|
|
16
|
+
/** Python repr() of a str or a list of str. */
|
|
17
|
+
export declare function pyRepr(s: unknown): string;
|
|
18
|
+
/** (usps, fips, name) from any form (USPS code, FIPS code, name). */
|
|
19
|
+
export declare function state(x: unknown): [string, string, string];
|
|
20
|
+
export declare function decode(sid0: string): {
|
|
21
|
+
series_id: string;
|
|
22
|
+
prefix: string;
|
|
23
|
+
survey: string;
|
|
24
|
+
seasonal: string;
|
|
25
|
+
};
|
|
26
|
+
export type Built = {
|
|
27
|
+
id: string;
|
|
28
|
+
label: string;
|
|
29
|
+
};
|
|
30
|
+
export declare function laus(st: unknown, county: unknown, measure?: string, seasonal?: string): Built[];
|
|
31
|
+
export declare function oews(occupation: unknown, measure?: string, st?: unknown): Built[];
|
|
32
|
+
export declare function cesState(st: unknown, industry?: string, datatype?: string, seasonal?: string): Built[];
|
|
33
|
+
export declare function jolts(industry?: unknown, measure?: string, rate?: boolean, seasonal?: string): Built[];
|
|
34
|
+
/** The state employment set: LAUS unemployment rate, employment, labor force and CES payrolls. */
|
|
35
|
+
export declare function stateSet(st: unknown): Built[];
|
|
36
|
+
export declare function build(kind: string, kw0: Record<string, unknown>): Built[];
|
|
37
|
+
export declare function searchCatalog(words: string, limit?: number): {
|
|
38
|
+
id: string;
|
|
39
|
+
name: string;
|
|
40
|
+
topic: string;
|
|
41
|
+
}[];
|
|
42
|
+
export declare function topics(): string[];
|
|
43
|
+
export {};
|
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* BLS series IDs: survey prefixes, a topic catalog of common series, and ID builders (port of
|
|
3
|
+
* sources/bls/lib/series_ids.py; the data are in packs/bls/series_ids.json).
|
|
4
|
+
*
|
|
5
|
+
* build("laus", { state: "MD", measure: "unemployment_rate" }) // [{id: "LASST240000000000003", label: ...}]
|
|
6
|
+
* build("laus", { county: "24005" }) // county LAUS (published unadjusted only)
|
|
7
|
+
* build("oews", { occupation: "15-1252", measure: "annual_median_wage", state: "MD" })
|
|
8
|
+
* build("state", { state: "MD" }) // LAUS rate, employment, labor force + CES payrolls
|
|
9
|
+
*
|
|
10
|
+
* Watch these IDs: U-6 is LNS13327709 (LNS13023621 is a level of job losers, not U-6); the ECI prefix is CI (EI is
|
|
11
|
+
* import/export prices); WPUFD4 is PPI final demand, not finished goods.
|
|
12
|
+
*/
|
|
13
|
+
import fs from "node:fs";
|
|
14
|
+
import path from "node:path";
|
|
15
|
+
import { PACKS_DIR } from "../core/env.js";
|
|
16
|
+
import { pyStr } from "../core/py.js";
|
|
17
|
+
let data = null;
|
|
18
|
+
export function D() {
|
|
19
|
+
if (!data)
|
|
20
|
+
data = JSON.parse(fs.readFileSync(path.join(PACKS_DIR, "bls", "series_ids.json"), "utf8"));
|
|
21
|
+
return data;
|
|
22
|
+
}
|
|
23
|
+
/** A ValueError of the Python builders (a spec problem). */
|
|
24
|
+
export class SpecError extends Error {
|
|
25
|
+
}
|
|
26
|
+
/** Python repr() of a str or a list of str. */
|
|
27
|
+
export function pyRepr(s) {
|
|
28
|
+
if (s === null || s === undefined)
|
|
29
|
+
return "None";
|
|
30
|
+
if (Array.isArray(s))
|
|
31
|
+
return "[" + s.map(pyRepr).join(", ") + "]";
|
|
32
|
+
if (typeof s !== "string")
|
|
33
|
+
return pyStr(s);
|
|
34
|
+
const q = s.includes("'") && !s.includes('"') ? '"' : "'";
|
|
35
|
+
return q + s.replace(/\\/g, "\\\\").replace(new RegExp(q, "g"), "\\" + q).replace(/\n/g, "\\n") + q;
|
|
36
|
+
}
|
|
37
|
+
const sortedKeys = (pairs) => pairs.map(([k]) => k).sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
|
|
38
|
+
const lookup = (pairs, k) => pairs.find(([x]) => x === k)?.[1];
|
|
39
|
+
/** (usps, fips, name) from any form (USPS code, FIPS code, name). */
|
|
40
|
+
export function state(x) {
|
|
41
|
+
let key = pyStr(x).trim().toLowerCase();
|
|
42
|
+
if (/^\d+$/.test(key) && key.length <= 2)
|
|
43
|
+
key = key.padStart(2, "0");
|
|
44
|
+
const by = new Map();
|
|
45
|
+
for (const s of D().states)
|
|
46
|
+
for (const k of [s[0].toLowerCase(), s[1], s[2].toLowerCase(), String(Number(s[1]))])
|
|
47
|
+
by.set(k, s);
|
|
48
|
+
const hit = by.get(key) ?? by.get(key.replace(/^0+/, ""));
|
|
49
|
+
if (!hit)
|
|
50
|
+
throw new SpecError(`unknown state ${pyRepr(x)}: give a USPS code (MD), a FIPS code (24) or a name (Maryland)`);
|
|
51
|
+
return hit;
|
|
52
|
+
}
|
|
53
|
+
export function decode(sid0) {
|
|
54
|
+
const sid = sid0.trim().toUpperCase();
|
|
55
|
+
const pre = sid.slice(0, 2);
|
|
56
|
+
const s = D().surveys.find(([p]) => p === pre);
|
|
57
|
+
const [name, hasSa] = s ? [s[1], s[2]] : ["unknown survey prefix: check https://www.bls.gov/help/hlpforma.htm", false];
|
|
58
|
+
let seasonal = "";
|
|
59
|
+
if (hasSa && sid.length > 2 && "SU".includes(sid[2]))
|
|
60
|
+
seasonal = sid[2] === "S" ? "seasonally adjusted" : "not seasonally adjusted";
|
|
61
|
+
return { series_id: sid, prefix: pre, survey: name, seasonal };
|
|
62
|
+
}
|
|
63
|
+
/** _list(): a comma-separated string or a list, as stripped non-empty strings. */
|
|
64
|
+
function list(x) {
|
|
65
|
+
if (x === null || x === undefined || x === "")
|
|
66
|
+
return [];
|
|
67
|
+
if (Array.isArray(x))
|
|
68
|
+
return x.map((v) => pyStr(v).trim()).filter(Boolean);
|
|
69
|
+
return pyStr(x).split(",").map((v) => v.trim()).filter(Boolean);
|
|
70
|
+
}
|
|
71
|
+
export function laus(st, county, measure = "unemployment_rate", seasonal = "S") {
|
|
72
|
+
const code = lookup(D().laus_measures, measure);
|
|
73
|
+
if (!code)
|
|
74
|
+
throw new SpecError(`LAUS measure must be one of ${pyRepr(sortedKeys(D().laus_measures))}`);
|
|
75
|
+
const words = measure.replaceAll("_", " ");
|
|
76
|
+
const out = [];
|
|
77
|
+
for (const c of list(county)) {
|
|
78
|
+
if (!/^\d{5}$/.test(c))
|
|
79
|
+
throw new SpecError(`county must be a 5-digit FIPS code (state + county, e.g. 24005), got ${pyRepr(c)}`);
|
|
80
|
+
out.push({ id: `LAUCN${c}00000000${code}`, label: `County ${c} ${words} (not seasonally adjusted)` });
|
|
81
|
+
}
|
|
82
|
+
for (const s of list(st)) {
|
|
83
|
+
const [, fips, name] = state(s);
|
|
84
|
+
const sa = (seasonal || "S").toUpperCase().slice(0, 1);
|
|
85
|
+
if (!"SU".includes(sa))
|
|
86
|
+
throw new SpecError("seasonal must be S (adjusted) or U (not adjusted)");
|
|
87
|
+
out.push({ id: `LA${sa}ST${fips}00000000000${code}`,
|
|
88
|
+
label: `${name} ${words} (${sa === "S" ? "seasonally adjusted" : "not seasonally adjusted"})` });
|
|
89
|
+
}
|
|
90
|
+
if (!out.length)
|
|
91
|
+
throw new SpecError("laus needs state (name, USPS or FIPS) or county (5-digit FIPS)");
|
|
92
|
+
return out;
|
|
93
|
+
}
|
|
94
|
+
export function oews(occupation, measure = "annual_median_wage", st) {
|
|
95
|
+
const code = lookup(D().oews_measures, measure);
|
|
96
|
+
if (!code)
|
|
97
|
+
throw new SpecError(`OEWS measure must be one of ${pyRepr(sortedKeys(D().oews_measures))}`);
|
|
98
|
+
const out = [];
|
|
99
|
+
for (const occ of list(occupation)) {
|
|
100
|
+
const soc = occ.replaceAll("-", "");
|
|
101
|
+
if (!/^\d{6}$/.test(soc))
|
|
102
|
+
throw new SpecError(`SOC occupation code must look like "15-1252", got ${pyRepr(occ)}`);
|
|
103
|
+
let area, where;
|
|
104
|
+
if (st) {
|
|
105
|
+
const [, fips, name] = state(st);
|
|
106
|
+
[area, where] = [`S${fips}00000`, name];
|
|
107
|
+
}
|
|
108
|
+
else
|
|
109
|
+
[area, where] = ["N0000000", "United States"];
|
|
110
|
+
out.push({ id: `OEU${area}000000${soc}${code}`,
|
|
111
|
+
label: `SOC ${soc.slice(0, 2)}-${soc.slice(2)} ${measure.replaceAll("_", " ")}, ${where} (OEWS, annual)` });
|
|
112
|
+
}
|
|
113
|
+
if (!out.length)
|
|
114
|
+
throw new SpecError("oews needs occupation (SOC code, e.g. 15-1252)");
|
|
115
|
+
return out;
|
|
116
|
+
}
|
|
117
|
+
export function cesState(st, industry = "00000000", datatype = "01", seasonal = "S") {
|
|
118
|
+
if (!/^\d{8}$/.test(industry) || !/^\d{2}$/.test(datatype)) {
|
|
119
|
+
throw new SpecError("industry is 8 digits (00000000 = total nonfarm), datatype 2 digits (01 = employment)");
|
|
120
|
+
}
|
|
121
|
+
return list(st).map((s) => {
|
|
122
|
+
const [, fips, name] = state(s);
|
|
123
|
+
const sa = (seasonal || "S").toUpperCase().slice(0, 1);
|
|
124
|
+
const what = industry === "00000000" && datatype === "01" ? "total nonfarm employment (thousands)"
|
|
125
|
+
: `industry ${industry}, data type ${datatype}`;
|
|
126
|
+
return { id: `SM${sa}${fips}00000${industry}${datatype}`, label: `${name} ${what} (${sa === "S" ? "SA" : "NSA"})` };
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
export function jolts(industry = "000000", measure = "quits", rate = true, seasonal = "S") {
|
|
130
|
+
const el = lookup(D().jolts_elements, measure);
|
|
131
|
+
if (!el)
|
|
132
|
+
throw new SpecError(`JOLTS measure must be one of ${pyRepr(sortedKeys(D().jolts_elements))}`);
|
|
133
|
+
const sa = (seasonal || "S").toUpperCase().slice(0, 1);
|
|
134
|
+
if (!"SU".includes(sa))
|
|
135
|
+
throw new SpecError("seasonal must be S (adjusted) or U (not adjusted)");
|
|
136
|
+
const inds = D().jolts_industries;
|
|
137
|
+
const names = new Map(inds.map(([k, v]) => [v.toLowerCase(), k]));
|
|
138
|
+
const l = list(industry);
|
|
139
|
+
const want = pyStr(industry).toLowerCase() === "all" ? inds.map(([k]) => k) : l.length ? l : ["000000"];
|
|
140
|
+
return want.map((i) => {
|
|
141
|
+
const code = i === "00000000" ? "000000" : names.get(i.toLowerCase()) ?? i;
|
|
142
|
+
const title = lookup(inds, code);
|
|
143
|
+
if (!title)
|
|
144
|
+
throw new SpecError(`unknown JOLTS industry ${pyRepr(i)}; use a code or name from: ` + inds.map(([k, v]) => `${k} ${v}`).join("; "));
|
|
145
|
+
const m = measure.replaceAll("_", " ");
|
|
146
|
+
return { id: `JT${sa}${code}000000000${el}${rate ? "R" : "L"}`,
|
|
147
|
+
label: `${m.charAt(0).toUpperCase() + m.slice(1).toLowerCase()} ${rate ? "rate" : "level (thousands)"}, ${title} (${sa === "S" ? "SA" : "NSA"})` };
|
|
148
|
+
});
|
|
149
|
+
}
|
|
150
|
+
/** The state employment set: LAUS unemployment rate, employment, labor force and CES payrolls. */
|
|
151
|
+
export function stateSet(st) {
|
|
152
|
+
const out = [];
|
|
153
|
+
for (const m of ["unemployment_rate", "employment", "labor_force"])
|
|
154
|
+
out.push(...laus(st, null, m));
|
|
155
|
+
return [...out, ...cesState(st)];
|
|
156
|
+
}
|
|
157
|
+
export function build(kind, kw0) {
|
|
158
|
+
const kw = Object.fromEntries(Object.entries(kw0).filter(([, v]) => v !== null && v !== undefined && v !== ""));
|
|
159
|
+
const str = (k, d) => (k in kw ? pyStr(kw[k]) : d);
|
|
160
|
+
if (kind === "laus")
|
|
161
|
+
return laus(kw.state, kw.county, str("measure", "unemployment_rate"), str("seasonal", "S"));
|
|
162
|
+
if (kind === "oews")
|
|
163
|
+
return oews(kw.occupation, str("measure", "annual_median_wage"), kw.state);
|
|
164
|
+
if (kind === "state")
|
|
165
|
+
return stateSet(kw.state);
|
|
166
|
+
if (kind === "ces_state")
|
|
167
|
+
return cesState(kw.state, str("industry", "00000000"), str("datatype", "01"), str("seasonal", "S"));
|
|
168
|
+
if (kind === "jolts") {
|
|
169
|
+
return jolts(kw.industry ?? "000000", str("measure", "quits"), !["false", "0", "level", "no"].includes(pyStr(kw.rate ?? true).toLowerCase()), str("seasonal", "S"));
|
|
170
|
+
}
|
|
171
|
+
throw new SpecError(`unknown builder ${pyRepr(kind)}; use one of (${D().builders.map(pyRepr).join(", ")})`);
|
|
172
|
+
}
|
|
173
|
+
export function searchCatalog(words, limit = 20) {
|
|
174
|
+
const toks = words.toLowerCase().match(/[a-z0-9-]+/g) || [];
|
|
175
|
+
const hits = [];
|
|
176
|
+
for (const [sid, name, topic] of D().catalog) {
|
|
177
|
+
const text = `${sid} ${name} ${topic}`.toLowerCase();
|
|
178
|
+
const score = toks.filter((t) => text.includes(t)).length + (toks.includes(topic) ? 2 : 0);
|
|
179
|
+
if (score)
|
|
180
|
+
hits.push([-score, { id: sid, name, topic }]);
|
|
181
|
+
}
|
|
182
|
+
hits.sort((a, b) => a[0] - b[0]);
|
|
183
|
+
return hits.slice(0, limit).map((h) => h[1]);
|
|
184
|
+
}
|
|
185
|
+
export function topics() {
|
|
186
|
+
return [...new Set(D().catalog.map(([, , t]) => t))].sort();
|
|
187
|
+
}
|
|
188
|
+
//# sourceMappingURL=_bls_ids.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_bls_ids.js","sourceRoot":"","sources":["../../src/deep/_bls_ids.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import type { Pack } from "../core/packs.js";
|
|
2
|
+
import { type BySeries, type Raw, type Version } from "./_bls_api.js";
|
|
3
|
+
export declare const SOURCE = "bls";
|
|
4
|
+
export type NSpec = {
|
|
5
|
+
description: string;
|
|
6
|
+
series: {
|
|
7
|
+
id: string;
|
|
8
|
+
label: string;
|
|
9
|
+
}[];
|
|
10
|
+
start_year: number;
|
|
11
|
+
end_year: number;
|
|
12
|
+
annual_average: boolean;
|
|
13
|
+
catalog: boolean;
|
|
14
|
+
calculations: boolean;
|
|
15
|
+
aspects: boolean;
|
|
16
|
+
};
|
|
17
|
+
/** The spec with defaults filled in and built IDs expanded; throws SpecError on a problem. */
|
|
18
|
+
export declare function normSpec(spec: any): NSpec;
|
|
19
|
+
/** Two specs asking for the same data hash the same (labels and description do not matter). */
|
|
20
|
+
export declare function fingerprint(sp: NSpec): string;
|
|
21
|
+
export declare function existingData(out: string, fp: string): any | null;
|
|
22
|
+
/** [freq, date] for a BLS period code. Annual averages get freq 'A' and the mid-year date. */
|
|
23
|
+
export declare function periodInfo(year: number, period: string): [string, string];
|
|
24
|
+
export type Row = {
|
|
25
|
+
series_id: string;
|
|
26
|
+
label: string;
|
|
27
|
+
year: number;
|
|
28
|
+
period: string;
|
|
29
|
+
period_name: string;
|
|
30
|
+
freq: string;
|
|
31
|
+
date: string;
|
|
32
|
+
value: string;
|
|
33
|
+
value_raw: string;
|
|
34
|
+
preliminary: number;
|
|
35
|
+
footnote_codes: string;
|
|
36
|
+
footnotes: string;
|
|
37
|
+
latest: number;
|
|
38
|
+
[k: string]: any;
|
|
39
|
+
};
|
|
40
|
+
/** Periods between a series' first and last row that BLS returned no row for at all (not even "-"). */
|
|
41
|
+
export declare function absentPeriods(sub: Row[]): string[];
|
|
42
|
+
export declare function tidy(by: BySeries, labels: Map<string, string>): Row[];
|
|
43
|
+
export type Packaged = {
|
|
44
|
+
req: any;
|
|
45
|
+
meta: any[];
|
|
46
|
+
rows: Row[];
|
|
47
|
+
};
|
|
48
|
+
export declare function packageData(pack: Pack, by: BySeries, messages: string[], raw: Raw, sp: NSpec, out: string, apiVersion: Version, acquired: string, route: string, extraProblems?: string[]): Promise<Packaged>;
|
|
49
|
+
/** The manual download plan: keyless v1 whenever it fits the daily limit, else v2 (needs the user's key). */
|
|
50
|
+
export declare function manualPlan(sp: NSpec): {
|
|
51
|
+
version: Version;
|
|
52
|
+
bodies: Record<string, unknown>[];
|
|
53
|
+
};
|
|
54
|
+
export declare function manualItems(spec: any): any[];
|
|
55
|
+
/** Spec series/years that no successful request asked for (an upload missing some responses). */
|
|
56
|
+
export declare function uncoveredYears(sp: NSpec, requests: any[]): string[];
|
|
57
|
+
export declare function ingest(pack: Pack, paths: string[], sp: NSpec, out: string): Promise<{
|
|
58
|
+
pk: Packaged;
|
|
59
|
+
notes: string[];
|
|
60
|
+
}>;
|
|
61
|
+
export declare function readHeader(p: string): string[];
|