ziplayer 0.2.1 → 0.2.3-dev-1

package/src/types/index.ts

@@ -1,7 +1,8 @@
-import { VoiceConnection } from "@discordjs/voice";
 import { Readable } from "stream";
 import { Player } from "../structures/Player";
 import type { PlayerManager } from "../structures/PlayerManager";
+import type { AudioFilter } from "./fillter";
+import type { SourcePluginLike } from "./plugin";
 
 /**
  * Represents a music track with metadata and streaming information.
@@ -178,42 +179,6 @@ export interface PlayerOptions {
 	filters?: (string | AudioFilter)[];
 }
 
-/**
- * Constructor for a SourcePlugin
- *
- * @example
- * const plugin = new YouTubePlugin();
- * console.log(`Plugin: ${plugin.name}`);
- */
-export type SourcePluginCtor<T extends SourcePlugin = SourcePlugin> = new (...args: any[]) => T;
-
-/**
- * SourcePlugin or SourcePluginCtor
- *
- * @example
- * const plugin = new YouTubePlugin();
- * console.log(`Plugin: ${plugin.name}`);
- */
-export type SourcePluginLike = SourcePlugin | SourcePluginCtor;
-
-/**
- * Configuration options for creating a PlayerManager instance.
- *
- * @example
- * const managerOptions: PlayerManagerOptions = {
- *   plugins: [
- *     new YouTubePlugin(),
- *     new SoundCloudPlugin(),
- *     new SpotifyPlugin(),
- *     new TTSPlugin({ defaultLang: "en" })
- *   ],
- *   extensions: [
- *     new voiceExt(null, { lang: "en-US" }),
- *     new lavalinkExt(null, { nodes: [...] })
- *   ],
- *   extractorTimeout: 10000
- * };
- */
 export interface PlayerManagerOptions {
 	plugins?: SourcePluginLike[];
 	extensions?: any[];
@@ -259,366 +224,20 @@ export interface SaveOptions {
 	timeout?: number;
 	/** Additional metadata to include */
 	metadata?: Record<string, any>;
+	/** Filter */
+	filter?: AudioFilter[];
+	/** Seek position in milliseconds to start saving from */
+	seek?: number;
 }
 
 export type LoopMode = "off" | "track" | "queue";
 
-/**
- * Audio filter configuration for applying effects to audio streams.
- * Based on FFmpeg audio filters for Discord music bots.
- *
- * @example
- * // Bass boost filter
- * const bassFilter: AudioFilter = {
- *   name: "bassboost",
- *   ffmpegFilter: "bass=g=10:f=110:w=0.5",
- *   description: "Tăng âm trầm"
- * };
- *
- * // Nightcore filter (speed + pitch)
- * const nightcoreFilter: AudioFilter = {
- *   name: "nightcore",
- *   ffmpegFilter: "atempo=1.25,asetrate=44100*1.25",
- *   description: "Tăng tốc độ và cao độ"
- * };
- *
- * // Custom filter
- * const customFilter: AudioFilter = {
- *   name: "custom",
- *   ffmpegFilter: "volume=1.5,treble=g=5",
- *   description: "Tăng âm lượng và âm cao"
- * };
- */
-export interface AudioFilter {
-	/** Unique name identifier for the filter */
-	name: string;
-	/** FFmpeg audio filter string */
-	ffmpegFilter: string;
-	/** Human-readable description of the filter */
-	description: string;
-	/** Optional category for grouping filters */
-	category?: string;
-	/** Optional parameters for dynamic filter generation */
-	parameters?: Record<string, any>;
-}
-
-/**
- * Predefined audio filters commonly used in Discord music bots.
- * These filters are based on popular FFmpeg audio filter combinations.
- */
-export const PREDEFINED_FILTERS: Record<string, AudioFilter> = {
-	bassboost: {
-		name: "bassboost",
-		ffmpegFilter: "bass=g=10:f=110:w=0.5",
-		description: "Bass Boost",
-		category: "eq",
-	},
-	nightcore: {
-		name: "nightcore",
-		ffmpegFilter: "aresample=48000,asetrate=48000*1.5",
-		description: "Nightcore",
-		category: "speed",
-	},
-	karaoke: {
-		name: "karaoke",
-		ffmpegFilter: "stereotools=mlev=0.1",
-		description: "Karaoke",
-		category: "vocal",
-	},
-	lofi: {
-		name: "lofi",
-		ffmpegFilter: "aresample=48000,asetrate=48000*0.9,extrastereo=m=2.5:c=disabled",
-		description: "Lo-fi",
-		category: "speed",
-	},
-	"8D": {
-		name: "8D",
-		ffmpegFilter: "apulsator=hz=0.08",
-		description: "8D Effect",
-		category: "effect",
-	},
-	vaporwave: {
-		name: "vaporwave",
-		ffmpegFilter:
-			"highpass=f=50, lowpass=f=2750, aresample=48000, asetrate=48000*0.85,bass=g=5:f=110:w=0.6, compand=attacks=0:points=-80/-169|-54/-80|-49.5/-64.6|-41.1/-41.1|-25.8/-15|-10.8/-4.5|0/0|20/8.3",
-		description: "Vaporwave",
-		category: "speed",
-	},
-	bathroom: {
-		name: "bathroom",
-		ffmpegFilter:
-			"highpass=f=10, lowpass=f=400, aresample=44100, asetrate=44100*0.85,bass=g=4:f=110:w=0.6, alimiter=1, compand=attacks=0:points=-80/-169|-54/-80|-49.5/-64.6|-41.1/-41.1|-25.8/-15|-10.8/-4.5|0/0|20/8.3",
-		description: "Bathroom",
-		category: "speed",
-	},
-	expander: {
-		name: "expander",
-		ffmpegFilter: "compand=attacks=0:points=-80/-169|-54/-80|-49.5/-64.6|-41.1/-41.1|-25.8/-15|-10.8/-4.5|0/0|20/8.3",
-		description: "Expander",
-		category: "speed",
-	},
-	reverse: {
-		name: "reverse",
-		ffmpegFilter: "areverse",
-		description: "Reverse",
-		category: "effect",
-	},
-	echo: {
-		name: "echo",
-		ffmpegFilter: "aecho=0.8:0.88:60:0.4",
-		description: "Echo",
-		category: "effect",
-	},
-	trebleboost: {
-		name: "trebleboost",
-		ffmpegFilter: "treble=g=10:f=3000:w=0.5",
-		description: "Treble Boost",
-		category: "eq",
-	},
-
-	chorus: {
-		name: "chorus",
-		ffmpegFilter: "chorus=0.5:0.9:50:0.4:0.25:2",
-		description: "Chorus",
-		category: "effect",
-	},
-	flanger: {
-		name: "flanger",
-		ffmpegFilter: "flanger=delay=10:depth=2:regen=0:width=71:speed=0.5",
-		description: "Flanger",
-		category: "effect",
-	},
-	phaser: {
-		name: "phaser",
-		ffmpegFilter: "aphaser=in_gain=0.4:out_gain=0.74:delay=3.0:decay=0.4:speed=0.5",
-		description: "Phaser",
-		category: "effect",
-	},
-	tremolo: {
-		name: "tremolo",
-		ffmpegFilter: "tremolo=f=4.0:d=0.5",
-		description: "Tremolo",
-		category: "effect",
-	},
-	vibrato: {
-		name: "vibrato",
-		ffmpegFilter: "vibrato=f=5.5:d=0.5",
-		description: "Vibrato",
-		category: "effect",
-	},
-	normalize: {
-		name: "normalize",
-		ffmpegFilter: "loudnorm",
-		description: "Normalize",
-		category: "volume",
-	},
-	compressor: {
-		name: "compressor",
-		ffmpegFilter: "compand=points=-80/-105|-62/-80|-15.4/-15.4|0/-12|20/-7.6",
-		description: "Compressor",
-		category: "dynamics",
-	},
-	limiter: {
-		name: "limiter",
-		ffmpegFilter: "alimiter=level_in=1:level_out=0.8:limit=0.9",
-		description: "Limiter",
-		category: "dynamics",
-	},
-	gate: {
-		name: "gate",
-		ffmpegFilter: "agate=threshold=0.01:ratio=2:attack=1:release=100",
-		description: "Gate",
-		category: "dynamics",
-	},
-	lowpass: {
-		name: "lowpass",
-		ffmpegFilter: "lowpass=f=3000",
-		description: "Lowpass",
-		category: "filter",
-	},
-	highpass: {
-		name: "highpass",
-		ffmpegFilter: "highpass=f=200",
-		description: "Highpass",
-		category: "filter",
-	},
-	bandpass: {
-		name: "bandpass",
-		ffmpegFilter: "bandpass=f=1000:csg=1",
-		description: "Bandpass",
-		category: "filter",
-	},
-	allpass: {
-		name: "allpass",
-		ffmpegFilter: "allpass=f=1000:width_type=h:width=200",
-		description: "Allpass",
-		category: "filter",
-	},
-	equalizer: {
-		name: "equalizer",
-		ffmpegFilter: "equalizer=f=1000:width_type=h:width=200:g=5",
-		description: "Equalizer",
-		category: "eq",
-	},
-	reverb: {
-		name: "reverb",
-		ffmpegFilter: "aecho=0.8:0.88:60:0.4",
-		description: "Reverb",
-		category: "effect",
-	},
-	delay: {
-		name: "delay",
-		ffmpegFilter: "aecho=0.8:0.9:1000:0.3",
-		description: "Delay",
-		category: "effect",
-	},
-	distortion: {
-		name: "distortion",
-		ffmpegFilter: "acrusher=bits=8:mode=log:aa=1",
-		description: "Distortion",
-		category: "effect",
-	},
-	bitcrusher: {
-		name: "bitcrusher",
-		ffmpegFilter: "acrusher=bits=8:mode=log:aa=1",
-		description: "Bitcrusher",
-		category: "effect",
-	},
-	robot: {
-		name: "robot",
-		ffmpegFilter: "afftfilt=real='hypot(re,im)*sin(0)':imag='hypot(re,im)*cos(0)':win_size=512:overlap=0.75",
-		description: "Robot",
-		category: "vocal",
-	},
-	slow: {
-		name: "slow",
-		ffmpegFilter: "atempo=0.5",
-		description: "Slow",
-		category: "speed",
-	},
-	fast: {
-		name: "fast",
-		ffmpegFilter: "atempo=2.0",
-		description: "Fast",
-		category: "speed",
-	},
-	mono: {
-		name: "mono",
-		ffmpegFilter: "pan=mono|c0=0.5*c0+0.5*c1",
-		description: "Mono",
-		category: "channel",
-	},
-	stereo: {
-		name: "stereo",
-		ffmpegFilter: "pan=stereo|c0<c0+c1+c2+c3+c4+c5|c1<c0+c1+c2+c3+c4+c5",
-		description: "Stereo",
-		category: "channel",
-	},
-	haas: {
-		name: "haas",
-		ffmpegFilter: "haas",
-		description: "Haas",
-		category: "dynamics",
-	},
-	fadein: {
-		name: "fadein",
-		ffmpegFilter: "afade=t=in:ss=0:d=5",
-		description: "Fadein",
-		category: "effect",
-	},
-};
-
-/**
- * Context for the extension
- *
- * @example
- * const context: ExtensionContext = {
- *   player: player,
- *   manager: manager
- * };
- */
-export interface ExtensionContext {
-	player: Player;
-	manager: PlayerManager;
-}
-
-/**
- * Request for the extension to play a track
- *
- * @example
- * const request: ExtensionPlayRequest = {
- *   query: "Song Name",
- *   requestedBy: "user123"
- * };
- */
-export interface ExtensionPlayRequest {
-	query: string | Track;
-	requestedBy?: string;
-}
-
-/**
- * Response for the extension to play a track
- *
- * @example
- * const response: ExtensionPlayResponse = {
- *   handled: true,
- *   query: "Song Name",
- *   requestedBy: "user123"
- * };
- */
-export interface ExtensionPlayResponse {
-	handled?: boolean;
-	query?: string | Track;
-	requestedBy?: string;
-	tracks?: Track[];
-	isPlaylist?: boolean;
-	success?: boolean;
-	error?: Error;
-}
-
-/**
- * Payload for the extension to play a track
- *
- * @example
- * const payload: ExtensionAfterPlayPayload = {
- *   success: true,
- *   query: "Song Name",
- *   requestedBy: "user123"
- * };
- */
-export interface ExtensionAfterPlayPayload {
-	success: boolean;
-	query: string | Track;
-	requestedBy?: string;
-	tracks?: Track[];
-	isPlaylist?: boolean;
-	error?: Error;
-}
-
-/**
- * Request for the extension to stream a track
- *
- * @example
- * const request: ExtensionStreamRequest = {
- *   track: track
- * };
- */
-export interface ExtensionStreamRequest {
-	track: Track;
-}
-
-/**
- * Request for the extension to search for a track
- *
- * @example
- * const request: ExtensionSearchRequest = {
- *   query: "Song Name",
- *   requestedBy: "user123"
- * };
- */
-export interface ExtensionSearchRequest {
-	query: string;
-	requestedBy: string;
+export interface VoiceChannel {
+	id: string;
+	guildId: string;
+	type: any;
+	guild: any;
+	// Placeholder for VoiceConnection properties and methods
 }
 
 /**
@@ -748,54 +367,7 @@ export interface PlayerEvents {
 	/** Emitted when all filters are cleared */
 	filtersCleared: [];
 }
-/**
- * Plugin interface
- *
- * @example
- * const plugin: SourcePlugin = {
- *   name: "YouTube",
- *   version: "1.0.0"
- * };
- */
-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[]>;
-}
 
