From 983d88002e64b2923ddf43d3a78851cb2b646136 Mon Sep 17 00:00:00 2001 From: Raven Scott Date: Sat, 15 Jun 2024 03:12:38 -0400 Subject: [PATCH] Add current bot readme --- chatBot/README.md | 214 +++++++++++++++++++++++++++++++++ chatBot/commands/ping.js | 2 +- chatBot/commands/test-audio.js | 6 +- chatBot/env.default | 2 +- 4 files changed, 219 insertions(+), 5 deletions(-) create mode 100644 chatBot/README.md diff --git a/chatBot/README.md b/chatBot/README.md new file mode 100644 index 0000000..6723ea4 --- /dev/null +++ b/chatBot/README.md @@ -0,0 +1,214 @@ +# Bot System Documentation + +## Overview + +This document provides a comprehensive guide to the bot system, detailing its structure, functionalities, and how to set it up. This bot system leverages the Hyperswarm network to enable decentralized communication and supports various types of messages, including text, files, and audio. + +## Table of Contents + +1. [Introduction](#introduction) +2. [Getting Started](#getting-started) + - [Prerequisites](#prerequisites) + - [Installation](#installation) + - [Configuration](#configuration) +3. [Bot Architecture](#bot-architecture) + - [Client Class](#client-class) + - [Message Classes](#message-classes) +4. [Command Handling](#command-handling) +5. [Event Handling](#event-handling) +6. [Running the Bot](#running-the-bot) +7. [API Reference](#api-reference) +8. [License](#license) + +## Introduction + +This bot system is designed for decentralized chat rooms using the Hyperswarm network. It supports multiple message types and dynamic command handling, making it highly customizable and extensible. + +## Getting Started + +### Prerequisites + +- Node.js (version 14.x or later) +- npm (version 6.x or later) + +### Installation + +1. Clone the repository: + ```bash + git clone + cd + ``` + +2. Install the dependencies: + ```bash + npm install + ``` + +### Configuration + +Create a `.env` file in the root directory and add the following environment variables: + +``` +BOT_NAME=MyBot +ON_READY_MESSAGE=Bot is ready and operational! +LINKUP_ROOM_ID= +``` + +## Bot Architecture + +### Client Class + +The `Client` class is the core component of the bot system. It handles connections to the Hyperswarm network, manages message sending and receiving, and emits events for various actions. + +#### Constructor + +```javascript +constructor(botName) +``` + +- `botName`: The name of the bot. + +#### Methods + +- `initializeServeDrive()`: Initializes the ServeDrive for serving files and audio. +- `getRandomPort()`: Returns a random port number. +- `fetchAvatar(filePath)`: Fetches and sets the bot's avatar from a local file. +- `setupSwarm()`: Sets up the Hyperswarm network and connection handlers. +- `joinChatRoom(chatRoomID)`: Joins a specified chat room. +- `sendTextMessage(message)`: Sends a text message. +- `sendFileMessage(filePath, fileType)`: Sends a file message. +- `sendAudioMessage(filePath, audioType)`: Sends an audio message. +- `sendMessage(message)`: Sends a generic message. +- `destroy()`: Disconnects the bot and shuts down the Hyperswarm network. + +### Message Classes + +The bot system supports various message types through dedicated classes, all extending the base `Message` class. + +#### Message Class + +```javascript +class Message { + constructor(messageType, peerName, peerAvatar, topic, timestamp) +} +``` + +#### TextMessage Class + +```javascript +class TextMessage extends Message { + constructor(peerName, peerAvatar, topic, timestamp, message) + static new(bot, message) +} +``` + +#### FileMessage Class + +```javascript +class FileMessage extends Message { + constructor(peerName, peerAvatar, topic, timestamp, fileName, fileUrl, fileType, fileData) + static new(bot, fileName, fileUrl, fileType, fileBuffer) +} +``` + +#### AudioMessage Class + +```javascript +class AudioMessage extends Message { + constructor(peerName, peerAvatar, topic, timestamp, audioUrl, audioType, audioData) + static new(bot, audioUrl, audioType, audioBuffer) +} +``` + +#### IconMessage Class + +```javascript +class IconMessage extends Message { + constructor(peerName, peerAvatar, timestamp) + static new(bot, avatarBuffer) +} +``` + +## Command Handling + +Commands are dynamically loaded from the `commands` directory. Each command is a JavaScript module with a default export containing a `handler` function. + +### Example Command Module + +```javascript +// commands/example.js +export default { + handler: (bot, args, message) => { + bot.sendTextMessage(`Example command executed with args: ${args.join(' ')}`); + } +}; +``` + +## Event Handling + +The bot uses Node.js `EventEmitter` to handle events. Key events include: + +- `onMessage`: Triggered when a new message is received. +- `onFile`: Triggered when a file message is received. +- `onAudio`: Triggered when an audio message is received. +- `onIcon`: Triggered when an icon message is received. +- `onError`: Triggered when there is a connection error. +- `onBotJoinRoom`: Triggered when the bot joins a room. + +### Example Event Listener + +```javascript +bot.on('onMessage', (peer, message) => { + console.log(`Message from ${message.peerName}: ${message.message}`); +}); +``` + +## Running the Bot + +To start the bot, run the following command: + +```bash +node bot.js +``` + +Ensure that the `.env` file is correctly configured and that all necessary dependencies are installed. + +## API Reference + +### Client + +- `constructor(botName)`: Creates a new instance of the Client. +- `initializeServeDrive()`: Initializes ServeDrive. +- `getRandomPort()`: Generates a random port number. +- `fetchAvatar(filePath)`: Fetches the bot's avatar. +- `setupSwarm()`: Sets up the Hyperswarm network. +- `joinChatRoom(chatRoomID)`: Joins a specified chat room. +- `sendTextMessage(message)`: Sends a text message. +- `sendFileMessage(filePath, fileType)`: Sends a file message. +- `sendAudioMessage(filePath, audioType)`: Sends an audio message. +- `sendMessage(message)`: Sends a generic message. +- `destroy()`: Disconnects the bot. + +### TextMessage + +- `constructor(peerName, peerAvatar, topic, timestamp, message)`: Creates a new text message. +- `static new(bot, message)`: Creates a new text message instance. + +### FileMessage + +- `constructor(peerName, peerAvatar, topic, timestamp, fileName, fileUrl, fileType, fileData)`: Creates a new file message. +- `static new(bot, fileName, fileUrl, fileType, fileBuffer)`: Creates a new file message instance. + +### AudioMessage + +- `constructor(peerName, peerAvatar, topic, timestamp, audioUrl, audioType, audioData)`: Creates a new audio message. +- `static new(bot, audioUrl, audioType, audioBuffer)`: Creates a new audio message instance. + +### IconMessage + +- `constructor(peerName, peerAvatar, timestamp)`: Creates a new icon message. +- `static new(bot, avatarBuffer)`: Creates a new icon message instance. + +## License + +This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. \ No newline at end of file diff --git a/chatBot/commands/ping.js b/chatBot/commands/ping.js index 4f6120d..f9e0044 100644 --- a/chatBot/commands/ping.js +++ b/chatBot/commands/ping.js @@ -1,7 +1,7 @@ export default { handler: function(bot, args, message) { // Specify the path to the file you want to send - const filePath = '/path/to/file.png'; // Replace with the actual file path + const filePath = '/Users/raven/chat/chatBot/commands/ping.js'; // Replace with the actual file path const fileType = 'text/html'; // Specify the correct file type // Send the file message using the bot instance diff --git a/chatBot/commands/test-audio.js b/chatBot/commands/test-audio.js index b866ee0..bac2b48 100644 --- a/chatBot/commands/test-audio.js +++ b/chatBot/commands/test-audio.js @@ -1,9 +1,9 @@ export default { handler: function(bot, args, message) { // Specify the path to the audio file you want to send - const audioFilePath = '/path/to/audio/file'; // Replace with the actual audio file path - const audioType = 'audio'; - + const audioFilePath = '/Users/raven/discord-linux.mp3'; // Replace with the actual audio file path + const audioType = 'audio'; + // Send the audio message using the bot instance bot.sendAudioMessage(audioFilePath, audioType); } diff --git a/chatBot/env.default b/chatBot/env.default index f677e9c..a844d4c 100644 --- a/chatBot/env.default +++ b/chatBot/env.default @@ -2,4 +2,4 @@ LINKUP_ROOM_ID= BOT_NAME=myBot -ON_READY_MESSAGE="Hello, I am a bot. I am here to help you. Please type 'help' to see the list of commands." \ No newline at end of file +ON_READY_MESSAGE="Hello, I am a bot. I am here to help you." \ No newline at end of file