@nindroidsystems/pluginator 2.3.0

package/dist/core/search/query-parser.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Query Parser
+ *
+ * Parses advanced search queries with field filters, boolean operators,
+ * comparisons, and date/time queries.
+ *
+ * @since v1.68.0
+ *
+ * Query syntax:
+ * - Basic: `luckperms` - search for term
+ * - Exact phrase: `"luck perms"` - exact phrase match
+ * - Field filter: `name:luck` `author:lucko` `source:modrinth`
+ * - Status filter: `is:installed` `is:outdated` `is:healthy`
+ * - Boolean: `luck AND perms` `luck OR vault` `luck NOT deprecated`
+ * - Comparison: `downloads:>10000` `rating:>=4.5` `updated:<30d`
+ * - Date/time: `updated:today` `created:this-week` `updated:2024-01-01..now`
+ * - Sort: `sort:name` `sort:downloads:desc`
+ */
+/**
+ * Token types in the query language
+ */
+export type TokenType = 'TERM' | 'PHRASE' | 'FIELD' | 'OPERATOR' | 'COMPARISON' | 'VALUE' | 'COLON' | 'LPAREN' | 'RPAREN' | 'EOF';
+/**
+ * A token from lexical analysis
+ */
+export interface Token {
+    type: TokenType;
+    value: string;
+    position: number;
+}
+/**
+ * Parsed query node types
+ */
+export type QueryNodeType = 'term' | 'phrase' | 'field' | 'comparison' | 'and' | 'or' | 'not' | 'group';
+/**
+ * Comparison operators
+ */
+export type ComparisonOp = '=' | '>' | '<' | '>=' | '<=' | '!=';
+/**
+ * A node in the parsed query tree
+ */
+export interface QueryNode {
+    type: QueryNodeType;
+    value?: string;
+    field?: string;
+    operator?: ComparisonOp;
+    children?: QueryNode[];
+    negated?: boolean;
+}
+/**
+ * Known field names for autocomplete
+ */
+export declare const KNOWN_FIELDS: readonly ["name", "author", "version", "source", "category", "tag", "description"];
+/**
+ * Known status filters
+ */
+export declare const STATUS_FILTERS: readonly ["installed", "outdated", "healthy", "error", "favorite", "pinned", "deprecated", "disabled"];
+/**
+ * Known sort fields
+ */
+export declare const SORT_FIELDS: readonly ["name", "downloads", "updated", "rating", "health", "size"];
+/**
+ * Date shortcuts
+ */
+export declare const DATE_SHORTCUTS: Record<string, () => number>;
+/**
+ * Parse a duration string (e.g., "30d", "2w", "6h")
+ */
+export declare function parseDuration(value: string): number | null;
+/**
+ * Parse a date value (shortcut, duration, or ISO date)
+ */
+export declare function parseDate(value: string): number | null;
+/**
+ * Parse a size value (e.g., "1mb", "500kb")
+ */
+export declare function parseSize(value: string): number | null;
+/**
+ * Tokenize a query string
+ */
+export declare function tokenize(query: string): Token[];
+/**
+ * Parse tokens into a query tree
+ */
+export declare function parse(tokens: Token[]): QueryNode;
+/**
+ * Parsed query with metadata
+ */
+export interface ParsedQuery {
+    /** The original query string */
+    original: string;
+    /** Parsed query tree */
+    tree: QueryNode;
+    /** Extracted terms for text search */
+    terms: string[];
+    /** Field filters */
+    filters: Array<{
+        field: string;
+        value: string;
+        operator: ComparisonOp;
+    }>;
+    /** Status filters (is:xxx) */
+    statusFilters: string[];
+    /** Sort specification */
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    /** Whether query has errors */
+    hasErrors: boolean;
+    /** Error messages */
+    errors: string[];
+}
+/**
+ * Parse a query string into a structured query
+ */
+export declare function parseQuery(query: string): ParsedQuery;
+/**
+ * Get autocomplete suggestions for a partial query
+ */
+export declare function getAutocompleteSuggestions(query: string, cursorPosition?: number): Array<{
+    text: string;
+    description: string;
+}>;
+/**
+ * Format a query tree back to a string
+ */
+export declare function formatQuery(node: QueryNode): string;
+//# sourceMappingURL=query-parser.d.ts.map

package/dist/core/search/query-parser.d.ts.map

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

