@nindroidsystems/pluginator 2.3.0

package/dist/core/registry/registry-download.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Registry Download Service
+ *
+ * Handles downloading plugins from the curated registry by resolving
+ * registry entries to downloadable plugin info using the appropriate sources.
+ *
+ * @since v1.54.0
+ */
+import { type DownloadProgress, type DownloadResult } from '../../workflows/download.js';
+import type { IPluginSource, PluginInfo } from '../types/index.js';
+import type { RegistryPlugin } from './registry-types.js';
+/**
+ * Options for downloading from registry
+ */
+export interface RegistryDownloadOptions {
+    /** Target directory (prod or test server plugins dir) */
+    targetDir: string;
+    /** Specific version to download (default: latest) */
+    version?: string;
+    /** Target Minecraft version for compatibility */
+    minecraftVersion?: string;
+    /** Create backup of existing file */
+    backupExisting?: boolean;
+    /** Backup directory */
+    backupDir?: string;
+    /** Progress callback */
+    onProgress?: (progress: DownloadProgress) => void;
+}
+/**
+ * Result of resolving a registry plugin to downloadable info
+ */
+export interface ResolveResult {
+    success: boolean;
+    pluginInfo?: PluginInfo;
+    sourceType?: string;
+    error?: string;
+    triedSources?: string[];
+}
+/**
+ * Result of downloading from registry
+ */
+export interface RegistryDownloadResult extends DownloadResult {
+    /** Which source was used */
+    sourceType?: string;
+    /** Sources that were tried but failed */
+    triedSources?: string[];
+}
+/**
+ * Registry Download Service
+ *
+ * Resolves registry plugins to download URLs using configured sources
+ */
+export declare class RegistryDownloadService {
+    private sources;
+    constructor(sources: IPluginSource[]);
+    /**
+     * Resolve a registry plugin to downloadable PluginInfo
+     * Tries sources in order of preference
+     */
+    resolvePlugin(plugin: RegistryPlugin, options?: {
+        minecraftVersion?: string;
+    }): Promise<ResolveResult>;
+    /**
+     * Resolve plugin info from a specific source
+     */
+    private resolveFromSource;
+    /**
+     * Get the source-specific identifier from a registry source config
+     */
+    private getSourceId;
+    /**
+     * Download a plugin from the registry
+     */
+    downloadPlugin(plugin: RegistryPlugin, options: RegistryDownloadOptions): Promise<RegistryDownloadResult>;
+    /**
+     * Download a plugin to multiple destinations
+     */
+    downloadToMultiple(plugin: RegistryPlugin, destinations: {
+        dir: string;
+        name: string;
+    }[], options: Omit<RegistryDownloadOptions, 'targetDir'>): Promise<{
+        destination: string;
+        result: RegistryDownloadResult;
+    }[]>;
+    /**
+     * Check if a source is available for a registry plugin
+     */
+    hasSource(plugin: RegistryPlugin): boolean;
+    /**
+     * Get available sources for a plugin
+     */
+    getAvailableSources(plugin: RegistryPlugin): string[];
+}
+/**
+ * Create a registry download service
+ */
+export declare function createRegistryDownloadService(sources: IPluginSource[]): RegistryDownloadService;
+//# sourceMappingURL=registry-download.d.ts.map

package/dist/core/registry/registry-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-download.d.ts","sourceRoot":"","sources":["../../../src/core/registry/registry-download.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAoB,MAAM,6BAA6B,CAAC;AAC3G,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAIhF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA6B;gBAEhC,OAAO,EAAE,aAAa,EAAE;IAOpC;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDhH;;OAEG;YACW,iBAAiB;IA4B/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA8C/G;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,EAC7C,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,GAClD,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,sBAAsB,CAAA;KAAE,EAAE,CAAC;IAcrE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAI1C;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE;CAGtD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,uBAAuB,CAE/F"}

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

