@nindroidsystems/pluginator 2.3.0

package/dist/core/search/search-index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Search Index
+ *
+ * Maintains an inverted index for fast full-text search.
+ *
+ * @since v1.68.0
+ */
+import type { IndexableDocument, SearchIndexStats, SearchResultType } from './search-types.js';
+/**
+ * Search index for fast full-text search
+ */
+export declare class SearchIndex {
+    /** Documents stored by ID */
+    private documents;
+    /** Inverted index: term -> documents containing term */
+    private invertedIndex;
+    /** Document count by type */
+    private typeCounts;
+    /** Last update timestamp */
+    private lastUpdated;
+    /**
+     * Add a document to the index
+     */
+    addDocument(doc: IndexableDocument): void;
+    /**
+     * Index tokens for a document
+     */
+    private indexTokens;
+    /**
+     * Remove a document from the index
+     */
+    removeDocument(id: string): boolean;
+    /**
+     * Get a document by ID
+     */
+    getDocument(id: string): IndexableDocument | undefined;
+    /**
+     * Check if a document exists
+     */
+    hasDocument(id: string): boolean;
+    /**
+     * Search for documents matching terms
+     */
+    search(terms: string[], options?: {
+        types?: SearchResultType[];
+        limit?: number;
+    }): Array<{
+        docId: string;
+        score: number;
+        doc: IndexableDocument;
+    }>;
+    /**
+     * Get suggestions for a prefix
+     */
+    suggest(prefix: string, limit?: number): string[];
+    /**
+     * Get all documents of a type
+     */
+    getDocumentsByType(type: SearchResultType): IndexableDocument[];
+    /**
+     * Get index statistics
+     */
+    getStats(): SearchIndexStats;
+    /**
+     * Clear the entire index
+     */
+    clear(): void;
+    /**
+     * Rebuild index from stored documents
+     */
+    rebuild(): void;
+}
+/**
+ * Create a new search index
+ */
+export declare function createSearchIndex(): SearchIndex;
+//# sourceMappingURL=search-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../../src/core/search/search-index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA8B/F;;GAEG;AACH,qBAAa,WAAW;IACtB,6BAA6B;IAC7B,OAAO,CAAC,SAAS,CAA0C;IAE3D,wDAAwD;IACxD,OAAO,CAAC,aAAa,CAAwC;IAE7D,6BAA6B;IAC7B,OAAO,CAAC,UAAU,CAA4C;IAE9D,4BAA4B;IAC5B,OAAO,CAAC,WAAW,CAAK;IAExB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IA6DzC;;OAEG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IA6BnC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAItD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAqDlE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE;IAiB7C;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,EAAE;IAY/D;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAgC5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/core/search/search-ranker.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Search Result Ranker
+ *
+ * Ranks and sorts search results based on relevance, recency,
+ * popularity, and other factors.
+ *
+ * @since v1.68.0
+ */
+import type { IndexableDocument, SearchResult, SearchResultType } from './search-types.js';
+/**
+ * Configuration for ranking
+ */
+export interface RankingConfig {
+    /** Weight for text match score */
+    textMatchWeight: number;
+    /** Weight for recency (0-1, more recent = higher) */
+    recencyWeight: number;
+    /** Weight for popularity (downloads, usage) */
+    popularityWeight: number;
+    /** Weight for type priority */
+    typePriorityWeight: number;
+    /** Boost for exact matches */
+    exactMatchBoost: number;
+    /** Boost for title matches vs description */
+    titleMatchBoost: number;
+    /** Max age for recency calculation (ms) */
+    recencyMaxAge: number;
+}
+/**
+ * Default ranking configuration
+ */
+export declare const DEFAULT_RANKING_CONFIG: RankingConfig;
+/**
+ * Calculate text match score for a document
+ */
+export declare function calculateTextScore(query: string, doc: IndexableDocument, config?: Partial<RankingConfig>): number;
+/**
+ * Calculate recency score (more recent = higher score)
+ */
+export declare function calculateRecencyScore(timestamp: number | undefined, config?: Partial<RankingConfig>): number;
+/**
+ * Calculate popularity score (normalized 0-1)
+ */
+export declare function calculatePopularityScore(value: number | undefined, maxValue?: number): number;
+/**
+ * Calculate type priority score (0-1, higher = more relevant type)
+ */
+export declare function calculateTypePriorityScore(type: SearchResultType): number;
+/**
+ * Calculate final ranking score for a document
+ */
+export declare function calculateRankingScore(query: string, doc: IndexableDocument, metadata?: {
+    timestamp?: number;
+    popularity?: number;
+    maxPopularity?: number;
+}, config?: Partial<RankingConfig>): number;
+/**
+ * Context for batch ranking
+ */
+export interface RankingContext {
+    /** Maximum popularity value (for normalization) */
+    maxPopularity: number;
+    /** Custom type priorities (overrides default) */
+    typePriorities?: Partial<Record<SearchResultType, number>>;
+    /** Boost factors for specific document IDs */
+    boosts?: Map<string, number>;
+}
+/**
+ * Rank a list of search results
+ */
+export declare function rankResults(query: string, results: Array<{
+    doc: IndexableDocument;
+    indexScore?: number;
+    timestamp?: number;
+    popularity?: number;
+}>, context?: RankingContext, config?: Partial<RankingConfig>): SearchResult[];
+/**
+ * Group results by type
+ */
+export declare function groupResultsByType(results: SearchResult[]): Map<SearchResultType, SearchResult[]>;
+/**
+ * Interleave results from different types for diversity
+ */
+export declare function interleaveResults(groups: Map<SearchResultType, SearchResult[]>, totalLimit?: number): SearchResult[];
+/**
+ * Deduplicate results by ID
+ */
+export declare function deduplicateResults(results: SearchResult[]): SearchResult[];
+//# sourceMappingURL=search-ranker.d.ts.map

