discordthings-api 1.0.0

package/README.md

@@ -0,0 +1,65 @@
+# DiscordThings API Wrapper
+
+Official NPM package for interacting with the **DiscordThings.com** API.  
+Easily post bot stats and check user votes.
+
+## Installation
+
+```bash
+npm install discordthings-api
+```
+
+## Usage
+
+First, get your **API Token** from your User Profile on DiscordThings.
+
+```javascript
+const DiscordThings = require('discordthings-api');
+
+// Initialize with your User API Token
+const dthings = new DiscordThings('YOUR_API_TOKEN');
+
+const BOT_ID = 'YOUR_BOT_ID';
+
+async function syncStats() {
+    try {
+        // Post Server Count (and optional Shard Count)
+        await dthings.postStats(BOT_ID, 1500, 2);
+        console.log('Stats posted successfully!');
+    } catch (error) {
+        console.error('Failed to post stats:', error.message);
+    }
+}
+
+async function handleVoteCheck(userId) {
+    try {
+        // Check if a user voted
+        const result = await dthings.checkVote(BOT_ID, userId);
+        
+        if (result.voted) {
+            console.log(`User ${userId} has voted!`);
+            console.log(`Next vote allowed at: ${result.nextVote}`);
+        } else {
+            console.log(`User ${userId} has not voted yet.`);
+        }
+    } catch (error) {
+        console.error('Error checking vote:', error.message);
+    }
+}
+
+syncStats();
+```
+
+## Methods
+
+### `constructor(token, options?)`
+- `token`: Your API Token from the dashboard.
+- `options.baseUrl`: Optional (default: `https://discordthings.com/api`).
+
+### `postStats(botId, serverCount, shardCount?)`
+- Updates the server and shard count for the specified bot.
+- **Note:** You must be the owner of the bot associated with the API Token.
+
+### `checkVote(botId, userId)`
+- Checks if a specific user has voted for the bot in the last 12 hours.
+- Returns: `{ voted: boolean, lastVote: Date|null, nextVote: Date|null }`.

package/index.js

@@ -0,0 +1,72 @@
+const axios = require('axios');
+
+class DiscordThings {
+    /**
+     * @param {string} token - Your Bot's API Token (from User Profile)
+     * @param {Object} options - Optional settings
+     * @param {string} [options.baseUrl='https://discordthings.com/api'] - API Base URL
+     */
+    constructor(token, options = {}) {
+        if (!token) throw new Error('A valid API Token is required');
+
+        this.token = token;
+        this.baseUrl = options.baseUrl || 'https://discordthings.com/api';
+
+        this.client = axios.create({
+            baseURL: this.baseUrl,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': this.token
+            }
+        });
+    }
+
+    /**
+     * Post Server and Shard Count Stats
+     * @param {string} botId - The ID of the bot
+     * @param {number} serverCount - Total number of servers
+     * @param {number} [shardCount=0] - Total number of shards (optional)
+     * @returns {Promise<Object>} API Response
+     */
+    async postStats(botId, serverCount, shardCount = 0) {
+        if (!botId) throw new Error('Bot ID is required');
+
+        try {
+            const response = await this.client.post(`/bots/${botId}/stats`, {
+                server_count: serverCount,
+                shard_count: shardCount
+            });
+            return response.data;
+        } catch (error) {
+            this._handleError(error);
+        }
+    }
+
+    /**
+     * Check if a user has voted for a bot
+     * @param {string} botId - The ID of the bot
+     * @param {string} userId - The ID of the user to check
+     * @returns {Promise<Object>} { voted: boolean, lastVote: Date, nextVote: Date }
+     */
+    async checkVote(botId, userId) {
+        if (!botId || !userId) throw new Error('Bot ID and User ID are required');
+
+        try {
+            const response = await this.client.get(`/bots/${botId}/check-vote`, {
+                params: { userId }
+            });
+            return response.data;
+        } catch (error) {
+            this._handleError(error);
+        }
+    }
+
+    _handleError(error) {
+        if (error.response) {
+            throw new Error(`API Error [${error.response.status}]: ${error.response.data.error || error.response.statusText}`);
+        }
+        throw error;
+    }
+}
+
+module.exports = DiscordThings;

package/package.json

@@ -0,0 +1,26 @@
+{
+    "name": "discordthings-api",
+    "version": "1.0.0",
+    "description": "Official API Wrapper for DiscordThings.com",
+    "main": "index.js",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": [
+        "discord",
+        "botlist",
+        "discordthings",
+        "api",
+        "wrapper",
+        "stats"
+    ],
+    "author": "DiscordThings",
+    "license": "ISC",
+    "dependencies": {
+        "axios": "^1.6.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/discordthings/npm-package.git"
+    }
+}