elections-types 1.0.91 → 1.0.93

package/dist/src/types/FederalElectionF1File.js

@@ -1,48 +1,48 @@
-import { is_committee_designation } from "./Committee.js";
-import { is_election_id } from "./Election.js";
+import { is_federal_election_committee_designation } from "./FederalElectionCommittee.js";
+import { is_federal_election_id } from "./FederalElection.js";
 import { FederalElectionFile } from "./FederalElectionFile.js";
 export class FederalElectionF1File extends FederalElectionFile {
-    committee_id;
+    federal_election_committee_id;
     name;
     url;
     report_date;
     designation;
-    election_id;
-    candidate_id;
-    jfp_committee_ids;
-    jfr_committee_ids;
-    aff_committee_ids;
-    sponsor_candidate_ids;
+    federal_election_id;
+    federal_election_candidate_id;
+    jfp_federal_election_committee_ids;
+    jfr_federal_election_committee_ids;
+    aff_federal_election_committee_ids;
+    sponsor_federal_election_candidate_ids;
     constructor(federal_election_file) {
         if (!FederalElectionF1File.is(federal_election_file)) {
             throw Error("Invalid input.");
         }
         super(federal_election_file);
-        this.committee_id = federal_election_file.committee_id;
+        this.federal_election_committee_id = federal_election_file.federal_election_committee_id;
         this.name = federal_election_file.name;
         this.url = federal_election_file.url;
         this.report_date = federal_election_file.report_date;
         this.designation = federal_election_file.designation;
-        this.election_id = federal_election_file.election_id;
-        this.candidate_id = federal_election_file.candidate_id;
-        this.jfp_committee_ids = federal_election_file.jfp_committee_ids;
-        this.jfr_committee_ids = federal_election_file.jfr_committee_ids;
-        this.aff_committee_ids = federal_election_file.aff_committee_ids;
-        this.sponsor_candidate_ids = federal_election_file.sponsor_candidate_ids;
+        this.federal_election_id = federal_election_file.federal_election_id;
+        this.federal_election_candidate_id = federal_election_file.federal_election_candidate_id;
+        this.jfp_federal_election_committee_ids = federal_election_file.jfp_federal_election_committee_ids;
+        this.jfr_federal_election_committee_ids = federal_election_file.jfr_federal_election_committee_ids;
+        this.aff_federal_election_committee_ids = federal_election_file.aff_federal_election_committee_ids;
+        this.sponsor_federal_election_candidate_ids = federal_election_file.sponsor_federal_election_candidate_ids;
     }
     static is(federal_election_file) {
         return (FederalElectionFile.is(federal_election_file) &&
             federal_election_file.form_type_id === "F1" &&
-            typeof federal_election_file.committee_id === "string" &&
+            typeof federal_election_file.federal_election_committee_id === "string" &&
             typeof federal_election_file.name === "string" &&
             (federal_election_file.url === undefined || typeof federal_election_file.url === "string") &&
             typeof federal_election_file.report_date === "string" &&
-            is_committee_designation(federal_election_file.designation) &&
-            (federal_election_file.election_id === undefined || is_election_id(federal_election_file.election_id)) &&
-            (federal_election_file.candidate_id === undefined || typeof federal_election_file.candidate_id === "string") &&
-            (federal_election_file.jfp_committee_ids === undefined || Array.isArray(federal_election_file.jfp_committee_ids) && federal_election_file.jfp_committee_ids.every((committee_id) => typeof committee_id === "string")) &&
-            (Array.isArray(federal_election_file.jfr_committee_ids) && federal_election_file.jfr_committee_ids.every((committee_id) => typeof committee_id === "string")) &&
-            (Array.isArray(federal_election_file.aff_committee_ids) && federal_election_file.aff_committee_ids.every((committee_id) => typeof committee_id === "string")) &&
-            (federal_election_file.sponsor_candidate_ids === undefined || Array.isArray(federal_election_file.sponsor_candidate_ids) && federal_election_file.sponsor_candidate_ids.every((committee_id) => typeof committee_id === "string")));
+            is_federal_election_committee_designation(federal_election_file.designation) &&
+            (federal_election_file.federal_election_id === undefined || is_federal_election_id(federal_election_file.federal_election_id)) &&
+            (federal_election_file.federal_election_candidate_id === undefined || typeof federal_election_file.federal_election_candidate_id === "string") &&
+            (federal_election_file.jfp_federal_election_committee_ids === undefined || Array.isArray(federal_election_file.jfp_federal_election_committee_ids) && federal_election_file.jfp_federal_election_committee_ids.every((federal_election_committee_id) => typeof federal_election_committee_id === "string")) &&
+            (Array.isArray(federal_election_file.jfr_federal_election_committee_ids) && federal_election_file.jfr_federal_election_committee_ids.every((federal_election_committee_id) => typeof federal_election_committee_id === "string")) &&
+            (Array.isArray(federal_election_file.aff_federal_election_committee_ids) && federal_election_file.aff_federal_election_committee_ids.every((federal_election_committee_id) => typeof federal_election_committee_id === "string")) &&
+            (federal_election_file.sponsor_federal_election_candidate_ids === undefined || Array.isArray(federal_election_file.sponsor_federal_election_candidate_ids) && federal_election_file.sponsor_federal_election_candidate_ids.every((federal_election_committee_id) => typeof federal_election_committee_id === "string")));
     }
 }

