@nindroidsystems/pluginator 2.3.0

package/dist/core/health/alert-engine.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Health Alert Engine
+ *
+ * Evaluates alert rules against plugin health data and manages alerts.
+ *
+ * @since v1.66.0
+ */
+import { type Alert, type AlertCheckResult, type AlertCondition, type AlertConfig, type AlertEngineState, type AlertHistoryEntry, type AlertRule, type AlertSeverity } from './alert-types.js';
+import type { PluginHealthScore, ServerHealthSummary } from './health-types.js';
+/**
+ * Plugin data for alert evaluation
+ */
+export interface PluginAlertData {
+    pluginId: string;
+    pluginName: string;
+    healthScore: PluginHealthScore;
+    previousScore?: PluginHealthScore;
+    isAbandoned: boolean;
+}
+/**
+ * Check if a value matches a condition
+ */
+export declare function evaluateCondition(condition: AlertCondition, value: number | string | boolean): boolean;
+/**
+ * Get value to check from plugin data based on condition type
+ */
+export declare function getConditionValue(condition: AlertCondition, plugin: PluginAlertData): number | string | boolean | null;
+/**
+ * Check if a rule should be skipped due to cooldown
+ */
+export declare function isOnCooldown(ruleId: string, cooldowns: Record<string, number>, cooldownHours: number): boolean;
+/**
+ * Evaluate a single rule against plugin data
+ */
+export declare function evaluateRule(rule: AlertRule, plugin: PluginAlertData, cooldowns: Record<string, number>, cooldownMultiplier?: number): Alert | null;
+/**
+ * Check if an alert should be resolved
+ */
+export declare function shouldResolveAlert(alert: Alert, rule: AlertRule, plugin: PluginAlertData | undefined): boolean;
+/**
+ * Health Alert Engine class
+ */
+export declare class HealthAlertEngine {
+    private config;
+    private state;
+    private alertsToday;
+    private lastDayReset;
+    constructor(config?: AlertConfig);
+    /**
+     * Get current configuration
+     */
+    getConfig(): AlertConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<AlertConfig>): void;
+    /**
+     * Get current state
+     */
+    getState(): AlertEngineState;
+    /**
+     * Get active alerts
+     */
+    getActiveAlerts(): Alert[];
+    /**
+     * Get alert history
+     */
+    getHistory(limit?: number): AlertHistoryEntry[];
+    /**
+     * Check plugins against all rules
+     */
+    checkPlugins(plugins: PluginAlertData[], summary?: ServerHealthSummary): AlertCheckResult;
+    /**
+     * Acknowledge an alert
+     */
+    acknowledgeAlert(alertId: string): boolean;
+    /**
+     * Manually resolve an alert
+     */
+    resolveAlert(alertId: string): boolean;
+    /**
+     * Add or update a rule
+     */
+    setRule(rule: AlertRule): void;
+    /**
+     * Remove a rule
+     */
+    removeRule(ruleId: string): boolean;
+    /**
+     * Enable/disable a rule
+     */
+    toggleRule(ruleId: string, enabled: boolean): boolean;
+    /**
+     * Get alerts by severity
+     */
+    getAlertsBySeverity(severity: AlertSeverity): Alert[];
+    /**
+     * Get critical alert count
+     */
+    getCriticalCount(): number;
+    /**
+     * Clear all alerts
+     */
+    clearAllAlerts(): void;
+    /**
+     * Clear alert history
+     */
+    clearHistory(): void;
+    /**
+     * Reset daily alert counter
+     */
+    private checkDailyReset;
+    /**
+     * Export state for persistence
+     */
+    exportState(): AlertEngineState;
+    /**
+     * Import state from persistence
+     */
+    importState(state: AlertEngineState): void;
+}
+/**
+ * Create a health alert engine instance
+ */
+export declare function createAlertEngine(config?: AlertConfig): HealthAlertEngine;
+//# sourceMappingURL=alert-engine.d.ts.map

package/dist/core/health/alert-engine.d.ts.map

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

