[TECH-2970] Add ballot reference param to request access code

lib/av_client.ts

@@ -146,17 +146,19 @@ export class AVClient implements IAVClient {
    *
    * @param opaqueVoterId Voter ID that preserves voter anonymity.
    * @param email where the voter expects to receive otp code.
+   * @param ballotReference The ballot which which voter voter intends to vote on
    * @returns Returns undefined or throws an error.
    * @throws VoterRecordNotFound if no voter was found
    * @throws {@link NetworkError | NetworkError } if any request failed to get a response
    */
-  public async requestAccessCode(opaqueVoterId: string, email: string): Promise<void> {
+  public async requestAccessCode(opaqueVoterId: string, email: string, ballotReference?: string): Promise<void> {
     const coordinatorURL = this.getLatestConfig().items.voterAuthorizerConfig.content.voterAuthorizer.url;
     const voterAuthorizerContextUuid = this.getLatestConfig().items.voterAuthorizerConfig.content.voterAuthorizer.contextUuid;
     const coordinator = new VoterAuthorizationCoordinator(coordinatorURL, voterAuthorizerContextUuid);
 
-    return coordinator.createSession(opaqueVoterId, email)
+    return coordinator.createSession(opaqueVoterId, email, ballotReference)
       .then(({ data: { sessionId } }) => {
+        // In the US voters are allowed to chose their ballot
         return sessionId as string
       })
       .then(async sessionId => {

lib/av_client/connectors/voter_authorization_coordinator.ts

@@ -1,6 +1,6 @@
 import axios, { AxiosInstance, AxiosResponse } from 'axios'
 import { IdentityConfirmationToken } from "./otp_provider";
-import { EmailDoesNotMatchVoterRecordError, NetworkError, UnsupportedServerReplyError, VoterRecordNotFoundError, DBBError } from "../errors";
+import { EmailDoesNotMatchVoterRecordError, NetworkError, UnsupportedServerReplyError, VoterRecordNotFoundError, DBBError, BallotReferenceNotOnVoterRecord } from "../errors";
 import { ProofOfElectionCodes } from "../crypto/proof_of_election_codes";
 import { BallotBoxReceipt } from '../types';
 
@@ -18,11 +18,12 @@ export default class VoterAuthorizationCoordinator {
    * @param opaqueVoterId Gets
    * @returns
    */
-  createSession(opaqueVoterId: string, email: string): Promise<AxiosResponse> {
+  createSession(opaqueVoterId: string, email: string, ballotReference?: string): Promise<AxiosResponse> {
     return this.backend.post('create_session', {
       electionContextUuid: this.electionContextUuid,
       opaqueVoterId: opaqueVoterId,
-      email
+      ballotReference: ballotReference,
+      email,
     }).catch(error => {
       const response = error.response;
 
@@ -34,6 +35,8 @@ export default class VoterAuthorizationCoordinator {
         const errorCode = response.data.error_code;
         const errorMessage = response.data.error_message;
         switch(errorCode) {
+          case 'BALLOT_REFERERENCE_NOT_ON_VOTER_RECORD':
+            throw new BallotReferenceNotOnVoterRecord(errorMessage);
           case 'EMAIL_DOES_NOT_MATCH_VOTER_RECORD':
             throw new EmailDoesNotMatchVoterRecordError(errorMessage);
           case 'COULD_NOT_CONNECT_TO_OTP_PROVIDER':

lib/av_client/errors.ts

@@ -77,6 +77,15 @@ export class EmailDoesNotMatchVoterRecordError extends AvClientError {
   }
 }
 
+export class BallotReferenceNotOnVoterRecord extends AvClientError {
+  readonly name = "BallotReferenceNotOnVoterRecord";
+
+  constructor(message: string) {
+    super(message);
+    Object.setPrototypeOf(this, BallotReferenceNotOnVoterRecord.prototype);
+  }
+}
+
 export class DBBError extends AvClientError {
   readonly name = "DBB_ERROR";