us-water-quality-data 1.0.0

package/index.d.ts

@@ -0,0 +1,39 @@
+export interface WaterQualityEntry {
+  zip: string;
+  city: string;
+  state: string;
+  system_name: string;
+  pwsid: string;
+  population: number;
+  water_source: 'SW' | 'GW';
+  total_violations: number;
+  health_violations: number;
+  unresolved_violations: number;
+  lead_level_mg_l: number | null;
+  copper_level_mg_l: number | null;
+  radon_zone: 1 | 2 | 3 | null;
+  home_safety_score: number | null;
+  home_safety_grade: 'A' | 'B' | 'C' | 'D' | 'F' | null;
+  latitude: number;
+  longitude: number;
+  contaminant_count: number;
+  health_contaminant_names: string;
+}
+
+/** Get water quality data for a ZIP code */
+export function getByZip(zip: string | number): WaterQualityEntry | null;
+
+/** Get all entries for a state (2-letter code) */
+export function getByState(state: string): WaterQualityEntry[];
+
+/** Get all entries */
+export function getAll(): WaterQualityEntry[];
+
+/** Get all entries with score at or below threshold (default 50) */
+export function getUnsafe(maxScore?: number): WaterQualityEntry[];
+
+/** Get all entries containing a specific contaminant */
+export function getByContaminant(name: string): WaterQualityEntry[];
+
+/** Raw data array */
+export const data: WaterQualityEntry[];

package/index.js

@@ -0,0 +1,47 @@
+'use strict';
+
+const data = require('./data.json');
+
+const zipIndex = Object.create(null);
+const stateIndex = Object.create(null);
+
+for (let i = 0; i < data.length; i++) {
+  const entry = data[i];
+  zipIndex[entry.zip] = entry;
+  if (!stateIndex[entry.state]) stateIndex[entry.state] = [];
+  stateIndex[entry.state].push(entry);
+}
+
+/** Get water quality data for a ZIP code */
+function getByZip(zip) {
+  return zipIndex[String(zip).padStart(5, '0')] || null;
+}
+
+/** Get all entries for a state (2-letter code) */
+function getByState(state) {
+  return stateIndex[String(state).toUpperCase()] || [];
+}
+
+/** Get all entries */
+function getAll() {
+  return data;
+}
+
+/** Get all entries with score below threshold */
+function getUnsafe(maxScore) {
+  if (maxScore === undefined) maxScore = 50;
+  return data.filter(function (d) {
+    return d.home_safety_score !== null && d.home_safety_score <= maxScore;
+  });
+}
+
+/** Get all entries with a specific contaminant */
+function getByContaminant(name) {
+  var lower = String(name).toLowerCase();
+  return data.filter(function (d) {
+    return d.health_contaminant_names &&
+      d.health_contaminant_names.toLowerCase().indexOf(lower) !== -1;
+  });
+}
+
+module.exports = { getByZip, getByState, getAll, getUnsafe, getByContaminant, data };

package/index.mjs

@@ -0,0 +1,42 @@
+import data from './data.json' assert { type: 'json' };
+
+const zipIndex = Object.create(null);
+const stateIndex = Object.create(null);
+
+for (let i = 0; i < data.length; i++) {
+  const entry = data[i];
+  zipIndex[entry.zip] = entry;
+  if (!stateIndex[entry.state]) stateIndex[entry.state] = [];
+  stateIndex[entry.state].push(entry);
+}
+
+/** Get water quality data for a ZIP code */
+export function getByZip(zip) {
+  return zipIndex[String(zip).padStart(5, '0')] || null;
+}
+
+/** Get all entries for a state (2-letter code) */
+export function getByState(state) {
+  return stateIndex[String(state).toUpperCase()] || [];
+}
+
+/** Get all entries */
+export function getAll() {
+  return data;
+}
+
+/** Get all entries with score below threshold */
+export function getUnsafe(maxScore = 50) {
+  return data.filter(d => d.home_safety_score !== null && d.home_safety_score <= maxScore);
+}
+
+/** Get all entries with a specific contaminant */
+export function getByContaminant(name) {
+  const lower = String(name).toLowerCase();
+  return data.filter(d =>
+    d.health_contaminant_names &&
+    d.health_contaminant_names.toLowerCase().includes(lower)
+  );
+}
+
+export { data };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "us-water-quality-data",
+  "version": "1.0.0",
+  "description": "U.S. water quality data by ZIP code — violations, lead/copper levels, radon zones, and Home Safety Scores for 6,300+ ZIP codes. Based on EPA SDWIS data.",
+  "main": "index.js",
+  "module": "index.mjs",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.mjs",
+    "index.d.ts",
+    "data.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "water-quality",
+    "epa",
+    "drinking-water",
+    "lead",
+    "contaminants",
+    "radon",
+    "zip-code",
+    "usa",
+    "public-health",
+    "sdwis",
+    "environmental-data",
+    "open-data"
+  ],
+  "homepage": "https://zipcheckup.com/data/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/artakulov/us-water-quality-data"
+  },
+  "bugs": {
+    "url": "https://github.com/artakulov/us-water-quality-data/issues"
+  },
+  "author": "ZipCheckup <contact@zipcheckup.com> (https://zipcheckup.com)",
+  "license": "CC-BY-4.0"
+}