Javascript client for the host-inventory API

If you want to use RedHatInsights/host-inventory you shouldn't use get requests directly, but rather use this client to integrate with this service.

Install

NPM
``bash
npm install --save @redhat-cloud-services/host-inventory-client
`

Or Yarn
`bash
yarn add @redhat-cloud-services/host-inventory-client
`

$3

This client is using typescript and axios. Types are distributed with this package, so no need to define or install them separately.

This package comes with a client in its api.ts already defined with every call available.
`JS
import host-inventoryClient from '@redhat-cloud-services/javascript-clients-shared/utils';

host-inventoryClient.someEndpoint();
``

To bootstrap this API manually, you should create your own client via the APIFactory defined in the @redhat-cloud-services/javascript-clients-shared package. See below for an example:
`JS
import APIFactory from '@redhat-cloud-services/javascript-clients-shared/utils';
import exampleEndpoint from '@redhat-cloud-services/host-inventory-client/ExampleEndpoint';

// BASE_PATH should be set in your constants file
const hostInventoryApi = APIFactory(BASE_PATH, undefined, { exampleEndpoint });
export hostInventoryApi;
`

If you want to add some interceptors you can use axios build in interceptors
`JS
import axios from 'axios';
import APIFactory from '@redhat-cloud-services/javascript-clients-shared/utils';
import exampleEndpoint from '@redhat-cloud-services/host-inventory-client/ExampleEndpoint';

const instance = axios.create();

// Request interceptor
instance.interceptors.request.use((request) => {
// some logic to do with request
});

// Response interceptor
instance.interceptors.response.use((response) => {
// some logic to do with request
});

// Error interceptor
instance.interceptors.response.use(null, (error) => {
// some logic to do with error
});

// BASE_PATH should be set in your constants file
const hostInventoryApi = APIFactory(BASE_PATH, instance, { exampleEndpoint });
export hostInventoryApi;
`


Generating

Ensure you have the javascript-clients generator built first with npm run build:generator. Then, run nx run @redhat-cloud-services/host-inventory-client:generate to generate the package.

Building

Run nx run @redhat-cloud-services/host-inventory-client:build to build the package. This creates the dist for publishing.

Running unit tests

Run nx run @redhat-cloud-services/host-inventory-client:test` to execute the unit tests via Jest.

API documentation

* README