ziplayer 0.3.3 → 0.3.5

package/src/structures/StreamManager.ts

@@ -12,6 +12,7 @@ export interface ManagedStream {
 	metadata: {
 		source: string;
 		isPreload: boolean;
+		isRemote: boolean;
 		priority: number;
 	};
 	listeners: {
@@ -128,6 +129,7 @@ export class StreamManager extends EventEmitter {
 				source: track.source || "unknown",
 				isPreload: metadata.isPreload || false,
 				priority: metadata.priority || 0,
+				isRemote: metadata.isRemote || false,
 				...metadata,
 			},
 			listeners,

package/src/types/extension.ts

@@ -47,6 +47,9 @@ export interface SourceExtension {
 export interface ExtensionContext {
 	player: Player;
 	manager: PlayerManager;
+	playNext?: () => Promise<void>;
+	skip?: () => void;
+	emit?: (event: string, ...args: any[]) => void;
 }
 
 /**

package/src/types/index.ts

@@ -4,6 +4,12 @@ import type { PlayerManager } from "../structures/PlayerManager";
 import type { AudioFilter } from "./fillter";
 import type { SourcePluginLike } from "./plugin";
 import type { AudioResource } from "@discordjs/voice";
+
+export enum PlaybackMode {
+	NATIVE = "native",
+	REMOTE = "remote",
+	FORWARD = "forward",
+}
 /**
  * Represents a music track with metadata and streaming information.
  *
@@ -118,8 +124,20 @@ export interface SearchScore {
  */
 export interface StreamInfo {
 	stream: Readable;
-	type: "webm/opus" | "ogg/opus" | "arbitrary";
+	type: "webm/opus" | "ogg/opus" | "arbitrary" | string;
 	metadata?: Record<string, any>;
+
+	remote?: boolean;
+
+	handle?: {
+		play(): Promise<void>;
+		stop(): Promise<void>;
+		pause(): Promise<void>;
+		resume(): Promise<void>;
+		seek(position: number): Promise<void>;
+		setVolume(volume: number): Promise<void>;
+		destroy(): Promise<void>;
+	};
 }
 
 /** Passed to each {@link TrackMiddleware} run (before stream resolution). */
@@ -135,20 +153,13 @@ export interface TrackMiddlewareContext {
  */
 export type TrackMiddleware = (track: Track, context: TrackMiddlewareContext) => void | Track | Promise<void | Track>;
 
-/** Options for {@link PlayerManager.subscribePlaybackMirror}. */
+/** Options for {@link PlayerManager.subscribeForwardMirror}. */
 export interface PlaybackMirrorOptions {
 	leaderGuildId: string;
 	followerGuildIds: string[];
-	/** User id passed to follower `play()` (often the bot application id). */
-	mirrorUserId: string;
-	/** When true (default), follower `setVolume` tracks the leader. */
-	syncVolume?: boolean;
 	/**
 	 * When enabled, follower connections subscribe directly
-	 * to leader.audioPlayer instead of creating their own streams.
-	 *
-	 * Greatly reduces bandwidth/CPU usage.
-	 *
+	 * to leader.audioPlayer
 	 * Default: true
 	 */
 	forwardMode?: boolean;
@@ -427,12 +438,28 @@ export interface PreloadState {
 	isBeingUsed: boolean;
 }
 
+export interface ForwardHealthStatus {
+	guildId: string;
+	healthy: boolean;
+	role: "leader" | "follower" | "none";
+	issues: string[];
+	details: {
+		leaderId?: string;
+		followerCount?: number;
+		connectionState?: string;
+		audioPlayerState?: string;
+	};
+}
+
 export interface PlayerStats {
 	totalPlayers: number;
+	leader: number;
+	follower: number;
 	activePlayers: number;
 	pausedPlayers: number;
 	connectedPlayers: number;
 	totalTracksInQueue: number;
+	forwardHealthStatus: ForwardHealthStatus[];
 }
 
 export interface StreamSlot {
@@ -553,7 +580,10 @@ export interface ManagerEvents {
 	lyricsChange: [player: Player, track: Track, lyrics: any];
 	voiceCreate: [player: Player, evt: any];
 	stats: [stats: PlayerStats];
-	streamError: [error: Error, track: Track | null];
+	streamError: [player: Player, error: Error, track: Track | null];
+
+	forwardModeStart: [player: Player, leader: Player];
+	forwardModeEnd: [player: Player, leader: Player, reason: string | undefined];
 }
 export interface PlayerEvents {
 	debug: [message: string, ...args: any[]];
@@ -587,6 +617,8 @@ export interface PlayerEvents {
 	streamError: [error: Error, track: Track | null];
 	/** Emitted when player stats are updated (if enabled) */
 	stats: [stats: PlayerStats];
+	forwardModeStart: [leader: Player];
+	forwardModeEnd: [leader: Player, reason: string | undefined];
 }
 
 export * from "./fillter";