magmastream 2.10.2-alpha.2 → 2.10.2-alpha.4

package/dist/index.d.ts

@@ -7,8 +7,9 @@ export * from "./statestorage/MemoryQueue";
 export * from "./structures/Rest";
 export * from "./structures/Utils";
 export * from "./structures/MagmastreamError";
-export * from "./wrappers/discordeno";
+export * from "./wrappers/cloudstorm";
 export * from "./wrappers/discord.js";
+export * from "./wrappers/discordeno";
 export * from "./wrappers/eris";
 export * from "./wrappers/oceanic";
 export * from "./wrappers/seyfert";

package/dist/index.js

@@ -11,8 +11,9 @@ tslib_1.__exportStar(require("./structures/Rest"), exports);
 tslib_1.__exportStar(require("./structures/Utils"), exports);
 tslib_1.__exportStar(require("./structures/MagmastreamError"), exports);
 // wrappers
-tslib_1.__exportStar(require("./wrappers/discordeno"), exports);
+tslib_1.__exportStar(require("./wrappers/cloudstorm"), exports);
 tslib_1.__exportStar(require("./wrappers/discord.js"), exports);
+tslib_1.__exportStar(require("./wrappers/discordeno"), exports);
 tslib_1.__exportStar(require("./wrappers/eris"), exports);
 tslib_1.__exportStar(require("./wrappers/oceanic"), exports);
 tslib_1.__exportStar(require("./wrappers/seyfert"), exports);

package/dist/wrappers/cloudstorm.d.ts

@@ -0,0 +1,27 @@
+import { GatewayVoiceStateUpdate } from "discord-api-types/v10";
+import { Manager as BaseManager } from "../structures/Manager";
+import { Client } from "cloudstorm";
+import { AnyGuild, AnyUser, ManagerOptions, PortableUser } from "../structures/Types";
+/**
+ * Cloudstorm wrapper for Magmastream.
+ *
+ * @note Unlike other wrappers, CloudStorm is a gateway-only library with no cache.
+ * You must manually call `manager.init({ clientId: "your-bot-id" })` inside your `ready` event.
+ *
+ * @example
+ * ```typescript
+ * const client = new Client("token", { intents: ["GUILDS", "GUILD_VOICE_STATES"] });
+ * const manager = new CloudstormManager(client, options);
+ *
+ * client.once("ready", async () => {
+ *     await manager.init({ clientId: "your-bot-id" });
+ * });
+ * ```
+ */
+export declare class CloudstormManager extends BaseManager {
+    readonly client: Client;
+    constructor(client: Client, options?: ManagerOptions);
+    protected send(packet: GatewayVoiceStateUpdate): void;
+    resolveUser(user: AnyUser | string): Promise<PortableUser>;
+    resolveGuild(guildId: string): AnyGuild;
+}

package/dist/wrappers/cloudstorm.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudstormManager = void 0;
+const Manager_1 = require("../structures/Manager");
+const cloudstorm_1 = require("cloudstorm");
+const Enums_1 = require("../structures/Enums");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
+/**
+ * Cloudstorm wrapper for Magmastream.
+ *
+ * @note Unlike other wrappers, CloudStorm is a gateway-only library with no cache.
+ * You must manually call `manager.init({ clientId: "your-bot-id" })` inside your `ready` event.
+ *
+ * @example
+ * ```typescript
+ * const client = new Client("token", { intents: ["GUILDS", "GUILD_VOICE_STATES"] });
+ * const manager = new CloudstormManager(client, options);
+ *
+ * client.once("ready", async () => {
+ *     await manager.init({ clientId: "your-bot-id" });
+ * });
+ * ```
+ */
+class CloudstormManager extends Manager_1.Manager {
+    client;
+    constructor(client, options) {
+        super(options);
+        this.client = client;
+        // Ensure GUILD_VOICE_STATES intent is enabled
+        const resolvedIntents = cloudstorm_1.Intents.resolve(client.options.intents ?? 0);
+        if (!(resolvedIntents & cloudstorm_1.Intents.flags.GUILD_VOICE_STATES)) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.INTENT_MISSING,
+                message: "[CloudstormManager] Your Cloudstorm client must have the GUILD_VOICE_STATES intent enabled.",
+            });
+        }
+        // Chain incoming gateway events into updateVoiceState
+        client.on("event", async (data) => {
+            if (data.t === "VOICE_STATE_UPDATE" || data.t === "VOICE_SERVER_UPDATE") {
+                await this.updateVoiceState(data);
+            }
+        });
+    }
+    send(packet) {
+        const totalShards = this.client.options.totalShards;
+        if (!totalShards)
+            return;
+        const shardId = Number((BigInt(packet.d.guild_id) >> BigInt(22)) % BigInt(totalShards));
+        const shard = this.client.shardManager.shards[shardId];
+        if (shard)
+            shard.connector.sendMessage(packet);
+    }
+    // CloudStorm has no user/guild cache — return minimal portable info only.
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : String(user.id);
+        const cached = this.getUserFromCache(id);
+        if (cached)
+            return cached;
+        return {
+            id,
+            username: typeof user === "string" ? undefined : user.username,
+        };
+    }
+    resolveGuild(guildId) {
+        // Try user-provided cache getter
+        return this.getGuildFromCache(guildId);
+    }
+}
+exports.CloudstormManager = CloudstormManager;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "magmastream",
-    "version": "2.10.2-alpha.2",
+    "version": "2.10.2-alpha.4",
     "description": "A user-friendly Lavalink client designed for NodeJS.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -46,10 +46,11 @@
         "ws": "^8.19.0"
     },
     "optionalDependencies": {
+        "cloudstorm": "0.17.x",
         "discord.js": "14.x",
         "discordeno": "21.x",
         "eris": "0.18.x",
-        "oceanic.js": "1.13.x",
+        "oceanic.js": "1.14.x",
         "seyfert": "4.x"
     },
     "overrides": {