pastCandidateVoteByCounty.ts

Filename	Percent	Threshold	Total	Covered	Uncovered
src/events/parsers/past-county-data/pastCandidateVoteByCounty.ts	100.00%	80%	96	96	0

import {
  parseCountyUid,
  parseKey,
  parseOfficeRaceUid,
  parseOfficeUid,
} from 'utils/documentKey.js';

import type { Document } from './types.js';
import type { NewPastCandidateVoteByCounty } from 'db/schema/pastCandidateVoteByCounty.js';
import { validateTimestamp } from 'utils/validateTimestamp.js';

/**
 * Parses documents we get from querying the `events/past-county-data` endpoint. It then transforms the data to fit the structure of the PastCandidateVoteByCounty model and returns an array of objects that can be upserted into the model.
 *
 * The returned array contains vote counts for each candidate and total votes for all candidates in each county for a particular past election. Each candidate may have voting data for multiple past elections.
 */
export const parsePastCandidateVotesByCounty = (documents: Document[]) => {
  const instances: NewPastCandidateVoteByCounty[] = [];
  for (const doc of documents) {
    const { state, jurisdiction, jurisdictionRace, electionType } = parseKey(
      doc.key
    );
    const { eDate: pastElectionDate } = doc.key;
    const { races } = doc;

    for (const race of races) {
      const { ofc, counties } = race;

      // Get unique IDs
      const office = parseOfficeUid(jurisdiction, ofc);
      const officeRace = parseOfficeRaceUid(office, electionType);

      // Loop through counties
      for (const cntyObj of counties) {
        const { cnty, candVotes, totVote: totalVoteForAllCandidates } = cntyObj;

        // Get county unique ID
        const county = parseCountyUid(state, cnty);

        // Loop through candidates in each county
        for (const cv of candVotes) {
          const {
            cId: candidate,
            cVote: candidateVote,

            // These fields are optional and may not be provided by EdisonTonight API.
            aVote: absenteeVote,
            earlyByMailVote,
            earlyInPersonVote,
            edayVote: electionDayVote,
            otherVote,
          } = cv;

          // Get unique ID
          const candidateRace = `${officeRace}_${candidate}`;

          const instance: NewPastCandidateVoteByCounty = {
            uid: `${candidateRace}_${county || 0}_${pastElectionDate}`,

            state,
            county,

            // Non foreign keys
            // We can't associate PastCandidateVote to these models because candidates may have run for
            // offices different from what they're currently running for in past elections.
            /**
             * @TODO This means we need many-to-many models. -Jon
             */
            candidate,
            candidateRace,
            jurisdiction,
            jurisdictionRace,
            office,
            officeRace,

            // Candidate's total vote count and total vote for all candidates
            candidateVote,
            totalVoteForAllCandidates,

            // Past election date
            pastElectionDate: validateTimestamp(pastElectionDate),

            // optional data
            absenteeVote,
            earlyByMailVote,
            earlyInPersonVote,
            electionDayVote,
            otherVote,
          };
          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