-/**
- * Extension interface
- *
- * @example
- * const extension: SourceExtension = {
- *   name: "YouTube",
- *   version: "1.0.0"
- * };
- */
-export interface SourceExtension {
-	name: string;
-	version: string;
-	connection?: VoiceConnection;
-	player: Player | null;
-	active(alas: any): boolean | Promise<boolean>;
-	onRegister?(context: ExtensionContext): void | Promise<void>;
-	onDestroy?(context: ExtensionContext): void | Promise<void>;
-	beforePlay?(
-		context: ExtensionContext,
-		payload: ExtensionPlayRequest,
-	): Promise<ExtensionPlayResponse | void> | ExtensionPlayResponse | void;
-	afterPlay?(context: ExtensionContext, payload: ExtensionAfterPlayPayload): Promise<void> | void;
-	provideSearch?(
-		context: ExtensionContext,
-		payload: ExtensionSearchRequest,
-	): Promise<SearchResult | null | undefined> | SearchResult | null | undefined;
-	provideStream?(
-		context: ExtensionContext,
-		payload: ExtensionStreamRequest,
-	): Promise<StreamInfo | null | undefined> | StreamInfo | null | undefined;
-}
+export * from "./fillter";
+export * from "./plugin";
+export * from "./extension";

package/src/types/plugin.ts