package/dist/src/types/FederalElectionF24File.d.ts

@@ -1,12 +1,12 @@
-import { Expenditure } from "./Expenditure.js";
+import { FederalElectionFileExpenditure } from "./FederalElectionFileExpenditure.js";
 import { FederalElectionFile } from "./FederalElectionFile.js";
 export declare class FederalElectionF24File extends FederalElectionFile {
-    readonly committee_id: string;
+    readonly federal_election_committee_id: string;
     readonly first_federal_election_file_id: number;
     readonly report_type: string;
     readonly first_report_date: string;
     readonly report_date: string;
-    readonly expenditures: Expenditure[];
+    readonly expenditures: FederalElectionFileExpenditure[];
     constructor(federal_election_file: any);
     static is(federal_election_file: any): federal_election_file is FederalElectionF24File;
 }

package/dist/src/types/FederalElectionF24File.js

@@ -1,7 +1,7 @@
-import { Expenditure } from "./Expenditure.js";
+import { FederalElectionFileExpenditure } from "./FederalElectionFileExpenditure.js";
 import { FederalElectionFile } from "./FederalElectionFile.js";
 export class FederalElectionF24File extends FederalElectionFile {
-    committee_id;
+    federal_election_committee_id;
     first_federal_election_file_id;
     report_type;
     first_report_date;
@@ -12,7 +12,7 @@ export class FederalElectionF24File extends FederalElectionFile {
             throw Error("Invalid input.");
         }
         super(federal_election_file);
-        this.committee_id = federal_election_file.committee_id;
+        this.federal_election_committee_id = federal_election_file.federal_election_committee_id;
         this.first_federal_election_file_id = federal_election_file.first_federal_election_file_id;
         this.report_type = federal_election_file.report_type;
         this.first_report_date = federal_election_file.first_report_date;
@@ -22,11 +22,11 @@ export class FederalElectionF24File extends FederalElectionFile {
     static is(federal_election_file) {
         return (FederalElectionFile.is(federal_election_file) &&
             federal_election_file.form_type_id === "F24" &&
-            typeof federal_election_file.committee_id === "string" &&
+            typeof federal_election_file.federal_election_committee_id === "string" &&
             typeof federal_election_file.first_federal_election_file_id === "number" &&
             typeof federal_election_file.report_type === "string" &&
             typeof federal_election_file.first_report_date === "string" &&
             typeof federal_election_file.report_date === "string" &&
-            Array.isArray(federal_election_file.expenditures) && federal_election_file.expenditures.every(Expenditure.is));
+            Array.isArray(federal_election_file.expenditures) && federal_election_file.expenditures.every(FederalElectionFileExpenditure.is));
     }
 }

package/dist/src/types/FederalElectionF2File.d.ts

