refactor: remove unused specificVersion configuration

- Remove specificVersion field from PluginVersionConfig interface
- Remove specificVersion from VersionOverrides interface
- Remove specificVersion file mapping from PLUGIN_FILES
- Remove specificVersion processing in setupPluginVersions
- Update all examples in sample config file
- Cleanup validatePluginFiles, listPluginFiles and cleanPluginFiles

Author: Miraeld

config/plugin.config.sample.ts

@@ -32,18 +32,6 @@ export interface PluginVersionConfig {
      */
     newRelease: string;
 
-    /**
-     * Specific version for rollback/upgrade tests (currently 3.10.9).
-     * This version is used for specific test scenarios.
-     * 
-     * Can be:
-     * - A version number (e.g., '3.10.9') - will download from WP Rocket releases
-     * - A GitHub branch name prefixed with 'branch:' (e.g., 'branch:release/3.10.9')
-     * - A GitHub tag prefixed with 'tag:' (e.g., 'tag:3.10.9')
-     * - A URL pointing to a zip file
-     */
-    specificVersion?: string;
-
     /**
      * GitHub repository information for building from branches.
      * Only required if using branch: or tag: prefixes.
@@ -67,15 +55,13 @@ export interface PluginVersionConfig {
  * export const pluginConfig: PluginVersionConfig = {
  *     previousStable: '3.16.0',
  *     newRelease: '3.16.1',
- *     specificVersion: '3.10.9',
  * };
  * 
  * @example
  * // Using GitHub branches
  * export const pluginConfig: PluginVersionConfig = {
  *     previousStable: 'branch:release/3.16.0',
  *     newRelease: 'branch:develop',
- *     specificVersion: '3.10.9',
  *     repository: {
  *         owner: 'wp-media',
  *         name: 'wp-rocket',
@@ -88,7 +74,6 @@ export interface PluginVersionConfig {
  * export const pluginConfig: PluginVersionConfig = {
  *     previousStable: 'https://example.com/wp-rocket-3.16.0.zip',
  *     newRelease: 'https://example.com/wp-rocket-3.16.1.zip',
- *     specificVersion: '3.10.9',
  * };
  */
 export const pluginConfig: PluginVersionConfig = {
@@ -102,8 +87,6 @@ export const pluginConfig: PluginVersionConfig = {
     specificVersion: '3.10.9',  // Specific version for rollback tests
 
     // Optional: Configure GitHub repository for branch-based builds
-    repository: {
-        owner: 'wp-media',
         name: 'wp-rocket',
         token: process.env.GITHUB_TOKEN,
     }

utils/plugin-manager.ts

@@ -68,7 +68,6 @@ function getActivePluginConfig(overrides?: VersionOverrides): PluginVersionConfi
 const PLUGIN_FILES: Record<string, string> = {
     previousStable: 'previous_stable.zip',
     newRelease: 'new_release.zip',
-    specificVersion: 'wp-rocket_3.10.9.zip',
 };
 
 /**
@@ -395,15 +394,7 @@ export async function setupPluginVersions(force: boolean = false, overrides?: Ve
             'new_release'
         );
 
-        if (pluginConfig.specificVersion) {
-            await processVersion(
-                pluginConfig.specificVersion,
-                PLUGIN_FILES.specificVersion,
-                pluginConfig.repository,
-                'specific_version'
-            );
-        }
-        
+
         console.log('\n✅ Plugin setup completed successfully!\n');
     } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
@@ -423,10 +414,6 @@ export async function validatePluginFiles(): Promise<boolean> {
         PLUGIN_FILES.newRelease,
     ];
 
-    if (basePluginConfig?.specificVersion) {
-        requiredFiles.push(PLUGIN_FILES.specificVersion);
-    }
-    
     const missingFiles = requiredFiles.filter(file => !pluginFileExists(file));
 
     if (missingFiles.length > 0) {
@@ -460,7 +447,6 @@ export async function listPluginFiles(overrides?: VersionOverrides): Promise<voi
     const files = [
         { name: PLUGIN_FILES.previousStable, config: pluginConfig.previousStable },
         { name: PLUGIN_FILES.newRelease, config: pluginConfig.newRelease },
-        { name: PLUGIN_FILES.specificVersion, config: pluginConfig.specificVersion },
     ];
 
     for (const file of files) {
@@ -487,7 +473,6 @@ export async function cleanPluginFiles(): Promise<void> {
     const files = [
         PLUGIN_FILES.previousStable,
         PLUGIN_FILES.newRelease,
-        PLUGIN_FILES.specificVersion,
     ];
 
     for (const file of files) {

utils/version-override.ts

@@ -22,7 +22,6 @@
 export interface VersionOverrides {
     previousStable?: string;
     newRelease?: string;
-    specificVersion?: string;
 }
 
 /**
@@ -31,7 +30,6 @@ export interface VersionOverrides {
 export interface PluginVersionConfig {
     previousStable: string;
     newRelease: string;
-    specificVersion?: string;
     repository?: {
         owner: string;
         name: string;
@@ -53,9 +51,6 @@ function extractFromNpmConfig(overrides: VersionOverrides): void {
         overrides.newRelease = process.env.npm_config_new_release;
     }
     if (process.env.npm_config_specific_version) {
-        overrides.specificVersion = process.env.npm_config_specific_version;
-    }
-}
 
 /**
  * Extracts version overrides from direct environment variables.
@@ -73,9 +68,6 @@ function extractFromEnv(overrides: VersionOverrides): void {
     if (process.env.SPECIFIC_VERSION) {
         overrides.specificVersion = process.env.SPECIFIC_VERSION;
     }
-}
-
-/**
  * Parses a command line argument in --key=value or --key value format.
  * 
  * @param {string} arg - The argument to parse
@@ -118,10 +110,7 @@ function parseArgument(arg: string, args: string[], index: number, overrides: Ve
     }
 
     return 0;
-}
-
-/**
- * Extracts version overrides from process.argv command line arguments.
+}tracts version overrides from process.argv command line arguments.
  * 
  * @param {VersionOverrides} overrides - Overrides object to populate
  * @return {void}
@@ -179,8 +168,7 @@ export function applyVersionOverrides(
 
 /**
  * Checks if any version overrides are present.
- * 
- * @param {VersionOverrides} overrides - Version overrides to check
+ * param {VersionOverrides} overrides - Version overrides to check
  * @return {boolean} True if any overrides are present
  */
 export function hasVersionOverrides(overrides: VersionOverrides): boolean {
@@ -193,8 +181,7 @@ export function hasVersionOverrides(overrides: VersionOverrides): boolean {
 
 /**
  * Formats version overrides for display.
- * 
- * @param {VersionOverrides} overrides - Version overrides to format
+ * rides - Version overrides to format
  * @return {string} Formatted string of overrides
  */
 export function formatVersionOverrides(overrides: VersionOverrides): string {
@@ -211,4 +198,4 @@ export function formatVersionOverrides(overrides: VersionOverrides): string {
     }
 
     return lines.length > 0 ? lines.join('\n') : '  (none)';
-}
+}