mantil.js is a JavaScript SDK for developing Mantil applications.
npm install @mantil-io/mantil.js
Using this SDK we can easily connect to a WebSocket endpoint of a mantil project.
To connect, use the createWsApi method:
import { createWsApi } from '@mantil-io/mantil.js';
const api = createWsApi();
This will attempt to find the API URL using the global variable mantilEnv (see here). Mantil will add a mantil_env.js script which defines this variable to the root of every deployed static website, so you can just include it in your public/index.html file:
<script type="text/javascript" src="/mantil_env.js"></script>
Alternatively, you can pass a custom URL to the createWsApi function:
const api = createWsApi('wss://...');
Now you can use the api object to:
- Subscribe to subjects:
api.subscribe('subject', message => console.log(message));
- Invoke api methods:
const rsp = await api.request('ping.default');
console.log(rsp);
This will invoke the default method of the ping API.