ziplayer 0.2.6 → 0.2.7-dev.1

package/src/types/persistence.ts

@@ -0,0 +1,65 @@
+import type { Track, LoopMode, PlayerOptions } from ".";
+
+export interface SerializedTrack {
+	id: string;
+	title: string;
+	url: string;
+	source: string;
+	duration: number;
+	thumbnail?: string;
+	author?: string;
+	requestedBy?: string;
+	isLive?: boolean;
+	artwork?: string;
+	[key: string]: any; // For additional metadata
+}
+
+export interface SerializedQueue {
+	tracks: SerializedTrack[];
+	current: SerializedTrack | null;
+	history: SerializedTrack[];
+	loopMode: LoopMode;
+	autoPlay: boolean;
+	position?: number; // Current playback position in ms
+}
+
+export interface SerializedPlayer {
+	guildId: string;
+	queue: SerializedQueue;
+	volume: number;
+	isPlaying: boolean;
+	isPaused: boolean;
+	options: PlayerOptions;
+	filters?: string[];
+	lastUpdate: number;
+	version: string; // For backward compatibility
+}
+
+export interface PersistenceOptions {
+	enabled: boolean;
+	provider?: "file" | "redis" | "database";
+	saveInterval?: number; // Auto-save interval (ms)
+	autoLoad?: boolean; // Auto-load on start
+	maxBackups?: number; // Number of backups to keep
+	compress?: boolean; // Compress saved data
+
+	// File provider options
+	filePath?: string;
+
+	// Redis provider options
+	redisUrl?: string;
+	redisPrefix?: string;
+
+	// Database options (for custom provider)
+	save?: (data: Map<string, SerializedPlayer>) => Promise<void>;
+	load?: () => Promise<Map<string, SerializedPlayer>>;
+	delete?: (guildId: string) => Promise<void>;
+	list?: () => Promise<string[]>;
+}
+
+export interface PersistenceProvider {
+	save(key: string, data: any, compress?: boolean): Promise<void>;
+	load(key: string): Promise<any>;
+	delete(key: string): Promise<void>;
+	list(): Promise<string[]>;
+}

package/src/types/plugin.ts

@@ -12,7 +12,7 @@ import type { SearchResult, StreamInfo, Track } from ".";
 export interface SourcePlugin {
 	name: string;
 	version: string;
-	priority?: number;
+	priority?: number; // Higher = run first, default is 0. Lower priority plugins are tried first in getStream fallback.
 	canHandle(query: string): boolean;
 	search(query: string, requestedBy: string): Promise<SearchResult>;
 	getStream(track: Track): Promise<StreamInfo>;

package/src/utils/timeout.ts

@@ -1,10 +1,10 @@
-/**
- * Utility function to add timeout to a promise
- * @param promise The promise to add timeout to
- * @param timeoutMs Timeout in milliseconds
- * @param message Error message when timeout occurs
- * @returns Promise that rejects if timeout is reached
- */
-export function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message: string): Promise<T> {
-	return Promise.race([promise, new Promise<never>((_, reject) => setTimeout(() => reject(new Error(message)), timeoutMs))]);
-}
+/**
+ * Utility function to add timeout to a promise
+ * @param promise The promise to add timeout to
+ * @param timeoutMs Timeout in milliseconds
+ * @param message Error message when timeout occurs
+ * @returns Promise that rejects if timeout is reached
+ */
+export function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message: string): Promise<T> {
+	return Promise.race([promise, new Promise<never>((_, reject) => setTimeout(() => reject(new Error(message)), timeoutMs))]);
+}

package/tsconfig.json

@@ -1,23 +1,22 @@
-{
-	"compilerOptions": {
-		"target": "es2021",
-		"module": "commonjs",
-		"lib": ["ES2021"],
-		"outDir": "./dist",
-		"rootDir": "./src",
-		"strict": true,
-		"esModuleInterop": true,
-		"skipLibCheck": true,
-		"forceConsistentCasingInFileNames": true,
-		"declaration": true,
-		"declarationMap": true,
-		"sourceMap": true,
-		"moduleResolution": "node",
-		"allowSyntheticDefaultImports": true,
-		"experimentalDecorators": true,
-		"emitDecoratorMetadata": true,
-		"resolveJsonModule": true
-	},
-	"include": ["src/**/*"],
-	"exclude": ["node_modules", "dist", "examples"]
-}
+{
+	"compilerOptions": {
+		"target": "es2021",
+		"module": "commonjs",
+		"lib": ["ES2021"],
+		"outDir": "./dist",
+		"rootDir": "./src",
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true,
+		"allowSyntheticDefaultImports": true,
+		"experimentalDecorators": true,
+		"emitDecoratorMetadata": true,
+		"resolveJsonModule": true
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "dist", "examples"]
+}