@@ -0,0 +1,57 @@
+import type { SearchResult, StreamInfo, Track } from ".";
+/**
+ * Plugin interface
+ *
+ * @example
+ * const plugin: SourcePlugin = {
+ *   name: "YouTube",
+ *   version: "1.0.0"
+ * };
+ */
+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[]>;
+}
+
+/**
+ * Constructor for a SourcePlugin
+ *
+ * @example
+ * const plugin = new YouTubePlugin();
+ * console.log(`Plugin: ${plugin.name}`);
+ */
+export type SourcePluginCtor<T extends SourcePlugin = SourcePlugin> = new (...args: any[]) => T;
+
+/**
+ * SourcePlugin or SourcePluginCtor
+ *
+ * @example
+ * const plugin = new YouTubePlugin();
+ * console.log(`Plugin: ${plugin.name}`);
+ */
+export type SourcePluginLike = SourcePlugin | SourcePluginCtor;
+
+/**
+ * Configuration options for creating a PlayerManager instance.
+ *
+ * @example
+ * const managerOptions: PlayerManagerOptions = {
+ *   plugins: [
+ *     new YouTubePlugin(),
+ *     new SoundCloudPlugin(),
+ *     new SpotifyPlugin(),
+ *     new TTSPlugin({ defaultLang: "en" })
+ *   ],
+ *   extensions: [
+ *     new voiceExt(null, { lang: "en-US" }),
+ *     new lavalinkExt(null, { nodes: [...] })
+ *   ],
+ *   extractorTimeout: 10000
+ * };
+ */

