update: add fallback to historic emails for authenticated mail lookups

• update: add fallback to historic emails for authenticated mail lookups

Added to allow matching on historic email addresses for better matching on older records.

Resolves #119 (closed)

src/main/java/org/eclipsefoundation/profile/api/PeopleAPI.java

@@ -71,6 +71,16 @@ public interface PeopleAPI {
     @Path("/{personId}/emails")
     List<PeopleEmailsData> getEmails(@PathParam("personId") String personId);
 
+    /**
+     * Gets all PeopleEmailData entities tied to the given email address. Used to do reverse lookups for historical emails
+     * 
+     * @param email The historical email for a potential user.
+     * @return A List of PeopleEmailData entities if they exist.
+     */
+    @GET
+    @Path("/emails")
+    List<PeopleEmailsData> getEmailsByEmail(@QueryParam("email") String email);
+
     /**
      * Gets a People entity tied to the given personId.
      *