@statcord-ts/seedcord-plugin 0.0.0 → 0.0.1-dev

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Vorasion Development
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @statcord-ts/seedcord-plugin
+
+The Seedcord plugin for Statcord.
+
+---
+
+Don't install this yet, we're still working out all the kinks.

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import { CoreBase, Plugin } from "@seedcord/gateway";
+import { Statcord, StatcordChart, StatcordCommand } from "@statcord-ts/core";
+import { StatcordPluginOptions } from "@statcord-ts/plugin-options";
+//#region src/index.d.ts
+export interface SeedcordStatcordPluginOptions extends StatcordPluginOptions {
+  allowGuildCommands?: boolean;
+}
+export declare class StatcordPlugin extends Plugin {
+  #private;
+  private readonly options?;
+  private client;
+  readonly charts: Map<string, StatcordChart>;
+  readonly commands: Map<string, StatcordCommand>;
+  constructor(host: CoreBase, options?: SeedcordStatcordPluginOptions | undefined);
+  dispose(): Promise<void>;
+  init(): Promise<void>;
+  ready(): Promise<void>;
+  stopAutoposting(): void;
+  postStats(): Promise<void>;
+  addCustomChart(name: string, data: Record<string, number>): void;
+  get statcordClient(): Statcord;
+}
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,134 @@
+import { InteractionKind, Plugin } from "@seedcord/gateway";
+import { Statcord } from "@statcord-ts/core";
+import os from "node:os";
+import { OSUtils } from "node-os-utils";
+//#region src/eventHandler.ts
+var PluginEventHandler = class {
+	commands;
+	options;
+	#acceptedInteractionKinds = [
+		InteractionKind.MessageContextMenu,
+		InteractionKind.Slash,
+		InteractionKind.UserContextMenu
+	];
+	onCommandsDeployed = (event) => this.#addDeployedCommandsToCommands(event);
+	onInteractionDispatched = (event) => this.#handleCommandInteraction(event);
+	constructor(commands, options) {
+		this.commands = commands;
+		this.options = options;
+	}
+	#addDeployedCommandsToCommands(event) {
+		for (const command of event.global) {
+			if (this.commands.has(command.name)) continue;
+			this.commands.set(command.name, {
+				name: command.name,
+				count: 0
+			});
+		}
+		if (this.options?.allowGuildCommands) for (const commands of Object.values(event.guilds)) for (const command of commands) {
+			if (this.commands.has(command.name)) continue;
+			this.commands.set(command.name, {
+				name: command.name,
+				count: 0
+			});
+		}
+	}
+	#getCommandName(routeId) {
+		const name = routeId.slice(routeId.indexOf(":") + 1);
+		const end = name.indexOf("/");
+		return end === -1 ? name : name.slice(0, end);
+	}
+	#handleCommandInteraction({ kind, outcome, routeId }) {
+		if (!this.#acceptedInteractionKinds.includes(kind) || outcome === "failed") return;
+		const command = this.commands.get(this.#getCommandName(routeId));
+		if (command) command.count++;
+	}
+};
+//#endregion
+//#region src/helpers.ts
+const osUtils = new OSUtils();
+const getCpuUsage = () => osUtils.cpu.usage();
+const getRamUsage = () => (getTotalMemory() - os.freemem()) / getTotalMemory() * 100;
+const getTotalMemory = () => os.totalmem();
+//#endregion
+//#region src/index.ts
+var StatcordPlugin = class extends Plugin {
+	options;
+	#autopostingInterval = null;
+	#eventHandler;
+	charts = /* @__PURE__ */ new Map();
+	commands = /* @__PURE__ */ new Map();
+	constructor(host, options) {
+		super(host);
+		this.options = options;
+		this.#eventHandler = new PluginEventHandler(this.commands, this.options);
+		if (!this.options?.apiKey && !process.env["STATCORD_API_KEY"]) this.rejectOptions("apiKey is required.");
+		if (this.options?.httpTimeout !== void 0 && (!Number.isFinite(this.options.httpTimeout) || this.options.httpTimeout <= 0)) this.rejectOptions("httpTimeout must be greater than 0.");
+	}
+	dispose() {
+		this.stopAutoposting();
+		this.core.bus.off("commandsDeployed", this.#eventHandler.onCommandsDeployed);
+		this.core.bus.off("interactionDispatched", this.#eventHandler.onInteractionDispatched);
+		return Promise.resolve();
+	}
+	init() {
+		this.logger.info("Statcord plugin initialized.");
+		this.core.bus.on("commandsDeployed", this.#eventHandler.onCommandsDeployed);
+		this.core.bus.on("interactionDispatched", this.#eventHandler.onInteractionDispatched);
+		return Promise.resolve();
+	}
+	ready() {
+		this.client = new Statcord(this.core.applicationId, this.options?.apiKey, this.options?.httpTimeout);
+		const autopost = this.options?.autopost;
+		if ((autopost === true || typeof autopost === "object" && autopost !== null && autopost.enabled) && !this.#autopostingInterval) this.#autopostingInterval = setInterval(() => void this.postStats().catch((err) => this.logger.error("Failed to autopost stats:", err)), typeof this.options?.autopost === "object" ? this.options.autopost.interval ?? 6e4 : 6e4);
+		return Promise.resolve();
+	}
+	stopAutoposting() {
+		if (this.#autopostingInterval) {
+			clearInterval(this.#autopostingInterval);
+			this.#autopostingInterval = null;
+		}
+	}
+	async postStats() {
+		const guilds = this.core.bot.client.guilds.cache;
+		const guildCount = guilds.size;
+		const shardCount = this.core.bot.client.ws.shards.size;
+		const userCount = this.core.bot.client.users.cache.size;
+		const memberCount = guilds.reduce((acc, guild) => acc + guild.memberCount, 0);
+		const builder = this.statcordClient.createPayloadBuilder().setGuildCount(guildCount).setShardCount(shardCount).setUserCount(userCount).setMemberCount(memberCount).setCustomCharts(Array.from(this.charts.values())).setTopCommands(Array.from(this.commands.values()));
+		if (typeof this.options?.autopost !== "object") {
+			const cpuUsage = await getCpuUsage();
+			const ramUsage = getRamUsage();
+			builder.setTotalRam(getTotalMemory()).setRamUsage(ramUsage);
+			if (cpuUsage.success) builder.setCpuUsage(cpuUsage.data);
+			else this.logger.warn("Failed to retrieve CPU usage, skipping it.");
+			await this.statcordClient.postStats(builder.build());
+			return;
+		}
+		const autopostingOptions = typeof this.options?.autopost === "object" ? this.options.autopost : {};
+		if (autopostingOptions.includeRam) builder.setTotalRam(getTotalMemory()).setRamUsage(getRamUsage());
+		if (autopostingOptions.includeCpu) {
+			const cpuUsage = await getCpuUsage();
+			if (!cpuUsage.success) {
+				this.logger.warn("Failed to retrieve CPU usage, doing a push without it.");
+				await this.statcordClient.postStats(builder.build());
+				return;
+			}
+			builder.setCpuUsage(cpuUsage.data);
+		}
+		await this.statcordClient.postStats(builder.build());
+	}
+	addCustomChart(name, data) {
+		if (this.charts.has(name)) return;
+		this.charts.set(name, {
+			id: name,
+			data
+		});
+	}
+	get statcordClient() {
+		if (!this.client) throw new Error("Statcord client has not been initialized fully yet, wait until after login before accessing the client.");
+		return this.client;
+	}
+};
+//#endregion
+export { StatcordPlugin };

package/package.json

@@ -1,14 +1,48 @@
 {
   "name": "@statcord-ts/seedcord-plugin",
-  "version": "0.0.0",
-  "description": "Placeholder for @statcord-ts/seedcord-plugin",
-  "main": "index.js",
-  "scripts": {},
-  "keywords": [],
-  "author": "lunaradev (https://www.npmjs.com/~lunaradev)",
-  "license": "UNLICENSED",
+  "version": "0.0.1-dev",
   "private": false,
+  "description": "The Seedcord plugin for Statcord.",
+  "homepage": "https://github.com/Vorasion-Development/statcord.ts#readme",
+  "bugs": {
+    "url": "https://github.com/Vorasion-Development/statcord.ts/issues"
+  },
+  "license": "MIT",
+  "author": "Vorasion Development",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vorasion-Development/statcord.ts.git"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
   "publishConfig": {
     "access": "public"
-  }
-}
+  },
+  "dependencies": {
+    "@sapphire/timestamp": "^1.0.5",
+    "@statcord-ts/core": "^0.0.1-dev",
+    "@statcord-ts/plugin-options": "^0.0.1-dev",
+    "node-os-utils": "^3.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "bumpp": "^11.1.0",
+    "tsdown": "^0.23",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.4"
+  },
+  "peerDependencies": {
+    "@seedcord/gateway": "^0.7.5",
+    "discord.js": "14"
+  },
+  "readme": "README.md"
+}

package/index.js

@@ -1 +0,0 @@
-// Placeholder