package/dist/plugins/SoundCloudPlugin.d.ts

@@ -1,22 +0,0 @@
-import { BasePlugin } from "./BasePlugin";
-import { Track, SearchResult, StreamInfo } from "../types";
-export declare class SoundCloudPlugin extends BasePlugin {
-    name: string;
-    version: string;
-    private client;
-    private ready;
-    constructor();
-    private init;
-    canHandle(query: string): boolean;
-    validate(url: string): boolean;
-    search(query: string, requestedBy: string): Promise<SearchResult>;
-    getStream(track: Track): Promise<StreamInfo>;
-    getRelatedTracks(trackURL: string | number, opts?: {
-        limit?: number;
-        offset?: number;
-        history?: Track[];
-    }): Promise<Track[]>;
-    getFallback(track: Track): Promise<StreamInfo>;
-    extractPlaylist(url: string, requestedBy: string): Promise<Track[]>;
-}
-//# sourceMappingURL=SoundCloudPlugin.d.ts.map

package/dist/plugins/SoundCloudPlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SoundCloudPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SoundCloudPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3D,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,IAAI,SAAgB;IACpB,OAAO,SAAW;IAClB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAgB;;YAOf,IAAI;IAKlB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsEjE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB5C,gBAAgB,CACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;KAAO,GAChE,OAAO,CAAC,KAAK,EAAE,CAAC;IAoCb,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAS9C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAsB1E"}