1.0.25 • Published 1 year ago
typebox-client v1.0.25
typebox-client is a simple client for Typebox schema based api using:
- Fully written in TypeScript
- Typebox for easy json-schema writting
- axios (more http client supported soon) as a http client
Table of Contents:
Installation
To get started, install typebox-client using npm or yarn:
npm install typebox-client
# or
yarn add typebox-client
Usage
Route definitions and api calls
import { loadRouteDefinitions, createRouteDefinition, Type } from 'typebox-client';
const definitions = {
getUser: createRouteDefinition({
method: 'GET',
// Id parameter is dynamicaly injected in the final url.
url: `/user/:id`,
schema: {
params: Type.Object({
id: Type.String(),
}),
response: {
200: Type.Array(
Type.Object({
name: Type.String(),
age: Type.Number(),
})
),
},
},
}),
};
const [createClient, schemas] = loadRouteDefinitions(definitions);
// fastify
server.get('/user', { schema: schemas.getUser }, async (request, response) => {
response.status(200).send([{ name: 'John', age: 30 }]);
});
// client
const apiClient = createClient(axios.create({ baseURL: 'localhost' }));
async () => {
const user = await apiClient.getUser({ params: { id: 'my-user-id' } }).call();
// { name: 'John', age: 30 }
};
Inject URL params
typebox-client use the /my-url/:my-param
syntax to inject given parameters in the final url.
Access the final URL
Sometime, instead of calling the client method you will want to get the computed url. It's usefull to use it as a link href for instance.
const url = await apiClient.getUser({ params: { id: 'my-user-id' } }).url;
// https://localhost/user/my-user-id
That's it! You can now use typebox-client to create fully typed and safe api client.