@nindroidsystems/pluginator 2.3.0

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

@@ -0,0 +1,151 @@
+/**
+ * Preview Types
+ *
+ * Type definitions for dry run / operation preview functionality.
+ *
+ * @since v1.32.0
+ */
+/**
+ * Types of operations that can be previewed
+ */
+export type OperationType = 'sync' | 'migrate' | 'update' | 'download' | 'backup' | 'restore' | 'batch-update';
+/**
+ * Types of changes that can occur
+ */
+export type ChangeType = 'add' | 'remove' | 'modify' | 'unchanged' | 'skip' | 'conflict';
+/**
+ * A single file/plugin change
+ */
+export interface FileChange {
+    /** Type of change */
+    type: ChangeType;
+    /** Full path to the file */
+    path: string;
+    /** Filename only */
+    filename: string;
+    /** Plugin name (if applicable) */
+    pluginName?: string;
+    /** Current/old version */
+    oldVersion?: string;
+    /** New version to be installed */
+    newVersion?: string;
+    /** Current file size in bytes */
+    oldSize?: number;
+    /** New file size in bytes */
+    newSize?: number;
+    /** Human-readable reason for this change */
+    reason?: string;
+    /** Source of the new file (modrinth, spigot, etc.) */
+    source?: string;
+}
+/**
+ * Summary of all changes
+ */
+export interface PreviewSummary {
+    /** Total number of changes (excluding unchanged) */
+    totalChanges: number;
+    /** Files to be added */
+    added: number;
+    /** Files to be removed */
+    removed: number;
+    /** Files to be modified/updated */
+    modified: number;
+    /** Files that won't change */
+    unchanged: number;
+    /** Files being skipped */
+    skipped: number;
+    /** Files with conflicts */
+    conflicts: number;
+    /** Net size change in bytes (negative = freeing space) */
+    totalSizeChange: number;
+    /** Total download size in bytes */
+    totalDownloadSize: number;
+}
+/**
+ * Complete operation preview
+ */
+export interface OperationPreview {
+    /** Type of operation */
+    operation: OperationType;
+    /** When preview was generated */
+    timestamp: string;
+    /** Operation-specific title */
+    title: string;
+    /** Operation-specific description */
+    description?: string;
+    /** Summary of changes */
+    summary: PreviewSummary;
+    /** List of individual changes */
+    changes: FileChange[];
+    /** Warning messages */
+    warnings: string[];
+    /** Error messages that would prevent operation */
+    errors: string[];
+    /** Estimated duration in milliseconds */
+    estimatedDuration?: number;
+    /** Space required in bytes */
+    spaceRequired?: number;
+    /** Space that would be freed in bytes */
+    spaceFreed?: number;
+    /** Whether the operation can proceed */
+    canProceed: boolean;
+}
+/**
+ * Options for generating previews
+ */
+export interface PreviewOptions {
+    /** Include unchanged files in the preview */
+    includeUnchanged?: boolean;
+    /** Calculate estimated time */
+    estimateTime?: boolean;
+    /** Check disk space availability */
+    checkSpace?: boolean;
+    /** Include detailed reasons for each change */
+    includeReasons?: boolean;
+}
+/**
+ * Direction for sync operations
+ */
+export type SyncDirection = 'prod-to-test' | 'test-to-prod';
+/**
+ * Plugin info for update previews
+ */
+export interface PluginUpdateInfo {
+    name: string;
+    currentVersion: string;
+    newVersion: string;
+    source: string;
+    downloadUrl?: string;
+    downloadSize?: number;
+    releaseNotes?: string;
+}
+/**
+ * Default preview options
+ */
+export declare const DEFAULT_PREVIEW_OPTIONS: PreviewOptions;
+/**
+ * Estimated time per operation type (ms per file)
+ */
+export declare const ESTIMATED_TIME_PER_FILE: {
+    copy: number;
+    download: number;
+    backup: number;
+    restore: number;
+};
+/**
+ * Create empty preview summary
+ */
+export declare function createEmptyPreviewSummary(): PreviewSummary;
+/**
+ * Create empty operation preview
+ */
+export declare function createEmptyPreview(operation: OperationType, title: string): OperationPreview;
+/**
+ * Get change type symbol for display
+ */
+export declare function getChangeSymbol(type: ChangeType): string;
+/**
+ * Get change type color for display
+ */
+export declare function getChangeColor(type: ChangeType): string;
+//# sourceMappingURL=preview-types.d.ts.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Profiles Module
+ *
+ * Exports for plugin profile management.
+ *
+ * @since v1.33.0
+ */
+export { type ApplyMode, type ApplyProfileOptions, type ApplyProfileResult, type CreateProfileOptions, type PluginProfile, type ProfileColor, type ProfileDiff, type ProfileFavoritesStore, type ProfileFilterPreferences, type ProfileGroup, type ProfileGroupStore, type ProfilePlugin, type ProfilePluginDiff, type ProfileStore, type ProfileTag, type ProfileTagStore, PROFILE_STORE_VERSION, DEFAULT_APPLY_OPTIONS, createEmptyApplyResult, createEmptyProfileStore, generateProfileId, } from './profile-types.js';
+export { ProfileService, type ProfileDataProvider, getProfileService, resetProfileService, } from './profile-service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/profiles/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/core/profiles/profile-service.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Profile Service
+ *
+ * Manages plugin profiles (server configurations).
+ *
+ * @since v1.33.0
+ */
+import { type ApplyProfileOptions, type ApplyProfileResult, type CreateProfileOptions, type PluginProfile, type ProfileColor, type ProfileDiff, type ProfilePlugin, type ProfileStore } from './profile-types.js';
+/**
+ * Data provider for getting current configuration
+ */
+export interface ProfileDataProvider {
+    /** Get current plugins configuration */
+    getCurrentPlugins?: () => ProfilePlugin[];
+    /** Get current tags configuration */
+    getCurrentTags?: () => {
+        tags: Array<{
+            id: string;
+            name: string;
+            color: string;
+        }>;
+        assignments: Array<{
+            pluginName: string;
+            tagIds: string[];
+        }>;
+    } | null;
+    /** Get current groups configuration */
+    getCurrentGroups?: () => {
+        groups: Array<{
+            id: string;
+            name: string;
+            color?: string;
+            icon?: string;
+            plugins: string[];
+            order: number;
+        }>;
+    } | null;
+    /** Get current favorites configuration */
+    getCurrentFavorites?: () => {
+        favorites: Array<{
+            pluginName: string;
+            note?: string;
+        }>;
+        pinned: Array<{
+            pluginName: string;
+            order: number;
+        }>;
+    } | null;
+}
+/**
+ * Profile service for managing plugin profiles
+ */
+export declare class ProfileService {
+    private store;
+    private provider;
+    private filePath;
+    constructor(initialStore?: ProfileStore, provider?: ProfileDataProvider);
+    /**
+     * Set the data provider
+     */
+    setProvider(provider: ProfileDataProvider): void;
+    /**
+     * Set the file path for persistence
+     */
+    setFilePath(path: string): void;
+    /**
+     * Get the file path
+     */
+    getFilePath(): string | null;
+    /**
+     * Create a new profile
+     */
+    createProfile(options: CreateProfileOptions): PluginProfile;
+    /**
+     * Update an existing profile
+     */
+    updateProfile(id: string, updates: Partial<Omit<PluginProfile, 'id' | 'createdAt'>>): PluginProfile | null;
+    /**
+     * Delete a profile
+     */
+    deleteProfile(id: string): boolean;
+    /**
+     * Get a profile by ID
+     */
+    getProfile(id: string): PluginProfile | null;
+    /**
+     * Get a profile by name
+     */
+    getProfileByName(name: string): PluginProfile | null;
+    /**
+     * Get all profiles
+     */
+    getProfiles(): PluginProfile[];
+    /**
+     * Get profile count
+     */
+    getProfileCount(): number;
+    /**
+     * Get the active profile
+     */
+    getActiveProfile(): PluginProfile | null;
+    /**
+     * Set the active profile
+     */
+    setActiveProfile(id: string | null): boolean;
+    /**
+     * Check if a profile is active
+     */
+    isActiveProfile(id: string): boolean;
+    /**
+     * Clone a profile
+     */
+    cloneProfile(id: string, newName: string): PluginProfile | null;
+    /**
+     * Save current configuration to a profile
+     */
+    snapshotToProfile(id: string): boolean;
+    /**
+     * Apply a profile (dry run only - returns what would change)
+     */
+    applyProfile(id: string, options?: ApplyProfileOptions): ApplyProfileResult;
+    /**
+     * Get changes between two plugin configurations
+     */
+    private getPluginChanges;
+    /**
+     * Compare two profiles
+     */
+    compareProfiles(profileAId: string, profileBId: string): ProfileDiff | null;
+    /**
+     * Compare a profile with current configuration
+     */
+    compareWithCurrent(profileId: string): ProfileDiff | null;
+    /**
+     * Diff two plugin lists
+     */
+    private diffPluginLists;
+    /**
+     * Get detailed diff between two plugin configs
+     */
+    private getPluginDiff;
+    /**
+     * Export a profile to JSON string
+     */
+    exportProfile(id: string): string | null;
+    /**
+     * Import a profile from JSON string
+     */
+    importProfile(data: string): PluginProfile | null;
+    /**
+     * Search profiles by name or description
+     */
+    searchProfiles(query: string): PluginProfile[];
+    /**
+     * Get profiles by color
+     */
+    getProfilesByColor(color: ProfileColor): PluginProfile[];
+    /**
+     * Serialize for persistence
+     */
+    serialize(): string;
+    /**
+     * Load from serialized data
+     */
+    static fromSerialized(data: string, provider?: ProfileDataProvider): ProfileService;
+    /**
+     * Get the raw store
+     */
+    getStore(): ProfileStore;
+    /**
+     * Reset the service
+     */
+    reset(): void;
+}
+/**
+ * Get the singleton profile service
+ */
+export declare function getProfileService(): ProfileService;
+/**
+ * Reset the singleton
+ */
+export declare function resetProfileService(): void;
+//# sourceMappingURL=profile-service.d.ts.map

