EmpationAPI Library

This is a front-end lightweight library for communication with the workbench service. The library is used by RationAI javascript applications to have uniform and tested access to the API with selected features. The API is not mirrored fully, but rather implements few selected uses routines. Any query can be performed easily on the target context class using rawQuery(...) which populates the request with all necessary data common to all API requests to that context.

Type definitions are taken from the official Empaia frontend WBC library. https://gitlab.com/empaia/integration/frontend-workspace

There are no dependencies, just build and use the library.

Supported WBS versions:

• v3

V3 Usage:

const api = new V3.Root({
    workbenchApiUrl: 'https://url.to.workbench.api'
});
// The library expects root api having intercepted communication
//  that assigns an access token for the WORKBENCH CLIENT.
//  The token can be obtained using for example OIDC client and
//  intercepted library communication using library of a choice.
//  The token also stores the user id:
api.from(token);
api.cases.list(); //lists available cases

// To access SCOPE API you need to provide a case ID and optionally app ID:
api.defaultScope.use(caseId); //default scope bound only to the case
api.defaultScope.use(caseId, appId); //default scope bound to case AND app

// To have multiple scopes active at once, use:
api.scopes.getScopeUse(caseId, appId?);
api.scopes.getScopesFrom(examination);

Building

Since the library is without dependencies (and there is -yet- no node package available) you can use the code as-is in typescript. With browser, you have to build the library with webpack:

npm install
npm run build

Testing

For automated type testing, first types must be compiled:

For version 3 compile the types using: npm run ttypes-v3

Then, tests can be run using npm run test. However, you first need to set up the test environmental variables. test/test.env is an example env file for the testing. Notable is the authentication setup:

# The authentication module. A filename without extension in `test/auth/` implementing auth style.
EMAPI_AUTH_MODULE=no-auth
# The client againts which we authenticate (see oAuth/Keycloak)
EMAPI_AUTH_CLIENT=
EMAPI_AUTH_CLIENT_SECRET=
# The authentication URL
EMAPI_AUTH_URL=

# Provide default test user
EMAPI_AUTH_DEFAULT_USER=pathologist
# Provide user comparison tests user, if not set comparison tests are not run
EMAPI_AUTH_COMPARE_USER=
# Users can be specified dynamically: simply provide userName identifier (camelcase)
# which is automatically converted to underscore & capital env style
# if user name empty the identifier is used as the actual user name
EMAPI_AUTH_USER_PATHOLOGIST=
EMAPI_AUTH_USER_SECRET_PATHOLOGIST=