state.ts

Filename	Percent	Threshold	Total	Covered	Uncovered
src/events/parsers/county-by-state/state.ts	90.10%	80%	101	91	10

import type { Document } from './types.js';
import type { Document as ElectionDocument } from '../election/types.js';
import { states } from 'constants/states.js';
import type { NewState } from 'db/schema/state.js';

// Returns the jurisdiction name for a particular state from the events/election endpoint data documents.
const findJurisdictionName = (st, electionDocs) => {
  return electionDocs.find((doc) => doc.key.st === st).jName;
};

/**
 * Parses documents we get from querying the `events/county-by-state` and `events/election` endpoints. It then transforms the data to fit the structure of the State model and returns an array of objects that can be upserted into the model.
 *
 * The returned array contains metadata for states such as the FIPS code, state name and the number of counties in the state.
 */
export const parseStates = (
  countyByStateDocs: Document[],
  electionDocs: ElectionDocument[]
) => {
  return countyByStateDocs
    .filter((doc) => doc.key.st > 0)
    .map((docPartial) => {
      const doc: typeof docPartial & { counties?: typeof docPartial.county } =
        docPartial;

      // Get keys and other values from the county-by-state doc
      const {
        key,
        numCntys: numCounties,
        numPseudoCntys: numPseudoCounties,
      } = doc;
      const { st } = key;

      /**
       * 🚨 Inconsistent with API schema
       * doc.counties: Key name in 2020 general election docs
       * doc.county: Key name in API schema
       */
      const countyFips = doc.county ? doc.county[0].fips : doc.counties[0].fips; // Key name in Edison's docs

      // Turn FIPS code into state FIPS code and stringify
      const fips = String(countyFips).padStart(5, '0').slice(0, 2);

      return {
        uid: st,
        code: st,
        fips,
        numCounties,
        numPseudoCounties,
        pseudoState: st > 51,
      };
    })
    .map((state) => {
      const filteredState = states.find((s) => s.code === state.uid);

      // Get the name, AP and postal abbreviations from the states constant
      const name = filteredState?.name;
      const apAbbr = filteredState?.apAbbr;
      const postalAbbr = filteredState?.postalAbbr;

      const instance: NewState = {
        ...state,
        // Add jName from election endpoint data if it's a pseudo state
        name:
          state.code > 51
            ? findJurisdictionName(state.code, electionDocs)
            : name,
        apAbbr: apAbbr,
        postalAbbr: postalAbbr,
      };
      return instance;
    });
};

[{"file":"src/events/parsers/county-by-state/state.ts","line":6,"character":30,"text":"st","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":6,"character":34,"text":"electionDocs","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":9,"text":"electionDocs","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":22,"text":"find","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":28,"text":"doc","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":36,"text":"doc","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":40,"text":"key","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":44,"text":"st","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":51,"text":"st","kind":1},{"file":"src/events/parsers/county-by-state/state.ts","line":7,"character":55,"text":"jName","kind":1}]

TypeScript coverage report