@@ -0,0 +1,216 @@
+/**
+ * Plugin Registry Service
+ *
+ * Manages loading, searching, and accessing the curated plugin registry.
+ * Supports both the internal curated registry and user custom registries.
+ *
+ * Key behaviors:
+ * - Bundled registry contains curated plugin entries (read-only)
+ * - User registry can add new entries or override bundled ones
+ * - User entries take precedence over bundled entries with same ID
+ * - Supports both v1 (single file) and v2 (directory) formats
+ *
+ * @since v1.7.0 - Initial registry support
+ * @updated v1.54.0 - Added directory-based registry format (v2)
+ * @updated v2.2.4 - API-first loading with bundled fallback
+ */
+import type { PluginCategory, RegistryMetadata, RegistryPlugin, RegistrySearchResult } from './registry-types.js';
+/**
+ * Plugin Registry Service
+ */
+export declare class RegistryService {
+    private registry;
+    private metadata;
+    private registryPath;
+    private registryDir;
+    private userRegistryPath;
+    private pluginMap;
+    private tagIndex;
+    private usingDirectoryFormat;
+    private useDefaultPaths;
+    private readonly apiUrl;
+    private explicitRegistryPath;
+    private explicitRegistryDir;
+    constructor(registryPath?: string, registryDir?: string, userRegistryPath?: string);
+    /**
+     * Load the registry from disk (internal + user custom)
+     * - If explicit registryPath provided: use file format
+     * - If explicit registryDir provided: use directory format
+     * - If neither (defaults): try directory first, fall back to file
+     */
+    load(): boolean;
+    /**
+     * Load registry with API-first strategy, falling back to bundled data.
+     * Tries GET /v2/pluginator/registry, on any failure falls back to load().
+     * User custom registry is always merged on top regardless of source.
+     */
+    loadWithApi(): Promise<boolean>;
+    /**
+     * Fetch registry data from the NinSys API.
+     * Returns true if successful, false on any error.
+     */
+    private fetchFromApi;
+    /**
+     * Load registry from directory format (v2)
+     */
+    private loadFromDirectory;
+    /**
+     * Validate that a plugin has all required fields
+     */
+    private isValidPlugin;
+    /**
+     * Load registry from single file format (v1)
+     */
+    private loadFromFile;
+    /**
+     * Load a single plugin by ID (for lazy loading)
+     * Only works with directory format
+     */
+    loadPlugin(id: string): RegistryPlugin | null;
+    /**
+     * Get all plugin IDs without loading full plugin data
+     * Useful for listing available plugins
+     */
+    getAllPluginIds(): string[];
+    /**
+     * Get registry metadata
+     */
+    getMetadata(): RegistryMetadata | null;
+    /**
+     * Check if using directory format
+     */
+    isDirectoryFormat(): boolean;
+    /**
+     * Load user custom registry and merge with internal registry
+     * User plugins override internal plugins with the same ID
+     */
+    private loadUserRegistry;
+    /**
+     * Build search indexes from loaded registry
+     */
+    private buildIndexes;
+    /**
+     * Check if registry is loaded
+     */
+    isLoaded(): boolean;
+    /**
+     * Get registry info
+     */
+    getInfo(): {
+        version: string;
+        lastUpdated: string;
+        pluginCount: number;
+        format?: 'directory';
+    } | null;
+    /**
+     * Get plugin by ID
+     */
+    getById(id: string): RegistryPlugin | undefined;
+    /**
+     * Get plugin by name (case-insensitive)
+     */
+    getByName(name: string): RegistryPlugin | undefined;
+    /**
+     * Search for plugins in the registry
+     */
+    search(query: string, limit?: number): RegistrySearchResult[];
+    /**
+     * Calculate match score for a plugin against a query
+     */
+    private calculateMatchScore;
+    /**
+     * Simple fuzzy string matching
+     */
+    private fuzzyMatch;
+    /**
+     * Get all plugins in a category
+     */
+    getByCategory(category: PluginCategory): RegistryPlugin[];
+    /**
+     * Get all plugins with a specific tag
+     */
+    getByTag(tag: string): RegistryPlugin[];
+    /**
+     * Get popular plugins
+     */
+    getPopular(limit?: number): RegistryPlugin[];
+    /**
+     * Get verified plugins
+     */
+    getVerified(limit?: number): RegistryPlugin[];
+    /**
+     * Get plugins compatible with a specific Minecraft version
+     * Compares the version against each plugin's min/max range
+     */
+    getCompatibleWith(mcVersion: string): RegistryPlugin[];
+    /**
+     * Check if a version is within a min/max range
+     * Uses simple string comparison for MC versions (1.18 < 1.19 < 1.20)
+     */
+    private isVersionInRange;
+    /**
+     * Get plugins similar to a given plugin
+     * Based on shared tags and category
+     */
+    getSimilar(plugin: RegistryPlugin, limit?: number): RegistryPlugin[];
+    /**
+     * Get registry plugins that match installed plugin names
+     * Useful for showing which installed plugins are from the curated registry
+     */
+    getInstalledFromRegistry(installedNames: Set<string>): RegistryPlugin[];
+    /**
+     * Get all unique tags from the registry
+     */
+    getAllTags(): string[];
+    /**
+     * Get tags with their plugin counts
+     */
+    getTagCounts(): Map<string, number>;
+    /**
+     * Get all plugins
+     */
+    getAll(): RegistryPlugin[];
+    /**
+     * Get all plugins sorted alphabetically by name
+     */
+    getAllSorted(): RegistryPlugin[];
+    /**
+     * Sort plugins alphabetically by name (case-insensitive)
+     */
+    sortPluginsByName(plugins: RegistryPlugin[]): RegistryPlugin[];
+    /**
+     * Sort the internal registry in place by name
+     * Useful for maintaining the registry file
+     */
+    sortRegistryByName(): void;
+    /**
+     * Save the registry to a file (for maintenance/tooling)
+     * @param filePath Optional file path, defaults to the loaded registry path
+     */
+    saveRegistry(filePath?: string): boolean;
+    /**
+     * Get total count
+     */
+    getCount(): number;
+    /**
+     * Get all categories with counts
+     */
+    getCategoryCounts(): Map<PluginCategory, number>;
+    /**
+     * Check if a plugin exists in the registry
+     */
+    has(idOrName: string): boolean;
+    /**
+     * Get the preferred source for a registry plugin
+     */
+    getPreferredSource(plugin: RegistryPlugin): RegistryPlugin['sources'][0] | undefined;
+}
+/**
+ * Get the singleton registry service
+ */
+export declare function getRegistryService(registryPath?: string): RegistryService;
+/**
+ * Create a new registry service (for testing)
+ */
+export declare function createRegistryService(registryPath?: string, userRegistryPath?: string, registryDir?: string): RegistryService;
+//# sourceMappingURL=registry-service.d.ts.map

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

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

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

