@ramkrishna-js/framelink 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ramkrishna
+
+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,155 @@
+<div align="center">
+
+<img src="https://capsule-render.vercel.app/render?type=waving&color=auto&height=250&section=header&text=FrameLink&fontSize=90&animation=fadeIn&fontAlignY=38" />
+
+**🚀 A lightweight, robust, and plugin-ready Lavalink client (v3 & v4) for Node.js.**
+
+[![npm version](https://img.shields.io/npm/v/framelink.svg?style=flat-square)](https://www.npmjs.com/package/framelink)
+[![npm downloads](https://img.shields.io/npm/dm/framelink.svg?style=flat-square)](https://www.npmjs.com/package/framelink)
+[![license](https://img.shields.io/github/license/ramkrishna-js/framelink.svg?style=flat-square)](https://github.com/ramkrishna-js/framelink/blob/master/LICENSE)
+[![stars](https://img.shields.io/github/stars/ramkrishna-js/framelink.svg?style=flat-square)](https://github.com/ramkrishna-js/framelink/stargazers)
+
+---
+
+[📄 Documentation](https://github.com/ramkrishna-js/framelink#readme) | [💬 Discord Support](https://discord.gg/your-invite-link) | [📦 NPM](https://www.npmjs.com/package/framelink)
+
+</div>
+
+<hr />
+
+## ✨ Features
+- 🎵 **Universal Support:** Seamlessly works with Lavalink v3 and v4.
+- 🎼 **Multi-Platform:** Built-in support for YouTube, Spotify, Apple Music, Deezer, and more.
+- 🚀 **Performance:** Optimized for speed with minimal memory footprint.
+- 🔄 **Smart Queue:** Advanced queue system with automated autoplay logic.
+- 🧩 **Extensible:** Robust plugin system to customize your experience.
+- 🛡️ **Type-Safe:** Written entirely in TypeScript for a superior DX.
+
+<hr />
+
+## 📦 Installation
+
+```bash
+npm install framelink
+```
+
+<hr />
+
+## ╰┈1️⃣ Quick Start
+
+### Initializing the Manager
+
+```typescript
+import { LavalinkManager } from 'framelink';
+
+const manager = new LavalinkManager({
+    nodes: [
+        {
+            host: 'localhost',
+            port: 2333,
+            password: 'youshallnotpass',
+            version: 'v4' // or 'v3'
+        }
+    ],
+    send: (guildId, payload) => {
+        // Your library's send logic (Discord.js, Eris, etc.)
+    }
+});
+
+manager.init('YOUR_BOT_ID');
+```
+
+### Creating a Player & Playing
+
+```typescript
+const player = manager.createPlayer({
+    guildId: 'GUILD_ID',
+    voiceChannelId: 'VOICE_CHANNEL_ID',
+    textChannelId: 'TEXT_CHANNEL_ID',
+    autoplay: true
+});
+
+// Search for a track
+const res = await manager.search('Never Gonna Give You Up', 'yt');
+
+// Add to queue and play
+player.queue.add(res.tracks[0]);
+player.play();
+```
+
+<hr />
+
+## ╰┈2️⃣ Event Handling
+
+```typescript
+manager.on('nodeConnect', (node) => {
+    console.log(`Node ${node.options.host} connected!`);
+});
+
+manager.on('trackStart', (player, track) => {
+    console.log(`Now playing: ${track.info.title}`);
+});
+
+manager.on('queueEnd', (player) => {
+    console.log(`Queue ended for guild ${player.guildId}`);
+});
+```
+
+<hr />
+
+## ╰┈3️⃣ Supported Platforms
+
+FrameLink supports any platform compatible with Lavalink and its plugins (like LavaSrc):
+- YouTube / YouTube Music
+- Spotify
+- Apple Music
+- Deezer
+- SoundCloud
+- Twitch
+- HTTP Links
+
+<hr />
+
+## 🧩 Plugins
+
+FrameLink is built with extensibility in mind. You can easily create and load plugins to extend the manager's functionality.
+
+```typescript
+import { Plugin } from 'framelink';
+
+class MyCustomPlugin extends Plugin {
+    name = 'MyPlugin';
+    load(manager) {
+        super.load(manager);
+        console.log('Plugin loaded!');
+    }
+    unload() {}
+}
+
+const manager = new LavalinkManager({
+    // ... other options
+    plugins: [new MyCustomPlugin()]
+});
+```
+
+<hr />
+
+## 🤝 Contributing
+
+Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
+
+Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
+
+<hr />
+
+## 📜 License
+
+Distributed under the MIT License. See [LICENSE](LICENSE) for more information.
+
+<hr />
+
+<div align="center">
+
+Built with ❤️ by [Ramkrishna](https://github.com/ramkrishna-js)
+
+</div>

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './structures/LavalinkManager';
+export * from './structures/LavalinkNode';
+export * from './structures/Player';
+export * from './structures/Queue';
+export * from './structures/Plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./structures/LavalinkManager"), exports);
+__exportStar(require("./structures/LavalinkNode"), exports);
+__exportStar(require("./structures/Player"), exports);
+__exportStar(require("./structures/Queue"), exports);
+__exportStar(require("./structures/Plugin"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,4DAA0C;AAC1C,sDAAoC;AACpC,qDAAmC;AACnC,sDAAoC"}

package/dist/structures/LavalinkManager.d.ts

@@ -0,0 +1,32 @@
+import { EventEmitter } from 'events';
+import { LavalinkNode, NodeOptions } from './LavalinkNode';
+import { Player, PlayerOptions } from './Player';
+import { Plugin } from './Plugin';
+export interface LavalinkManagerOptions {
+    nodes: NodeOptions[];
+    send: (guildId: string, payload: any) => void;
+    autoResume?: boolean;
+    plugins?: Plugin[];
+}
+export declare class LavalinkManager extends EventEmitter {
+    nodes: Map<string, LavalinkNode>;
+    players: Map<string, Player>;
+    options: LavalinkManagerOptions;
+    userId: string | null;
+    plugins: Plugin[];
+    constructor(options: LavalinkManagerOptions);
+    init(userId: string): void;
+    createNode(options: NodeOptions): LavalinkNode;
+    createPlayer(options: PlayerOptions): Player;
+    destroyPlayer(guildId: string): boolean;
+    getBestNode(): LavalinkNode | undefined;
+    /**
+     * Search for tracks using a specific source or default.
+     * @param query The search query.
+     * @param source The source prefix (e.g., 'yt', 'sc', 'sp'). Defaults to 'yt'.
+     * @returns The load result.
+     */
+    search(query: string, source?: 'yt' | 'ytm' | 'sc' | 'sp' | 'am' | 'dz' | string): Promise<any>;
+    handleVoiceUpdate(update: any): Promise<void>;
+}
+//# sourceMappingURL=LavalinkManager.d.ts.map

package/dist/structures/LavalinkManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LavalinkManager.d.ts","sourceRoot":"","sources":["../../src/structures/LavalinkManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,eAAgB,SAAQ,YAAY;IACtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAM;gBAElB,OAAO,EAAE,sBAAsB;IAWpC,IAAI,CAAC,MAAM,EAAE,MAAM;IAOnB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY;IAO9C,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAS5C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASvC,WAAW,IAAI,YAAY,GAAG,SAAS;IAS9C;;;;;OAKG;IACU,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAa;IAYtF,iBAAiB,CAAC,MAAM,EAAE,GAAG;CAgC7C"}

package/dist/structures/LavalinkManager.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LavalinkManager = void 0;
+const events_1 = require("events");
+const LavalinkNode_1 = require("./LavalinkNode");
+const Player_1 = require("./Player");
+class LavalinkManager extends events_1.EventEmitter {
+    constructor(options) {
+        super();
+        this.userId = null;
+        this.plugins = [];
+        this.options = options;
+        this.nodes = new Map();
+        this.players = new Map();
+        if (options.plugins) {
+            this.plugins = options.plugins;
+            this.plugins.forEach(p => p.load(this));
+        }
+    }
+    init(userId) {
+        this.userId = userId;
+        this.options.nodes.forEach(nodeOptions => {
+            this.createNode(nodeOptions);
+        });
+    }
+    createNode(options) {
+        const node = new LavalinkNode_1.LavalinkNode(this, options);
+        this.nodes.set(options.id || options.host, node);
+        node.connect();
+        return node;
+    }
+    createPlayer(options) {
+        const node = this.getBestNode();
+        if (!node)
+            throw new Error("No available nodes.");
+        const player = new Player_1.Player(this, node, options);
+        this.players.set(options.guildId, player);
+        return player;
+    }
+    destroyPlayer(guildId) {
+        const player = this.players.get(guildId);
+        if (!player)
+            return false;
+        player.destroy();
+        this.players.delete(guildId);
+        return true;
+    }
+    getBestNode() {
+        // Simple strategy: return first connected node
+        // In future: load balancing
+        for (const node of this.nodes.values()) {
+            if (node.connected)
+                return node;
+        }
+        return undefined;
+    }
+    /**
+     * Search for tracks using a specific source or default.
+     * @param query The search query.
+     * @param source The source prefix (e.g., 'yt', 'sc', 'sp'). Defaults to 'yt'.
+     * @returns The load result.
+     */
+    async search(query, source = 'yt') {
+        const node = this.getBestNode();
+        if (!node)
+            throw new Error("No available nodes.");
+        const identifier = /^(https?:\/\/)/.test(query)
+            ? query
+            : `${source}search:${query}`;
+        return node.loadTracks(identifier);
+    }
+    // Handle voice state updates from Discord
+    async handleVoiceUpdate(update) {
+        if (!['VOICE_STATE_UPDATE', 'VOICE_SERVER_UPDATE'].includes(update.t))
+            return;
+        const data = update.d;
+        const guildId = data.guild_id;
+        if (!guildId)
+            return;
+        const player = this.players.get(guildId);
+        if (!player)
+            return;
+        if (update.t === 'VOICE_SERVER_UPDATE') {
+            player.voiceUpdateState.event = data;
+        }
+        else {
+            if (data.user_id !== this.userId)
+                return;
+            player.voiceUpdateState.sessionId = data.session_id;
+            if (data.channel_id) {
+                player.voiceChannelId = data.channel_id;
+            }
+        }
+        if (player.voiceUpdateState.sessionId && player.voiceUpdateState.event) {
+            player.node.send({
+                op: 'voiceUpdate',
+                guildId: guildId,
+                sessionId: player.voiceUpdateState.sessionId,
+                event: player.voiceUpdateState.event
+            });
+            // Clear after sending? Usually Lavalink handles it. 
+            // Some libs keep it for reconnection. Let's keep it.
+        }
+    }
+}
+exports.LavalinkManager = LavalinkManager;
+//# sourceMappingURL=LavalinkManager.js.map

package/dist/structures/LavalinkManager.js.map

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

package/dist/structures/LavalinkNode.d.ts

@@ -0,0 +1,29 @@
+import WebSocket from 'ws';
+import { LavalinkManager } from './LavalinkManager';
+export interface NodeOptions {
+    id?: string;
+    host: string;
+    port?: number;
+    password?: string;
+    secure?: boolean;
+    retryAmount?: number;
+    retryDelay?: number;
+    version?: 'v3' | 'v4';
+}
+export declare class LavalinkNode {
+    manager: LavalinkManager;
+    options: NodeOptions;
+    socket: WebSocket | null;
+    stats: any;
+    connected: boolean;
+    constructor(manager: LavalinkManager, options: NodeOptions);
+    connect(): void;
+    send(payload: any): void;
+    loadTracks(identifier: string): Promise<any>;
+    private onOpen;
+    private onMessage;
+    private handleEvent;
+    private onError;
+    private onClose;
+}
+//# sourceMappingURL=LavalinkNode.d.ts.map

package/dist/structures/LavalinkNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LavalinkNode.d.ts","sourceRoot":"","sources":["../../src/structures/LavalinkNode.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,WAAW;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,qBAAa,YAAY;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAChC,KAAK,EAAE,GAAG,CAAM;IAChB,SAAS,EAAE,OAAO,CAAS;gBAEtB,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW;IAQnD,OAAO;IA0BP,IAAI,CAAC,OAAO,EAAE,GAAG;IAKX,UAAU,CAAC,UAAU,EAAE,MAAM;IAoB1C,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;CAKlB"}

package/dist/structures/LavalinkNode.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LavalinkNode = void 0;
+const ws_1 = __importDefault(require("ws"));
+class LavalinkNode {
+    constructor(manager, options) {
+        this.socket = null;
+        this.stats = {};
+        this.connected = false;
+        this.manager = manager;
+        this.options = {
+            version: 'v4',
+            ...options
+        };
+    }
+    connect() {
+        if (this.socket)
+            return;
+        const headers = {
+            Authorization: this.options.password || 'youshallnotpass',
+            'User-Id': this.manager.userId || '0',
+            'Client-Name': 'framelink/1.0.0'
+        };
+        const protocol = this.options.secure ? 'wss' : 'ws';
+        let endpoint = '';
+        if (this.options.version === 'v4') {
+            endpoint = '/v4/websocket';
+        }
+        const url = `${protocol}://${this.options.host}:${this.options.port || 2333}${endpoint}`;
+        this.socket = new ws_1.default(url, { headers });
+        this.socket.on('open', this.onOpen.bind(this));
+        this.socket.on('message', this.onMessage.bind(this));
+        this.socket.on('error', this.onError.bind(this));
+        this.socket.on('close', this.onClose.bind(this));
+    }
+    send(payload) {
+        if (!this.connected || !this.socket)
+            return;
+        this.socket.send(JSON.stringify(payload));
+    }
+    async loadTracks(identifier) {
+        const protocol = this.options.secure ? 'https' : 'http';
+        let endpoint = '/loadtracks';
+        if (this.options.version === 'v4') {
+            endpoint = '/v4/loadtracks';
+        }
+        const url = new URL(`${protocol}://${this.options.host}:${this.options.port || 2333}${endpoint}`);
+        url.searchParams.append('identifier', identifier);
+        const response = await fetch(url.toString(), {
+            headers: {
+                Authorization: this.options.password || 'youshallnotpass'
+            }
+        });
+        return await response.json();
+    }
+    onOpen() {
+        this.connected = true;
+        this.manager.emit('nodeConnect', this);
+    }
+    onMessage(data) {
+        const payload = JSON.parse(data.toString());
+        switch (payload.op) {
+            case 'stats':
+                this.stats = payload;
+                this.manager.emit('nodeStats', this, payload);
+                break;
+            case 'playerUpdate':
+                const player = this.manager.players.get(payload.guildId);
+                if (player)
+                    player.update(payload.state);
+                break;
+            case 'event':
+                this.handleEvent(payload);
+                break;
+            default:
+                this.manager.emit('nodeMessage', this, payload);
+        }
+    }
+    handleEvent(payload) {
+        const player = this.manager.players.get(payload.guildId);
+        if (!player)
+            return;
+        switch (payload.type) {
+            case 'TrackStartEvent':
+                this.manager.emit('trackStart', player, payload.track);
+                break;
+            case 'TrackEndEvent':
+                this.manager.emit('trackEnd', player, payload.track, payload.reason);
+                if (payload.reason === 'FINISHED' || payload.reason === 'LOAD_FAILED') {
+                    // Auto-play next track in queue or trigger autoplay
+                    if (player.queue.tracks.length > 0) {
+                        player.play();
+                    }
+                    else if (player.autoplay) {
+                        player.triggerAutoplay();
+                    }
+                    else {
+                        player.isPlaying = false;
+                        this.manager.emit('queueEnd', player);
+                    }
+                }
+                break;
+            case 'TrackExceptionEvent':
+                this.manager.emit('trackError', player, payload.track, payload.exception);
+                break;
+            case 'TrackStuckEvent':
+                this.manager.emit('trackStuck', player, payload.track, payload.thresholdMs);
+                break;
+            case 'WebSocketClosedEvent':
+                this.manager.emit('socketClosed', player, payload);
+                break;
+        }
+    }
+    onError(error) {
+        this.manager.emit('nodeError', this, error);
+    }
+    onClose(code, reason) {
+        this.connected = false;
+        this.socket = null;
+        this.manager.emit('nodeDisconnect', this, code, reason);
+    }
+}
+exports.LavalinkNode = LavalinkNode;
+//# sourceMappingURL=LavalinkNode.js.map

package/dist/structures/LavalinkNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LavalinkNode.js","sourceRoot":"","sources":["../../src/structures/LavalinkNode.ts"],"names":[],"mappings":";;;;;;AAAA,4CAA2B;AAc3B,MAAa,YAAY;IAOrB,YAAY,OAAwB,EAAE,OAAoB;QAJnD,WAAM,GAAqB,IAAI,CAAC;QAChC,UAAK,GAAQ,EAAE,CAAC;QAChB,cAAS,GAAY,KAAK,CAAC;QAG9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG;YACX,OAAO,EAAE,IAAI;YACb,GAAG,OAAO;SACb,CAAC;IACN,CAAC;IAEM,OAAO;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,OAAO,GAA2B;YACpC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,iBAAiB;YACzD,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG;YACrC,aAAa,EAAE,iBAAiB;SACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAChC,QAAQ,GAAG,eAAe,CAAC;QAC/B,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;QAEzF,IAAI,CAAC,MAAM,GAAG,IAAI,YAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAEM,IAAI,CAAC,OAAY;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,IAAI,QAAQ,GAAG,aAAa,CAAC;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAChC,QAAQ,GAAG,gBAAgB,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,QAAQ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC;QAClG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YACzC,OAAO,EAAE;gBACL,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,iBAAiB;aAC5D;SACJ,CAAC,CAAC;QAEH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAEO,MAAM;QACV,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAEO,SAAS,CAAC,IAAoB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE5C,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;YACjB,KAAK,OAAO;gBACR,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM;YAEV,KAAK,cAAc;gBACf,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACzD,IAAI,MAAM;oBAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzC,MAAM;YAEV,KAAK,OAAO;gBACR,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAC1B,MAAM;YAEV;gBACI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,OAAY;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,iBAAiB;gBAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACvD,MAAM;YACV,KAAK,eAAe;gBAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrE,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;oBACnE,oDAAoD;oBACpD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACjC,MAAM,CAAC,IAAI,EAAE,CAAC;oBAClB,CAAC;yBAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;wBACzB,MAAM,CAAC,eAAe,EAAE,CAAC;oBAC7B,CAAC;yBAAM,CAAC;wBACL,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;wBACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;oBACzC,CAAC;gBACN,CAAC;gBACD,MAAM;YACV,KAAK,qBAAqB;gBACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC1E,MAAM;YACV,KAAK,iBAAiB;gBAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC5E,MAAM;YACV,KAAK,sBAAsB;gBACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM;QACd,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,KAAY;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAEO,OAAO,CAAC,IAAY,EAAE,MAAc;QACxC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;CACJ;AAzID,oCAyIC"}

package/dist/structures/Player.d.ts

@@ -0,0 +1,36 @@
+import { LavalinkNode } from './LavalinkNode';
+import { LavalinkManager } from './LavalinkManager';
+import { Queue } from './Queue';
+export interface PlayerOptions {
+    guildId: string;
+    textChannelId?: string;
+    voiceChannelId?: string;
+    selfDeaf?: boolean;
+    selfMute?: boolean;
+    autoplay?: boolean;
+}
+export declare class Player {
+    manager: LavalinkManager;
+    node: LavalinkNode;
+    guildId: string;
+    voiceChannelId: string | null;
+    textChannelId: string | null;
+    position: number;
+    paused: boolean;
+    isPlaying: boolean;
+    timestamp: number;
+    voiceUpdateState: {
+        sessionId?: string;
+        event?: any;
+    };
+    queue: Queue;
+    autoplay: boolean;
+    constructor(manager: LavalinkManager, node: LavalinkNode, options: PlayerOptions);
+    play(track?: string | any, options?: any): Promise<void>;
+    triggerAutoplay(): Promise<void>;
+    stop(): void;
+    setVolume(volume: number): void;
+    update(state: any): void;
+    destroy(): void;
+}
+//# sourceMappingURL=Player.d.ts.map

package/dist/structures/Player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../../src/structures/Player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,MAAM;IACR,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpC,QAAQ,EAAE,MAAM,CAAK;IACrB,MAAM,EAAE,OAAO,CAAS;IACxB,SAAS,EAAE,OAAO,CAAS;IAC3B,SAAS,EAAE,MAAM,CAAK;IACtB,gBAAgB,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,CAAM;IAC3D,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,OAAO,CAAS;gBAErB,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa;IAUnE,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,GAAQ;IA4B5C,eAAe;IAgCrB,IAAI;IAQJ,SAAS,CAAC,MAAM,EAAE,MAAM;IAQxB,MAAM,CAAC,KAAK,EAAE,GAAG;IAKjB,OAAO;CAQjB"}

package/dist/structures/Player.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Player = void 0;
+const Queue_1 = require("./Queue");
+class Player {
+    constructor(manager, node, options) {
+        this.voiceChannelId = null;
+        this.textChannelId = null;
+        this.position = 0;
+        this.paused = false;
+        this.isPlaying = false;
+        this.timestamp = 0;
+        this.voiceUpdateState = {};
+        this.autoplay = false;
+        this.manager = manager;
+        this.node = node;
+        this.guildId = options.guildId;
+        this.voiceChannelId = options.voiceChannelId || null;
+        this.textChannelId = options.textChannelId || null;
+        this.autoplay = options.autoplay || false;
+        this.queue = new Queue_1.Queue(this);
+    }
+    async play(track, options = {}) {
+        if (!track && !this.queue.current && this.queue.tracks.length > 0) {
+            const next = this.queue.next();
+            if (next) {
+                track = next.track; // Assuming object has .track
+            }
+        }
+        if (!track) {
+            if (this.autoplay) {
+                return this.triggerAutoplay();
+            }
+            return;
+        }
+        this.isPlaying = true;
+        // Handle if track is an object (Lavalink track object) or string
+        const trackString = typeof track === 'string' ? track : track.track;
+        this.node.send({
+            op: 'play',
+            guildId: this.guildId,
+            track: trackString,
+            ...options
+        });
+    }
+    async triggerAutoplay() {
+        const previousTrack = this.queue.previous[this.queue.previous.length - 1];
+        if (!previousTrack)
+            return; // Cannot autoplay without seed
+        // Use previous track URI or ID for recommendation
+        // Simple implementation: Search for related tracks or a mix
+        // Ideally, this uses a specific source feature like "spotify:seed_tracks" or similar via a plugin
+        // For general usage:
+        const source = previousTrack.info?.sourceName;
+        let identifier = '';
+        if (source === 'spotify' || source === 'applemusic' || source === 'deezer') {
+            // If using Lavasrc, we might get recommendations. 
+            // Common pattern: `sprec:${trackId}` or similar if plugin supports it.
+            // Fallback to "related" search on YouTube if all else fails?
+            identifier = `ytsearch:${previousTrack.info.author} - ${previousTrack.info.title}`;
+        }
+        else {
+            identifier = `ytmsearch:${previousTrack.info.author} - ${previousTrack.info.title}`;
+        }
+        const res = await this.node.loadTracks(identifier);
+        if (res && res.tracks && res.tracks.length > 0) {
+            // Filter out current track?
+            const nextTrack = res.tracks[0].track === previousTrack.track ? res.tracks[1] : res.tracks[0];
+            if (nextTrack) {
+                this.queue.add(nextTrack);
+                this.play();
+            }
+        }
+    }
+    stop() {
+        this.isPlaying = false;
+        this.node.send({
+            op: 'stop',
+            guildId: this.guildId
+        });
+    }
+    setVolume(volume) {
+        this.node.send({
+            op: 'volume',
+            guildId: this.guildId,
+            volume: volume
+        });
+    }
+    update(state) {
+        this.position = state.position;
+        this.timestamp = state.time;
+    }
+    destroy() {
+        this.stop();
+        this.node.send({
+            op: 'destroy',
+            guildId: this.guildId
+        });
+        this.manager.emit('playerDestroy', this);
+    }
+}
+exports.Player = Player;
+//# sourceMappingURL=Player.js.map

package/dist/structures/Player.js.map

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

package/dist/structures/Plugin.d.ts

@@ -0,0 +1,8 @@
+import { LavalinkManager } from './LavalinkManager';
+export declare abstract class Plugin {
+    manager: LavalinkManager | null;
+    abstract name: string;
+    load(manager: LavalinkManager): void;
+    abstract unload(): void;
+}
+//# sourceMappingURL=Plugin.d.ts.map

package/dist/structures/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/structures/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,8BAAsB,MAAM;IACjB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC9C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,OAAO,EAAE,eAAe;aAIpB,MAAM,IAAI,IAAI;CACjC"}

package/dist/structures/Plugin.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Plugin = void 0;
+class Plugin {
+    constructor() {
+        this.manager = null;
+    }
+    load(manager) {
+        this.manager = manager;
+    }
+}
+exports.Plugin = Plugin;
+//# sourceMappingURL=Plugin.js.map

package/dist/structures/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/structures/Plugin.ts"],"names":[],"mappings":";;;AAEA,MAAsB,MAAM;IAA5B;QACW,YAAO,GAA2B,IAAI,CAAC;IAQlD,CAAC;IALU,IAAI,CAAC,OAAwB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CAGJ;AATD,wBASC"}

package/dist/structures/Queue.d.ts

@@ -0,0 +1,13 @@
+import { Player } from './Player';
+export declare class Queue {
+    readonly player: Player;
+    tracks: any[];
+    previous: any[];
+    current: any | null;
+    constructor(player: Player);
+    add(track: any | any[]): void;
+    next(): any | null;
+    clear(): void;
+    shuffle(): void;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/dist/structures/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../src/structures/Queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,KAAK;IACd,SAAgB,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,GAAG,EAAE,CAAM;IACnB,QAAQ,EAAE,GAAG,EAAE,CAAM;IACrB,OAAO,EAAE,GAAG,GAAG,IAAI,CAAQ;gBAEtB,MAAM,EAAE,MAAM;IAInB,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE;IAQtB,IAAI,IAAI,GAAG,GAAG,IAAI;IAUlB,KAAK;IAML,OAAO;CAMjB"}

package/dist/structures/Queue.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+class Queue {
+    constructor(player) {
+        this.tracks = [];
+        this.previous = [];
+        this.current = null;
+        this.player = player;
+    }
+    add(track) {
+        if (Array.isArray(track)) {
+            this.tracks.push(...track);
+        }
+        else {
+            this.tracks.push(track);
+        }
+    }
+    next() {
+        if (this.current) {
+            this.previous.push(this.current);
+        }
+        const nextTrack = this.tracks.shift();
+        this.current = nextTrack || null;
+        return this.current;
+    }
+    clear() {
+        this.tracks = [];
+        this.previous = [];
+        this.current = null;
+    }
+    shuffle() {
+        for (let i = this.tracks.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [this.tracks[i], this.tracks[j]] = [this.tracks[j], this.tracks[i]];
+        }
+    }
+}
+exports.Queue = Queue;
+//# sourceMappingURL=Queue.js.map

package/dist/structures/Queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../src/structures/Queue.ts"],"names":[],"mappings":";;;AAEA,MAAa,KAAK;IAMd,YAAY,MAAc;QAJnB,WAAM,GAAU,EAAE,CAAC;QACnB,aAAQ,GAAU,EAAE,CAAC;QACrB,YAAO,GAAe,IAAI,CAAC;QAG9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAEM,GAAG,CAAC,KAAkB;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAEM,IAAI;QACP,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAEM,OAAO;QACV,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;CACJ;AAxCD,sBAwCC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ramkrishna-js/framelink",
+  "version": "1.0.0",
+  "description": "🚀 A lightweight, robust, and plugin-ready Lavalink client (v3 & v4) for Node.js.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "lavalink",
+    "lavalink-client",
+    "discord",
+    "discord-bot",
+    "music-bot",
+    "music",
+    "framelink",
+    "lavasrc"
+  ],
+  "author": "Ramkrishna",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramkrishna-js/framelink.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ramkrishna-js/framelink/issues"
+  },
+  "homepage": "https://github.com/ramkrishna-js/framelink#readme",
+  "type": "commonjs",
+  "devDependencies": {
+    "@types/node": "^25.0.5",
+    "@types/ws": "^8.18.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "ws": "^8.19.0"
+  }
+}