@nindroidsystems/pluginator 2.3.0

package/dist/ui/widgets/widget-types.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Widget Type Definitions
+ *
+ * Core types for the dashboard widget system including widget interfaces,
+ * layout configuration, and tier-gating support.
+ *
+ * @since v1.56.0
+ */
+import type { ReactNode } from 'react';
+import type { Tier } from '../../core/types/auth.js';
+/**
+ * Widget size options
+ */
+export type WidgetSize = 'small' | 'medium' | 'large' | 'full';
+/**
+ * Widget category for organization
+ */
+export type WidgetCategory = 'status' | 'analytics' | 'health' | 'actions' | 'logs';
+/**
+ * Widget refresh state
+ */
+export type WidgetRefreshState = 'idle' | 'refreshing' | 'error';
+/**
+ * Size configuration mapping
+ */
+export declare const WIDGET_SIZE_CONFIG: Record<WidgetSize, {
+    columns: number;
+    rows: number;
+}>;
+/**
+ * Grid column configuration based on terminal width
+ */
+export declare const GRID_COLUMN_CONFIG: {
+    readonly narrow: {
+        readonly minWidth: 60;
+        readonly maxWidth: 80;
+        readonly columns: 2;
+    };
+    readonly medium: {
+        readonly minWidth: 81;
+        readonly maxWidth: 120;
+        readonly columns: 3;
+    };
+    readonly wide: {
+        readonly minWidth: 121;
+        readonly maxWidth: number;
+        readonly columns: 4;
+    };
+};
+/**
+ * Get column count based on terminal width
+ */
+export declare function getColumnCount(terminalWidth: number): number;
+/**
+ * Widget definition interface
+ */
+export interface WidgetDefinition {
+    /** Unique widget identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Widget category */
+    category: WidgetCategory;
+    /** Minimum tier required to use this widget */
+    minTier: Tier;
+    /** Default size */
+    defaultSize: WidgetSize;
+    /** Auto-refresh interval in ms (0 = no auto-refresh) */
+    refreshInterval: number;
+    /** Whether widget can be collapsed */
+    collapsible: boolean;
+    /** Whether widget can be resized */
+    resizable: boolean;
+    /** Icon character */
+    icon: string;
+}
+/**
+ * Widget state for runtime
+ */
+export interface WidgetState {
+    /** Whether widget is collapsed */
+    collapsed: boolean;
+    /** Current size (may differ from default if resized) */
+    size: WidgetSize;
+    /** Refresh state */
+    refreshState: WidgetRefreshState;
+    /** Last refresh timestamp */
+    lastRefresh: number;
+    /** Error message if refresh failed */
+    error?: string;
+    /** Widget-specific data */
+    data?: unknown;
+}
+/**
+ * Widget placement in the grid
+ */
+export interface WidgetPlacement {
+    /** Widget ID */
+    widgetId: string;
+    /** Column position (0-indexed) */
+    column: number;
+    /** Row position (0-indexed) */
+    row: number;
+    /** Whether widget is visible */
+    visible: boolean;
+    /** Collapsed state */
+    collapsed: boolean;
+    /** Custom size (overrides default) */
+    customSize?: WidgetSize;
+}
+/**
+ * Dashboard layout configuration
+ */
+export interface DashboardLayout {
+    /** Layout identifier */
+    id: string;
+    /** Layout name */
+    name: string;
+    /** Widget placements */
+    widgets: WidgetPlacement[];
+    /** Number of columns (may be auto-calculated) */
+    columns?: number;
+    /** Whether this is a preset layout */
+    isPreset: boolean;
+    /** Minimum tier required for this layout */
+    minTier: Tier;
+}
+/**
+ * Preset layout names
+ */
+export type PresetLayoutName = 'compact' | 'standard' | 'detailed';
+/**
+ * Widget render context passed to render function
+ */
+export interface WidgetRenderContext {
+    /** Widget definition */
+    definition: WidgetDefinition;
+    /** Current state */
+    state: WidgetState;
+    /** Current placement */
+    placement: WidgetPlacement;
+    /** User's tier */
+    tier: Tier;
+    /** Terminal width */
+    terminalWidth: number;
+    /** Terminal height */
+    terminalHeight: number;
+    /** Calculated widget width in characters */
+    widgetWidth: number;
+    /** Calculated widget height in rows */
+    widgetHeight: number;
+    /** Trigger a refresh */
+    onRefresh: () => void;
+    /** Update widget data */
+    onDataUpdate: (data: unknown) => void;
+}
+/**
+ * Widget component props
+ */
+export interface WidgetProps {
+    /** Render context */
+    context: WidgetRenderContext;
+}
+/**
+ * Widget render function type
+ */
+export type WidgetRenderFn = (context: WidgetRenderContext) => ReactNode;
+/**
+ * Registered widget with render function
+ */
+export interface RegisteredWidget {
+    /** Widget definition */
+    definition: WidgetDefinition;
+    /** Render function */
+    render: WidgetRenderFn;
+    /** Optional data fetcher */
+    fetchData?: () => Promise<unknown>;
+}
+/**
+ * Dashboard configuration stored in user settings
+ */
+export interface DashboardConfig {
+    /** Active layout ID */
+    activeLayoutId: string;
+    /** Custom layouts */
+    customLayouts: DashboardLayout[];
+    /** Widget states (persisted separately from placement) */
+    widgetStates: Record<string, Partial<WidgetState>>;
+    /** Per-server configurations */
+    serverConfigs?: Record<string, {
+        layoutId: string;
+    }>;
+}
+/**
+ * Default dashboard configuration
+ */
+export declare const DEFAULT_DASHBOARD_CONFIG: DashboardConfig;
+/**
+ * Widget event types
+ */
+export type WidgetEventType = 'refresh' | 'collapse' | 'expand' | 'resize' | 'move' | 'hide' | 'show';
+/**
+ * Widget event
+ */
+export interface WidgetEvent {
+    type: WidgetEventType;
+    widgetId: string;
+    timestamp: number;
+    payload?: unknown;
+}
+/**
+ * Check if tier meets minimum requirement
+ */
+export declare function tierMeetsMinimum(userTier: Tier, minTier: Tier): boolean;
+/**
+ * Get effective widget size accounting for column constraints
+ */
+export declare function getEffectiveSize(size: WidgetSize, availableColumns: number): WidgetSize;
+/**
+ * Calculate widget dimensions in characters
+ */
+export declare function calculateWidgetDimensions(size: WidgetSize, terminalWidth: number, totalColumns: number): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=widget-types.d.ts.map