package/dist/core/profiles/profile-service.d.ts.map

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

package/dist/core/profiles/profile-types.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Profile Types
+ *
+ * Type definitions for plugin profiles (server configurations).
+ *
+ * @since v1.33.0
+ */
+import type { PluginSourceType } from '../types/plugin.js';
+/**
+ * Profile store version
+ */
+export declare const PROFILE_STORE_VERSION = "1.0";
+/**
+ * Available profile colors
+ */
+export type ProfileColor = 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'gray';
+/**
+ * Plugin configuration within a profile
+ */
+export interface ProfilePlugin {
+    /** Plugin name */
+    name: string;
+    /** Source type */
+    source: PluginSourceType;
+    /** Source-specific ID */
+    sourceId?: string;
+    /** Locked version (if any) */
+    version?: string;
+    /** Version constraint (e.g., ">=5.4.0", "~5.4.0") */
+    versionConstraint?: string;
+    /** Whether the plugin is enabled */
+    enabled: boolean;
+    /** Whether auto-update is enabled */
+    autoUpdate: boolean;
+    /** Tag IDs assigned to this plugin */
+    tags?: string[];
+    /** Group ID this plugin belongs to */
+    group?: string;
+}
+/**
+ * Tag configuration within a profile
+ */
+export interface ProfileTag {
+    id: string;
+    name: string;
+    color: string;
+    isSystem?: boolean;
+}
+/**
+ * Tags store within a profile
+ */
+export interface ProfileTagStore {
+    tags: ProfileTag[];
+    assignments: Array<{
+        pluginName: string;
+        tagIds: string[];
+    }>;
+}
+/**
+ * Group configuration within a profile
+ */
+export interface ProfileGroup {
+    id: string;
+    name: string;
+    color?: string;
+    icon?: string;
+    plugins: string[];
+    order: number;
+}
+/**
+ * Groups store within a profile
+ */
+export interface ProfileGroupStore {
+    groups: ProfileGroup[];
+}
+/**
+ * Favorites store within a profile
+ */
+export interface ProfileFavoritesStore {
+    favorites: Array<{
+        pluginName: string;
+        note?: string;
+    }>;
+    pinned: Array<{
+        pluginName: string;
+        order: number;
+    }>;
+}
+/**
+ * Filter preferences within a profile
+ */
+export interface ProfileFilterPreferences {
+    defaultFilters?: string[];
+    savedFilterSets?: Array<{
+        name: string;
+        filters: string[];
+    }>;
+}
+/**
+ * A complete plugin profile
+ */
+export interface PluginProfile {
+    /** Unique profile ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Icon (emoji) */
+    icon?: string;
+    /** Color for display */
+    color?: ProfileColor;
+    /** When the profile was created */
+    createdAt: string;
+    /** When the profile was last updated */
+    updatedAt: string;
+    /** Whether this is the default profile */
+    isDefault?: boolean;
+    /** Whether the profile is locked from modification */
+    locked?: boolean;
+    /** Plugins in this profile */
+    plugins: ProfilePlugin[];
+    /** Tags configuration */
+    tags?: ProfileTagStore;
+    /** Groups configuration */
+    groups?: ProfileGroupStore;
+    /** Favorites configuration */
+    favorites?: ProfileFavoritesStore;
+    /** Filter preferences */
+    filterPreferences?: ProfileFilterPreferences;
+}
+/**
+ * Profile store (persisted data)
+ */
+export interface ProfileStore {
+    /** Store version */
+    version: string;
+    /** Currently active profile ID */
+    activeProfileId: string | null;
+    /** All profiles */
+    profiles: PluginProfile[];
+}
+/**
+ * Options for creating a profile
+ */
+export interface CreateProfileOptions {
+    /** Profile name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Icon */
+    icon?: string;
+    /** Color */
+    color?: ProfileColor;
+    /** Create from current configuration */
+    fromCurrent?: boolean;
+    /** Clone from existing profile ID */
+    fromProfile?: string;
+}
+/**
+ * Mode for applying a profile
+ */
+export type ApplyMode = 'replace' | 'merge';
+/**
+ * Options for applying a profile
+ */
+export interface ApplyProfileOptions {
+    /** How to apply the profile */
+    mode: ApplyMode;
+    /** Download plugins that aren't installed */
+    downloadMissing?: boolean;
+    /** Remove plugins not in the profile (only for replace mode) */
+    removeExtra?: boolean;
+    /** Preview only, don't apply changes */
+    dryRun?: boolean;
+}
+/**
+ * Result of applying a profile
+ */
+export interface ApplyProfileResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Plugins that were added */
+    added: string[];
+    /** Plugins that were removed/disabled */
+    removed: string[];
+    /** Plugins that were modified */
+    modified: Array<{
+        name: string;
+        changes: string[];
+    }>;
+    /** Plugins that were downloaded */
+    downloaded: string[];
+    /** Errors encountered */
+    errors: Array<{
+        plugin: string;
+        error: string;
+    }>;
+}
+/**
+ * Difference between plugin configurations
+ */
+export interface ProfilePluginDiff {
+    /** Version change */
+    version?: {
+        from: string;
+        to: string;
+    };
+    /** Enabled state change */
+    enabled?: {
+        from: boolean;
+        to: boolean;
+    };
+    /** Auto-update change */
+    autoUpdate?: {
+        from: boolean;
+        to: boolean;
+    };
+    /** Source change */
+    source?: {
+        from: PluginSourceType;
+        to: PluginSourceType;
+    };
+}
+/**
+ * Difference between two profiles
+ */
+export interface ProfileDiff {
+    /** Plugins only in the first profile */
+    onlyInA: ProfilePlugin[];
+    /** Plugins only in the second profile */
+    onlyInB: ProfilePlugin[];
+    /** Plugins that differ between profiles */
+    modified: Array<{
+        plugin: string;
+        changes: ProfilePluginDiff;
+        pluginA: ProfilePlugin;
+        pluginB: ProfilePlugin;
+    }>;
+    /** Plugins that are the same in both */
+    unchanged: ProfilePlugin[];
+}
+/**
+ * Default apply options
+ */
+export declare const DEFAULT_APPLY_OPTIONS: ApplyProfileOptions;
+/**
+ * Create empty profile store
+ */
+export declare function createEmptyProfileStore(): ProfileStore;
+/**
+ * Create empty apply result
+ */
+export declare function createEmptyApplyResult(): ApplyProfileResult;
+/**
+ * Generate a unique profile ID
+ */
+export declare function generateProfileId(): string;
+//# sourceMappingURL=profile-types.d.ts.map