@@ -0,0 +1,222 @@
+/**
+ * Plugin Registry Type Definitions
+ *
+ * Types for the curated plugin registry system
+ */
+import type { PluginSourceType } from '../types/plugin.js';
+/**
+ * Plugin category for organization
+ */
+export type PluginCategory = 'admin' | 'economy' | 'permissions' | 'world' | 'gameplay' | 'chat' | 'protection' | 'utility' | 'library' | 'performance' | 'cosmetic' | 'minigames' | 'social';
+/**
+ * Source configuration for a registry plugin
+ */
+export interface RegistryPluginSource {
+    /** Source type */
+    type: PluginSourceType;
+    /** Modrinth project slug */
+    projectSlug?: string;
+    /** Hangar project slug (often same as project name) */
+    hangarSlug?: string;
+    /** Spigot resource ID */
+    resourceId?: number;
+    /** CurseForge project ID */
+    curseforgeId?: string;
+    /** GitHub repo in owner/repo format */
+    repoSlug?: string;
+    /** Jenkins job name */
+    jenkinsJob?: string;
+    /** Jenkins base URL */
+    jenkinsUrl?: string;
+    /** Mark as preferred source for this plugin */
+    preferred?: boolean;
+    /** Release channel preference */
+    releaseChannel?: 'release' | 'beta' | 'alpha';
+}
+/**
+ * Minecraft version compatibility range
+ */
+export interface MinecraftVersionRange {
+    /** Minimum supported version (e.g., "1.16") */
+    min: string;
+    /** Maximum supported version (e.g., "1.21") */
+    max: string;
+}
+/**
+ * A plugin entry in the curated registry
+ */
+export interface RegistryPlugin {
+    /** Unique identifier (lowercase, hyphenated) */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** List of authors */
+    authors: string[];
+    /** Project website/homepage */
+    website?: string;
+    /** Plugin category */
+    category: PluginCategory;
+    /** Tags for search */
+    tags: string[];
+    /** Configured sources (in priority order) */
+    sources: RegistryPluginSource[];
+    /** Minecraft version compatibility */
+    minecraftVersions: MinecraftVersionRange;
+    /** Is this a premium/paid plugin? */
+    premium?: boolean;
+    /** Has this been manually verified by maintainers? */
+    verified?: boolean;
+    /** Featured as a popular plugin? */
+    popular?: boolean;
+    /** Other plugin IDs this depends on */
+    dependencies?: string[];
+    /** Plugins that conflict with this one */
+    conflicts?: string[];
+    /** Notes for users */
+    notes?: string;
+    /**
+     * Extended metadata for recommendations (optional)
+     * These fields may be populated from API sources during runtime
+     */
+    /** Total download count (populated from sources) */
+    downloads?: number;
+    /** Average rating (0-5, populated from sources) */
+    rating?: number;
+    /** Last updated date ISO string (populated from sources) */
+    lastUpdated?: string;
+    /** Creation date ISO string (populated from sources) */
+    createdAt?: string;
+    /** Current version (populated from sources) */
+    version?: string;
+}
+/**
+ * The full plugin registry file structure (v1 - single file format)
+ */
+export interface PluginRegistry {
+    /** Registry format version (semver) */
+    version: string;
+    /** Last updated date (ISO 8601) */
+    lastUpdated: string;
+    /** Description of the registry */
+    description?: string;
+    /** All registered plugins */
+    plugins: RegistryPlugin[];
+}
+/**
+ * Registry metadata for directory-based format (v2)
+ */
+export interface RegistryMetadata {
+    /** Registry format version (semver) */
+    version: string;
+    /** Last updated date (ISO 8601) */
+    lastUpdated: string;
+    /** Description of the registry */
+    description?: string;
+    /** Format type ('directory' for v2) */
+    format: 'directory';
+    /** Number of plugins in the registry */
+    pluginCount: number;
+    /** List of all categories */
+    categories: PluginCategory[];
+}
+/**
+ * Result from searching the registry
+ */
+export interface RegistrySearchResult {
+    /** The matched plugin */
+    plugin: RegistryPlugin;
+    /** Match confidence score (0-1) */
+    confidence: number;
+    /** Why this was matched */
+    matchReason: 'exact' | 'partial' | 'tag' | 'fuzzy';
+}
+/**
+ * Unified search result from any source (registry or API)
+ */
+export interface UnifiedSearchResult {
+    /** Source of the result */
+    source: 'registry' | PluginSourceType;
+    /** Plugin identifier (registry id or source-specific) */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Short description */
+    description?: string;
+    /** Author(s) */
+    authors: string[];
+    /** Latest version */
+    version?: string;
+    /** Minecraft versions supported */
+    minecraftVersions?: string[];
+    /** Download count (if available) */
+    downloads?: number;
+    /** Last updated (ISO 8601) */
+    lastUpdated?: string;
+    /** Download URL (if available) */
+    downloadUrl?: string;
+    /** Project URL */
+    projectUrl?: string;
+    /** Match confidence (0-1) */
+    confidence: number;
+    /** Is from curated registry */
+    fromRegistry: boolean;
+    /** Original registry plugin (if from registry) */
+    registryPlugin?: RegistryPlugin;
+}
+/**
+ * Options for searching plugins
+ */
+export interface PluginSearchOptions {
+    /** Search query */
+    query: string;
+    /** Maximum results */
+    limit?: number;
+    /** Target Minecraft version */
+    minecraftVersion?: string;
+    /** Filter by category */
+    category?: PluginCategory;
+    /** Sources to search (default: all) */
+    sources?: PluginSourceType[];
+    /** Search registry first (default: true) */
+    searchRegistryFirst?: boolean;
+    /** Stop after first source finds results (default: false) */
+    stopOnFirstResult?: boolean;
+    /** Include API sources even if registry has result (default: true) */
+    includeApiResults?: boolean;
+}
+/**
+ * Plugin confirmation dialog data
+ */
+export interface PluginConfirmData {
+    /** Plugin name */
+    name: string;
+    /** Authors */
+    authors: string[];
+    /** Description */
+    description?: string;
+    /** Plugin version */
+    version: string;
+    /** Minecraft versions supported */
+    minecraftVersions: string[];
+    /** Source type */
+    source: 'registry' | PluginSourceType;
+    /** Source display name */
+    sourceDisplay: string;
+    /** Download URL */
+    downloadUrl: string;
+    /** File size (if known) */
+    fileSize?: number;
+    /** Is from curated registry */
+    fromRegistry: boolean;
+    /** Category */
+    category?: PluginCategory;
+    /** Is premium plugin */
+    premium?: boolean;
+    /** Is verified */
+    verified?: boolean;
+    /** Dependencies to install */
+    dependencies?: string[];
+}
+//# sourceMappingURL=registry-types.d.ts.map

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

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

