Cloudways JS Client

Description

Cloudways JS Client is a TypeScript-based client library that allows you to power your applications with the Cloudways API. It provides a convenient and strongly-typed way to interact with the Cloudways API, enabling you to manage servers, perform automation, and integrate Cloudways functionality into your web applications.

🚧 Under Development 🚧

Please note that this library is still under development. Although it's functional and can be used, some features might be incomplete or subject to changes.

Features

Easy-to-use client library for the Cloudways API.
Simplifies server management and web app integration.
Built with TypeScript for improved type safety and development experience.
Comprehensive documentation and code examples, including JSDoc comments.

Installation

You can install the package via npm:

npm install cloudways-js-client

Usage

The Cloudways JS Client library makes it easy to interact with the Cloudways API for various operations. Below are some examples to help you get started.

Initializing the API

Before performing any operations, initialize the API with your Cloudways account credentials:

```javascript import { initializeCloudwaysApi } from 'cloudways-js-client'; const email = 'your_email@example.com'; // Replace with your Cloudways account email const apiKey = 'your_api_key'; // Replace with your Cloudways API key initializeCloudwaysApi(email, apiKey); ```

Deleting a Server

To delete a server, use the deleteServer function. Ensure you have the correct server ID:

```javascript import { deleteServer } from "cloudways-js-client"; async function deleteServerA() { const serverId = 12345; // Replace with the server ID you want to delete await deleteServer(serverId); console.log("Server deleted successfully."); } ```

Getting the List of Servers

You can retrieve the list of servers associated with your account using the getServersList function:

```javascript import { getServersList } from "cloudways-js-client"; async function listServers() { try { const servers = await getServersList(); console.log("Servers List:", servers); } catch (error) { console.error("Error fetching servers list:", error); } } listServers(); ```

Combining Operations

You can combine these functions to perform multiple operations. For example, to delete a server and then get the updated list of servers:

```javascript async function deleteServerAndGetList() { const serverId = 12345; // Replace with the server ID to delete await deleteServer(serverId); console.log("Server deleted successfully."); console.log("Updated Servers List:", await getServersList()); } deleteServerAndGetList(); ```

Issues

If you find any issues or have any feature requests, please open an issue on GitHub.

License

This project is open source and available under the MIT License.