feat: add configuration, custom Auth and event handlers for Diamond Light Source

[GrantDLS]

Description

This PR is to add the necessary configuration files, custom authorization class and email event handler for Diamond Light Source to be able to use User Office Project.

Motivation and Context

• apps/backend/src/auth/DlsUserAuthorization.ts
  • Our own custom authorization class that works the same as the OAuthAuthorization class that it extends, except for it excludes some user attributes being pulled from the OAuth provider.
• apps/backend/src/config/dls/configureDLSEnvironment.ts
  • This is all standard but also adds a utility method getUASInstance() which reads the value of a .env variable and falls back to a sensible default.
• apps/backend/src/config/dependencyConfigDLS.ts
  • This is standard and just sets the dependency mappings
• apps/backend/src/eventHandlers/email/DLS/DLSEmailHandler.ts
  • This is our email handler in which we're currently handling the following 2 events: PROPOSAL_SUBMITTED and PROPOSAL_CO_PROPOSER_INVITES_UPDATED. The logic for building and sending each email type is separated into different files for readability.
• apps/frontend/public/images/diamond-white.svg
  • This is our logo for use in the header.

How Has This Been Tested

A test has been written for the email handler to ensure the correct email template is used for each event that we're handling.

Changes

There are only 2 changes to the core files of the code base:

• apps/backend/src/auth/OAuthAuthorization.ts
  • This class mostly meets our needs, but a small change is needed in externalTokenLogin(). I've extended the class, but needed access to the private method getUserRole(), so I've made it's access modifier protected rather than private.
• apps/backend/src/config/index.ts
  • A case has been added to the switch statement to load the DLS config file when it is set in the .env file.

Tests included/Docs Updated?

N/A

[yoganandaness]

@GrantDLS Is this PR ready to be reviewed? If so, could you add the label "review:please"

[GrantDLS]

@GrantDLS Is this PR ready to be reviewed? If so, could you add the label "review:please"

I've done quite a bit of refactoring since I created the PR. Just adding a couple of tests for the email handler and I'll add the label. Thank you, @yoganandaness .

[zacharyjhankin]

Can you add an image of the email PROPOSAL_CO_PROPOSER_INVITES_UPDATED?