index.ts

Filename	Percent	Threshold	Total	Covered	Uncovered
src/results/parsers/electoral-vote/index.ts	100.00%	80%	142	142	0

import type { Document } from './types.js';
import { ELECTORAL_VOTE } from 'constants/docTypes.js';
import type { NewCandidateElectoralVote } from 'db/schema/candidateElectoralVote.js';
import type { NewDocumentSequence } from 'db/schema/documentSequence.js';
import type { NewElectoralVote } from 'db/schema/electoralVote.js';
import { parseKey } from 'utils/documentKey.js';
import { prettifyTransmissionSourceTypeCodes } from 'utils/prettifyCodes.js';
import { validateTimestamp } from 'utils/validateTimestamp.js';

/**
 * Parses documents we get from querying the `results/electoral-vote` endpoint. It then transforms the data to fit the structure of the electoralVote model and returns an array of objects that can be upserted into the model.
 */
const parseElectoralVotes = (documents: Document[]) => {
  const instances: NewElectoralVote[] = [];

  for (const doc of documents) {
    const {
      nDec: electoralVotesAllocated,
      nUp: electoralVotesAtStake,
      transSrc,
      ts,
    } = doc;

    // Parsed UIDs from doc.key
    const {
      electionType,
      jurisdiction,
      jurisdictionRace,
      office,
      officeRace,
      state,
    } = parseKey(doc.key);

    const instance: NewElectoralVote = {
      uid: state,
      electionType,
      jurisdiction,
      jurisdictionRace,
      office,
      officeRace,
      state,
      electoralVotesAllocated,
      electoralVotesAtStake,
      transmissionSource: prettifyTransmissionSourceTypeCodes(transSrc),
      timestamp: validateTimestamp(ts),
    };

    instances.push(instance);
  }

  return instances;
};

/**
 * Parses documents we get from querying the `results/electoral-vote` endpoint. It then transforms the data to fit the structure of the CandidateElectoralVote model and returns an array of objects that can be upserted into the model.
 */
const parseCandidateElectoralVotes = (documents: Document[]) => {
  const instances: NewCandidateElectoralVote[] = [];

  for (const doc of documents) {
    const { candidates, transSrc, ts } = doc;

    // Parsed UIDs from doc.key
    const {
      electionType,
      jurisdiction,
      jurisdictionRace,
      office,
      officeRace,
      state,
    } = parseKey(doc.key);

    for (const c of candidates) {
      const { cId: candidate, cVote: electoralVotes } = c;

      const candidateRace = `${officeRace}_${candidate}`;

      const instance: NewCandidateElectoralVote = {
        uid: candidateRace,
        candidate,
        candidateRace,
        electionType,
        jurisdiction,
        jurisdictionRace,
        office,
        officeRace,
        state,

        electoralVotes,
        transmissionSource: prettifyTransmissionSourceTypeCodes(transSrc),
        timestamp: validateTimestamp(ts),
      };

      instances.push(instance);
    }
  }
  return instances;
};

const parseSequenceId = (doc: Document) => {
  const { electionType, state } = parseKey(doc.key);
  return `${state}_${electionType}`;
};

/**
 * Parses documents we get from querying the `results/county-vote` endpoint. It then transforms the data to fit the structure of the DocumentSequence model and returns an array of objects that can be upserted into the model.
 */
export const parseDocumentSequences = (documents: Document[]) => {
  const sequences: NewDocumentSequence[] = [];
  for (const vote of documents) {
    const { seq: sequence } = vote;
    const uid = parseSequenceId(vote);

    const documentSequence = {
      uid,
      docType: ELECTORAL_VOTE,
      sequence,
    };

    sequences.push(documentSequence);
  }
  return sequences;
};

export default {
  parseElectoralVotes,
  parseCandidateElectoralVotes,
  parseSequenceId,
  parseDocumentSequences,
};

[]

TypeScript coverage report