package/dist/ui/widgets/widget-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-types.d.ts","sourceRoot":"","sources":["../../../src/ui/widgets/widget-types.ts"],"names":[],"mappings":"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"}

package/dist/workflows/backup.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Backup Workflow
+ *
+ * Handles backup creation, restoration, and management
+ */
+import { EventEmitter } from 'node:events';
+import { type RestoreOptions } from '../infrastructure/backup.js';
+/**
+ * Backup type
+ */
+export type BackupType = 'plugins' | 'config' | 'full';
+/**
+ * Backup metadata
+ */
+export interface BackupMetadata {
+    filename: string;
+    path: string;
+    type: BackupType;
+    created: Date;
+    size: number;
+    fileCount?: number;
+    description?: string;
+}
+/**
+ * Backup progress event
+ */
+export interface BackupProgress {
+    phase: 'scanning' | 'compressing' | 'writing' | 'done' | 'error';
+    current?: number;
+    total?: number;
+    filename?: string;
+    message?: string;
+}
+/**
+ * Backup workflow options
+ */
+export interface BackupWorkflowOptions {
+    backupDir: string;
+    maxBackups?: number;
+    description?: string;
+    onProgress?: (progress: BackupProgress) => void;
+}
+/**
+ * Backup workflow class
+ */
+export declare class BackupWorkflow extends EventEmitter {
+    private options;
+    constructor(options: BackupWorkflowOptions);
+    /**
+     * Create a backup of a directory
+     */
+    create(sourceDir: string, type?: BackupType): Promise<BackupMetadata>;
+    /**
+     * Restore a backup
+     */
+    restore(backupPath: string, targetDir: string, options?: RestoreOptions): Promise<{
+        restoredFiles: number;
+    }>;
+    /**
+     * List available backups
+     */
+    list(type?: BackupType): Promise<BackupMetadata[]>;
+    /**
+     * Delete a backup
+     */
+    delete(backupPath: string): Promise<void>;
+    /**
+     * Delete old backups, keeping only the specified number
+     */
+    cleanup(type: BackupType, keepCount: number): Promise<string[]>;
+    /**
+     * Get backup contents without extracting
+     */
+    getContents(backupPath: string): Promise<string[]>;
+    /**
+     * Get detailed backup information
+     */
+    getInfo(backupPath: string): Promise<BackupMetadata & {
+        files: string[];
+    }>;
+}
+/**
+ * Create a backup workflow
+ */
+export declare function createBackupWorkflow(options: BackupWorkflowOptions): BackupWorkflow;
+/**
+ * Quick backup of plugins directory
+ */
+export declare function quickBackup(pluginsDir: string, backupDir: string, description?: string): Promise<BackupMetadata>;
+/**
+ * Quick restore of latest backup
+ */
+export declare function quickRestore(backupDir: string, targetDir: string, type?: BackupType): Promise<{
+    restoredFiles: number;
+} | null>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/workflows/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/workflows/backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAEL,KAAK,cAAc,EAOpB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACjD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAClC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAIlD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,UAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8CtF;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBtH;;OAEG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA6DxD;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUrE;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQxD;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CA2BjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEnF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAOtH;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,UAAsB,GAAG,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAchJ"}

