ConnectionManager

Connection Manager for data source connections and OAuth management

Connection Manager for data source connections and OAuth management. Provides methods for managing connections to healthcare providers and data sources.

Methods

getMemberConnections()

getMemberConnections(): Promise<BWellQueryResult<MemberConnection[], BaseManagerError>>

Retrieves a list of MemberConnections resources from a FHIR server. There are no parameters and no request object for this method.

Returns

Promise<BWellQueryResult<MemberConnection[], BaseManagerError>>

A promise resolving to an object representing the list of MemberConnections resources retrieved, along with potential validation or GraphQL errors.


getDataSource()

getDataSource(request): Promise<BWellQueryResult<DataSource, BaseManagerError>>

Retrieves a data source by ID. Gets information about a specific healthcare provider connection.

Parameters

request

DataSourceRequest

Returns

Promise<BWellQueryResult<DataSource, BaseManagerError>>

Example

const dataSource = await sdk.connection.getDataSource(
  new DataSourceRequest({
    connectionId: 'epic-123'
  })
);

createConnection()

createConnection(request): Promise<BWellTransactionResult<Connection, BaseManagerError>>

Creates a new connection to a healthcare provider. Establishes a connection to retrieve health data.

Parameters

request

ConnectionRequest

Returns

Promise<BWellTransactionResult<Connection, BaseManagerError>>

Example

await sdk.connection.createConnection(
  new ConnectionRequest({
    connectionId: 'epic-123',
    username: 'user',
    password: 'pass'
  })
);

disconnectConnection()

disconnectConnection(request): Promise<BWellTransactionResult<ConnectionStatus, BaseManagerError>>

Disconnects an existing connection. Stops data synchronization but preserves existing data.

Parameters

request

DataSourceRequest

Returns

Promise<BWellTransactionResult<ConnectionStatus, BaseManagerError>>

Example

await sdk.connection.disconnectConnection(
  new DataSourceRequest({
    connectionId: 'epic-123'
  })
);

deleteConnection()

deleteConnection(request): Promise<BWellTransactionResult<ConnectionStatus, BaseManagerError>>

Permanently deletes a connection. Removes the connection and all associated data.

Parameters

request

DataSourceRequest

Returns

Promise<BWellTransactionResult<ConnectionStatus, BaseManagerError>>

Example

await sdk.connection.deleteConnection(
  new DataSourceRequest({
    connectionId: 'epic-123'
  })
);

getOauthUrl()

getOauthUrl(request): Promise<BWellQueryResult<OAuthUrl, BaseManagerError>>

Retrieves OAuth URL for connection setup. Gets the authorization URL for OAuth-based connections.

Parameters

request

DataSourceRequest

Returns

Promise<BWellQueryResult<OAuthUrl, BaseManagerError>>

Example

const oauthUrl = await sdk.connection.getOauthUrl(
  new DataSourceRequest({
    connectionId: 'epic-123'
  })
);