@devoinc/app-developer-kit

Devo Applications Developer Kit

Devo Applications Development Kit is the mandatory NPM package to start building javascript web browser applications on Devo, it allows you to communicate your application with the devo web and APIs.

Devo Apps

A Devo App is a front-end web browser extension capable of being injected and hosted into the Devo web platform as well as communicating with it and with the collection of HTTP services enabled for Devo customers.

Before starting

As a main requirement for the development of applications in Devo it is necessary to have access to the platform and a domain.

Once you have access, to prepare the development environment you must install the google chrome extension "Devo Runner", you will find it here. This extension will help the developer to be able to debug and develop their application by providing a mechanism to inject it into an existing Devo client domain.

Instalation

Start by installing this package in your NPM project

$ npm install @devoinc/app-developer-kit

For these applications to be compatible with Devo and Devo Runner, it will be necessary to configure the javascript bundler so that the result of its process generates a single HTML file with all the javascript code and css styles inline. For this we recommend to use Webpack 5 and the InlineChunkHtmlPlugin plugin.

A complete usage example for this package can be found in this react template.

Features

You can find the complete reference of the development kit API here.

• User information: The IDevoApp instance could be used to obtain the information of the current user who is executing this application in the web browser.

import { 
    IDevoApp, 
    DevoAppProvider, 
    UserInfo,
} from '@devoinc/app-developer-kit';

(async () => {
    const dApp: IDevoApp = DevoAppProvider.init();
    const userInfo: UserInfo = await dApp.getUserInfo();
    console.log(userInfo);
})();

• Create notifications messages: The IDevoApp instance could be used to render a devo notification message in the browser.

import { 
    IDevoApp, 
    DevoAppProvider, 
    NotipopRequest,
} from '@devoinc/app-developer-kit';

(async () => {
    const dApp: IDevoApp = DevoAppProvider.init();
    const notipop: NotipopRequest = {
        title: 'Hello world',
        text: '...',
        type: 'ok',
    };
    dApp.createNotipop(notipop);
})();

• Devo queries: The IDevoApp instance could be used to make queries on Devo query engine. The different operations provided here are a wrapper of this other package. It is intended to be consumed in a simple way with async/await syntax and masking the obtaining of the user credentials as well as the service URL.

import { 
    IDevoApp, 
    DevoAppProvider, 
    Query, 
    NotipopRequest 
} from '@devoinc/app-developer-kit';

(async () => {
    const dApp: IDevoApp = DevoAppProvider.init();

    const query: Query = {
        queryString: `
            from ...
            select ...
        `,
        dates: {
            from: new Date('...').getMilliseconds(),
            to: new Date('...').getMilliseconds(),
        },
    };
    const queryClient: IQueryClient = await dApp.getQueryClient();
    const queryResponse = await queryClient.runQuery(query, dates);
    console.log(queryResponse);
})();

• Devo alerts: The IDevoApp instance could be used to operate with Devo alerts. You could found a complete documentation about Devo alerts here and the client reference here.

import { 
    IDevoApp, 
    DevoAppProvider, 
    AlertsApiClient,
} from '@devoinc/app-developer-kit';

(async () => {
    const dApp: IDevoApp = DevoAppProvider.init();
    const alertsClient: AlertsApiClient.IClient = await dApp.getAlertsClient('alertsApiUrl');
    const alertDefinitions: AlertsApiClient.AlertDefinition = await alertsClient.getAlerts();
    console.log(alertDefinitions);
})();

Standalone mode

It is possible to initialize the IDevoApp instance to work in standalone mode, in this way, the different dependencies of the application with the Devo web core and API endpoints could be mocked. Just use the init method passing it a specific settings for the 'standaloneDependencies' field as the following example.

import { 
    IDevoApp, 
    DevoAppProvider,
    WebCoreRuntimeDeps,
    Dates,
} from '@devoinc/app-developer-kit';

(async () => {
    class StandaloneNotipop {
        constructor(request: NotiPopRequest) {
            console.log(`Fake notification`, request);
        }
    }

    const mockedUserInfo: UserInfo = {
        name: 'John Doe',
        email: '[e-mail]',
        locale: 'en-US',
        ...
    };

    const mockedGoToQuery: (query: string, dates: Dates) => {
        console.log(`Fake goToQuery. ${query} ${dates}`);
    };

    const dApp: IDevoApp = DevoAppProvider.init({
        standaloneDependencies: {
            goToQuery: mockedGoToQuery,
            userInfo: mockedUserInfo,
            NotiPop: StandaloneNotipop,
        },
    });
})();

Publishing and hosting

The publishing and hosting process for these applications will be carried out by Devo employees. Please contact Devo support for this task.