Profiles

Profiles fetches the list of profiles configured in EML AdminTool. Use it to populate a profile selector in the launcher UI, then pass the selected IProfile to the Launcher constructor.

import { Profiles, Launcher } from 'eml-lib'

getProfiles()

async function getProfiles() {
  const profiles = new Profiles('https://at.myserver.com')
  const list = await profiles.getProfiles()
}

Constructor

Parameter	Type	Description	Required?
url	string	The URL of your EML AdminTool instance.	Yes

auth() method

Authenticate against a protected profile.

Parameter	Type	Description	Required?
slug	string	The slug of the profile to authenticate against.	Yes
password	string	The password for the profile.	Yes

Returns: Promise<{ slug: string; token: string }> — An object containing the slug and the authentication token.

Throws: AUTH_ERROR — If the authentication fails (invalid slug or password). • TOO_MANY_REQUESTS — If the profile has been locked due to too many failed attempts.

getProfiles() method

Fetches the list of all profiles available on the EML AdminTool.

Parameter	Type	Description	Required?
account	Account	The account to use for authentication, to display any hidden profiles.	No
slug	string	The slug of the protected profile you want to access. You need to authenticate against the profile first using the auth() method.	No

Returns: Promise<IProfile[]> — An array of profile objects. The default profile is always included.

Throws: FETCH_ERROR — If the request to EML AdminTool fails.