@evlt/apix-client

API-X Node.js TypeScript Client

A client for API-X (GitHub repository). This package provides an easy-to-use interface for interacting with API-X-based servers. The client is designed to be:

• Extensible & Modifiable: Easily extend or modify the client for custom API-X-based servers.
• Secure & Fast: Built with secure request mechanisms, ensuring safe interactions with API-X endpoints while maintaining high performance.

Full documentation at https://apix.evoluti.us/client.

Features

• Simplified API Interaction: Convenient methods for creating and making GET, POST, PUT, DELETE, and PATCH requests.
• Extensible Design: Can be extended to support custom authentication, additional HTTP methods, or other functionalities.
• Security First: Requests are signed and timestamped, providing protection against replay attacks and unauthorized access.
• Intuitive Usage: Create request objects or directly make requests with ease.

Installation

You can install this package using npm:

npm install @evlt/apix-client

Or using yarn:

yarn add @evlt/apix-client

Usage

Creating an API-X Client

First, create an instance of ApiXClient by providing your keyStore:

import { ApiXClient, ApiXEnvironmentKeyStore } from '@evlt/apix-client';

const keyStore = ApiXEnvironmentKeyStore.shared;  /// Only secure for backend environments.
keyStore.startupTest();  /// Will halt execution or throw if either key is not defined.
const client = new ApiXClient(keyStore);

Making Requests

GET Request

const url = new URL('https://apix.example.com/endpoint');
client.makeGetRequest(url)
  .then(response => console.log(response))
  .catch(error => console.error(error));

POST Request

const url = new URL('https://apix.example.com/endpoint');
const data = { key: 'value' };
client.makePostRequest(url, data)
  .then(response => console.log(response))
  .catch(error => console.error(error));

Creating Request Objects

If you prefer more control over the request, you can create a request object first, modify it if needed, and then execute it:

const request = client.createPostRequest(url, data);
request.setHeader('Authorization', 'Bearer your-token');
request.make()
  .then(response => console.log(response))
  .catch(error => console.error(error));

API Reference

ApiXClient

Constructor

constructor(keyStore: ApiXKeyStore)

Creates a new instance of an API-X Client.

• keyStore: An object that securely retrieves the keys used in an API-X.

Methods

• createRequest(url: URL, httpMethod: ApiXHttpMethod, data?: ApiXJsonObject): ApiXRequest

  • Creates a new ApiXRequest object.

• createGetRequest(url: URL): ApiXRequest

  • Creates a new GET request object.

• makeRequest(url: URL, httpMethod: ApiXHttpMethod, data?: ApiXJsonObject): Promise<ApiXResponse>

  • Directly makes a request and returns the response.

• Convenience Methods

  • makeGetRequest(url: URL), makePostRequest(url: URL, data?: ApiXJsonObject), makePutRequest(url: URL, data?: ApiXJsonObject), makeDeleteRequest(url: URL, data?: ApiXJsonObject), makePatchRequest(url: URL, data?: ApiXJsonObject): Simplified methods for common HTTP actions.

ApiXRequest

For advanced usage, ApiXRequest provides full control over individual requests, allowing for custom headers, cookies, and more.

Extending the Client

The ApiXClient can be easily extended for additional functionality, such as:

• Adding custom headers or authentication mechanisms.
• Implementing retry logic or other custom request handling features.

License

This package is licensed under the MIT License. See the LICENSE file for more information.

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests on the GitHub repository.