package/dist/core/search/saved-searches.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Saved Searches & Smart Folders
+ *
+ * Service for managing saved searches and smart folders that
+ * automatically group plugins based on dynamic queries.
+ *
+ * @since v1.68.0
+ */
+import type { SearchResultType } from './search-types.js';
+/**
+ * A saved search definition
+ */
+export interface SavedSearch {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** The search query string */
+    query: string;
+    /** Icon for display */
+    icon?: string;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Last used timestamp */
+    lastUsedAt?: number;
+    /** Usage count */
+    useCount: number;
+    /** Whether this is a smart folder (auto-updating) */
+    isSmartFolder: boolean;
+    /** Scopes to search */
+    scopes?: SearchResultType[];
+    /** Color for UI */
+    color?: string;
+    /** Sort order for display */
+    sortOrder?: number;
+    /** Whether pinned to top */
+    pinned?: boolean;
+}
+/**
+ * Smart folder configuration
+ */
+export interface SmartFolderConfig {
+    /** Auto-refresh interval in ms (0 = manual only) */
+    refreshInterval: number;
+    /** Maximum items to show */
+    maxItems: number;
+    /** Show count badge */
+    showCount: boolean;
+    /** Notification on new items */
+    notifyOnNew: boolean;
+}
+/**
+ * Default smart folder config
+ */
+export declare const DEFAULT_SMART_FOLDER_CONFIG: SmartFolderConfig;
+/**
+ * Built-in saved searches
+ */
+export declare const BUILTIN_SEARCHES: SavedSearch[];
+/**
+ * Saved searches service
+ */
+export declare class SavedSearchesService {
+    private searches;
+    private smartFolderConfigs;
+    constructor();
+    /**
+     * Get all saved searches
+     */
+    getAll(): SavedSearch[];
+    /**
+     * Get smart folders only
+     */
+    getSmartFolders(): SavedSearch[];
+    /**
+     * Get regular saved searches only
+     */
+    getSavedSearches(): SavedSearch[];
+    /**
+     * Get a saved search by ID
+     */
+    get(id: string): SavedSearch | undefined;
+    /**
+     * Create a new saved search
+     */
+    create(data: Omit<SavedSearch, 'id' | 'createdAt' | 'useCount'>): SavedSearch;
+    /**
+     * Update a saved search
+     */
+    update(id: string, updates: Partial<Omit<SavedSearch, 'id' | 'createdAt'>>): SavedSearch | undefined;
+    /**
+     * Delete a saved search
+     */
+    delete(id: string): boolean;
+    /**
+     * Record usage of a saved search
+     */
+    recordUsage(id: string): void;
+    /**
+     * Save current search as new saved search
+     */
+    saveCurrentSearch(query: string, name: string, options?: {
+        description?: string;
+        icon?: string;
+        isSmartFolder?: boolean;
+        scopes?: SearchResultType[];
+    }): SavedSearch;
+    /**
+     * Pin/unpin a saved search
+     */
+    togglePin(id: string): boolean;
+    /**
+     * Get smart folder config
+     */
+    getSmartFolderConfig(id: string): SmartFolderConfig;
+    /**
+     * Set smart folder config
+     */
+    setSmartFolderConfig(id: string, config: Partial<SmartFolderConfig>): void;
+    /**
+     * Validate a search query
+     */
+    validateQuery(query: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Search saved searches by name
+     */
+    search(query: string): SavedSearch[];
+    /**
+     * Get recently used searches
+     */
+    getRecentlyUsed(limit?: number): SavedSearch[];
+    /**
+     * Get frequently used searches
+     */
+    getFrequentlyUsed(limit?: number): SavedSearch[];
+    /**
+     * Export searches to JSON
+     */
+    export(): string;
+    /**
+     * Import searches from JSON
+     */
+    import(json: string): number;
+    /**
+     * Clear all custom searches (keeps built-ins)
+     */
+    clearCustom(): number;
+    /**
+     * Get count of searches
+     */
+    count(): {
+        total: number;
+        custom: number;
+        builtin: number;
+    };
+}
+/**
+ * Get the global saved searches service
+ */
+export declare function getSavedSearchesService(): SavedSearchesService;
+/**
+ * Reset the saved searches service
+ */
+export declare function resetSavedSearchesService(): void;
+//# sourceMappingURL=saved-searches.d.ts.map

package/dist/core/search/saved-searches.d.ts.map

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

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

@@ -0,0 +1,205 @@
+/**
+ * Search Analytics & Learning
+ *
+ * Tracks search behavior and patterns to improve search results
+ * over time through query analysis and click tracking.
+ *
+ * @since v1.68.0
+ */
+import type { SearchResult, SearchResultType } from './search-types.js';
+/**
+ * A recorded search event
+ */
+export interface SearchEvent {
+    /** Event ID */
+    id: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Search query */
+    query: string;
+    /** Result count */
+    resultCount: number;
+    /** Search duration in ms */
+    duration: number;
+    /** Scopes searched */
+    scopes?: SearchResultType[];
+    /** Session ID */
+    sessionId: string;
+}
+/**
+ * A recorded click event
+ */
+export interface ClickEvent {
+    /** Event ID */
+    id: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Search query that led to click */
+    query: string;
+    /** Result ID that was clicked */
+    resultId: string;
+    /** Result type */
+    resultType: SearchResultType;
+    /** Position in results (0-indexed) */
+    position: number;
+    /** Session ID */
+    sessionId: string;
+}
+/**
+ * Query statistics
+ */
+export interface QueryStats {
+    /** The query */
+    query: string;
+    /** Total search count */
+    searchCount: number;
+    /** Total click count */
+    clickCount: number;
+    /** Click-through rate */
+    ctr: number;
+    /** Average result position clicked */
+    avgClickPosition: number;
+    /** Most clicked result ID */
+    topResult?: string;
+    /** Last searched */
+    lastSearched: number;
+}
+/**
+ * Search analytics summary
+ */
+export interface AnalyticsSummary {
+    /** Total searches */
+    totalSearches: number;
+    /** Total clicks */
+    totalClicks: number;
+    /** Overall CTR */
+    overallCtr: number;
+    /** Average results per search */
+    avgResultCount: number;
+    /** Average search duration */
+    avgDuration: number;
+    /** Searches with no results */
+    zeroResultSearches: number;
+    /** Top queries */
+    topQueries: QueryStats[];
+    /** Top clicked results */
+    topClickedResults: Array<{
+        resultId: string;
+        clicks: number;
+    }>;
+    /** Search distribution by scope */
+    searchesByScope: Record<SearchResultType, number>;
+}
+/**
+ * Search analytics service
+ */
+export declare class SearchAnalyticsService {
+    private searches;
+    private clicks;
+    private sessionId;
+    private maxEvents;
+    constructor(options?: {
+        maxEvents?: number;
+    });
+    /**
+     * Record a search event
+     */
+    recordSearch(query: string, resultCount: number, duration: number, scopes?: SearchResultType[]): SearchEvent;
+    /**
+     * Record a click event
+     */
+    recordClick(query: string, result: SearchResult, position: number): ClickEvent;
+    /**
+     * Get statistics for a specific query
+     */
+    getQueryStats(query: string): QueryStats | undefined;
+    /**
+     * Get popular queries
+     */
+    getPopularQueries(limit?: number): QueryStats[];
+    /**
+     * Get queries with no results
+     */
+    getZeroResultQueries(limit?: number): string[];
+    /**
+     * Get most clicked results
+     */
+    getTopClickedResults(limit?: number): Array<{
+        resultId: string;
+        clicks: number;
+    }>;
+    /**
+     * Get analytics summary
+     */
+    getSummary(): AnalyticsSummary;
+    /**
+     * Get search boost recommendations
+     */
+    getBoostRecommendations(): Map<string, number>;
+    /**
+     * Get query refinement suggestions
+     */
+    getQueryRefinements(query: string): string[];
+    /**
+     * Get time-based trends
+     */
+    getTrends(periodHours?: number): {
+        searchesPerHour: number[];
+        peakHour: number;
+        totalInPeriod: number;
+    };
+    /**
+     * Start a new session
+     */
+    newSession(): string;
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Clear all analytics data
+     */
+    clear(): void;
+    /**
+     * Get raw event counts
+     */
+    getCounts(): {
+        searches: number;
+        clicks: number;
+    };
+    /**
+     * Export analytics data
+     */
+    export(): {
+        searches: SearchEvent[];
+        clicks: ClickEvent[];
+    };
+    /**
+     * Import analytics data
+     */
+    import(data: {
+        searches?: SearchEvent[];
+        clicks?: ClickEvent[];
+    }): void;
+    /**
+     * Generate a unique event ID
+     */
+    private generateEventId;
+    /**
+     * Generate a session ID
+     */
+    private generateSessionId;
+    /**
+     * Trim events to stay within limit
+     */
+    private trimEvents;
+}
+/**
+ * Get the global search analytics service
+ */
+export declare function getSearchAnalyticsService(): SearchAnalyticsService;
+/**
+ * Reset the search analytics service
+ */
+export declare function resetSearchAnalyticsService(): void;
+//# sourceMappingURL=search-analytics.d.ts.map

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

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

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

@@ -0,0 +1,125 @@
+/**
+ * Search Engine
+ *
+ * Main search engine that coordinates indexing, searching, and ranking.
+ *
+ * @since v1.68.0
+ */
+import { type RankingConfig } from './search-ranker.js';
+import type { IndexableDocument, SearchHistoryEntry, SearchIndexStats, SearchOptions, SearchResult, SearchResultType, SearchResults } from './search-types.js';
+/**
+ * Search engine configuration
+ */
+export interface SearchEngineConfig {
+    /** Maximum results per scope */
+    maxResultsPerScope: number;
+    /** Maximum total results */
+    maxTotalResults: number;
+    /** Minimum score threshold */
+    minScoreThreshold: number;
+    /** Enable search history */
+    enableHistory: boolean;
+    /** Maximum history entries */
+    maxHistoryEntries: number;
+    /** Ranking configuration */
+    ranking?: Partial<RankingConfig>;
+}
+/**
+ * Default search engine configuration
+ */
+export declare const DEFAULT_SEARCH_CONFIG: SearchEngineConfig;
+/**
+ * Universal search engine
+ */
+export declare class SearchEngine {
+    private index;
+    private config;
+    private history;
+    private rankingContext;
+    constructor(config?: Partial<SearchEngineConfig>);
+    /**
+     * Add a document to the search index
+     */
+    addDocument(doc: IndexableDocument): void;
+    /**
+     * Add multiple documents to the index
+     */
+    addDocuments(docs: IndexableDocument[]): void;
+    /**
+     * Remove a document from the index
+     */
+    removeDocument(id: string): boolean;
+    /**
+     * Update a document in the index
+     */
+    updateDocument(doc: IndexableDocument): void;
+    /**
+     * Check if a document exists
+     */
+    hasDocument(id: string): boolean;
+    /**
+     * Get a document by ID
+     */
+    getDocument(id: string): IndexableDocument | undefined;
+    /**
+     * Search for documents
+     */
+    search(options: SearchOptions): SearchResults;
+    /**
+     * Quick search that returns flat results
+     */
+    quickSearch(query: string, limit?: number, scopes?: SearchResultType[]): SearchResult[];
+    /**
+     * Get search suggestions for a prefix
+     */
+    getSuggestions(prefix: string, limit?: number): string[];
+    /**
+     * Get recent searches
+     */
+    getRecentSearches(limit?: number): SearchHistoryEntry[];
+    /**
+     * Clear search history
+     */
+    clearHistory(): void;
+    /**
+     * Add entry to search history
+     */
+    private addToHistory;
+    /**
+     * Get documents by type
+     */
+    getDocumentsByType(type: SearchResultType): IndexableDocument[];
+    /**
+     * Get index statistics
+     */
+    getStats(): SearchIndexStats;
+    /**
+     * Clear the entire index
+     */
+    clear(): void;
+    /**
+     * Rebuild the index
+     */
+    rebuild(): void;
+    /**
+     * Set custom ranking boosts
+     */
+    setBoosts(boosts: Map<string, number>): void;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<SearchEngineConfig>): void;
+}
+/**
+ * Get the global search engine instance
+ */
+export declare function getSearchEngine(): SearchEngine;
+/**
+ * Create a new search engine
+ */
+export declare function createSearchEngine(config?: Partial<SearchEngineConfig>): SearchEngine;
+/**
+ * Reset the global search engine instance
+ */
+export declare function resetSearchEngine(): void;
+//# sourceMappingURL=search-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-engine.d.ts","sourceRoot":"","sources":["../../../src/core/search/search-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,KAAK,aAAa,EAA4E,MAAM,oBAAoB,CAAC;AAClI,OAAO,KAAK,EAAE,iBAAiB,EAAsB,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAqB,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtM;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAMnC,CAAC;AAiBF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,cAAc,CAA8C;gBAExD,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAKpD;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAYzC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAM7C;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAK5C;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAItD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa;IA8E7C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE;IAmBnF;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;IAKnD;;OAEG;IACH,iBAAiB,CAAC,KAAK,SAAK,GAAG,kBAAkB,EAAE;IAInD;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,EAAE;IAI/D;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI5C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;CAGxD;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY,CAErF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}