ziplayer 0.2.7-dev.1 → 0.2.7-dev.3

package/README.md

@@ -32,6 +32,7 @@ advanced music bots quickly.
 ```bash
 npm install ziplayer @ziplayer/plugin @ziplayer/extension @ziplayer/infinity @discordjs/voice discord.js opusscript
 ```
+
 ---
 
 ## 🚀 Quick Start
@@ -173,12 +174,19 @@ const manager = new PlayerManager({
 	plugins: [new YouTubePlugin()],
 	persistence: {
 		enabled: true,
-		provider: "file", // "file", "redis", or "database"
 		filePath: "./player_data",
-		saveInterval: 60000, // Save every minute
-		autoLoad: true, // Auto-load on startup
-		compress: true, // Compress saved data
-		maxBackups: 5, // Keep 5 backups
+
+		// Backup management
+		maxBackups: 3, // Keep only 3 backups per player
+		maxTotalBackups: 20, // Keep max 20 total backup files
+		autoCleanupBackupsOnStart: true, // Clean old backups on startup
+		backupRetentionDays: 3, // Delete backups older than 3 days
+
+		// Auto restore
+		autoRestoreOnRestart: true,
+		restoreDelay: 3000,
+
+		compress: true,
 	},
 });
 
@@ -510,4 +518,7 @@ player.extensionManager.clearCache("search");
 ## 📄 License
 
 MIT License
-````
+
+```
+
+```

package/dist/persistence/PersistenceManager.d.ts

@@ -1,30 +1,30 @@
 import { EventEmitter } from "events";
-import type { PersistenceOptions, PersistenceProvider } from "../types";
+import type { PersistenceOptions, DestroyedRecord } from "../types";
 import type { Player } from "../structures/Player";
 import type { PlayerManager } from "../structures/PlayerManager";
-export declare class FileProvider implements PersistenceProvider {
-    private basePath;
-    private maxBackups;
-    constructor(basePath: string, maxBackups?: number);
-    private getFilePath;
-    private getBackupPath;
-    private cleanOldBackups;
-    save(key: string, data: any, compress?: boolean): Promise<void>;
-    load(key: string): Promise<any>;
-    delete(key: string): Promise<void>;
-    list(): Promise<string[]>;
-    restoreBackup(key: string, backupTimestamp?: number): Promise<boolean>;
-}
 export declare class PersistenceManager extends EventEmitter {
     private manager;
     private options;
     private provider;
     private saveInterval;
     private isSaving;
+    private isRestoring;
+    private destroyedPlayers;
+    private restoredPlayers;
+    private backupCleanupDone;
     constructor(manager: PlayerManager, options: PersistenceOptions);
+    private setupDestroyTracking;
     private createProvider;
     private debug;
     private startAutoSave;
+    private cleanupBackupsOnStart;
+    private cleanOldBackupsByAge;
+    private enforceTotalBackupLimit;
+    private markAsDestroyed;
+    private isDestroyed;
+    private saveDestroyedStatus;
+    private loadDestroyedStatus;
+    private clearDestroyedStatus;
     private serializeTrack;
     private serializeQueue;
     private serializePlayer;
@@ -40,11 +40,19 @@ export declare class PersistenceManager extends EventEmitter {
     /**
      * Load a single player
      */
-    loadPlayer(guildId: string, restorePosition?: boolean): Promise<boolean>;
+    loadPlayer(guildId: string, restorePosition?: boolean, skipIfDestroyed?: boolean): Promise<boolean>;
     /**
-     * Load all saved players
+     * Load all saved players with auto-restore logic
      */
     loadAll(restorePosition?: boolean): Promise<Map<string, boolean>>;
+    /**
+     * Mark a player as destroyed
+     */
+    markPlayerDestroyed(guildId: string, reason?: string): Promise<void>;
+    /**
+     * Clear destroyed status for a player
+     */
+    clearDestroyed(guildId: string): Promise<void>;
     /**
      * Delete a player's saved data
      */
@@ -53,9 +61,35 @@ export declare class PersistenceManager extends EventEmitter {
      * Restore from backup
      */
     restoreBackup(guildId: string, timestamp?: number): Promise<boolean>;
+    /**
+     * Clean all backups for a specific player
+     */
+    cleanBackupsForPlayer(guildId: string): Promise<number>;
+    /**
+     * Clean all backups
+     */
+    cleanAllBackups(): Promise<number>;
+    /**
+     * Get backup statistics
+     */
+    getBackupStats(): {
+        totalBackups: number;
+        totalSizeMB: number;
+        oldestBackup: Date | null;
+        newestBackup: Date | null;
+        backupsByPlayer: Record<string, number>;
+    } | null;
     /**
      * Stop auto-save and clean up
      */
     shutdown(): Promise<void>;
+    /**
+     * Get list of destroyed players
+     */
+    getDestroyedPlayers(): DestroyedRecord[];
+    /**
+     * Check if auto-restore is enabled
+     */
+    isAutoRestoreEnabled(): boolean;
 }
 //# sourceMappingURL=PersistenceManager.d.ts.map

package/dist/persistence/PersistenceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersistenceManager.d.ts","sourceRoot":"","sources":["../../src/persistence/PersistenceManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,OAAO,KAAK,EAAsD,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC5H,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAOjE,qBAAa,YAAa,YAAW,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU;IAQpD,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;IAcjB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAmB/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA6B5E;AAiCD,qBAAa,kBAAmB,SAAQ,YAAY;IACnD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB;IA0C/D,OAAO,CAAC,cAAc;IAgDtB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA4B9C;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,GAAE,OAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAiEpF;;OAEG;IACG,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAuB7E;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1E;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}
+{"version":3,"file":"PersistenceManager.d.ts","sourceRoot":"","sources":["../../src/persistence/PersistenceManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,OAAO,KAAK,EAIX,kBAAkB,EAElB,eAAe,EAEf,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAkUjE,qBAAa,kBAAmB,SAAQ,YAAY;IACnD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAAkB;gBAE/B,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB;IAiE/D,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,cAAc;IAiDtB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,aAAa;YAgBP,qBAAqB;YAkDrB,oBAAoB;YA2BpB,uBAAuB;IA2BrC,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;YAIL,mBAAmB;YAKnB,mBAAmB;YAenB,oBAAoB;IAKlC,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA2B9C;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,GAAE,OAAc,EAAE,eAAe,GAAE,OAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAqFrH;;OAEG;IACG,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiC7E;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1E;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpD;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBrD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1E;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY7D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAYxC;;OAEG;IACH,cAAc,IAAI;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,GAAG,IAAI;IAiBR;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAIxC;;OAEG;IACH,oBAAoB,IAAI,OAAO;CAG/B"}