package/dist/core/health/alert-types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Health Alert Types
+ *
+ * Type definitions for the health alert system.
+ *
+ * @since v1.66.0
+ */
+/**
+ * Alert condition types
+ */
+export type AlertConditionType = 'health_score' | 'component_score' | 'specific_issue' | 'trend' | 'event' | 'vulnerability' | 'abandonment';
+/**
+ * Comparison operators for alert conditions
+ */
+export type AlertOperator = '<' | '>' | '<=' | '>=' | '==' | '!=' | 'contains' | 'not_contains';
+/**
+ * Alert notification channels
+ */
+export type AlertChannel = 'ui' | 'desktop' | 'webhook' | 'log';
+/**
+ * Alert severity levels
+ */
+export type AlertSeverity = 'critical' | 'warning' | 'info';
+/**
+ * Alert condition definition
+ */
+export interface AlertCondition {
+    /** Type of condition */
+    type: AlertConditionType;
+    /** Comparison operator */
+    operator: AlertOperator;
+    /** Value to compare against */
+    value: number | string;
+    /** Specific component to check (for component_score type) */
+    component?: 'version' | 'compatibility' | 'maintenance' | 'dependencies' | 'security';
+    /** Filter to specific plugins */
+    plugins?: string[];
+    /** Filter to specific issue types */
+    issueTypes?: string[];
+}
+/**
+ * Alert rule definition
+ */
+export interface AlertRule {
+    /** Unique rule ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what this rule checks */
+    description?: string;
+    /** The condition to evaluate */
+    condition: AlertCondition;
+    /** Alert severity when triggered */
+    severity: AlertSeverity;
+    /** Channels to notify */
+    notifyVia: AlertChannel[];
+    /** Cooldown period in hours before re-alerting */
+    cooldown: number;
+    /** Whether to auto-resolve when condition no longer met */
+    autoResolve: boolean;
+    /** Whether this rule is enabled */
+    enabled: boolean;
+    /** Custom message template */
+    messageTemplate?: string;
+}
+/**
+ * Alert instance (a triggered alert)
+ */
+export interface Alert {
+    /** Unique alert instance ID */
+    id: string;
+    /** Rule that triggered this alert */
+    ruleId: string;
+    /** Rule name for display */
+    ruleName: string;
+    /** Severity level */
+    severity: AlertSeverity;
+    /** Alert title */
+    title: string;
+    /** Alert message */
+    message: string;
+    /** Affected plugin(s) */
+    affectedPlugins: string[];
+    /** When the alert was triggered */
+    triggeredAt: number;
+    /** When the alert was acknowledged */
+    acknowledgedAt?: number;
+    /** When the alert was resolved */
+    resolvedAt?: number;
+    /** Whether the alert is currently active */
+    active: boolean;
+    /** Additional context data */
+    context?: Record<string, unknown>;
+}
+/**
+ * Alert history entry
+ */
+export interface AlertHistoryEntry {
+    /** Alert ID */
+    alertId: string;
+    /** Rule ID */
+    ruleId: string;
+    /** Alert title */
+    title: string;
+    /** Severity */
+    severity: AlertSeverity;
+    /** When triggered */
+    triggeredAt: number;
+    /** When resolved */
+    resolvedAt?: number;
+    /** Duration in ms */
+    durationMs?: number;
+    /** Whether it was auto-resolved */
+    autoResolved: boolean;
+}
+/**
+ * Alert engine state
+ */
+export interface AlertEngineState {
+    /** Active alerts */
+    activeAlerts: Alert[];
+    /** Alert history */
+    history: AlertHistoryEntry[];
+    /** Rule cooldown timestamps */
+    cooldowns: Record<string, number>;
+    /** Last check timestamp */
+    lastCheck: number;
+}
+/**
+ * Alert check result
+ */
+export interface AlertCheckResult {
+    /** New alerts triggered */
+    triggered: Alert[];
+    /** Alerts that were resolved */
+    resolved: Alert[];
+    /** Alerts still active */
+    active: Alert[];
+    /** Check timestamp */
+    timestamp: number;
+}
+/**
+ * Webhook notification payload
+ */
+export interface WebhookAlertPayload {
+    /** Alert data */
+    alert: Alert;
+    /** Server name/ID */
+    serverName?: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Severity for filtering */
+    severity: AlertSeverity;
+    /** Source identifier */
+    source: 'pluginator';
+}
+/**
+ * Default alert rules
+ */
+export declare const DEFAULT_ALERT_RULES: AlertRule[];
+/**
+ * Alert configuration
+ */
+export interface AlertConfig {
+    /** Whether alerting is enabled */
+    enabled: boolean;
+    /** Alert rules */
+    rules: AlertRule[];
+    /** Global cooldown multiplier */
+    cooldownMultiplier: number;
+    /** Maximum alerts per day */
+    maxAlertsPerDay: number;
+    /** Webhook URL for notifications */
+    webhookUrl?: string;
+    /** Desktop notifications enabled */
+    desktopNotifications: boolean;
+}
+/**
+ * Default alert configuration
+ */
+export declare const DEFAULT_ALERT_CONFIG: AlertConfig;
+//# sourceMappingURL=alert-types.d.ts.map

