county.ts

Filename	Percent	Threshold	Total	Covered	Uncovered
src/events/parsers/county-by-state/county.ts	100.00%	80%	87	87	0

import type { Document } from './types.js';
import type { NewCounty } from 'db/schema/county.js';
import { parseKey } from 'utils/documentKey.js';
import { townStatesFips } from 'constants/geography.js';

/**
 * Parses documents we get from querying the `events/county-by-state` endpoint. It then transforms the data to fit the structure of the County model and returns an array of objects that can be upserted into the model.
 *
 * The returned array contains metadata for counties such as the county FIPS code, county name and total registered voters.
 */
export const parseCounties = (documents: Document[]) => {
  const instances: NewCounty[] = [];

  for (const docPartial of documents) {
    const doc: typeof docPartial & { counties?: typeof docPartial.county } =
      docPartial;
    const { st } = doc.key;
    const { state } = parseKey(doc.key);

    /**
     * 🚨 Inconsistent with API schema
     * doc.counties: Key name in 2020 general election docs
     * doc.county: Key name in API schema
     */
    const countyArr = doc?.counties ? doc.counties : doc.county;

    for (const county of countyArr) {
      const {
        absMethodId: absenteeMethod,
        cnty,
        cntyAbbv: abbr,
        cntyName: name,
        cntyTotReg: totalRegisteredVoters,
        mainCnty,
        maxAbs: maxAbsenteeBallotsExpected,
      } = county;
      const fips = String(county.fips).padStart(5, '0');
      const isTown = townStatesFips.includes(fips.slice(0, 2));
      const isPseudo = county.mainCnty > 0;

      const instance: NewCounty = {
        uid: cnty > 0 ? `${st}_${cnty}` : null,
        state,
        absenteeMethod,
        fips: isPseudo ? null : fips,
        code: cnty > 0 ? cnty : null,
        abbr,
        name,
        totalRegisteredVoters,
        isTown,
        isPseudoCounty: isPseudo,
        containingCounty: isPseudo ? mainCnty : null,
        maxAbsenteeBallotsExpected,
      };
      instances.push(instance);
    }
  }
  return instances;
};

[]

TypeScript Coverage Report generated by type-coverage and typescript-coverage-report at Thu, 04 Apr 2024 19:50:44 GMT

TypeScript coverage report