package/dist/core/profiles/profile-types.d.ts.map

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

package/dist/core/recommendations/algorithms/cooccurrence.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Co-occurrence Algorithm
+ *
+ * Recommends plugins that are frequently used together with
+ * the user's installed plugins (collaborative filtering).
+ *
+ * @since v1.66.0
+ */
+import type { AlgorithmResult, CooccurrenceEntry, Recommendation, RecommendationContext } from '../recommendation-types.js';
+/**
+ * Co-occurrence matrix for tracking plugin relationships
+ */
+export declare class CooccurrenceMatrix {
+    private matrix;
+    private totalServers;
+    /**
+     * Add a co-occurrence observation
+     */
+    addObservation(pluginA: string, pluginB: string, probability: number, sampleSize?: number): void;
+    /**
+     * Get co-occurrence probability between two plugins
+     */
+    getProbability(pluginA: string, pluginB: string): number;
+    /**
+     * Get all related plugins for a given plugin
+     */
+    getRelated(pluginId: string): Array<{
+        pluginId: string;
+        probability: number;
+    }>;
+    /**
+     * Get all entries in the matrix
+     */
+    getAllEntries(): CooccurrenceEntry[];
+    /**
+     * Load data from array of entries
+     */
+    loadFromEntries(entries: CooccurrenceEntry[]): void;
+    /**
+     * Clear the matrix
+     */
+    clear(): void;
+    /**
+     * Get matrix size
+     */
+    size(): number;
+}
+/**
+ * Default co-occurrence data based on common plugin combinations
+ */
+export declare const DEFAULT_COOCCURRENCE_DATA: CooccurrenceEntry[];
+/**
+ * Find plugins frequently used together with installed plugins
+ */
+export declare function findComplementaryPlugins(context: RecommendationContext, matrix: CooccurrenceMatrix, maxResults?: number): Recommendation[];
+/**
+ * Create default co-occurrence matrix
+ */
+export declare function createDefaultMatrix(): CooccurrenceMatrix;
+/**
+ * Run the co-occurrence algorithm
+ */
+export declare function runCooccurrenceAlgorithm(context: RecommendationContext, matrix?: CooccurrenceMatrix, maxResults?: number): AlgorithmResult;
+//# sourceMappingURL=cooccurrence.d.ts.map