package/dist/core/health/alert-types.d.ts.map

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

package/dist/core/health/compatibility-checker.d.ts

@@ -0,0 +1,80 @@
+/**
+ * MC Version Compatibility Checker
+ *
+ * Evaluates plugin compatibility with the current Minecraft server version.
+ *
+ * @since v1.66.0
+ */
+import { type HealthCheckConfig, type HealthComponent } from './health-types.js';
+/**
+ * Minecraft version structure
+ */
+export interface McVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    raw: string;
+}
+/**
+ * Compatibility status
+ */
+export type CompatibilityStatus = 'compatible' | 'likely_compatible' | 'possibly_compatible' | 'outdated' | 'incompatible' | 'unknown';
+/**
+ * Compatibility check result
+ */
+export interface CompatibilityCheckResult {
+    /** Current server MC version */
+    serverVersion: string;
+    /** Plugin's supported MC versions */
+    supportedVersions: string[];
+    /** Compatibility status */
+    status: CompatibilityStatus;
+    /** Score (0-100) */
+    score: number;
+    /** Human-readable description */
+    description: string;
+    /** Highest supported MC version by the plugin */
+    highestSupported: string | null;
+}
+/**
+ * Parse a Minecraft version string
+ */
+export declare function parseMcVersion(version: string): McVersion | null;
+/**
+ * Compare two MC versions
+ * Returns: negative if a < b, positive if a > b, 0 if equal
+ */
+export declare function compareMcVersions(a: McVersion, b: McVersion): number;
+/**
+ * Calculate how many minor versions behind
+ */
+export declare function getMinorVersionsBehind(current: McVersion, supported: McVersion): number;
+/**
+ * Check if a version string matches or is within range
+ */
+export declare function versionMatches(serverVersion: McVersion, supportedVersion: string): boolean;
+/**
+ * Find the highest supported MC version from a list
+ */
+export declare function findHighestSupportedVersion(versions: string[]): McVersion | null;
+/**
+ * Determine compatibility status
+ */
+export declare function getCompatibilityStatus(serverVersion: McVersion, supportedVersions: string[], knownIncompatible?: boolean): CompatibilityStatus;
+/**
+ * Calculate compatibility score
+ */
+export declare function calculateCompatibilityScore(status: CompatibilityStatus, config?: HealthCheckConfig['compatibilityScoring']): number;
+/**
+ * Get compatibility description
+ */
+export declare function getCompatibilityDescription(serverVersion: string, status: CompatibilityStatus, highestSupported: McVersion | null): string;
+/**
+ * Check MC compatibility and return health component
+ */
+export declare function checkMcCompatibility(serverVersionStr: string, supportedVersions: string[], knownIncompatible?: boolean, config?: HealthCheckConfig['compatibilityScoring']): HealthComponent;
+/**
+ * Full compatibility check result
+ */
+export declare function checkCompatibility(serverVersionStr: string, supportedVersions: string[], knownIncompatible?: boolean, config?: HealthCheckConfig['compatibilityScoring']): CompatibilityCheckResult;
+//# sourceMappingURL=compatibility-checker.d.ts.map

package/dist/core/health/compatibility-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-checker.d.ts","sourceRoot":"","sources":["../../../src/core/health/compatibility-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,mBAAmB,GACnB,qBAAqB,GACrB,UAAU,GACV,cAAc,GACd,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAehE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAQpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAMvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAkC1F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAehF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,iBAAiB,UAAQ,GAAG,mBAAmB,CA+B5I;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAE,iBAAiB,CAAC,sBAAsB,CAA8C,GAAG,MAAM,CAgB/K;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAe1I;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,iBAAiB,UAAQ,EACzB,MAAM,GAAE,iBAAiB,CAAC,sBAAsB,CAA8C,GAC7F,eAAe,CAiCjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,iBAAiB,UAAQ,EACzB,MAAM,GAAE,iBAAiB,CAAC,sBAAsB,CAA8C,GAC7F,wBAAwB,CA0B1B"}

