@nindroidsystems/pluginator 2.3.0

package/dist/core/history/history-service.d.ts

@@ -0,0 +1,170 @@
+/**
+ * History Service
+ *
+ * Manages session history and audit logging.
+ *
+ * @since v1.30.0
+ */
+import { type ActionDetails, type ActionType, type ExportFormat, type HistoryEntry, type HistoryQuery, type HistoryStore, type RecordOptions, type Session } from './history-types.js';
+/**
+ * History service for tracking actions and sessions
+ */
+export declare class HistoryService {
+    private store;
+    private currentSession;
+    private filePath;
+    constructor(initialStore?: HistoryStore);
+    /**
+     * Set the file path for persistence
+     */
+    setFilePath(path: string): void;
+    /**
+     * Get the current file path
+     */
+    getFilePath(): string | null;
+    /**
+     * Start a new session
+     */
+    startSession(environment?: string, version?: string): Session;
+    /**
+     * End the current session
+     */
+    endSession(): Session | null;
+    /**
+     * Get the current session
+     */
+    getCurrentSession(): Session | null;
+    /**
+     * Check if a session is active
+     */
+    hasActiveSession(): boolean;
+    /**
+     * Record an action
+     */
+    record(action: ActionType, details: ActionDetails, options?: RecordOptions): HistoryEntry;
+    /**
+     * Record a successful action
+     */
+    recordSuccess(action: ActionType, details: ActionDetails, duration?: number): HistoryEntry;
+    /**
+     * Record a failed action
+     */
+    recordFailure(action: ActionType, details: ActionDetails, error: string, duration?: number): HistoryEntry;
+    /**
+     * Get recent entries
+     */
+    getRecentEntries(limit?: number): HistoryEntry[];
+    /**
+     * Get entries by action type
+     */
+    getEntriesByAction(action: ActionType): HistoryEntry[];
+    /**
+     * Get entries for a plugin
+     */
+    getEntriesByPlugin(pluginName: string): HistoryEntry[];
+    /**
+     * Get entries for a session
+     */
+    getEntriesBySession(sessionId: string): HistoryEntry[];
+    /**
+     * Get entries by date range
+     */
+    getEntriesByDateRange(startDate: string, endDate: string): HistoryEntry[];
+    /**
+     * Query entries with filters
+     */
+    query(options: HistoryQuery): HistoryEntry[];
+    /**
+     * Get sessions
+     */
+    getSessions(limit?: number): Session[];
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): Session | null;
+    /**
+     * Search entries by text
+     */
+    search(query: string): HistoryEntry[];
+    /**
+     * Get entry count
+     */
+    getEntryCount(): number;
+    /**
+     * Get session count
+     */
+    getSessionCount(): number;
+    /**
+     * Get action counts by type
+     */
+    getActionCounts(): Map<ActionType, number>;
+    /**
+     * Get success/failure counts
+     */
+    getSuccessRate(): {
+        success: number;
+        failure: number;
+        rate: number;
+    };
+    /**
+     * Clean up old entries based on retention policy
+     */
+    cleanup(retentionDays?: number): number;
+    /**
+     * Enforce maximum entries limit
+     */
+    private enforceMaxEntries;
+    /**
+     * Set retention days
+     */
+    setRetentionDays(days: number): void;
+    /**
+     * Get retention days
+     */
+    getRetentionDays(): number;
+    /**
+     * Export history to specified format
+     */
+    export(format: ExportFormat): string;
+    /**
+     * Export as JSON
+     */
+    private exportJSON;
+    /**
+     * Export as CSV
+     */
+    private exportCSV;
+    /**
+     * Summarize details for display
+     */
+    private summarizeDetails;
+    /**
+     * Serialize for persistence
+     */
+    serialize(): string;
+    /**
+     * Load from serialized data
+     */
+    static fromSerialized(data: string): HistoryService;
+    /**
+     * Get the raw store
+     */
+    getStore(): HistoryStore;
+    /**
+     * Reset the service
+     */
+    reset(): void;
+}
+/**
+ * Get the singleton history service
+ */
+export declare function getHistoryService(): HistoryService;
+/**
+ * Reset the singleton
+ */
+export declare function resetHistoryService(): void;
+/**
+ * Wrap an operation with history recording
+ */
+export declare function withHistory<T>(service: HistoryService, action: ActionType, getDetails: (result: T | null) => ActionDetails, operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=history-service.d.ts.map

package/dist/core/history/history-service.d.ts.map

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

package/dist/core/history/history-types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * History Types
+ *
+ * Type definitions for the session history and audit log system.
+ *
+ * @since v1.30.0
+ */
+/**
+ * Types of actions that can be recorded
+ */
+export type ActionType = 'update-check' | 'download' | 'sync' | 'migrate' | 'backup' | 'restore' | 'config-change' | 'plugin-add' | 'plugin-remove' | 'plugin-disable' | 'plugin-enable' | 'tag-assign' | 'tag-remove' | 'group-add' | 'group-remove' | 'favorite-add' | 'favorite-remove' | 'pin-add' | 'pin-remove' | 'scan' | 'session-start' | 'session-end';
+/**
+ * Update check details
+ */
+export interface UpdateCheckDetails {
+    type: 'update-check';
+    pluginCount: number;
+    updatesFound: number;
+    errors: number;
+}
+/**
+ * Download details
+ */
+export interface DownloadDetails {
+    type: 'download';
+    pluginName: string;
+    fromVersion: string;
+    toVersion: string;
+    source: string;
+    fileSize?: number;
+}
+/**
+ * Sync/migrate details
+ */
+export interface SyncDetails {
+    type: 'sync' | 'migrate';
+    direction: 'prod-to-test' | 'test-to-prod';
+    pluginsCopied: number;
+    pluginsSkipped: number;
+}
+/**
+ * Backup/restore details
+ */
+export interface BackupDetails {
+    type: 'backup' | 'restore';
+    backupPath: string;
+    pluginCount: number;
+    totalSize: number;
+}
+/**
+ * Config change details
+ */
+export interface ConfigChangeDetails {
+    type: 'config-change';
+    setting: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+/**
+ * Plugin change details
+ */
+export interface PluginChangeDetails {
+    type: 'plugin-add' | 'plugin-remove' | 'plugin-disable' | 'plugin-enable';
+    pluginName: string;
+    version?: string;
+    source?: string;
+}
+/**
+ * Tag change details
+ */
+export interface TagChangeDetails {
+    type: 'tag-assign' | 'tag-remove';
+    pluginName: string;
+    tagId: string;
+    tagName: string;
+}
+/**
+ * Group change details
+ */
+export interface GroupChangeDetails {
+    type: 'group-add' | 'group-remove';
+    pluginName: string;
+    groupId: string;
+    groupName: string;
+}
+/**
+ * Favorite/pin change details
+ */
+export interface FavoriteChangeDetails {
+    type: 'favorite-add' | 'favorite-remove' | 'pin-add' | 'pin-remove';
+    pluginName: string;
+}
+/**
+ * Scan details
+ */
+export interface ScanDetails {
+    type: 'scan';
+    directory: string;
+    pluginsFound: number;
+    newPlugins: number;
+    removedPlugins: number;
+}
+/**
+ * Session details
+ */
+export interface SessionActionDetails {
+    type: 'session-start' | 'session-end';
+    sessionId: string;
+    environment?: string;
+    version?: string;
+}
+/**
+ * Union of all action details
+ */
+export type ActionDetails = UpdateCheckDetails | DownloadDetails | SyncDetails | BackupDetails | ConfigChangeDetails | PluginChangeDetails | TagChangeDetails | GroupChangeDetails | FavoriteChangeDetails | ScanDetails | SessionActionDetails;
+/**
+ * History entry
+ */
+export interface HistoryEntry {
+    /** Unique entry ID */
+    id: string;
+    /** When the action occurred */
+    timestamp: string;
+    /** Type of action */
+    action: ActionType;
+    /** Action-specific details */
+    details: ActionDetails;
+    /** Session this entry belongs to */
+    sessionId: string;
+    /** Whether the action succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session information
+ */
+export interface Session {
+    /** Unique session ID */
+    id: string;
+    /** When the session started */
+    startTime: string;
+    /** When the session ended */
+    endTime?: string;
+    /** Session duration in milliseconds */
+    duration?: number;
+    /** Number of actions in this session */
+    actionCount: number;
+    /** Environment type */
+    environment: string;
+    /** Pluginator version */
+    version: string;
+}
+/**
+ * History store
+ */
+export interface HistoryStore {
+    /** Store version */
+    version: string;
+    /** All sessions */
+    sessions: Session[];
+    /** All history entries */
+    entries: HistoryEntry[];
+    /** Retention period in days */
+    retentionDays: number;
+}
+/**
+ * Options for recording an action
+ */
+export interface RecordOptions {
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Query options for filtering history
+ */
+export interface HistoryQuery {
+    /** Filter by action type */
+    action?: ActionType;
+    /** Filter by plugin name */
+    pluginName?: string;
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Filter by date range start */
+    startDate?: string;
+    /** Filter by date range end */
+    endDate?: string;
+    /** Filter by success status */
+    success?: boolean;
+    /** Maximum results */
+    limit?: number;
+    /** Skip first N results */
+    offset?: number;
+}
+/**
+ * Export format
+ */
+export type ExportFormat = 'json' | 'csv';
+/**
+ * History store version
+ */
+export declare const HISTORY_STORE_VERSION = "1.0";
+/**
+ * Default retention configuration
+ */
+export declare const RETENTION_CONFIG: {
+    defaultDays: number;
+    maxDays: number;
+    minDays: number;
+    maxEntries: number;
+    cleanupOnStart: boolean;
+};
+/**
+ * Create an empty history store
+ */
+export declare function createEmptyHistoryStore(): HistoryStore;
+/**
+ * Generate a unique ID
+ */
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=history-types.d.ts.map

package/dist/core/history/history-types.d.ts.map

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

package/dist/core/history/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * History Module
+ *
+ * Exports for the session history and audit log system.
+ *
+ * @since v1.30.0
+ */
+export { type ActionDetails, type ActionType, type BackupDetails, type ConfigChangeDetails, type DownloadDetails, type ExportFormat, type FavoriteChangeDetails, type GroupChangeDetails, HISTORY_STORE_VERSION, type HistoryEntry, type HistoryQuery, type HistoryStore, type PluginChangeDetails, RETENTION_CONFIG, type RecordOptions, type ScanDetails, type Session, type SessionActionDetails, type SyncDetails, type TagChangeDetails, type UpdateCheckDetails, createEmptyHistoryStore, generateId, } from './history-types.js';
+export { HistoryService, getHistoryService, resetHistoryService, withHistory } from './history-service.js';
+export { type PluginVersionEntry, type PluginHistory, type VersionHistoryStore, type RollbackConfig, DEFAULT_ROLLBACK_CONFIG, VersionHistoryService, getVersionHistoryService, resetVersionHistoryService, } from './version-history.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG3G,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/core/history/version-history.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Version History Service
+ *
+ * Tracks plugin version history for rollback support.
+ * Records installed versions with metadata for restoration.
+ *
+ * @since v1.22.0
+ */
+import type { PluginSourceType } from '../types/index.js';
+/**
+ * A single version entry in the history
+ */
+export interface PluginVersionEntry {
+    /** The version string */
+    version: string;
+    /** When this version was installed */
+    installedAt: string;
+    /** Original JAR filename */
+    jarFilename: string;
+    /** JAR file size in bytes */
+    jarSize: number;
+    /** SHA256 hash for verification */
+    sha256: string;
+    /** Source that provided this version */
+    source: PluginSourceType;
+    /** Path to backup file containing this version (if available) */
+    backupPath?: string;
+}
+/**
+ * History for a single plugin
+ */
+export interface PluginHistory {
+    /** Plugin name (normalized) */
+    pluginName: string;
+    /** Version entries (newest first) */
+    entries: PluginVersionEntry[];
+}
+/**
+ * Full version history store
+ */
+export interface VersionHistoryStore {
+    /** Schema version for migrations */
+    version: string;
+    /** Last modification timestamp */
+    lastUpdated: string;
+    /** Plugin histories by normalized name */
+    plugins: Record<string, PluginHistory>;
+}
+/**
+ * Rollback configuration
+ */
+export interface RollbackConfig {
+    /** Maximum versions to keep per plugin */
+    maxVersionsPerPlugin: number;
+    /** Maximum days to keep backup files */
+    maxBackupAgeDays: number;
+    /** Maximum total backup storage in bytes */
+    maxBackupSizeBytes: number;
+}
+/**
+ * Default rollback configuration
+ */
+export declare const DEFAULT_ROLLBACK_CONFIG: RollbackConfig;
+/**
+ * Version History Service
+ *
+ * Manages plugin version history for rollback support.
+ */
+export declare class VersionHistoryService {
+    private store;
+    private storagePath;
+    private loaded;
+    private config;
+    constructor(storagePath?: string, config?: Partial<RollbackConfig>);
+    /**
+     * Create an empty store
+     */
+    private createEmptyStore;
+    /**
+     * Load history from disk
+     */
+    load(): Promise<void>;
+    /**
+     * Save history to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Record a new version installation
+     */
+    recordInstall(pluginName: string, entry: Omit<PluginVersionEntry, 'installedAt'>): Promise<void>;
+    /**
+     * Get history for a specific plugin
+     */
+    getHistory(pluginName: string): PluginVersionEntry[];
+    /**
+     * Get a specific version entry
+     */
+    getVersion(pluginName: string, version: string): PluginVersionEntry | null;
+    /**
+     * Get the previous version (one before current)
+     */
+    getPreviousVersion(pluginName: string, currentVersion: string): PluginVersionEntry | null;
+    /**
+     * Get all plugins with rollback history available
+     */
+    getPluginsWithHistory(): string[];
+    /**
+     * Get rollback options for a plugin (versions available for rollback)
+     */
+    getRollbackOptions(pluginName: string, currentVersion?: string): PluginVersionEntry[];
+    /**
+     * Check if rollback is available for a plugin
+     */
+    hasRollbackAvailable(pluginName: string, currentVersion?: string): boolean;
+    /**
+     * Remove a plugin's history
+     */
+    removePlugin(pluginName: string): Promise<void>;
+    /**
+     * Remove a specific version from history
+     */
+    removeVersion(pluginName: string, version: string): Promise<void>;
+    /**
+     * Update backup path for a version
+     */
+    updateBackupPath(pluginName: string, version: string, backupPath: string): Promise<void>;
+    /**
+     * Clear all history
+     */
+    clear(): Promise<void>;
+    /**
+     * Get total number of tracked plugins
+     */
+    getPluginCount(): number;
+    /**
+     * Get total number of version entries
+     */
+    getTotalVersionCount(): number;
+    /**
+     * Get the last updated timestamp
+     */
+    getLastUpdated(): Date | null;
+}
+/**
+ * Get the singleton version history service instance
+ */
+export declare function getVersionHistoryService(): VersionHistoryService;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetVersionHistoryService(): void;
+//# sourceMappingURL=version-history.d.ts.map

package/dist/core/history/version-history.d.ts.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core module exports
+ *
+ * Re-exports all core functionality for easy importing
+ */
+export * from './types/index.js';
+export { parseVersion, cleanVersion, compareVersions, isNewer, isOlder, isEqual, satisfiesRange, getLatestVersion, sortVersions, sortVersionsDescending, isPrerelease, isBuildNumber, formatVersion, isMcVersionCompatible, VersionCompareResult, type ParsedVersion, } from './version.js';
+export { scanJar, scanDirectory, findPluginByName, getAuthorsString, getDependenciesString, matchesFilenamePattern, } from './scanner.js';
+export { PluginManager, createPlugin, validatePlugin } from './plugin-manager.js';
+export { ServerManager } from './server-manager.js';
+export { BasePluginSource, SourceCache, SourceError, SourceRegistry, SpigotSource, ModrinthSource, GitHubSource, WebManifestSource, createWebManifestSource, BukkitSource, SourcesService, getSourcesService, createSourcesService, resetSourcesService, } from './sources/index.js';
+export { MigrationService, getMigrationService, createMigrationService, resetMigrationService, type MigrationItemResult, type MigrationResult, type MigrationOptions, } from './migration/index.js';
+export { UpdaterService, getUpdaterService, createUpdaterService, resetUpdaterService, detectInstallMethod, getInstallMethodDisplayName, getUpdateCommand, supportsAutoUpdate, type InstallMethod, type GitHubRelease, type UpdateInfo, type UpdateCheckCache, } from './updater/index.js';
+export { PreferencesService, getPreferencesService, createPreferencesService } from './preferences/index.js';
+export { ScanCacheService, getScanCacheService, createScanCacheService, resetScanCacheService, } from './cache/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EAGZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAG7G,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/core/migration/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Migration Module Exports
+ */
+export { MigrationService, getMigrationService, createMigrationService, resetMigrationService, type MigrationItemResult, type MigrationResult, type MigrationOptions, } from './migration-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/migration/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC"}