@nindroidsystems/pluginator 2.3.0

package/dist/core/types/plugin.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Plugin type definitions
+ */
+/**
+ * Supported plugin source types
+ */
+export type PluginSourceType = 'spigot' | 'modrinth' | 'github' | 'jenkins' | 'bukkit' | 'web' | 'manual' | 'ninsys' | 'hangar';
+/**
+ * How a source was assigned to a plugin
+ * @since v2.2.0
+ */
+export type AssignmentMethod = 'registry' | 'website-hint' | 'manual' | 'none';
+/**
+ * The primary plugin representation used throughout the application.
+ * Configured in plugins.json
+ */
+export interface Plugin {
+    name: string;
+    type: PluginSourceType;
+    id?: string;
+    jType?: string;
+    version?: string;
+    resourceId?: string;
+    projectSlug?: string;
+    repoSlug?: string;
+    job?: string;
+    mcVersion?: string;
+    filenamePattern?: string;
+    sourceUrl?: string;
+    disableOnTest?: boolean;
+    buildFromSource?: boolean;
+    enabled?: boolean;
+    sourceAssignment?: AssignmentMethod;
+    sourceAssignedAt?: number;
+    registryId?: string;
+}
+/**
+ * Load phase from plugin.yml
+ */
+export type LoadPhase = 'STARTUP' | 'POSTWORLD';
+/**
+ * Represents a plugin extracted from a JAR file's plugin.yml
+ */
+export interface ScannedPlugin {
+    name: string;
+    version: string;
+    main: string;
+    description?: string;
+    author?: string;
+    authors?: string[];
+    website?: string;
+    apiVersion?: string;
+    depend?: string[];
+    softDepend?: string[];
+    loadBefore?: string[];
+    prefix?: string;
+    load?: LoadPhase;
+    jarPath: string;
+    jarFilename: string;
+    fileSize?: number;
+    modifiedTime?: number;
+    valid: boolean;
+    error?: string;
+    disabled?: boolean;
+}
+/**
+ * Information about a plugin from a remote source (API response)
+ */
+export interface PluginInfo {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    downloadUrl: string;
+    minecraftVersion?: string;
+    minecraftVersions?: string[];
+    dependencies?: string[];
+    tags?: string[];
+    categories?: string[];
+    sha256?: string;
+    sha512?: string;
+    sha1?: string;
+    md5?: string;
+    releaseDate?: string;
+    changelog?: string;
+    changelogUrl?: string;
+    license?: string;
+    website?: string;
+    fileSize?: number;
+    downloadCount?: number;
+    sourceType?: PluginSourceType;
+    sourceId?: string;
+    iconUrl?: string;
+    rating?: number;
+    ratingCount?: number;
+    category?: string;
+    stars?: number;
+    prerelease?: boolean;
+}
+/**
+ * Result of checking a plugin for updates
+ */
+export interface PluginUpdateInfo {
+    pluginName: string;
+    currentVersion: string;
+    latestVersion: string;
+    hasUpdate: boolean;
+    latestInfo: PluginInfo;
+    error?: string;
+}
+/**
+ * Plugins configuration file structure
+ */
+export interface PluginsConfig {
+    plugins: Plugin[];
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/types/plugin.d.ts.map

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

package/dist/core/types/preferences.d.ts

@@ -0,0 +1,67 @@
+/**
+ * User Preferences Type Definitions
+ *
+ * Types for user-specific plugin preferences like enable/disable, skip migrate, pinned.
+ * This is separate from plugin definitions (user-registry.ts) to avoid data coupling.
+ *
+ * Data Model (Plan 01):
+ * - Registry: How to find updates (source IDs, patterns)
+ * - Scan Cache: What's actually installed (from JAR scan)
+ * - Preferences: User flags (enable/disable, skip migrate, pinned) <- THIS FILE
+ *
+ * @since v1.50.0
+ */
+/**
+ * User preferences for plugins
+ * Stored at ~/.pluginator/preferences.json
+ */
+export interface PluginPreferences {
+    /** Schema version for migrations */
+    version: 1;
+    /** Last modified timestamp (ISO 8601) */
+    lastModified: string;
+    /** Plugin names disabled on production server */
+    disabledOnProd: string[];
+    /** Plugin names disabled on test server */
+    disabledOnTest: string[];
+    /** Plugin names to skip when migrating to production */
+    skipMigrateToProd: string[];
+    /** Plugin names pinned to top of lists */
+    pinned: string[];
+    /** Plugin names marked as favorites */
+    favorites: string[];
+    /** Notes attached to plugins (plugin name -> note text) */
+    notes: Record<string, string>;
+    /** Plugin names to auto-update without confirmation */
+    autoUpdate?: string[];
+    /** Plugin-specific settings (plugin name -> settings object) */
+    pluginSettings?: Record<string, Record<string, unknown>>;
+}
+/**
+ * Default empty preferences
+ */
+export declare const DEFAULT_PREFERENCES: PluginPreferences;
+/**
+ * Server target for enable/disable operations
+ */
+export type ServerTarget = 'prod' | 'test' | 'both';
+/**
+ * Result of checking plugin preferences
+ */
+export interface PluginPreferenceState {
+    /** Plugin name */
+    name: string;
+    /** Is disabled on production */
+    disabledOnProd: boolean;
+    /** Is disabled on test */
+    disabledOnTest: boolean;
+    /** Should skip migration to production */
+    skipMigrate: boolean;
+    /** Is pinned to top of lists */
+    pinned: boolean;
+    /** Is marked as favorite */
+    favorite: boolean;
+    /** User note (if any) */
+    note?: string;
+}
+//# sourceMappingURL=preferences.d.ts.map

package/dist/core/types/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../src/core/types/preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC;IAEX,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IAIrB,iDAAiD;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,EAAE,CAAC;IAIzB,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAI5B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI9B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBASjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,cAAc,EAAE,OAAO,CAAC;IAExB,0BAA0B;IAC1B,cAAc,EAAE,OAAO,CAAC;IAExB,0CAA0C;IAC1C,WAAW,EAAE,OAAO,CAAC;IAErB,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAEhB,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAElB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/core/types/scan-cache.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Scan Cache Type Definitions
+ *
+ * Types for caching server scan results between sessions.
+ * Prevents "0 plugins" on startup by preserving scan data.
+ *
+ * Data Model (Plan 01):
+ * - Registry: How to find updates (source IDs, patterns)
+ * - Scan Cache: What's actually installed (from JAR scan) <- THIS FILE
+ * - Preferences: User flags (enable/disable, skip migrate, pinned)
+ *
+ * @since v1.50.0
+ */
+import type { ScannedPlugin } from './plugin.js';
+/**
+ * Cached scan results for a single server
+ */
+export interface ServerScanCache {
+    /** Server path that was scanned */
+    path: string;
+    /** Scanned plugins from this server */
+    plugins: ScannedPlugin[];
+    /** Total plugin count (quick access without array length) */
+    pluginCount: number;
+    /** Scan duration in milliseconds */
+    scanDurationMs?: number;
+}
+/**
+ * Full scan cache file structure
+ * Stored at ~/.pluginator/cache/scan-cache.json
+ */
+export interface ScanCache {
+    /** Schema version for migrations */
+    version: 1;
+    /** When the scan was performed (ISO 8601) */
+    timestamp: string;
+    /** Cache time-to-live in milliseconds (default: 24 hours) */
+    ttlMs: number;
+    /** Production server scan results */
+    prod: ServerScanCache;
+    /** Test server scan results */
+    test: ServerScanCache;
+    /** Hash of server paths to detect config changes */
+    pathsHash?: string;
+}
+/**
+ * Default TTL for scan cache (24 hours)
+ */
+export declare const DEFAULT_SCAN_CACHE_TTL_MS: number;
+/**
+ * Minimum TTL for scan cache (1 hour)
+ */
+export declare const MIN_SCAN_CACHE_TTL_MS: number;
+/**
+ * Default empty scan cache
+ */
+export declare function createDefaultScanCache(prodPath: string, testPath: string): ScanCache;
+/**
+ * Result of checking cache validity
+ */
+export interface CacheValidityResult {
+    /** Whether the cache is valid and can be used */
+    valid: boolean;
+    /** Reason if invalid */
+    reason?: 'expired' | 'paths-changed' | 'missing' | 'version-mismatch' | 'corrupted';
+    /** Age of cache in milliseconds (if valid) */
+    ageMs?: number;
+    /** Time until expiry in milliseconds (if valid) */
+    expiresInMs?: number;
+}
+/**
+ * Summary of scan cache state
+ */
+export interface ScanCacheSummary {
+    /** Whether cache exists */
+    exists: boolean;
+    /** Whether cache is valid */
+    valid: boolean;
+    /** Cache timestamp (if exists) */
+    timestamp?: string;
+    /** Production plugin count */
+    prodCount: number;
+    /** Test plugin count */
+    testCount: number;
+    /** Reason if invalid */
+    invalidReason?: string;
+}
+//# sourceMappingURL=scan-cache.d.ts.map

package/dist/core/types/scan-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-cache.d.ts","sourceRoot":"","sources":["../../../src/core/types/scan-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,OAAO,EAAE,aAAa,EAAE,CAAC;IAEzB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC;IAEX,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,IAAI,EAAE,eAAe,CAAC;IAEtB,+BAA+B;IAC/B,IAAI,EAAE,eAAe,CAAC;IAEtB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAsB,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAiB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAgBpF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IAEf,wBAAwB;IACxB,MAAM,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,GAAG,kBAAkB,GAAG,WAAW,CAAC;IAEpF,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAEhB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;IAEf,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/core/types/server.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Server type definitions
+ */
+import type { ScannedPlugin } from './plugin.js';
+/**
+ * Server type enum
+ */
+export declare enum ServerType {
+    Production = "production",
+    Test = "test"
+}
+/**
+ * Represents the scanned state of a server's plugins directory
+ */
+export interface ServerPluginState {
+    serverPath: string;
+    pluginsPath: string;
+    plugins: ScannedPlugin[];
+    lastScanTime: number;
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Represents a version mismatch between production and test servers
+ */
+export interface VersionDifference {
+    pluginName: string;
+    productionVersion: string;
+    testVersion: string;
+    inProduction: boolean;
+    inTest: boolean;
+}
+/**
+ * Progress tracking for long-running scan operations
+ */
+export interface ScanProgress {
+    currentPlugin: string;
+    current: number;
+    total: number;
+    complete: boolean;
+}
+/**
+ * Callback for scan progress updates
+ */
+export type ScanProgressCallback = (progress: ScanProgress) => void;
+//# sourceMappingURL=server.d.ts.map

package/dist/core/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/types/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,oBAAY,UAAU;IACpB,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC"}

package/dist/core/types/source.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Plugin source type definitions
+ */
+import type { PluginInfo } from './plugin.js';
+/**
+ * Supported source types
+ */
+export type SourceType = 'spigot' | 'modrinth' | 'github' | 'bukkit' | 'web' | 'jenkins' | 'ninsys' | 'hangar';
+/**
+ * Configuration for a plugin source
+ */
+export interface SourceConfig {
+    id: string;
+    name: string;
+    type: SourceType;
+    url: string;
+    enabled?: boolean;
+    checkIntervalSeconds?: number;
+    priority?: number;
+    apiKey?: string;
+    username?: string;
+    password?: string;
+    cacheEnabled?: boolean;
+    cacheExpirySeconds?: number;
+    extraParams?: Record<string, string>;
+}
+/**
+ * Sources configuration file structure
+ */
+export interface SourcesConfig {
+    version: string;
+    description?: string;
+    sources: SourceConfig[];
+}
+/**
+ * Interface for plugin source implementations
+ */
+export interface IPluginSource {
+    readonly id: string;
+    readonly name: string;
+    readonly type: SourceType;
+    enabled: boolean;
+    priority: number;
+    /**
+     * Get plugin information by identifier
+     * @param identifier - Plugin identifier (format varies by source)
+     * @returns Plugin info or null if not found
+     */
+    getPluginInfo(identifier: string): Promise<PluginInfo | null>;
+    /**
+     * Search for plugins
+     * @param query - Search query
+     * @param limit - Maximum results
+     * @returns Array of matching plugins
+     */
+    searchPlugins(query: string, limit?: number): Promise<PluginInfo[]>;
+    /**
+     * Get latest version for a plugin
+     * @param identifier - Plugin identifier
+     * @returns Version string or null
+     */
+    getLatestVersion(identifier: string): Promise<string | null>;
+    /**
+     * Check if source supports a Minecraft version
+     * @param mcVersion - Minecraft version string
+     * @returns Whether version is supported
+     */
+    supportsMinecraftVersion(mcVersion: string): Promise<boolean>;
+    /**
+     * Clear the source's internal cache
+     * Useful when troubleshooting stale cached results
+     */
+    clearCache(): void;
+}
+/**
+ * Options for source requests
+ */
+export interface SourceRequestOptions {
+    timeout?: number;
+    mcVersion?: string;
+    useCache?: boolean;
+}
+/**
+ * Cached response entry
+ */
+export interface CacheEntry<T> {
+    data: T;
+    timestamp: number;
+    expiresAt: number;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/core/types/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/core/types/source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/G;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEpE;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE7D;;;;OAIG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9D;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/types/user-registry.d.ts

@@ -0,0 +1,81 @@
+/**
+ * User Plugin Registry Type Definitions
+ *
+ * Types for user-configured plugin entries that tell the system how to find updates.
+ * This is separate from the curated registry (registry-types.ts) which is bundled.
+ *
+ * Data Model (Plan 01):
+ * - Registry: How to find updates (source IDs, patterns)
+ * - Scan Cache: What's actually installed (from JAR scan)
+ * - Preferences: User flags (enable/disable, skip migrate, pinned)
+ *
+ * @since v1.50.0
+ */
+import type { PluginSourceType } from './plugin.js';
+/**
+ * Plugin category for organization
+ */
+export type UserPluginCategory = 'admin' | 'economy' | 'permissions' | 'world' | 'gameplay' | 'chat' | 'protection' | 'utility' | 'library' | 'performance' | 'cosmetic' | 'minigames' | 'social' | 'uncategorized';
+/**
+ * A user-configured plugin entry that tells the system how to find updates.
+ * Stored in ~/.pluginator/plugins-registry.json
+ */
+export interface UserPluginEntry {
+    /** Plugin name (used as key, case-insensitive) */
+    name: string;
+    /** Source type for update checking */
+    type: PluginSourceType;
+    /** Generic resource identifier (fallback for various sources) */
+    id?: string;
+    /** Jenkins type (for URL construction) */
+    jType?: string;
+    /** Spigot/Spiget resource ID */
+    resourceId?: string;
+    /** Modrinth/Hangar project slug */
+    projectSlug?: string;
+    /** GitHub owner/repo format */
+    repoSlug?: string;
+    /** Jenkins job name */
+    job?: string;
+    /** Web manifest URL */
+    manifestUrl?: string;
+    /** Regex pattern to match JAR filenames */
+    filenamePattern?: string;
+    /** Alternative names this plugin might be known as */
+    aliases?: string[];
+    /** Target Minecraft version */
+    mcVersion?: string;
+    /** Plugin description */
+    description?: string;
+    /** Plugin website */
+    website?: string;
+    /** Category for organization */
+    category?: UserPluginCategory;
+    /** Build from source if no release available (GitHub) */
+    buildFromSource?: boolean;
+    /** Release channel preference */
+    releaseChannel?: 'release' | 'beta' | 'alpha';
+    /** How the source was assigned (auto vs manual) @since v2.2.0 */
+    sourceAssignment?: import('./plugin.js').AssignmentMethod;
+    /** When the source was last auto-assigned (Unix timestamp) @since v2.2.0 */
+    sourceAssignedAt?: number;
+    /** Registry plugin ID if matched from curated registry @since v2.2.0 */
+    registryId?: string;
+}
+/**
+ * User plugin registry file structure
+ * Stored at ~/.pluginator/plugins-registry.json
+ */
+export interface UserPluginRegistry {
+    /** Schema version for migrations */
+    version: 1;
+    /** Last modified timestamp (ISO 8601) */
+    lastModified: string;
+    /** User-configured plugin entries */
+    plugins: UserPluginEntry[];
+}
+/**
+ * Default empty user registry
+ */
+export declare const DEFAULT_USER_REGISTRY: UserPluginRegistry;
+//# sourceMappingURL=user-registry.d.ts.map

package/dist/core/types/user-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-registry.d.ts","sourceRoot":"","sources":["../../../src/core/types/user-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,SAAS,GACT,aAAa,GACb,OAAO,GACP,UAAU,GACV,MAAM,GACN,YAAY,GACZ,SAAS,GACT,SAAS,GACT,aAAa,GACb,UAAU,GACV,WAAW,GACX,QAAQ,GACR,eAAe,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,IAAI,EAAE,gBAAgB,CAAC;IAEvB,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAInB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,iCAAiC;IACjC,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAE9C,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,OAAO,aAAa,EAAE,gBAAgB,CAAC;IAE1D,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC;IAEX,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAInC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Updater Module
+ *
+ * Self-update functionality for Pluginator CLI.
+ */
+export { detectInstallMethod, getInstallMethodDisplayName, getUpdateCommand, supportsAutoUpdate, type InstallMethod, } from './install-method.js';
+export { UpdaterService, createUpdaterService, getUpdaterService, resetUpdaterService, type GitHubRelease, type UpdateCheckCache, type UpdateInfo, } from './updater-service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/updater/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/core/updater/install-method.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Install Method Detection
+ *
+ * Detects how Pluginator was installed to determine the correct update command.
+ */
+/**
+ * Installation methods for Pluginator
+ */
+export type InstallMethod = 'npm-global' | 'bun-global' | 'homebrew' | 'scoop' | 'apt' | 'binary' | 'development' | 'unknown';
+/**
+ * Detect how Pluginator was installed
+ */
+export declare function detectInstallMethod(): InstallMethod;
+/**
+ * Get the command to update Pluginator for the given install method
+ * @returns The update command, or null if manual update is required
+ */
+export declare function getUpdateCommand(method: InstallMethod): string | null;
+/**
+ * Get human-readable display name for install method
+ */
+export declare function getInstallMethodDisplayName(method: InstallMethod): string;
+/**
+ * Check if the install method supports automatic updates
+ */
+export declare function supportsAutoUpdate(method: InstallMethod): boolean;
+//# sourceMappingURL=install-method.d.ts.map

package/dist/core/updater/install-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-method.d.ts","sourceRoot":"","sources":["../../../src/core/updater/install-method.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,OAAO,GACP,KAAK,GACL,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAEd;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAwCnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAmBrE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAYzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEjE"}