package/dist/core/health/compatibility-matrix.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Compatibility Matrix Service
+ *
+ * Builds and analyzes plugin-to-plugin compatibility.
+ *
+ * @since v1.66.0
+ */
+import { type CompatibilityCheckConfig, type CompatibilityEntry, type CompatibilityMatrix, type CompatibilityMatrixSummary, type CompatibilityStatus, type ConflictResolution, type DependencyGraph, type KnownConflictEntry, type PluginConflict } from './compatibility-types.js';
+/**
+ * Plugin info for compatibility checking
+ */
+export interface PluginCompatInfo {
+    name: string;
+    version: string;
+    hardDeps: string[];
+    softDeps: string[];
+    commands?: string[];
+    permissions?: string[];
+    apiProvides?: string[];
+    apiRequires?: string[];
+}
+/**
+ * Generate matrix key from two plugin names (alphabetically sorted)
+ */
+export declare function getMatrixKey(pluginA: string, pluginB: string): string;
+/**
+ * Check if two plugins have a command conflict
+ */
+export declare function detectCommandConflicts(pluginA: PluginCompatInfo, pluginB: PluginCompatInfo): PluginConflict[];
+/**
+ * Check if two plugins have a permission conflict
+ */
+export declare function detectPermissionConflicts(pluginA: PluginCompatInfo, pluginB: PluginCompatInfo): PluginConflict[];
+/**
+ * Check if two plugins have an API conflict
+ */
+export declare function detectApiConflicts(pluginA: PluginCompatInfo, pluginB: PluginCompatInfo): PluginConflict[];
+/**
+ * Check for version mismatch conflicts based on dependencies
+ */
+export declare function detectVersionMismatch(pluginA: PluginCompatInfo, pluginB: PluginCompatInfo): PluginConflict[];
+/**
+ * Check against known conflict database
+ */
+export declare function checkKnownConflicts(pluginA: PluginCompatInfo, pluginB: PluginCompatInfo, knownConflicts: KnownConflictEntry[]): PluginConflict[];
+/**
+ * Calculate compatibility score from conflicts
+ */
+export declare function calculateCompatibilityScore(conflicts: PluginConflict[]): number;
+/**
+ * Determine compatibility status from score and conflicts
+ */
+export declare function getCompatibilityStatus(score: number, conflicts: PluginConflict[]): CompatibilityStatus;
+/**
+ * Build compatibility entry between two plugins
+ */
+export declare function buildCompatibilityEntry(pluginA: PluginCompatInfo, pluginB: PluginCompatInfo, knownConflicts: KnownConflictEntry[], config?: CompatibilityCheckConfig): CompatibilityEntry;
+/**
+ * Build full compatibility matrix for a set of plugins
+ */
+export declare function buildCompatibilityMatrix(plugins: PluginCompatInfo[], knownConflicts?: KnownConflictEntry[], config?: CompatibilityCheckConfig): CompatibilityMatrix;
+/**
+ * Get compatibility entry between two plugins
+ */
+export declare function getCompatibilityEntry(matrix: CompatibilityMatrix, pluginA: string, pluginB: string): CompatibilityEntry | undefined;
+/**
+ * Get all conflicts for a specific plugin
+ */
+export declare function getPluginConflicts(matrix: CompatibilityMatrix, pluginName: string): PluginConflict[];
+/**
+ * Generate compatibility matrix summary
+ */
+export declare function generateMatrixSummary(matrix: CompatibilityMatrix): CompatibilityMatrixSummary;
+/**
+ * Build dependency graph from plugins
+ */
+export declare function buildDependencyGraph(plugins: PluginCompatInfo[], installedPlugins: Set<string>): DependencyGraph;
+/**
+ * Generate conflict resolution suggestions
+ */
+export declare function generateResolutions(conflicts: PluginConflict[]): ConflictResolution[];
+/**
+ * Get risk level from conflicts
+ */
+export declare function assessRiskLevel(conflicts: PluginConflict[]): 'low' | 'medium' | 'high' | 'critical';
+//# sourceMappingURL=compatibility-matrix.d.ts.map

package/dist/core/health/compatibility-matrix.d.ts.map

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