ziplayer 0.0.1

package/dist/structures/Queue.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+class Queue {
+    constructor() {
+        this.tracks = [];
+        this.current = null;
+        this.history = [];
+        this._autoPlay = false;
+        this.willnext = null;
+    }
+    add(track) {
+        this.tracks.push(track);
+    }
+    addMultiple(tracks) {
+        this.tracks.push(...tracks);
+    }
+    remove(index) {
+        if (index < 0 || index >= this.tracks.length)
+            return null;
+        return this.tracks.splice(index, 1)[0];
+    }
+    next() {
+        if (this.current) {
+            this.history.push(this.current);
+            if (this.history.length > 200) {
+                this.history.shift();
+            }
+        }
+        this.current = this.tracks.shift() || null;
+        return this.current;
+    }
+    clear() {
+        this.tracks = [];
+    }
+    autoPlay(value) {
+        if (typeof value !== "undefined") {
+            this._autoPlay = value;
+        }
+        return this._autoPlay;
+    }
+    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]];
+        }
+    }
+    get size() {
+        return this.tracks.length;
+    }
+    get isEmpty() {
+        return this.tracks.length === 0;
+    }
+    get currentTrack() {
+        return this.current;
+    }
+    get previousTracks() {
+        return [...this.history];
+    }
+    get nextTrack() {
+        return this.tracks[0] || null;
+    }
+    willNextTrack(track) {
+        if (track) {
+            this.willnext = track;
+            return this.willnext;
+        }
+        return this.willnext;
+    }
+    getTracks() {
+        return [...this.tracks];
+    }
+    getTrack(index) {
+        return this.tracks[index] || null;
+    }
+}
+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":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,75 @@
+import { Readable } from "stream";
+export interface Track {
+    id: string;
+    title: string;
+    url: string;
+    duration: number;
+    thumbnail?: string;
+    requestedBy: string;
+    source: string;
+    metadata?: Record<string, any>;
+}
+export interface SearchResult {
+    tracks: Track[];
+    playlist?: {
+        name: string;
+        url: string;
+        thumbnail?: string;
+    };
+}
+export interface StreamInfo {
+    stream: Readable;
+    type: "webm/opus" | "ogg/opus" | "arbitrary";
+    metadata?: Record<string, any>;
+}
+export interface PlayerOptions {
+    leaveOnEnd?: boolean;
+    leaveOnEmpty?: boolean;
+    leaveTimeout?: number;
+    volume?: number;
+    quality?: "high" | "low";
+    /**
+     * Timeout in milliseconds for plugin operations (search, streaming, etc.)
+     * to prevent long-running tasks from blocking the player.
+     */
+    extractorTimeout?: number;
+    userdata?: Record<string, any>;
+}
+export interface PlayerManagerOptions {
+    plugins?: SourcePlugin[];
+}
+export interface ProgressBarOptions {
+    size?: number;
+    barChar?: string;
+    progressChar?: string;
+}
+export interface PlayerEvents {
+    debug: [message: string, ...args: any[]];
+    willPlay: [track: Track, upcomingTracks: Track[]];
+    trackStart: [track: Track];
+    trackEnd: [track: Track];
+    queueEnd: [];
+    playerError: [error: Error, track?: Track];
+    connectionError: [error: Error];
+    volumeChange: [oldVolume: number, newVolume: number];
+    queueAdd: [track: Track];
+    queueRemove: [track: Track, index: number];
+    playerPause: [track: Track];
+    playerResume: [track: Track];
+    playerStop: [];
+    playerDestroy: [];
+}
+export interface SourcePlugin {
+    name: string;
+    version: string;
+    canHandle(query: string): boolean;
+    search(query: string, requestedBy: string): Promise<SearchResult>;
+    getStream(track: Track): Promise<StreamInfo>;
+    getRelatedTracks?(track: string | number, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Track[]>;
+    validate?(url: string): boolean;
+    extractPlaylist?(url: string, requestedBy: string): Promise<Track[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,29 @@
+{
+	"name": "ziplayer",
+	"version": "0.0.1",
+	"description": "A modular Discord voice player with plugin system",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"prepare": "npm run build"
+	},
+	"dependencies": {
+		"@discordjs/voice": "^0.19.0",
+		"@snazzah/davey": "^0.1.6",
+		"discord.js": "^14.0.0",
+		"ffmpeg-static": "^5.2.0",
+		"libsodium-wrappers": "^0.7.15",
+		"opusscript": "^0.1.1"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"typescript": "^5.0.0"
+	},
+	"peerDependencies": {
+		"@zibot/scdl": "^0.0.5",
+		"soundcloud-scraper": "^5.0.2",
+		"youtubei.js": "^15.0.1"
+	}
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+import { PlayerManager } from "./structures/PlayerManager";
+
+export { Player } from "./structures/Player";
+export { Queue } from "./structures/Queue";
+export { PlayerManager } from "./structures/PlayerManager";
+export * from "./types";
+export * from "./plugins";
+
+// Default export
+export default PlayerManager;

package/src/plugins/BasePlugin.ts

@@ -0,0 +1,29 @@
+import { SourcePlugin, Track, SearchResult, StreamInfo } from "../types";
+
+export abstract class BasePlugin implements SourcePlugin {
+  abstract name: string;
+  abstract version: string;
+
+  abstract canHandle(query: string): boolean;
+  abstract search(query: string, requestedBy: string): Promise<SearchResult>;
+  abstract getStream(track: Track): Promise<StreamInfo>;
+
+  getFallback?(track: Track): Promise<StreamInfo> {
+    throw new Error("getFallback not implemented");
+  }
+
+  getRelatedTracks?(
+    trackURL: string,
+    opts?: { limit?: number; offset?: number; history?: Track[] }
+  ): Promise<Track[]> {
+    return Promise.resolve([]);
+  }
+
+  validate?(url: string): boolean {
+    return this.canHandle(url);
+  }
+
+  extractPlaylist?(url: string, requestedBy: string): Promise<Track[]> {
+    return Promise.resolve([]);
+  }
+}

package/src/plugins/index.ts

@@ -0,0 +1,32 @@
+import { BasePlugin } from "./BasePlugin";
+
+export { BasePlugin } from "./BasePlugin";
+
+// Plugin factory
+export class PluginManager {
+  private plugins: Map<string, BasePlugin> = new Map();
+
+  register(plugin: BasePlugin): void {
+    this.plugins.set(plugin.name, plugin);
+  }
+
+  unregister(name: string): boolean {
+    return this.plugins.delete(name);
+  }
+
+  get(name: string): BasePlugin | undefined {
+    return this.plugins.get(name);
+  }
+
+  getAll(): BasePlugin[] {
+    return Array.from(this.plugins.values());
+  }
+
+  findPlugin(query: string): BasePlugin | undefined {
+    return this.getAll().find((plugin) => plugin.canHandle(query));
+  }
+
+  clear(): void {
+    this.plugins.clear();
+  }
+}