delegateDistrict.ts

Filename	Percent	Threshold	Total	Covered	Uncovered
src/events/parsers/delegate-district/delegateDistrict.ts	100.00%	80%	126	126	0

import type { Document } from './types.js';
import type { NewDelegateDistrict } from 'db/schema/delegateDistrict.js';
import type { NewDelegateDistrictCounty } from 'db/schema/delegateDistrictCounty.js';
import { parseKey } from 'utils/documentKey.js';
import { prettifyDistrictTypeCodes } from 'utils/prettifyCodes.js';

/**
 * Parses documents we get from querying the `events/delegate-district` endpoint. It then transforms the data to fit the structure of the DelegateDistrictType model and returns an array of objects that can be upserted into the model.
 *
 * The returned array contains metadata about districts used to report on a particular election such as the district name.
 */
export const parseDelegateDistricts = (documents: Document[]) => {
  const instances: NewDelegateDistrict[] = [];
  for (const doc of documents) {
    /**
     * @TODO - Check if key is truly optional. Run a test to see if there are any instances where key doesn't exist.
     */
    const { st, eType } = doc.key;
    const { state, jurisdiction, electionType } = parseKey(doc.key);

    for (const districtType of doc['district-types']) {
      const { dType, dTot, districts } = districtType;
      const delegateDistrictType = `${st}_${dType}`;

      for (const district of districts) {
        const { dId, districtName, districtAbbrev, totPcts, statewideFlg } =
          district;
        const instance: NewDelegateDistrict = {
          uid: `${st}_${eType}_${dType}_${dId}`,
          delegateDistrictType,
          electionType,
          jurisdiction,
          state,

          id: dId,
          name: districtName,
          abbr: districtAbbrev,
          isStatewide: statewideFlg,
          totalDelegates: dTot,
          totalPrecincts: totPcts,
        };
        instances.push(instance);
      }
    }
  }
  return instances;
};

/**
 * Parses documents we get from querying the `events/delegate-district` endpoint. It then transforms the data to fit the structure of the DistrictCounties model and returns an array of objects that can be upserted into the model.
 *
 * The returned array contains information about what districts counties belong to. Each object in the array is a unique instance of a county and a district. For example, if a county belongs to two districts, there will be two objects in the array for that county.
 */
export const parseDelegateDistrictCounties = (documents: Document[]) => {
  const instances: NewDelegateDistrictCounty[] = [];
  for (const doc of documents) {
    const { st, eType } = doc.key;
    const { state, electionType } = parseKey(doc.key);
    for (const districtType of doc['district-types']) {
      const { districts, dType } = districtType;

      for (const district of districts) {
        const { dId, counties } = district;
        const delegateDistrict = `${st}_${eType}_${dType}_${dId}`;
        for (const county of counties) {
          const instance: NewDelegateDistrictCounty = {
            uid: `${delegateDistrict}_${county.cnty}`,
            county: state && county.cnty > 0 ? `${state}_${county.cnty}` : null, // 🔑
            delegateDistrict, // 🔑
            electionType, // 🔑

            districtTypeCode: dType,
            districtTypeName: prettifyDistrictTypeCodes(dType),

            totalPrecinctsInCounty: county.cntyTotPcts,
          };
          instances.push(instance);
        }
      }
    }
  }
  return instances;
};

[]

TypeScript coverage report