package/dist/core/search/search-ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-ranker.d.ts","sourceRoot":"","sources":["../../../src/core/search/search-ranker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAQpC,CAAC;AAkBF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM,CAkCrH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM,CAWhH;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAU,GAAG,MAAM,CAM9F;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAIzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,iBAAiB,EACtB,QAAQ,GAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,EACN,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,MAAM,CAUR;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,8CAA8C;IAC9C,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,iBAAiB,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,EACF,OAAO,GAAE,cAA2C,EACpD,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,YAAY,EAAE,CA6ChB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,gBAAgB,EAAE,YAAY,EAAE,CAAC,CAajG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,SAAK,GAAG,YAAY,EAAE,CAkChH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAY1E"}

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

@@ -0,0 +1,241 @@
+/**
+ * Search Type Definitions
+ *
+ * Types for the universal search and filter system.
+ *
+ * @since v1.68.0
+ */
+/**
+ * Types of searchable content
+ */
+export type SearchResultType = 'plugin' | 'registry' | 'server' | 'command' | 'backup' | 'log' | 'activity' | 'config' | 'help';
+/**
+ * Quick action available on a search result
+ */
+export interface SearchAction {
+    /** Unique action ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Keyboard shortcut */
+    shortcut?: string;
+    /** Action handler */
+    execute: () => void | Promise<void>;
+}
+/**
+ * A single search result
+ */
+export interface SearchResult {
+    /** Result type */
+    type: SearchResultType;
+    /** Unique identifier */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Secondary text */
+    subtitle?: string;
+    /** Icon/emoji */
+    icon?: string;
+    /** Relevance score 0-1 */
+    score: number;
+    /** Matched text with highlighting markers */
+    highlight?: string;
+    /** Available quick actions */
+    actions?: SearchAction[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Search options
+ */
+export interface SearchOptions {
+    /** Search query */
+    query: string;
+    /** Limit to specific scopes */
+    scopes?: SearchResultType[];
+    /** Maximum results per scope */
+    limit?: number;
+    /** Enable fuzzy matching */
+    fuzzy?: boolean;
+    /** Include hidden/disabled items */
+    includeHidden?: boolean;
+    /** Minimum score threshold (0-1) */
+    minScore?: number;
+}
+/**
+ * Grouped search results
+ */
+export interface SearchResults {
+    /** Query that was executed */
+    query: string;
+    /** Results grouped by type */
+    groups: SearchResultGroup[];
+    /** Total result count across all groups */
+    totalCount: number;
+    /** Search execution time in ms */
+    searchTime: number;
+}
+/**
+ * A group of search results of the same type
+ */
+export interface SearchResultGroup {
+    /** Result type */
+    type: SearchResultType;
+    /** Display label for the group */
+    label: string;
+    /** Results in this group */
+    results: SearchResult[];
+    /** Total count (may be more than returned if limited) */
+    totalCount: number;
+}
+/**
+ * A document that can be indexed for search
+ */
+export interface IndexableDocument {
+    /** Unique document ID */
+    id: string;
+    /** Document type */
+    type: SearchResultType;
+    /** Primary searchable text */
+    title: string;
+    /** Secondary searchable text */
+    description?: string;
+    /** Keywords/tags */
+    tags?: string[];
+    /** Category */
+    category?: string;
+    /** Additional searchable fields */
+    fields?: Record<string, string | number | boolean | string[]>;
+    /** Data for result display */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Index entry for a plugin
+ */
+export interface PluginIndexEntry extends IndexableDocument {
+    type: 'plugin' | 'registry';
+    /** Plugin name (lowercased for matching) */
+    nameLower: string;
+    /** Name split into tokens */
+    nameTokens: string[];
+    /** Description tokens */
+    descriptionTokens: string[];
+    /** Plugin author */
+    author?: string;
+    /** Plugin source */
+    source?: string;
+    /** Plugin version */
+    version?: string;
+    /** Status flags */
+    status: string[];
+    /** Health score 0-100 */
+    health?: number;
+    /** Download count */
+    downloads?: number;
+    /** Last updated timestamp */
+    updated?: number;
+}
+/**
+ * Index entry for a command
+ */
+export interface CommandIndexEntry extends IndexableDocument {
+    type: 'command';
+    /** Command shortcut */
+    shortcut?: string;
+    /** Command keywords */
+    keywords?: string[];
+}
+/**
+ * Index entry for a log entry
+ */
+export interface LogIndexEntry extends IndexableDocument {
+    type: 'log';
+    /** Log level */
+    level: 'debug' | 'info' | 'warn' | 'error';
+    /** Timestamp */
+    timestamp: number;
+    /** Source plugin/component */
+    source?: string;
+}
+/**
+ * Search history entry
+ */
+export interface SearchHistoryEntry {
+    /** Search query */
+    query: string;
+    /** When the search was performed */
+    timestamp: number;
+    /** Number of results */
+    resultCount: number;
+    /** Scopes searched */
+    scopes?: SearchResultType[];
+}
+/**
+ * Saved search configuration
+ */
+export interface SavedSearch {
+    /** Unique ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Search query */
+    query: string;
+    /** Scopes to search */
+    scopes?: SearchResultType[];
+    /** Is a default/system search */
+    isDefault?: boolean;
+    /** Created timestamp */
+    createdAt: number;
+    /** Last used timestamp */
+    lastUsedAt?: number;
+    /** Enable alerts for new matches */
+    alertEnabled?: boolean;
+}
+/**
+ * Token with position info for highlighting
+ */
+export interface MatchToken {
+    /** The matched text */
+    text: string;
+    /** Start position in original string */
+    start: number;
+    /** End position in original string */
+    end: number;
+    /** Whether this is a match */
+    isMatch: boolean;
+}
+/**
+ * Result of fuzzy matching
+ */
+export interface FuzzyMatchResult {
+    /** Whether there was a match */
+    matched: boolean;
+    /** Match score 0-1 */
+    score: number;
+    /** Matched tokens for highlighting */
+    tokens?: MatchToken[];
+}
+/**
+ * Search index statistics
+ */
+export interface SearchIndexStats {
+    /** Document counts by type */
+    documentCounts: Record<SearchResultType, number>;
+    /** Total document count */
+    totalDocuments: number;
+    /** Total terms in index */
+    totalTerms: number;
+    /** Index size estimate in bytes */
+    sizeBytes: number;
+    /** Last index update time */
+    lastUpdated: number;
+}
+/**
+ * Display labels for result types
+ */
+export declare const RESULT_TYPE_LABELS: Record<SearchResultType, string>;
+/**
+ * Icons for result types
+ */
+export declare const RESULT_TYPE_ICONS: Record<SearchResultType, string>;
+//# sourceMappingURL=search-types.d.ts.map

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

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

package/dist/core/server-jar/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Server JAR Module
+ *
+ * Service for downloading Minecraft server JARs
+ */
+export type { IServerJarSource, ServerJarDownloadResult, ServerJarInfo, ServerJarType, } from './types.js';
+export { paperSource, PaperMCSource } from './paper.js';
+export { purpurSource, PurpurMCSource } from './purpur.js';
+export { getAvailableServerTypes, getServerJarSource, isServerTypeSupported, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/server-jar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/server-jar/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/core/server-jar/paper.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PaperMC Server JAR Source
+ *
+ * Fetches Paper server JARs from the PaperMC API v3
+ * https://fill.papermc.io/v3/
+ */
+import type { IServerJarSource, ServerJarInfo } from './types.js';
+/**
+ * PaperMC server JAR source implementation (v3 API)
+ */
+export declare class PaperMCSource implements IServerJarSource {
+    readonly type: "paper";
+    readonly name = "PaperMC";
+    private versionsCache;
+    private cacheTime;
+    private readonly cacheDurationMs;
+    /**
+     * Get available Minecraft versions for Paper
+     * Returns cached versions if offline with graceful degradation
+     */
+    getAvailableVersions(): Promise<string[]>;
+    /**
+     * Check if a Minecraft version is supported by Paper
+     */
+    isVersionSupported(version: string): Promise<boolean>;
+    /**
+     * Get the latest build for a Minecraft version
+     */
+    getLatestBuild(version: string): Promise<ServerJarInfo>;
+}
+/**
+ * Singleton instance
+ */
+export declare const paperSource: PaperMCSource;
+//# sourceMappingURL=paper.d.ts.map

package/dist/core/server-jar/paper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper.d.ts","sourceRoot":"","sources":["../../../src/core/server-jar/paper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuClE;;GAEG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEjD;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAwD/C;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA6C9D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,eAAsB,CAAC"}

package/dist/core/server-jar/purpur.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PurpurMC Server JAR Source
+ *
+ * Fetches Purpur server JARs from the PurpurMC API
+ * https://api.purpurmc.org/v2/purpur
+ */
+import type { IServerJarSource, ServerJarInfo } from './types.js';
+/**
+ * PurpurMC server JAR source implementation
+ */
+export declare class PurpurMCSource implements IServerJarSource {
+    readonly type: "purpur";
+    readonly name = "PurpurMC";
+    private versionsCache;
+    private cacheTime;
+    private readonly cacheDurationMs;
+    /**
+     * Get available Minecraft versions for Purpur
+     * Returns cached versions if offline with graceful degradation
+     */
+    getAvailableVersions(): Promise<string[]>;
+    /**
+     * Check if a Minecraft version is supported by Purpur
+     */
+    isVersionSupported(version: string): Promise<boolean>;
+    /**
+     * Get the latest build for a Minecraft version
+     */
+    getLatestBuild(version: string): Promise<ServerJarInfo>;
+}
+/**
+ * Singleton instance
+ */
+export declare const purpurSource: PurpurMCSource;
+//# sourceMappingURL=purpur.d.ts.map

package/dist/core/server-jar/purpur.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purpur.d.ts","sourceRoot":"","sources":["../../../src/core/server-jar/purpur.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA+BlE;;GAEG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEjD;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA2C/C;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAiC9D;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,gBAAuB,CAAC"}

package/dist/core/server-jar/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Server JAR Source Registry
+ *
+ * Maps server types to their source implementations
+ */
+import type { IServerJarSource, ServerJarType } from './types.js';
+/**
+ * Get a server JAR source by type
+ * @param type Server type identifier
+ * @returns The source implementation
+ * @throws Error if type is not registered
+ */
+export declare function getServerJarSource(type: ServerJarType): IServerJarSource;
+/**
+ * Get all available server types
+ */
+export declare function getAvailableServerTypes(): ServerJarType[];
+/**
+ * Check if a server type is supported
+ */
+export declare function isServerTypeSupported(type: string): type is ServerJarType;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/server-jar/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/server-jar/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUlE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAMxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAEzE"}

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

@@ -0,0 +1,47 @@
+/**
+ * Server JAR Types
+ *
+ * Type definitions for server JAR download feature
+ */
+/** Supported server JAR types */
+export type ServerJarType = 'paper' | 'purpur';
+/** Information about a server JAR build */
+export interface ServerJarInfo {
+    type: ServerJarType;
+    version: string;
+    build: number | string;
+    downloadUrl: string;
+    filename: string;
+    sha256?: string;
+    md5?: string;
+}
+/** Interface for server JAR sources */
+export interface IServerJarSource {
+    readonly type: ServerJarType;
+    readonly name: string;
+    /**
+     * Get the latest build for a Minecraft version
+     * @param version Minecraft version (e.g., "1.21.1")
+     * @returns Build information with download URL
+     */
+    getLatestBuild(version: string): Promise<ServerJarInfo>;
+    /**
+     * Get available Minecraft versions
+     * @returns List of supported versions
+     */
+    getAvailableVersions(): Promise<string[]>;
+    /**
+     * Check if a version is supported
+     * @param version Minecraft version to check
+     */
+    isVersionSupported(version: string): Promise<boolean>;
+}
+/** Result of a server JAR download operation */
+export interface ServerJarDownloadResult {
+    success: boolean;
+    filePath?: string;
+    error?: string;
+    buildInfo?: ServerJarInfo;
+    checksumVerified?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/server-jar/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAExD;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1C;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}