discordthings-api 1.1.1 → 1.1.6

package/README.md

@@ -38,7 +38,10 @@ const BOT_ID = '123456789012345678'; // Your Bot ID
 ```javascript
 async function updateStats() {
     try {
-        await dthings.postStats(BOT_ID, 1250);
+        await dthings.postStats(BOT_ID, 1250, 0, 50000, [
+            { name: "play", count: 120 },
+            { name: "profile", count: 50 },
+        ]);
         console.log('Stats updated on DiscordThings!');
     } catch (err) {
         console.error('Error updating stats:', err.message);
@@ -94,8 +97,10 @@ async function syncCommands() {
 - `token` (String): Your personal API Token.
 - `options.baseUrl` (String): Override default API endpoint.
 
-### `postStats(botId, serverCount, [shardCount])`
+### `postStats(botId, serverCount, [shardCount], [userCount], [commandStats])`
 - Updates the bot's server and shard presence.
+- `userCount`: Total user count (Number).
+- `commandStats`: Array of `{ name, count }`.
 - Returns `Promise<Object>`.
 
 ### `checkVote(botId, userId)`

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+export interface DiscordThingsOptions {
+    baseUrl?: string;
+}
+export interface VoteResult {
+    voted: boolean;
+    lastVote: string | null;
+    nextVote: string | null;
+}
+export interface CommandOption {
+    name: string;
+    description: string;
+    type: number;
+    required?: boolean;
+    choices?: {
+        name: string;
+        value: string | number;
+    }[];
+    options?: CommandOption[];
+}
+export interface Command {
+    name: string;
+    description: string;
+    type?: number;
+    options?: CommandOption[];
+}
+export declare class DiscordThings {
+    private client;
+    /**
+     * @param {string} token - Your User API Token
+     * @param {DiscordThingsOptions} [options] - Configuration options
+     */
+    constructor(token: string, options?: DiscordThingsOptions);
+    /**
+     * Post bot statistics to DiscordThings
+     * @param {string} botId - The ID of the bot
+     * @param {number} serverCount - Total number of servers the bot is in
+     * @param {number} [shardCount] - Total number of shards (optional)
+     * @param {number} [userCount] - Total number of users (optional)
+     * @param {Array<{name: string, count: number}>} [commandStats] - Array of command usage stats (optional)
+     * @returns {Promise<any>} API Response
+     */
+    postStats(botId: string, serverCount: number, shardCount?: number, userCount?: number, commandStats?: {
+        name: string;
+        count: number;
+    }[]): Promise<any>;
+    /**
+     * Check if a user has voted for the bot
+     * @param {string} botId - The ID of the bot
+     * @param {string} userId - The ID of the user
+     * @returns {Promise<VoteResult>} Vote status object
+     */
+    checkVote(botId: string, userId: string): Promise<VoteResult | undefined>;
+    /**
+     * Sync commands for the bot
+     * @param {string} botId - The ID of the bot
+     * @param {Command[]} commands - Array of command objects
+     * @returns {Promise<any>} API Response
+     */
+    syncCommands(botId: string, commands: Command[]): Promise<any>;
+    private _handleError;
+}
+export default DiscordThings;

package/dist/index.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscordThings = void 0;
+const axios_1 = __importDefault(require("axios"));
+class DiscordThings {
+    /**
+     * @param {string} token - Your User API Token
+     * @param {DiscordThingsOptions} [options] - Configuration options
+     */
+    constructor(token, options = {}) {
+        if (!token)
+            throw new Error('API Token is required');
+        this.client = axios_1.default.create({
+            baseURL: options.baseUrl || 'https://discordthings.com/api',
+            headers: {
+                'Authorization': token,
+                'Content-Type': 'application/json'
+            }
+        });
+    }
+    /**
+     * Post bot statistics to DiscordThings
+     * @param {string} botId - The ID of the bot
+     * @param {number} serverCount - Total number of servers the bot is in
+     * @param {number} [shardCount] - Total number of shards (optional)
+     * @param {number} [userCount] - Total number of users (optional)
+     * @param {Array<{name: string, count: number}>} [commandStats] - Array of command usage stats (optional)
+     * @returns {Promise<any>} API Response
+     */
+    async postStats(botId, serverCount, shardCount, userCount, commandStats) {
+        if (!botId || serverCount === undefined)
+            throw new Error('Bot ID and server count are required');
+        try {
+            const payload = {
+                server_count: serverCount
+            };
+            if (shardCount !== undefined)
+                payload.shard_count = shardCount;
+            if (userCount !== undefined)
+                payload.user_count = userCount;
+            if (commandStats !== undefined)
+                payload.commandStats = commandStats;
+            const response = await this.client.post(`/bots/${botId}/stats`, payload);
+            return response.data;
+        }
+        catch (error) {
+            this._handleError(error);
+        }
+    }
+    /**
+     * Check if a user has voted for the bot
+     * @param {string} botId - The ID of the bot
+     * @param {string} userId - The ID of the user
+     * @returns {Promise<VoteResult>} Vote status object
+     */
+    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);
+        }
+    }
+    /**
+     * Sync commands for the bot
+     * @param {string} botId - The ID of the bot
+     * @param {Command[]} commands - Array of command objects
+     * @returns {Promise<any>} API Response
+     */
+    async syncCommands(botId, commands) {
+        if (!botId || !Array.isArray(commands))
+            throw new Error('Bot ID and commands array are required');
+        try {
+            const response = await this.client.post(`/bots/${botId}/commands`, {
+                commands
+            });
+            return response.data;
+        }
+        catch (error) {
+            this._handleError(error);
+        }
+    }
+    _handleError(error) {
+        if (axios_1.default.isAxiosError(error) && error.response) {
+            throw new Error(`API Error [${error.response.status}]: ${error.response.data.error || error.response.statusText}`);
+        }
+        throw error;
+    }
+}
+exports.DiscordThings = DiscordThings;
+// Support CommonJS require and ES imports
+exports.default = DiscordThings;
+module.exports = DiscordThings;
+// To maintain compatibility with the previous require('discordthings-api') pattern
+module.exports.default = DiscordThings;
+module.exports.DiscordThings = DiscordThings;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,9 +1,15 @@
 {
     "name": "discordthings-api",
-    "version": "1.1.1",
+    "version": "1.1.6",
     "description": "Official API Wrapper for DiscordThings.com",
-    "main": "index.js",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
     "scripts": {
+        "build": "tsc",
+        "prepublishOnly": "npm run build",
         "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [
@@ -22,5 +28,9 @@
     "repository": {
         "type": "git",
         "url": "https://github.com/wdiscordthings/discordthings-api.git"
+    },
+    "devDependencies": {
+        "@types/node": "^25.0.3",
+        "typescript": "^5.9.3"
     }
 }

package/index.js

@@ -1,91 +0,0 @@
-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);
-        }
-    }
-
-    /**
-     * Sync commands for the bot
-     * @param {string} botId - The ID of the bot
-     * @param {Array} commands - Array of command objects
-     * @returns {Promise<Object>} API Response
-     */
-    async syncCommands(botId, commands) {
-        if (!botId || !Array.isArray(commands)) throw new Error('Bot ID and commands array are required');
-
-        try {
-            const response = await this.client.post(`/bots/${botId}/commands`, {
-                commands
-            });
-            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;