package/dist/core/scanner.d.ts

@@ -0,0 +1,63 @@
+/**
+ * JAR Scanner
+ *
+ * Extracts plugin metadata from Minecraft plugin JAR files by reading plugin.yml
+ */
+import type { ScanProgressCallback, ScannedPlugin } from './types/index.js';
+/**
+ * Scan a single JAR file and extract plugin metadata
+ */
+export declare function scanJar(jarPath: string): Promise<ScannedPlugin>;
+/**
+ * Scan all JAR files in a directory
+ */
+export declare function scanDirectory(pluginsPath: string, onProgress?: ScanProgressCallback): Promise<ScannedPlugin[]>;
+/**
+ * Find a plugin by name in a list of scanned plugins
+ */
+export declare function findPluginByName(plugins: ScannedPlugin[], name: string): ScannedPlugin | undefined;
+/**
+ * Get authors as a comma-separated string
+ */
+export declare function getAuthorsString(plugin: ScannedPlugin): string;
+/**
+ * Get dependencies as a comma-separated string
+ */
+export declare function getDependenciesString(plugin: ScannedPlugin): string;
+/**
+ * Check if a JAR filename matches a pattern
+ * Uses escaped pattern to prevent ReDoS attacks (v2.0.0)
+ */
+export declare function matchesFilenamePattern(filename: string, pattern: string): boolean;
+/**
+ * Find a plugin's JAR file in a directory by plugin name
+ * Returns the full path and whether it's currently disabled
+ *
+ * @since v1.51.7
+ */
+export declare function findPluginJar(pluginsPath: string, pluginName: string): Promise<{
+    path: string;
+    filename: string;
+    disabled: boolean;
+} | null>;
+/**
+ * Disable a plugin by renaming its JAR file to .jar.disabled
+ *
+ * @since v1.51.7
+ */
+export declare function disablePluginJar(pluginsPath: string, pluginName: string): Promise<boolean>;
+/**
+ * Enable a plugin by renaming its .jar.disabled file back to .jar
+ *
+ * @since v1.51.7
+ */
+export declare function enablePluginJar(pluginsPath: string, pluginName: string): Promise<boolean>;
+/**
+ * Find the server JAR file in a server directory
+ *
+ * @param serverPath - Path to the plugins directory or server root
+ * @returns Full path to the server JAR or null if not found
+ * @since v1.50.5
+ */
+export declare function findServerJar(serverPath: string): Promise<string | null>;
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAA2B,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA0JrG;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8CrE;AA2CD;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA4DpH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAGlG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAYnE;AAUD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAajF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBlJ;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBhG;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqC/F;AAOD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8B9E"}

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

