npm install @droz-js/sdkTo set up the sdk you need to tell the tenant and the authentication method, the tenant is required. You must run this
first before making any sdk calls. The sdk will fail if you don't set up the tenant.
``typescript
import { DrozSdk } from '@droz-js/sdk';
DrozSdk.forTenant('dev').withAuthorization('Basic', 'username', 'password');
`
You can also split the setup in two steps
`typescript
import { DrozSdk } from '@droz-js/sdk';
// first step (required)
DrozSdk.forTenant('dev');
// (optional) later when you have the authentication token you can set it and it will automatically be used in the new requests
DrozSdk.withAuthorization('Basic', 'username', 'password');
`
The sdk will throw an error on every request that fails, but you can also catch the error globally by using the on
method.
`typescript
import { DrozSdk } from '@droz-js/sdk';
DrozSdk.on('error', (error) => {
console.log(error);
});
`
Every error sent is of type SdkError and contains the following properties:
- message: the original error message sent from the server;statusCode
- : similar to the http status codes and indicates the class of the error, 400 bad request, 403 forbidden,errorCode
404 not found...;
- : a unique identifier for the error, this is useful to for i18n friendly messages;
For websockets we use graphql-ws protocol with AsyncIterator to handle the subscriptions. The sdk will automaticallyAsyncIterator
handle the connection and reconnection for you,
see https://the-guild.dev/graphql/ws/recipes#client-usage-with-asynciterator
on how to use the .
`typescript
import { DrozSdk } from '@droz-js/sdk';
import { DrozChat } from '@droz-js/sdk/drozchat';
DrozSdk.forTenant('dev');
const chat = new DrozChat();
const iterable = chat.onTicketInQueue();
for await (const result of iterable) {
console.log(result);
}
`
#### For the React developers
`typescript
import { DrozSdk } from '@droz-js/sdk';
import { DrozChat } from '@droz-js/sdk/drozchat';
DrozSdk.forTenant('dev');
function useOnTicketInQueue() {
const chat = new DrozChat();
const [tickets, setTickets] = useState
useEffect(() => {
const subscription = chat.onTicketInQueue();
// YES I KNOW, REACT SUCKS
(async () => {
// attention! this is just an example what you do with the result is up to you
for await (const each of subscription) setTickets(tickets => [...tickets, each]);
})();
// this is required to close the subscription when the component unmounts
return () => subscription.return();
}, []);
}
`
`typescript`
import { DrozNexo } from '@droz-js/sdk/droznexo';
`typescript``
import { DrozChat } from '@droz-js/sdk/drozchat';