▶

Getting started

Flutter
React Native
This package serves as a Flutter wrapper around all FibriCheck cloud services.
To get started with the FibriCheck SDK you'll need to install it, and then get credentials which will allow you to access the backend.

Installation

In your project, you can add the package below to the pubspec.yaml file. Replace {TOKEN} with your personal access token. You can get a new one here. Make sure you enable the repo scope.
flutter_fibricheck_sdk:
git:
url: https://{TOKEN}@github.com/fibricheck/flutter-sdk
ref: v1.0.0
​

Quick Start

import 'package:flutter_fibricheck_sdk/flutter_fibricheck_sdk.dart';
​
_sdk = FLFibriCheckSdk.client("consumerKey", "consumerSecret");
​
await _sdk.authenticateWithEmail(
ParamsOauth1WithEmail(email: "email", password: "password"),
(consents) {
_onConsentNeeded(consents);
},
);
The client method (default export) supports several options you may set to achieve the expected behavior:
Name
Default
Description
env
production
Specifies the environment you connect to
consumerKey
​
Required. Your application's consumerKey
consumerSecret
​
Required. Your application's consumerSecret
For the env, Env.dev or Env.production enumeration from the library flutter_fibricheck_sdk can be used.

API

When you initialize the sdk, the returned object will have the following methods available.
class FLFibricheckSDK {
/// Create an account based on a [UserRegisterData] object
/// and returns [UserData] of the created user
///
/// can throw [EmailUsedError]
Future<UserData> register(UserRegisterData data) async {}
/// Authenticate with an [ParamsOauth1WithToken] object and returns a
/// [TokenDataOauth1] object
///
/// can throw [ApplicationNotAuthenticatedError], [AuthenticationError],
/// [LoginTimeoutError], [LoginFreezeError], [TooManyFailedAttemptsError], [MfaRequiredError]
Future<TokenDataOauth1> authenticateWithToken(
ParamsOauth1WithToken credentials, void Function(List<Consent> consents) onConsentNeeded) async {}
/// Authenticate with an [ParamsOauth1WithEmail] object and returns a
/// [TokenDataOauth1] object
///
/// can throw [ApplicationNotAuthenticatedError], [AuthenticationError],
/// [LoginTimeoutError], [LoginFreezeError], [TooManyFailedAttemptsError], [MfaRequiredError]
Future<TokenDataOauth1> authenticateWithEmail(
ParamsOauth1WithEmail credentials, void Function(List<Consent> consents) onConsentNeeded) async {}
/// Clears oauth session data
bool logout() {}
/// Gives consent based on a [Consent] object
/// Returns the number of affected records
Future<int> giveConsent(Consent consent) async {}
/// Send a measurement to the cloud
Future<Measurement> postMeasurement(MeasurementCreationData measurementCreationData, String cameraSdkVersion) async {}
/// Check if the user is entitled to perform a measurement
Future<bool> canPerformMeasurement() async {}
/// Updates the measurement context for a given measurement id
Future<int> updateMeasurementContext(String measurementId, MeasurementContext measurementContext) async {}
/// Update the user profile of the [userId] provided
/// with the given [ProfileData] and returns the number of affected records
Future<int> updateProfile(ProfileData updateData) async {}
/// Get a measurement based on a [measurementId]
Future<Measurement> getMeasurement(String measurementId) async {
/// Get all measurements of the current user
Future<PagedMeasurementResult> getMeasurements(bool newestFirst) async {}
/// Returns a measurement report url for the given measurement id
/// or creates one if it not yet exists.
Future<String> getMeasurementReportUrl(String measurementId) async {}
/// Returns a list of periodic reports
Future<PagedPeriodicReportsResult> getPeriodicReports(bool newestFirst) async {}
/// Returns the pdf of a periodic report as a string
Future<String> getPeriodicReportPdf(String reportId) async {}
///Activates a prescription hash, so the user can perform a measurement
Future activatePrescription(String hash) async {}
/// Return the general configuration as a [GeneralConfiguration].
Future<GeneralConfiguration> getGeneralConfiguration() async {}
/// Return the user configuration as a [UserConfiguration].
Future<UserConfiguration> getUserConfiguration() async {}
/// Update the user with the id [userId] configuration.
/// The [key] is the key where to save the value for the user.
/// The [value] is an object that can be jsonEncoded.
/// Return true if the update was done successfully.
Future<bool> updateUserConfig(String key, Object value) async {}
}
​
This package serves as a JavaScript wrapper around all FibriCheck cloud services.
To get started with the FibriCheck SDK you'll need to install it, and then get credentials which will allow you to access the backend.

Installation

In your project, if you are using yarn or npm you need to create a file called .npmrc at the root level of your project and add these lines. Replace ${AUTH_TOKEN} with your personal access token. You can get a new one at here. Make sure you enable the read:packages scope.
@extrahorizon:registry=https://npm.pkg.github.com
@fibricheck:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${AUTH_TOKEN}
Alternatively, this file can be added/edited in your home directory and it will be applied to all projects.
Explanation from GitHub on how to add your token can be found here.
Using npm:
npm install --save @fibricheck/javascript-sdk react-native-device-info
Using yarn:
yarn add @fibricheck/javascript-sdk react-native-device-info

Quick Start

To be able to receive data from the FibriCheck cloud services, an app should authenticate with a username/password or token/tokenSecret combination.
To debug your data, an additional request/response logger can be added
import client from '@fibricheck/javascript-sdk';
import { requestLogger } from 'axios-logger';
​
(async () => {
const sdk = client({
consumerKey: '',
consumerSecret: '',
requestLogger
});
​
await sdk.authenticate({
username: '',
password: '',
});
})();
The client method (default export) supports several options you may set to achieve the expected behavior:
Name
Default
Description
env
production
Specifies the environment you connect to
consumerKey
​
Required. Your application's consumerKey
consumerSecret
​
Required. Your application's consumerSecret

API

When you initialize the sdk, the returned object will have the following interface. These descriptions and signatures are also available as inline JSDoc in your IDE.
interface FibricheckSDK {
/**
* Create an account
*
* @param requestBody UserRegisterData
* @returns User
* @throws {EmailUsedError}
*/
register: (data: UserRegisterData) => Promise<UserData>;
/**
* Use token authentication.
* As second parameter you need to pass in callback function that is fired when the user needs to sign updated legal documents
* @see https://docs.fibricheck.com/examples#legal-documents-updated
* @example
* await sdk.auth.authenticate({
* token: '',
* tokenSecret: '',
* });
* @throws {ApplicationNotAuthenticatedError}
* @throws {AuthenticationError}
* @throws {LoginTimeoutError}
* @throws {LoginFreezeError}
* @throws {TooManyFailedAttemptsError}
* @throws {MfaRequiredError}
*/
authenticate(credentials: ParamsOauth1WithToken,
onConsentNeeded: (data: Consent[]) => void
): Promise<TokenDataOauth1>;
/**
* Use password authentication.
* As second parameter you need to pass in callback function that is fired when the user needs to sign updated legal documents
* @see https://docs.fibricheck.com/examples#legal-documents-updated
* @example
* await sdk.auth.authenticate({
* email: '',
* password: '',
* });
* @throws {ApplicationNotAuthenticatedError}
* @throws {AuthenticationError}
* @throws {LoginTimeoutError}
* @throws {LoginFreezeError}
* @throws {TooManyFailedAttemptsError}
* @throws {MfaRequiredError}
*/
authenticate(credentials: ParamsOauth1WithEmail,
onConsentNeeded: (data: Consent[]) => void
): Promise<TokenDataOauth1>;
/**
* Logout
* @returns {boolean} Success
* @example
* await sdk.authenticate({
* password: '',
* username: '',
* });
* sdk.auth.logout();
*/
logout: () => boolean;
/**
* Return documents received from the `onConsentNeeded` callback on authentication after the user has approved them.
* @params {Omit<Consent, 'url'>} data
* @returns AffectedRecords
*/
giveConsent: (data: Omit<Consent, 'url'>) => Promise<AffectedRecords>;
/**
* Send a measurement to the cloud.
* @see https://docs.fibricheck.com/examples#react-component-to-make-a-measurement
* @params {MeasurementCreationData} measurementData
* @throws {NoActivePrescriptionError}
* @returns {Promise<Measurement>} measurement
*/
postMeasurement: (measurement: MeasurementCreationData, cameraSdkVersion?: string) => Promise<Measurement>;
/**
* Check if the user is entitled to perform a measurement
* @returns {Promise<Measurement>} measurement
*/
canPerformMeasurement: () => Promise<boolean>;
/**
* Add context to an existing measurement
* @param {string} measurementId
* @params {MeasurementError} measurementContext
* @throws {LockedDocumentError}
* @returns AffectedRecords
*/
updateMeasurementContext: (measurementId: string, measurementContext: MeasurementContext) => Promise<AffectedRecords>;
/**
* Update the user profile
* @param {string} userId
* @params {ProfileData} profileData
* @returns AffectedRecords
*/
updateProfile: (profileData: ProfileData) => Promise<AffectedRecords>;
/**
* Gets a measurement by measurementId
* @param {string} measurementId
* @returns {Promise<Measurement>} measurement
*/
getMeasurement: (measurementId: string) => Promise<Measurement>;
/**
* Gets all measurements for the current user
* @returns {Promise<PagedResult<Measurement>>} measurements
*/
getMeasurements: () => Promise<PagedResult<Measurement>>;
/**
* Returns an url that can be used to render or download the report as PDF.
* @see https://docs.fibricheck.com/examples#requesting-a-measurement-report-and-rendering-pdf
* @returns {string} url
*/
getMeasurementReportUrl: (measurementId: string) => Promise<string>;
/**
* Gets a list of periodic reports
* @returns {FindAllIterator<PeriodicReport>} periodicReports
*/
getPeriodicReports: () => Promise<FindAllIterator<PeriodicReport>>;
/**
* Get the pdf of a periodic report
* @returns {pdf} pdf
*/
getPeriodicReportPdf: (reportId: string) => Promise<ArrayBuffer>;
/**
* Activates a prescription hash, so the user can perform a measurement
* @throws {NotPaidError}
* @throws {AlreadyActivatedError}
*/
activatePrescription: (hash: string) => Promise<void>;
}
​
​