Skip to content

trytriangles/lithium-email-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lithium Email Search

What is it?

A simple web-based interface to the Lithium user search API. Given a list of email addresses, this tool will fetch you profile information from your Lithium community, which can be displayed as a table or saved as a CSV file (using client-side file generation -- no server/Node needed).

Written using TypeScript, Pug, and Sass with the Materialize CSS framework.

How do I use it?

Clone the repository, and run npm install then gulp from its root. Access through dist/index.html. The tool is completely static/client-side, so you can run it locally without issue, or host it wherever you like.

Notes and Potential Problems

  • You must authenticate before attempting to fetch information on users whose profiles are set to private.
  • To an unauthenticated user, the Lithium API does not differ private profiles from nonexistent ones.
  • After a successful call, user information is stored in your browser's local storage. When making new calls, local storage is checked before the remote API, preventing you from making additional unnecessary calls. This could lead to inaccurate results if, for example, two users swapped email addresses (which hopefully would never happen, but never say never), or if your community lets users change usernames.
    A more likely issue is that you make an unauthenticated query and get back hidden profiles, making their information show up as hidden even on future authenticated queries. In this eventuality, clear your local storage.

Changelog

  • 1.2.0: Shows more user profile information (including names) in both the displayed and downloaded output.
  • 1.1.3: Deauthenticates after 30 minutes, warning user of expired session keys. Fixes a bug where successes were counted in valid email addresses, rather than valid usernames.
  • 1.1.2: Bundles jQuery, rather than relying on a CDN.
  • 1.1.1: Fixes off-by-one error in the statistics report. The number of emails is now the number of rows in the table, not the number of comma-separated values in the search field.
  • 1.1.0: Adds a button to clear local results cache.
  • 1.0.0: Initial release.