@@ -1,13 +1,13 @@
-import { ElectionID, OfficeID } from "./Election.js";
+import { FederalElectionID, FederalElectionOfficeID } from "./FederalElection.js";
 import { FederalElectionFile } from "./FederalElectionFile.js";
 import { StateID } from "./State.js";
 export declare class FederalElectionF2File extends FederalElectionFile {
-    readonly candidate_id: string;
-    readonly fec_name: string;
-    readonly office_id: OfficeID;
+    readonly federal_election_candidate_id: string;
+    readonly name: string;
+    readonly federal_election_office_id: FederalElectionOfficeID;
     readonly state_id: StateID;
     readonly district?: number;
-    readonly election_id: ElectionID;
+    readonly federal_election_id: FederalElectionID;
     readonly party_id?: string;
     readonly report_date: string;
     constructor(federal_election_file: any);

package/dist/src/types/FederalElectionF2File.js

@@ -1,13 +1,13 @@
-import { is_election_id, is_office_id } from "./Election.js";
+import { is_federal_election_id, is_federal_election_office_id } from "./FederalElection.js";
 import { FederalElectionFile } from "./FederalElectionFile.js";
 import { is_state_id } from "./State.js";
 export class FederalElectionF2File extends FederalElectionFile {
-    candidate_id;
-    fec_name;
-    office_id;
+    federal_election_candidate_id;
+    name;
+    federal_election_office_id;
     state_id;
     district;
-    election_id;
+    federal_election_id;
     party_id;
     report_date;
     constructor(federal_election_file) {
@@ -15,24 +15,24 @@ export class FederalElectionF2File extends FederalElectionFile {
             throw Error("Invalid input.");
         }
         super(federal_election_file);
-        this.candidate_id = federal_election_file.candidate_id;
-        this.fec_name = federal_election_file.fec_name;
-        this.office_id = federal_election_file.office_id;
+        this.federal_election_candidate_id = federal_election_file.federal_election_candidate_id;
+        this.name = federal_election_file.name;
+        this.federal_election_office_id = federal_election_file.federal_election_office_id;
         this.state_id = federal_election_file.state_id;
         this.district = federal_election_file.district;
-        this.election_id = federal_election_file.election_id;
+        this.federal_election_id = federal_election_file.federal_election_id;
         this.party_id = federal_election_file.party_id;
         this.report_date = federal_election_file.report_date;
     }
     static is(federal_election_file) {
         return (FederalElectionFile.is(federal_election_file) &&
             federal_election_file.form_type_id === "F2" &&
-            typeof federal_election_file.candidate_id === "string" &&
-            typeof federal_election_file.fec_name === "string" &&
-            is_office_id(federal_election_file.office_id) &&
+            typeof federal_election_file.federal_election_candidate_id === "string" &&
+            typeof federal_election_file.name === "string" &&
+            is_federal_election_office_id(federal_election_file.federal_election_office_id) &&
             is_state_id(federal_election_file.state_id) &&
             (federal_election_file.district === undefined || typeof federal_election_file.district === "number") &&
-            is_election_id(federal_election_file.election_id) &&
+            is_federal_election_id(federal_election_file.federal_election_id) &&
             (federal_election_file.party_id === undefined || typeof federal_election_file.party_id === "string") &&
             typeof federal_election_file.report_date === "string");
     }

package/dist/src/types/FederalElectionF3File.d.ts

@@ -1,6 +1,6 @@
 import { FederalElectionFile } from "./FederalElectionFile.js";
 export declare class FederalElectionF3File extends FederalElectionFile {
-    readonly committee_id: string;
+    readonly federal_election_committee_id: string;
     readonly period_id: string;
     readonly period_start_date: string;
     readonly period_end_date: string;

package/dist/src/types/FederalElectionF3File.js

@@ -1,6 +1,6 @@
 import { FederalElectionFile } from "./FederalElectionFile.js";
 export class FederalElectionF3File extends FederalElectionFile {
-    committee_id;
+    federal_election_committee_id;
     period_id;
     period_start_date;
     period_end_date;
@@ -13,7 +13,7 @@ export class FederalElectionF3File extends FederalElectionFile {
             throw Error("Invalid input.");
         }
         super(federal_election_file);
-        this.committee_id = federal_election_file.committee_id;
+        this.federal_election_committee_id = federal_election_file.federal_election_committee_id;
         this.period_id = federal_election_file.period_id;
         this.period_start_date = federal_election_file.period_start_date;
         this.period_end_date = federal_election_file.period_end_date;
@@ -25,7 +25,7 @@ export class FederalElectionF3File extends FederalElectionFile {
     static is(federal_election_file) {
         return (FederalElectionFile.is(federal_election_file) &&
             federal_election_file.form_type_id === "F3" &&
-            typeof federal_election_file.committee_id === "string" &&
+            typeof federal_election_file.federal_election_committee_id === "string" &&
             typeof federal_election_file.period_id === "string" &&
             typeof federal_election_file.period_start_date === "string" &&
             typeof federal_election_file.period_end_date === "string" &&

package/dist/src/types/FederalElectionFileExpenditure.d.ts

@@ -0,0 +1,28 @@
+import { FederalElectionCandidate } from "./FederalElectionCandidate.js";
+import { FederalElectionCommittee } from "./FederalElectionCommittee.js";
+import { FederalElectionID } from "./FederalElection.js";
+import { FederalElectionF24File } from "./FederalElectionF24File.js";
+export declare class FederalElectionFileExpenditure {
+    readonly federal_election_file_id: number;
+    readonly expenditure_id: string;
+    readonly federal_election_committee_id: string;
+    readonly date: string;
+    readonly payee: string;
+    readonly election_stage: string;
+    readonly federal_election_id: FederalElectionID;
+    readonly federal_election_candidate_id: string;
+    readonly amount: number;
+    readonly cumulative_amount: number;
+    readonly purpose: string;
+    readonly is_support: boolean;
+    readonly [x: string]: any;
+    constructor(federal_election_file_expenditure: any);
+    static is(federal_election_file_expenditure: any): federal_election_file_expenditure is FederalElectionFileExpenditure;
+}
+export declare class FederalElectionFileExpenditureAux extends FederalElectionFileExpenditure {
+    readonly federal_election_candidate: FederalElectionCandidate;
+    readonly federal_election_committee: FederalElectionCommittee;
+    readonly federal_election_f24_file: FederalElectionF24File;
+    constructor(federal_election_file_expenditure: any);
+    static is(federal_election_file_expenditure: any): federal_election_file_expenditure is FederalElectionFileExpenditureAux;
+}

package/dist/src/types/FederalElectionFileExpenditure.js

@@ -0,0 +1,70 @@
+import { FederalElectionCandidate } from "./FederalElectionCandidate.js";
+import { FederalElectionCommittee } from "./FederalElectionCommittee.js";
+import { is_federal_election_id } from "./FederalElection.js";
+import { FederalElectionF24File } from "./FederalElectionF24File.js";
+export class FederalElectionFileExpenditure {
+    federal_election_file_id;
+    expenditure_id;
+    federal_election_committee_id;
+    date;
+    payee;
+    election_stage;
+    federal_election_id;
+    federal_election_candidate_id;
+    amount;
+    cumulative_amount;
+    purpose;
+    is_support;
+    constructor(federal_election_file_expenditure) {
+        if (!FederalElectionFileExpenditure.is(federal_election_file_expenditure)) {
+            throw Error("Invalid input.");
+        }
+        this.federal_election_file_id = federal_election_file_expenditure.federal_election_file_id;
+        this.expenditure_id = federal_election_file_expenditure.expenditure_id;
+        this.federal_election_committee_id = federal_election_file_expenditure.federal_election_committee_id;
+        this.date = federal_election_file_expenditure.date;
+        this.payee = federal_election_file_expenditure.payee;
+        this.election_stage = federal_election_file_expenditure.election_stage;
+        this.federal_election_id = federal_election_file_expenditure.federal_election_id;
+        this.federal_election_candidate_id = federal_election_file_expenditure.federal_election_candidate_id;
+        this.amount = federal_election_file_expenditure.amount;
+        this.cumulative_amount = federal_election_file_expenditure.cumulative_amount;
+        this.purpose = federal_election_file_expenditure.purpose;
+        this.is_support = federal_election_file_expenditure.is_support;
+    }
+    static is(federal_election_file_expenditure) {
+        return (federal_election_file_expenditure !== undefined &&
+            typeof federal_election_file_expenditure.federal_election_file_id === "number" &&
+            typeof federal_election_file_expenditure.expenditure_id === "string" &&
+            typeof federal_election_file_expenditure.federal_election_committee_id === "string" &&
+            typeof federal_election_file_expenditure.date === "string" &&
+            typeof federal_election_file_expenditure.payee === "string" &&
+            typeof federal_election_file_expenditure.election_stage === "string" &&
+            is_federal_election_id(federal_election_file_expenditure.federal_election_id) &&
+            typeof federal_election_file_expenditure.federal_election_candidate_id === "string" &&
+            typeof federal_election_file_expenditure.amount === "number" &&
+            typeof federal_election_file_expenditure.cumulative_amount === "number" &&
+            typeof federal_election_file_expenditure.purpose === "string" &&
+            typeof federal_election_file_expenditure.is_support === "boolean");
+    }
+}
+export class FederalElectionFileExpenditureAux extends FederalElectionFileExpenditure {
+    federal_election_candidate;
+    federal_election_committee;
+    federal_election_f24_file;
+    constructor(federal_election_file_expenditure) {
+        if (!FederalElectionFileExpenditureAux.is(federal_election_file_expenditure)) {
+            throw Error("Invalid input.");
+        }
+        super(federal_election_file_expenditure);
+        this.federal_election_candidate = federal_election_file_expenditure.federal_election_candidate;
+        this.federal_election_committee = federal_election_file_expenditure.federal_election_committee;
+        this.federal_election_f24_file = federal_election_file_expenditure.federal_election_f24_file;
+    }
+    static is(federal_election_file_expenditure) {
+        return (FederalElectionFileExpenditure.is(federal_election_file_expenditure) &&
+            FederalElectionCandidate.is(federal_election_file_expenditure.federal_election_candidate) &&
+            FederalElectionCommittee.is(federal_election_file_expenditure.federal_election_committee) &&
+            FederalElectionF24File.is(federal_election_file_expenditure.federal_election_f24_file));
+    }
+}

package/dist/src/types/Tweet.d.ts

@@ -2,11 +2,8 @@ export declare class Tweet {
     readonly tweet_id: string;
     readonly username: string;
     readonly url: string;
-    readonly tweet_time: string;
-    readonly tweet_content: string;
-    readonly quote?: string;
+    readonly publish_time: string;
     readonly html: string;
-    readonly text: string;
     constructor(tweet: Tweet);
     static is(tweet: any): tweet is Tweet;
 }

package/dist/src/types/Tweet.js

@@ -2,11 +2,11 @@ export class Tweet {
     tweet_id;
     username;
     url;
-    tweet_time;
-    tweet_content;
-    quote;
+    publish_time;
+    // readonly tweet_content : string
+    // readonly quote? : string
     html;
-    text;
+    // readonly text : string
     constructor(tweet) {
         if (!Tweet.is(tweet)) {
             throw Error("Invalid input.");
@@ -14,21 +14,22 @@ export class Tweet {
         this.tweet_id = tweet.tweet_id;
         this.username = tweet.username;
         this.url = tweet.url;
-        this.tweet_time = tweet.tweet_time;
-        this.tweet_content = tweet.tweet_content;
-        this.quote = tweet.quote;
+        this.publish_time = tweet.publish_time;
+        // this.tweet_content = tweet.tweet_content
+        // this.quote = tweet.quote
         this.html = tweet.html;
-        this.text = tweet.text;
+        // this.text = tweet.text
     }
     static is(tweet) {
         return (tweet !== undefined &&
             typeof tweet.tweet_id === "string" &&
             typeof tweet.username === "string" &&
             typeof tweet.url === "string" &&
-            typeof tweet.tweet_time === "string" &&
-            typeof tweet.tweet_content === "string" &&
-            (tweet.quote === undefined || typeof tweet.quote === "string") &&
-            typeof tweet.html === "string" &&
-            (typeof tweet.text === "string"));
+            typeof tweet.publish_time === "string" &&
+            // typeof tweet.tweet_content === "string" &&
+            // (tweet.quote === undefined || typeof tweet.quote === "string") &&
+            typeof tweet.html === "string"
+        // (typeof tweet.text === "string")
+        );
     }
 }

package/dist/src/types/UserFederalElection.d.ts

@@ -0,0 +1,9 @@
+import { FederalElectionID } from "./FederalElection.js";
+export declare class UserFederalElection {
+    readonly user_id: string;
+    readonly federal_election_id: FederalElectionID;
+    readonly candidate_display: Record<string, number>;
+    readonly notify: boolean;
+    constructor(user_federal_election: UserFederalElection);
+    static is(user_federal_election: any): user_federal_election is UserFederalElection;
+}

package/dist/src/types/UserFederalElection.js

@@ -0,0 +1,24 @@
+import { is_federal_election_id } from "./FederalElection.js";
+export class UserFederalElection {
+    user_id;
+    federal_election_id;
+    candidate_display;
+    notify;
+    // readonly [x : string] : any
+    constructor(user_federal_election) {
+        if (!UserFederalElection.is(user_federal_election)) {
+            throw Error("Invalid Input.");
+        }
+        this.user_id = user_federal_election.user_id;
+        this.federal_election_id = user_federal_election.federal_election_id;
+        this.candidate_display = user_federal_election.candidate_display;
+        this.notify = user_federal_election.notify;
+    }
+    static is(user_federal_election) {
+        return (user_federal_election !== undefined &&
+            typeof user_federal_election.user_id === "string" &&
+            is_federal_election_id(user_federal_election.federal_election_id) &&
+            Object.entries(user_federal_election.candidate_display).every(([key, value]) => (typeof key === "string" && typeof value === "number")) &&
+            typeof user_federal_election.notify === "boolean");
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "elections-types",
-    "version": "1.0.91",
+    "version": "1.0.93",
     "main": "dist/src/index.js",
     "types": "dist/src/index.d.ts",
     "directories": {

package/src/index.ts

@@ -1,14 +1,14 @@
 export * from "./types/APIError"
 export * from "./types/Article"
-export * from "./types/Candidate"
 export * from "./types/CandidateArticle"
-export * from "./types/CandidateCommittee"
 export * from "./types/CandidateTweet"
 export * from "./types/CandidateVideo"
-export * from "./types/Committee"
-export * from "./types/Election"
+export * from "./types/FederalElection"
 export * from "./types/ElectionsConfig"
-export * from "./types/Expenditure"
+export * from "./types/FederalElectionCommittee"
+export * from "./types/FederalElectionCandidate"
+export * from "./types/FederalElectionCandidateCommittee"
+export * from "./types/FederalElectionFileExpenditure"
 export * from "./types/FederalElectionDonation"
 export * from "./types/FederalElectionFile"
 export * from "./types/FederalElectionF1File"
@@ -19,5 +19,5 @@ export * from "./types/FormTypeID"
 export * from "./types/State"
 export * from "./types/Tweet"
 export * from "./types/User"
-export * from "./types/UserElection"
+export * from "./types/UserFederalElection"
 export * from "./types/Video"

package/src/types/ElectionsConfig.ts

@@ -20,13 +20,13 @@ export interface ElectionsConfig extends ElectionsUtilsConfig {
     super_gov_api_keys : string[],
     gov_api_keys : string[],
     lobby_api_key : string,
-    dynamodb_elections : string,
-    dynamodb_candidates : string,
-    dynamodb_committees : string,
-    dynamodb_candidate_committees : string,
-    dynamodb_expenditures : string,
+    dynamodb_federal_elections : string,
+    dynamodb_federal_election_candidates : string,
+    dynamodb_federal_election_committees : string,
+    dynamodb_federal_election_candidate_committees : string,
+    dynamodb_federal_election_file_expenditures : string,
     dynamodb_users : string,
-    dynamodb_user_elections : string,
+    dynamodb_user_federal_elections : string,
     dynamodb_articles : string,
     dynamodb_candidate_articles : string,
     dynamodb_tweets : string,

package/src/types/FederalElection.ts

@@ -0,0 +1,105 @@
+import { FederalElectionCandidate, FederalElectionCandidateAux } from "./FederalElectionCandidate"
+import { FederalElectionCommittee, FederalElectionCommitteeAux } from "./FederalElectionCommittee"
+import { FederalElectionFileExpenditureAux } from "./FederalElectionFileExpenditure"
+import { is_state_id, state_ids, StateID } from "./State"
+
+const federal_election_office_ids = ["H", "S", "P"] as const
+
+export type FederalElectionOfficeID = typeof federal_election_office_ids[number]
+
+export function is_federal_election_office_id(federal_election_office_id : any) : federal_election_office_id is FederalElectionOfficeID {
+    return federal_election_office_ids.includes(federal_election_office_id)
+}
+
+const state_ids_without_district : StateID[] = ["AK", "DE", "ND", "SD", "VT", "WY"]
+
+export type FederalElectionID = string
+
+export function is_federal_election_id(federal_election_id : any) : federal_election_id is FederalElectionID {
+    const parts = federal_election_id.split("-")
+    const year = Number(parts[0])
+    const federal_election_office_id = parts[1]
+    const state_id = parts[2]
+    const district = Number(parts[3])
+    if (!(Number.isInteger(year) && year > 1700 && year < 3000 && is_federal_election_office_id(federal_election_office_id))) {
+        return false
+    }
+    if (federal_election_office_id === "P" && parts.length === 2) {
+        return true
+    }
+    if (!is_state_id(state_id)) {
+        return false
+    }
+    if (federal_election_office_id === "S" && parts.length === 3) {
+        return true
+    }
+    if (federal_election_office_id !== "H") {
+        return false
+    }
+    if (!(state_ids_without_district.includes(state_id) && parts.length === 3 || parts.length === 4)) {
+        return false
+    }
+    if (!Number.isInteger(district) && district < 100) {
+        return false
+    }
+    return true
+}
+
+export class FederalElection {
+    readonly federal_election_id : FederalElectionID
+    readonly name : string
+    readonly federal_election_office_id : FederalElectionOfficeID
+    readonly state_id? : StateID
+    readonly district? : number
+    readonly [x : string] : any
+
+    constructor(federal_election : FederalElection) {
+        if (!FederalElection.is(federal_election)) {
+            throw Error("Invalid input.")
+        }
+        this.federal_election_id = federal_election.federal_election_id
+        this.name = federal_election.name
+        this.federal_election_office_id = federal_election.federal_election_office_id
+        this.state_id = federal_election.state_id
+        this.district = federal_election.district
+    }
+
+    static is(federal_election : any) : federal_election is FederalElection {
+        return (
+            federal_election !== undefined &&
+            is_federal_election_id(federal_election.federal_election_id) &&
+            typeof federal_election.name === "string" &&
+            is_federal_election_office_id(federal_election.federal_election_office_id) &&
+            (federal_election.state_id === undefined || is_state_id(federal_election.state_id)) &&
+            (federal_election.district === undefined || typeof federal_election.district === "number")
+        )
+    }
+}
+
+export class ElectionAux extends FederalElection {
+    readonly federal_election_candidates : FederalElectionCandidateAux[]
+    readonly federal_election_committees : FederalElectionCommitteeAux[]
+    readonly federal_election_file_expenditures : FederalElectionFileExpenditureAux[]
+
+    constructor(federal_election : any) {
+        if (!ElectionAux.is(federal_election)) {
+            throw Error("Invalid input.")
+        }
+        super(federal_election)
+        this.federal_election_candidates = federal_election.federal_election_candidates
+        this.federal_election_committees = federal_election.committees
+        this.federal_election_file_expenditures = federal_election.federal_election_file_expenditures
+    }
+
+    static is(federal_election : any) : federal_election is ElectionAux {
+        return (
+            FederalElection.is(federal_election) &&
+            Array.isArray(federal_election.federal_election_candidates) &&
+            federal_election.federal_election_candidates.every(FederalElectionCandidateAux.is) &&
+            Array.isArray(federal_election.federal_election_committees) &&
+            federal_election.federal_election_committees.every(FederalElectionCommitteeAux.is) &&
+            Array.isArray(federal_election.federal_election_file_expenditures) &&
+            federal_election.federal_election_file_expenditures.every(FederalElectionFileExpenditureAux.is)
+        )
+    }
+}