package/dist/workflows/download.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Download Workflow
+ *
+ * Handles downloading plugin files with verification and progress tracking
+ */
+import { EventEmitter } from 'node:events';
+import type { PluginInfo, PluginUpdateInfo } from '../core/types/index.js';
+/**
+ * Download progress event
+ */
+export interface DownloadProgress {
+    pluginName: string;
+    percent: number;
+    bytesDownloaded: number;
+    totalBytes: number;
+    status: 'downloading' | 'verifying' | 'done' | 'error';
+    message?: string;
+}
+/**
+ * Download result
+ */
+export interface DownloadResult {
+    success: boolean;
+    pluginName: string;
+    version: string;
+    filePath: string;
+    bytesDownloaded: number;
+    checksumValid?: boolean;
+    error?: string;
+    backedUpFile?: string;
+}
+/**
+ * Batch download result
+ */
+export interface BatchDownloadResult {
+    successful: DownloadResult[];
+    failed: DownloadResult[];
+    duration: number;
+}
+/**
+ * Download workflow options
+ */
+export interface DownloadWorkflowOptions {
+    targetDir: string;
+    backupExisting?: boolean;
+    backupDir?: string;
+    verifyChecksums?: boolean;
+    strictChecksumVerification?: boolean;
+    useStreaming?: boolean;
+    concurrency?: number;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+/**
+ * Plugin downloader class
+ */
+export declare class PluginDownloader extends EventEmitter {
+    private options;
+    constructor(options: DownloadWorkflowOptions);
+    /**
+     * Download a single plugin
+     */
+    download(info: PluginInfo): Promise<DownloadResult>;
+    /**
+     * Download multiple plugins
+     */
+    downloadBatch(plugins: PluginInfo[]): Promise<BatchDownloadResult>;
+    /**
+     * Download updates from update check results
+     */
+    downloadUpdates(updates: PluginUpdateInfo[]): Promise<BatchDownloadResult>;
+    /**
+     * Get the filename for a plugin
+     */
+    private getFilename;
+}
+/**
+ * Create a plugin downloader
+ */
+export declare function createDownloader(options: DownloadWorkflowOptions): PluginDownloader;
+/**
+ * Quick download a single plugin
+ */
+export declare function quickDownload(info: PluginInfo, targetDir: string, onProgress?: (progress: DownloadProgress) => void): Promise<DownloadResult>;
+//# sourceMappingURL=download.d.ts.map

package/dist/workflows/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/workflows/download.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AA6E3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IACpC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAIpD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAySzD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiDxE;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAchF;;OAEG;IACH,OAAO,CAAC,WAAW;CAepB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAEnF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CASnJ"}

package/dist/workflows/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Workflows module exports
+ */
+export { UpdateChecker, createUpdateChecker, quickUpdateCheck, type UpdateCheckProgress, type UpdateCheckResult, type UpdateCheckOptions, } from './update-check.js';
+export { PluginDownloader, createDownloader, quickDownload, type DownloadProgress, type DownloadResult, type BatchDownloadResult, type DownloadWorkflowOptions, } from './download.js';
+export { SyncWorkflow, createSyncWorkflow, syncProdToTest, type SyncDirection, type SyncAction, type SyncProgress, type SyncResult, type SyncOptions, } from './sync.js';
+export { MigrateWorkflow, createMigrateWorkflow, type MigrationCheck, type MigrateProgress, type MigrateResult, type MigrateOptions, } from './migrate.js';
+export { BackupWorkflow, createBackupWorkflow, quickBackup, quickRestore, type BackupType, type BackupMetadata, type BackupProgress, type BackupWorkflowOptions, } from './backup.js';
+export { downloadServerJar, getLatestBuildInfo, isVersionSupported, listAvailableVersions, type ServerDownloadOptions, type ServerDownloadProgress, } from './server-download.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC"}

package/dist/workflows/migrate.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Migrate Workflow
+ *
+ * Handles migration of plugins between servers with version compatibility
+ */
+import { EventEmitter } from 'node:events';
+import type { SourceRegistry } from '../core/sources/index.js';
+import type { Plugin } from '../core/types/index.js';
+/**
+ * Migration check result for a plugin
+ */
+export interface MigrationCheck {
+    pluginName: string;
+    currentVersion: string;
+    currentMcVersion?: string;
+    targetMcVersion: string;
+    compatible: boolean;
+    latestCompatibleVersion?: string;
+    requiresUpdate: boolean;
+    downloadUrl?: string;
+    status: 'compatible' | 'needs-update' | 'incompatible' | 'unknown';
+    message?: string;
+}
+/**
+ * Migration progress event
+ */
+export interface MigrateProgress {
+    current: number;
+    total: number;
+    pluginName: string;
+    phase: 'checking' | 'downloading' | 'copying' | 'done' | 'error';
+    status: string;
+    message?: string;
+}
+/**
+ * Migration result
+ */
+export interface MigrateResult {
+    sourceDir: string;
+    targetDir: string;
+    targetMcVersion: string;
+    migrated: string[];
+    updated: string[];
+    skipped: string[];
+    incompatible: string[];
+    errors: Array<{
+        pluginName: string;
+        error: string;
+    }>;
+    duration: number;
+    backupPath?: string;
+}
+/**
+ * Migration options
+ */
+export interface MigrateOptions {
+    sourceDir: string;
+    targetDir: string;
+    targetMcVersion: string;
+    plugins?: Plugin[];
+    sourceRegistry?: SourceRegistry;
+    downloadUpdates?: boolean;
+    createBackup?: boolean;
+    backupDir?: string;
+    skipIncompatible?: boolean;
+    forceCopy?: boolean;
+    dryRun?: boolean;
+    onProgress?: (progress: MigrateProgress) => void;
+}
+/**
+ * Migration workflow class
+ */
+export declare class MigrateWorkflow extends EventEmitter {
+    private options;
+    constructor(options: MigrateOptions);
+    /**
+     * Execute migration
+     */
+    migrate(): Promise<MigrateResult>;
+    /**
+     * Check compatibility of a plugin with target Minecraft version
+     */
+    private checkCompatibility;
+    /**
+     * Get source identifier from plugin config
+     */
+    private getSourceIdentifier;
+    /**
+     * Get migration preview
+     */
+    preview(): Promise<MigrationCheck[]>;
+}
+/**
+ * Create a migration workflow
+ */
+export declare function createMigrateWorkflow(options: MigrateOptions): MigrateWorkflow;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/workflows/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/workflows/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAA6B,MAAM,wBAAwB,CAAC;AAMhF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IACnC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAI3C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IA4KvC;;OAEG;YACW,kBAAkB;IAiDhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAkB3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAE9E"}

package/dist/workflows/rollback.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Plugin Rollback Workflow
+ *
+ * Provides functionality to roll back plugins to previous versions
+ * using version history and backup files.
+ *
+ * @since v1.22.0
+ */
+import { EventEmitter } from 'node:events';
+import { type PluginVersionEntry, type VersionHistoryService } from '../core/history/index.js';
+/**
+ * Options for rollback operation
+ */
+export interface RollbackOptions {
+    /** Target plugin name */
+    pluginName: string;
+    /** Version to rollback to */
+    targetVersion: string;
+    /** Directory containing plugin JARs */
+    pluginsDir: string;
+    /** Whether to backup current version before rollback */
+    backupCurrent?: boolean;
+    /** Version history service instance */
+    versionHistory?: VersionHistoryService;
+}
+/**
+ * Result of a rollback operation
+ */
+export interface RollbackResult {
+    /** Whether rollback succeeded */
+    success: boolean;
+    /** Plugin name */
+    pluginName: string;
+    /** Version before rollback */
+    fromVersion: string;
+    /** Version after rollback */
+    toVersion: string;
+    /** Path to restored JAR */
+    restoredJarPath?: string;
+    /** Path to backup of previous version */
+    previousVersionBackup?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Progress event during rollback
+ */
+export interface RollbackProgress {
+    /** Current step */
+    step: 'validating' | 'backing-up' | 'restoring' | 'verifying' | 'complete';
+    /** Description of current action */
+    message: string;
+    /** Plugin being rolled back */
+    pluginName: string;
+}
+/**
+ * Create a single-file backup for rollback
+ */
+export declare function backupPluginForRollback(jarPath: string): Promise<string>;
+/**
+ * Rollback Workflow
+ *
+ * Handles plugin version rollbacks with backup and verification.
+ */
+export declare class RollbackWorkflow extends EventEmitter {
+    private versionHistory;
+    constructor(versionHistory?: VersionHistoryService);
+    /**
+     * Emit progress event
+     */
+    private emitProgress;
+    /**
+     * Rollback a plugin to a specific version
+     */
+    rollback(options: RollbackOptions): Promise<RollbackResult>;
+    /**
+     * Rollback to the previous version
+     */
+    rollbackToPrevious(pluginName: string, pluginsDir: string, currentVersion?: string): Promise<RollbackResult>;
+    /**
+     * Get available rollback options for a plugin
+     */
+    getRollbackOptions(pluginName: string, currentVersion?: string): Promise<PluginVersionEntry[]>;
+    /**
+     * Check if rollback is available
+     */
+    hasRollbackAvailable(pluginName: string, currentVersion?: string): Promise<boolean>;
+    /**
+     * Clean up old rollback backups
+     */
+    cleanupOldBackups(maxAgeDays?: number): Promise<number>;
+}
+/**
+ * Get the singleton rollback workflow instance
+ */
+export declare function getRollbackWorkflow(): RollbackWorkflow;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetRollbackWorkflow(): void;
+/**
+ * Create a new rollback workflow with custom dependencies
+ */
+export declare function createRollbackWorkflow(versionHistory?: VersionHistoryService): RollbackWorkflow;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/workflows/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/workflows/rollback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAA4B,MAAM,0BAA0B,CAAC;AAOzH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3E,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAwCD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9E;AA6BD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,cAAc,CAAwB;gBAElC,cAAc,CAAC,EAAE,qBAAqB;IAKlD;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAsMjE;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA0BlH;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKpG;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzF;;OAEG;IACG,iBAAiB,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CA6B1D;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,CAAC,EAAE,qBAAqB,GAAG,gBAAgB,CAE/F"}