@@ -0,0 +1,15 @@
+/**
+ * Schedule Module
+ *
+ * Exports for the update scheduling system.
+ *
+ * @since v1.24.0
+ */
+export { ScheduleService, getScheduleService, resetScheduleService, } from './schedule-service.js';
+export { DEFAULT_SCHEDULE_CONFIG, INTERVAL_MS, type ScheduleCheckRecord, type ScheduleCommand, type ScheduleConfig, type ScheduleInterval, type ScheduleState, type ScheduledCheckResult, type ScheduledPluginUpdate, } from './schedule-types.js';
+export { UpdateQueue, getUpdateQueue, resetUpdateQueue, type QueuedUpdate, type QueuedUpdateStatus, type QueueProcessResult, } from './update-queue.js';
+export { ScheduleExecutor, getScheduleExecutor, initScheduleExecutor, resetScheduleExecutor, DEFAULT_EXECUTOR_CONFIG, type AutoBackupConfig, type ExecutionMode, type ExecutionResult, type ScheduleExecutorConfig, type TimeWindow, } from './schedule-executor.js';
+export { ScheduleDaemon, getScheduleDaemon, initScheduleDaemon, resetScheduleDaemon, DEFAULT_DAEMON_CONFIG, type DaemonConfig, type DaemonState, type DaemonStatus, } from './schedule-daemon.js';
+export { ScheduleNotifier, getScheduleNotifier, initScheduleNotifier, resetScheduleNotifier, DEFAULT_NOTIFICATION_CONFIG, type NotificationChannel, type NotificationConfig, type NotificationEvent, type NotificationEventType, type NotificationPluginStatus, type StoredNotification, } from './notifications.js';
+export { PluginScheduleManager, getPluginScheduleManager, initPluginScheduleManager, resetPluginScheduleManager, DEFAULT_SCHEDULE_OVERRIDES, type PluginScheduleConfig, type ScheduleOverrides, } from './plugin-schedule.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/schedule/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC"}