/** * DOL SDK — typed API client for the U.S. Department of Labor APIs. * * Covers OSHA (inspections, violations, accidents), WHD (Wage and Hour Division * enforcement), and ETA (Employment and Training Administration — UI claims). * * Standalone — no MCP server required. Usage: * * import { getOshaInspections, getOshaViolations, getWhdEnforcement } from "us-gov-open-data-mcp/sdk/dol"; * * const inspections = await getOshaInspections({ state: "TX", limit: 25 }); * console.log(inspections); * * Requires DOL_API_KEY (free registration: https://data.dol.gov/registration via LOGIN.GOV). * Docs: https://data.dol.gov/user-guide */ /** Osha Inspection. */ export interface OshaInspection { activity_nr?: number; reporting_id?: string; state_flag?: string; estab_name?: string; site_address?: string; site_city?: string; site_state?: string; site_zip?: string; owner_type?: string; owner_code?: string; adv_notice?: string; safety_hlth?: string; sic_code?: string; naics_code?: string; insp_type?: string; insp_scope?: string; why_no_insp?: string; union_status?: string; safety_manuf?: string; safety_const?: string; safety_marit?: string; health_manuf?: string; health_const?: string; health_marit?: string; migrant?: string; mail_street?: string; mail_city?: string; mail_state?: string; mail_zip?: string; host_est_key?: string; nr_in_estab?: number; open_date?: string; case_mod_date?: string; close_conf_date?: string; close_case_date?: string; ld_dt?: string; [key: string]: unknown; } /** Osha Violation. */ export interface OshaViolation { activity_nr?: number; citation_id?: string; delete_flag?: string; standard?: string; viol_type?: string; issuance_date?: string; abate_date?: string; abate_complete?: string; current_penalty?: number; initial_penalty?: number; contest_date?: string; final_order_date?: string; nr_instances?: number; nr_exposed?: number; rec?: string; gravity?: string; emphasis?: string; hazcat?: string; fta_insp_nr?: number; fta_issuance_date?: string; fta_penalty?: number; fta_contest_date?: string; fta_final_order_date?: string; hazsub1?: string; hazsub2?: string; hazsub3?: string; hazsub4?: string; hazsub5?: string; [key: string]: unknown; } /** Osha Accident. */ export interface OshaAccident { summary_nr?: number; event_date?: string; event_time?: string; event_desc?: string; event_keyword?: string; const_end_use?: string; build_stories?: number; nonbuild_ht?: number; project_cost?: string; project_type?: string; sic_list?: string; fatession?: string; state?: string; sitecity?: string; sitestate?: string; sitezip?: string; owner_type?: string; nature_of_insp?: string; abstract_text?: string; load_dt?: string; [key: string]: unknown; } /** Osha Accident Injury. */ export interface OshaAccidentInjury { summary_nr?: number; rel_insp_nr?: number; age?: number; sex?: string; nature_of_inj?: number; part_of_body?: number; src_of_injury?: number; event_type?: number; evn_factor?: number; human_factor?: number; occ_code?: number; degree_of_inj?: number; task_assigned?: number; hazsub?: string; const_op?: number; const_op_cause?: number; fat_cause?: number; fall_distance?: number; fall_ht?: number; injury_line_nr?: number; [key: string]: unknown; } /** Whd Enforcement. */ export interface WhdEnforcement { case_id?: number; trade_nm?: string; legal_name?: string; street_addr_1_txt?: string; cty_nm?: string; st_cd?: string; zip_cd?: string; naic_cd?: string; naics_code_description?: string; case_violtn_cnt?: number; cmp_assd_cnt?: number; ee_violtd_cnt?: number; bw_atp_amt?: number; ee_atp_cnt?: number; findings_start_date?: string; findings_end_date?: string; flsa_violtn_cnt?: number; flsa_repeat_violator?: string; flsa_bw_atp_amt?: number; flsa_ee_atp_cnt?: number; flsa_mw_bw_atp_amt?: number; flsa_ot_bw_atp_amt?: number; flsa_15a3_bw_atp_amt?: number; flsa_cmp_assd_amt?: number; sca_violtn_cnt?: number; sca_bw_atp_amt?: number; sca_ee_atp_cnt?: number; dbra_violtn_cnt?: number; dbra_bw_atp_amt?: number; dbra_ee_atp_cnt?: number; fmla_violtn_cnt?: number; fmla_bw_atp_amt?: number; fmla_ee_atp_cnt?: number; [key: string]: unknown; } /** Ui Claims National. */ export interface UiClaimsNational { rptdate?: string; reflected_week_end?: string; initial_claims?: number; continued_claims?: number; covered_employment?: number; insured_unemployment_rate?: number; [key: string]: unknown; } /** Ui Claims State. */ export interface UiClaimsState { st?: string; rptdate?: string; reflected_week_end?: string; initial_claims?: number; continued_claims?: number; covered_employment?: number; insured_unemployment_rate?: number; [key: string]: unknown; } /** OSHA inspection types. */ export declare const INSPECTION_TYPES: { readonly A: "Accident investigation"; readonly B: "Complaint"; readonly C: "Referral"; readonly D: "Monitoring"; readonly E: "Variance"; readonly F: "Follow-up"; readonly G: "Unprogrammed related"; readonly H: "Planned"; readonly I: "Unprogrammed other"; readonly J: "Programmed related"; readonly K: "Programmed other"; readonly L: "Programmed — high hazard"; }; /** OSHA violation types. */ export declare const VIOLATION_TYPES: { readonly S: "Serious"; readonly W: "Willful"; readonly R: "Repeat"; readonly O: "Other-than-serious"; readonly U: "Unclassified"; readonly F: "Failure to abate"; }; /** Available DOL API datasets. */ export declare const DATASETS: { readonly "OSHA/inspection": "OSHA workplace inspections — site, type, scope, dates"; readonly "OSHA/violation": "OSHA violations found during inspections — standards, penalties, abatement"; readonly "OSHA/accident": "OSHA accident/fatality investigations — events, descriptions"; readonly "OSHA/accident_injury": "Injuries from OSHA accident investigations — demographics, injury type"; readonly "WHD/enforcement": "Wage & Hour Division enforcement — back wages, penalties, FLSA/FMLA/DBRA violations"; readonly "ETA/ui_claims_national": "Unemployment Insurance weekly claims — national"; readonly "ETA/ui_claims_state": "Unemployment Insurance weekly claims — by state"; }; /** * Search OSHA workplace inspections. * * Example: * const inspections = await getOshaInspections({ state: "TX", limit: 25 }); * const recent = await getOshaInspections({ estab_name: "Amazon", limit: 10 }); */ export declare function getOshaInspections(opts?: { state?: string; estab_name?: string; sic_code?: string; naics_code?: string; insp_type?: string; limit?: number; offset?: number; sort_by?: string; sort_order?: string; }): Promise; /** * Search OSHA violations found during inspections. * * Example: * const violations = await getOshaViolations({ activity_nr: 317463633 }); * const willful = await getOshaViolations({ viol_type: "W", limit: 25 }); */ export declare function getOshaViolations(opts?: { activity_nr?: number; viol_type?: string; standard?: string; limit?: number; offset?: number; sort_by?: string; sort_order?: string; }): Promise; /** * Search OSHA accident/fatality investigations. * * Example: * const accidents = await getOshaAccidents({ state: "CA", limit: 25 }); */ export declare function getOshaAccidents(opts?: { state?: string; sic_code?: string; event_keyword?: string; limit?: number; offset?: number; sort_by?: string; sort_order?: string; }): Promise; /** * Get injury details from OSHA accident investigations. * * Example: * const injuries = await getOshaAccidentInjuries({ summary_nr: 123456 }); */ export declare function getOshaAccidentInjuries(opts?: { summary_nr?: number; degree_of_inj?: number; limit?: number; offset?: number; }): Promise; /** * Search WHD (Wage and Hour Division) enforcement cases. * Covers FLSA (minimum wage, overtime), FMLA, Davis-Bacon, Service Contract Act violations. * * Example: * const cases = await getWhdEnforcement({ state: "TX", limit: 25 }); * const company = await getWhdEnforcement({ trade_nm: "McDonald's", limit: 10 }); */ export declare function getWhdEnforcement(opts?: { state?: string; trade_nm?: string; naics_code?: string; limit?: number; offset?: number; sort_by?: string; sort_order?: string; }): Promise; /** * Get national weekly Unemployment Insurance claims data. * * Example: * const claims = await getUiClaimsNational({ limit: 52 }); */ export declare function getUiClaimsNational(opts?: { limit?: number; offset?: number; sort_by?: string; sort_order?: string; }): Promise; /** * Get state-level weekly Unemployment Insurance claims data. * * Example: * const claims = await getUiClaimsState({ state: "CA", limit: 52 }); */ export declare function getUiClaimsState(opts?: { state?: string; limit?: number; offset?: number; sort_by?: string; sort_order?: string; }): Promise; /** Clear cached responses. */ export declare function clearCache(): void; //# sourceMappingURL=sdk.d.ts.map