@nindroidsystems/pluginator 2.3.0

package/dist/core/sources/jenkins.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Jenkins Source
+ *
+ * Fetches plugin information from Jenkins CI servers using the REST API
+ * API Docs: https://www.jenkins.io/doc/book/using/remote-access-api/
+ */
+import type { PluginInfo, SourceType } from '../types/index.js';
+import { BasePluginSource } from './base.js';
+/**
+ * Jenkins API response types
+ */
+/**
+ * Jenkins build artifact information
+ */
+interface JenkinsArtifact {
+    displayPath: string;
+    fileName: string;
+    relativePath: string;
+}
+/**
+ * Jenkins build information from lastSuccessfulBuild
+ */
+interface JenkinsBuild {
+    number: number;
+    url: string;
+    timestamp: number;
+    duration: number;
+    result: string;
+    displayName?: string;
+    description?: string;
+    artifacts: JenkinsArtifact[];
+}
+/**
+ * Configuration options for JenkinsSource
+ */
+export interface JenkinsSourceOptions {
+    /** Base URL of the Jenkins server (e.g., "https://ci.example.com") */
+    baseUrl: string;
+    /** Username for authentication (optional) */
+    username?: string;
+    /** API token for authentication (optional) */
+    apiToken?: string;
+    /** Cache TTL in seconds (default: 300) */
+    cacheTtlSeconds?: number;
+}
+/**
+ * JenkinsSource implementation for fetching plugins from Jenkins CI
+ */
+export declare class JenkinsSource extends BasePluginSource {
+    readonly id: string;
+    readonly name = "Jenkins CI";
+    readonly type: SourceType;
+    private readonly baseUrl;
+    private readonly username;
+    private readonly apiToken;
+    /**
+     * Create a new JenkinsSource
+     * @param options - Configuration options
+     */
+    constructor(options: JenkinsSourceOptions);
+    /**
+     * Encode a job path for use in URLs
+     * Handles nested folder paths like "Folder/job/JobName" by encoding each segment
+     * but preserving the /job/ separators
+     * @param jobPath - The job path (e.g., "EvenMoreFish/job/EvenMoreFish" or just "JobName")
+     * @returns Properly encoded path segment
+     */
+    private encodeJobPath;
+    /**
+     * Set authentication credentials
+     * @param username - Jenkins username
+     * @param apiToken - Jenkins API token
+     */
+    setCredentials(username: string, apiToken: string): void;
+    /**
+     * Get plugin info by job name
+     * @param jobName - Jenkins job name
+     * @param artifactType - Optional artifact type filter (e.g., "jar")
+     * @returns Plugin info or null if not found
+     */
+    getPluginInfo(jobName: string, artifactType?: string): Promise<PluginInfo | null>;
+    /**
+     * Search for plugins (not supported by Jenkins)
+     * Jenkins doesn't have a search API, so this returns an empty array
+     * @param _query - Search query (unused)
+     * @param _limit - Maximum results (unused)
+     * @returns Empty array
+     */
+    searchPlugins(_query: string, _limit?: number): Promise<PluginInfo[]>;
+    /**
+     * Get latest version (build number) for a job
+     * @param jobName - Jenkins job name
+     * @returns Build number as string, or null if no successful builds
+     */
+    getLatestVersion(jobName: string): Promise<string | null>;
+    /**
+     * Build the download URL for an artifact
+     * @param jobName - Jenkins job name
+     * @param artifactPath - Relative path to the artifact
+     * @returns Download URL
+     */
+    buildDownloadUrl(jobName: string, artifactPath: string): string;
+    /**
+     * Get all artifacts for a job's latest successful build
+     * @param jobName - Jenkins job name
+     * @returns Array of artifacts
+     */
+    getArtifacts(jobName: string): Promise<JenkinsArtifact[]>;
+    /**
+     * Get build information for a specific build number
+     * @param jobName - Jenkins job name
+     * @param buildNumber - Build number
+     * @returns Build info or null
+     */
+    getBuild(jobName: string, buildNumber: number): Promise<JenkinsBuild | null>;
+    /**
+     * Override headers to include authentication if configured
+     */
+    protected buildHeaders(additional?: Record<string, string>): Record<string, string>;
+    /**
+     * Parse Jenkins build into PluginInfo
+     * @param job - Jenkins job information
+     * @param build - Jenkins build information
+     * @param artifactType - Optional artifact type filter
+     * @returns Plugin info or null if no suitable artifact found
+     */
+    private parseBuild;
+    /**
+     * Find the best artifact from a build
+     * @param artifacts - List of build artifacts
+     * @param artifactType - Optional type filter (e.g., "jar")
+     * @returns Best matching artifact or undefined
+     */
+    private findArtifact;
+    /**
+     * Clean version string (remove 'v' prefix, etc.)
+     * @param version - Raw version string
+     * @returns Cleaned version
+     */
+    private cleanVersion;
+}
+/**
+ * Create a JenkinsSource instance with the given options
+ * @param options - Configuration options
+ * @returns JenkinsSource instance
+ */
+export declare function createJenkinsSource(options: JenkinsSourceOptions): JenkinsSource;
+export {};
+//# sourceMappingURL=jenkins.d.ts.map

package/dist/core/sources/jenkins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jenkins.d.ts","sourceRoot":"","sources":["../../../src/core/sources/jenkins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAe,MAAM,WAAW,CAAC;AAE1D;;GAEG;AAEH;;GAEG;AACH,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAiBD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAa;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAEhD;;;OAGG;gBACS,OAAO,EAAE,oBAAoB;IAgBzC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IASrB;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxD;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA+BvF;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAK3E;;;;OAIG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgB/D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAI/D;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAS/D;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAQlF;;OAEG;cACgB,YAAY,CAAC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAWhG;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IA0BlB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAGrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF"}

package/dist/core/sources/modrinth.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Modrinth Source
+ *
+ * Fetches plugin information from Modrinth using API v2
+ * API Docs: https://docs.modrinth.com/
+ *
+ * @since v1.0.0
+ * @updated v1.37.0 - Uses enhanced caching and retry support
+ */
+import type { PluginInfo, SourceType } from '../types/index.js';
+import { BasePluginSource, type BaseSourceOptions } from './base.js';
+/**
+ * ModrinthSource implementation
+ *
+ * Uses enhanced caching with statistics and automatic retry on transient failures.
+ */
+export declare class ModrinthSource extends BasePluginSource {
+    readonly id = "modrinth";
+    readonly name = "Modrinth";
+    readonly type: SourceType;
+    private static readonly API_BASE;
+    private minecraftVersion;
+    private versionCache;
+    constructor(options?: BaseSourceOptions);
+    /**
+     * Set the target Minecraft version for filtering
+     */
+    setMinecraftVersion(version: string): void;
+    /**
+     * Get plugin info by project slug or ID
+     */
+    getPluginInfo(slugOrId: string): Promise<PluginInfo | null>;
+    /**
+     * Search for plugins
+     */
+    searchPlugins(query: string, limit?: number): Promise<PluginInfo[]>;
+    /**
+     * Get latest version for a project
+     */
+    getLatestVersion(slugOrId: string): Promise<string | null>;
+    /**
+     * Get versions for a project with loader/version filtering
+     */
+    private getVersionsForProject;
+    /**
+     * Check if source supports a Minecraft version
+     */
+    supportsMinecraftVersion(mcVersion: string): Promise<boolean>;
+    /**
+     * Parse Modrinth project and version into PluginInfo
+     */
+    private parseProject;
+}
+//# sourceMappingURL=modrinth.d.ts.map

package/dist/core/sources/modrinth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modrinth.d.ts","sourceRoot":"","sources":["../../../src/core/sources/modrinth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAe,MAAM,WAAW,CAAC;AA0ElF;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAc;IAEvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IACjE,OAAO,CAAC,gBAAgB,CAAuB;IAG/C,OAAO,CAAC,YAAY,CAAsE;gBAE9E,OAAO,GAAE,iBAAsB;IAgB3C;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM1C;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA2CjE;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6BrE;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBhE;;OAEG;YACW,qBAAqB;IAkCnC;;OAEG;IACY,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5E;;OAEG;IACH,OAAO,CAAC,YAAY;CAsBrB"}

package/dist/core/sources/registry.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Source Registry
+ *
+ * Manages multiple plugin sources with priority ordering
+ */
+import type { IPluginSource, PluginInfo, PluginUpdateInfo, SourceConfig } from '../types/index.js';
+/**
+ * Source Registry manages all plugin sources
+ */
+export declare class SourceRegistry {
+    private sources;
+    private configPath;
+    constructor(configPath?: string);
+    /**
+     * Add a source to the registry
+     */
+    addSource(source: IPluginSource): boolean;
+    /**
+     * Remove a source from the registry
+     */
+    removeSource(id: string): boolean;
+    /**
+     * Get a source by ID
+     */
+    getSource(id: string): IPluginSource | undefined;
+    /**
+     * Get all registered sources
+     */
+    getAllSources(): IPluginSource[];
+    /**
+     * Get enabled sources, sorted by priority (highest first)
+     */
+    getEnabledSources(): IPluginSource[];
+    /**
+     * Get sources of a specific type
+     */
+    getSourcesByType(type: string): IPluginSource[];
+    /**
+     * Check for plugin updates across all enabled sources
+     * Uses priority ordering - first source with a valid update wins
+     */
+    checkUpdate(pluginName: string, currentVersion: string, identifier: string, sourceType?: string): Promise<PluginUpdateInfo>;
+    /**
+     * Search for plugins across all enabled sources
+     */
+    searchAll(query: string, limit?: number): Promise<PluginInfo[]>;
+    /**
+     * Load sources configuration from file
+     */
+    loadConfig(): Promise<boolean>;
+    /**
+     * Save sources configuration to file
+     */
+    saveConfig(sources: SourceConfig[]): Promise<boolean>;
+    /**
+     * Get source count
+     */
+    get count(): number;
+    /**
+     * Get enabled source count
+     */
+    get enabledCount(): number;
+    /**
+     * Clear all sources
+     */
+    clear(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/sources/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/sources/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AAKlH;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,SAAqB;IAI3C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAQzC;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD;;OAEG;IACH,aAAa,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACH,iBAAiB,IAAI,aAAa,EAAE;IAMpC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAI/C;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqCjI;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA4BjE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBpC;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAe3D;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/sources/source-cache-factory.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Source Cache Factory
+ *
+ * Factory for creating cache instances for plugin sources.
+ * Provides a bridge between the source utilities and the infrastructure CacheService.
+ *
+ * This allows sources to use either:
+ * 1. The simple SourceCache from utils (lightweight, in-memory only)
+ * 2. The full CacheService from infrastructure (size limits, persistence, stats)
+ *
+ * @since v1.39.0
+ */
+import { generateCacheKey, getCacheService } from '../../infrastructure/cache/cache-service.js';
+import { type CacheStats, type SourceCacheOptions } from './utils/source-cache.js';
+/**
+ * Source cache configuration
+ */
+export interface SourceCacheConfig {
+    /** Source name (used for cache key prefixes) */
+    sourceName: string;
+    /** Default TTL in milliseconds (default: 5 minutes) */
+    defaultTtl?: number;
+    /** Maximum cache entries (default: 500) */
+    maxSize?: number;
+    /** Use infrastructure CacheService instead of simple SourceCache (default: false) */
+    useInfrastructure?: boolean;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Unified cache interface that works with both cache implementations
+ */
+export interface ISourceCache<T> {
+    /** Get a value from cache */
+    get(key: string): T | undefined;
+    /** Set a value in cache */
+    set(key: string, data: T, ttlMs?: number): void;
+    /** Check if key exists */
+    has(key: string): boolean;
+    /** Delete a key */
+    delete(key: string): boolean;
+    /** Clear all entries */
+    clear(): void;
+    /** Invalidate entries matching pattern */
+    invalidate(pattern?: RegExp | string): number;
+    /** Get cache size */
+    readonly size: number;
+    /** Get cache statistics */
+    getStats(): CacheStats;
+    /** Reset statistics */
+    resetStats(): void;
+    /** Get or set with async fetcher */
+    getOrSet(key: string, fetcher: () => Promise<T>, ttlMs?: number): Promise<T>;
+}
+/**
+ * Create a cache instance for a plugin source
+ *
+ * @example
+ * ```typescript
+ * // Simple cache (default)
+ * const cache = createSourceCacheForSource<PluginInfo>({
+ *   sourceName: 'modrinth',
+ *   defaultTtl: 5 * 60 * 1000,
+ * });
+ *
+ * // Use infrastructure CacheService
+ * const cache = createSourceCacheForSource<PluginInfo>({
+ *   sourceName: 'modrinth',
+ *   useInfrastructure: true,
+ * });
+ *
+ * // Usage
+ * const info = await cache.getOrSet('plugin:essentialsx', () => fetchPluginInfo('essentialsx'));
+ * ```
+ */
+export declare function createSourceCacheForSource<T>(config: SourceCacheConfig): ISourceCache<T>;
+/**
+ * Get the global CacheService singleton
+ * Use this when you need access to the shared infrastructure cache
+ */
+export { getCacheService, generateCacheKey };
+/**
+ * Type re-exports for convenience
+ */
+export type { CacheStats, SourceCacheOptions };
+//# sourceMappingURL=source-cache-factory.d.ts.map

package/dist/core/sources/source-cache-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-cache-factory.d.ts","sourceRoot":"","sources":["../../../src/core/sources/source-cache-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAgB,gBAAgB,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAI9G,OAAO,EAAE,KAAK,UAAU,EAAe,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIhG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,6BAA6B;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAChC,2BAA2B;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,mBAAmB;IACnB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,wBAAwB;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,0CAA0C;IAC1C,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9C,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,IAAI,UAAU,CAAC;IACvB,uBAAuB;IACvB,UAAU,IAAI,IAAI,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9E;AAkLD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAAC,CAAC,CAaxF;AAED;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAE7C;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -0,0 +1,181 @@
+/**
+ * Sources Service
+ *
+ * Manages loading, merging, and accessing plugin sources.
+ * Supports both bundled (read-only) sources and user custom sources.
+ *
+ * Key behaviors:
+ * - Bundled sources cannot be deleted, only disabled via UI
+ * - User sources can override bundled source settings
+ * - User can add new custom sources
+ */
+import type { SourceConfig } from '../types/source.js';
+/**
+ * Extended source config with bundled flag
+ */
+export interface ExtendedSourceConfig extends SourceConfig {
+    /** Whether this source is bundled with the application (read-only) */
+    bundled?: boolean;
+    /** Whether this source requires an API key */
+    requiresApiKey?: boolean;
+    /** Environment variable name for API key */
+    apiKeyEnvVar?: string;
+}
+/**
+ * User source override - can modify enabled state or provide API keys
+ */
+export interface UserSourceOverride {
+    /** Source ID to override */
+    id: string;
+    /** Override enabled state */
+    enabled?: boolean;
+    /** API key for authenticated sources */
+    apiKey?: string;
+    /** Additional settings */
+    settings?: Record<string, unknown>;
+}
+/**
+ * User sources configuration file structure
+ */
+export interface UserSourcesConfig {
+    version: string;
+    description?: string;
+    /** Overrides for bundled sources (can only disable, not delete) */
+    overrides: UserSourceOverride[];
+    /** Custom user-defined sources */
+    customSources: SourceConfig[];
+}
+/**
+ * Sources Service class
+ */
+export declare class SourcesService {
+    private bundledSources;
+    private userOverrides;
+    private customSources;
+    private mergedSources;
+    private loaded;
+    private bundledPath;
+    private userPath;
+    constructor(bundledPath?: string, userPath?: string);
+    /**
+     * Load sources from bundled and user files
+     */
+    load(): boolean;
+    /**
+     * Load bundled sources from the defaults file
+     */
+    private loadBundledSources;
+    /**
+     * Load user sources from the user config file
+     */
+    private loadUserSources;
+    /**
+     * Merge bundled and user sources
+     * User overrides are applied to bundled sources
+     * Custom sources are appended at the end
+     */
+    private mergeSources;
+    /**
+     * Get default fallback sources
+     */
+    private getDefaultSources;
+    /**
+     * Check if service is loaded
+     */
+    isLoaded(): boolean;
+    /**
+     * Get all merged sources
+     */
+    getAll(): ExtendedSourceConfig[];
+    /**
+     * Get only enabled sources
+     */
+    getEnabled(): ExtendedSourceConfig[];
+    /**
+     * Get source by ID
+     */
+    getById(id: string): ExtendedSourceConfig | undefined;
+    /**
+     * Get sources by type
+     */
+    getByType(type: string): ExtendedSourceConfig[];
+    /**
+     * Check if a source is bundled (cannot be deleted)
+     */
+    isBundled(id: string): boolean;
+    /**
+     * Disable a bundled source via UI
+     * This saves an override to the user config
+     *
+     * @internal Should only be called from UI components
+     */
+    disableSource(id: string): boolean;
+    /**
+     * Enable a source via UI
+     *
+     * @internal Should only be called from UI components
+     */
+    enableSource(id: string): boolean;
+    /**
+     * Set the enabled state of a source
+     *
+     * @internal Should only be called from UI components
+     */
+    setSourceEnabled(id: string, enabled: boolean): boolean;
+    /**
+     * Set API key for a source
+     *
+     * @internal Should only be called from UI components
+     */
+    setSourceApiKey(id: string, apiKey: string): boolean;
+    /**
+     * Add a custom source
+     *
+     * @internal Should only be called from UI components
+     */
+    addCustomSource(source: SourceConfig): boolean;
+    /**
+     * Remove a custom source (cannot remove bundled sources)
+     *
+     * @internal Should only be called from UI components
+     */
+    removeCustomSource(id: string): boolean;
+    /**
+     * Update a custom source
+     *
+     * @internal Should only be called from UI components
+     */
+    updateCustomSource(id: string, updates: Partial<SourceConfig>): boolean;
+    /**
+     * Save user configuration to file
+     */
+    private saveUserConfig;
+    /**
+     * Reset user overrides to defaults
+     *
+     * @internal Should only be called from UI components
+     */
+    resetOverrides(): boolean;
+    /**
+     * Get statistics about sources
+     */
+    getStats(): {
+        total: number;
+        enabled: number;
+        bundled: number;
+        custom: number;
+    };
+}
+/**
+ * Get the singleton sources service
+ */
+export declare function getSourcesService(): SourcesService;
+/**
+ * Create a new sources service (for testing)
+ */
+export declare function createSourcesService(bundledPath?: string, userPath?: string): SourcesService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetSourcesService(): void;
+//# sourceMappingURL=sources-service.d.ts.map

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

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

package/dist/core/sources/spigot.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Spigot Source
+ *
+ * Fetches plugin information from SpigotMC using the Spiget API v2
+ * API Docs: https://spiget.org/documentation
+ */
+import type { PluginInfo, SourceType } from '../types/index.js';
+import { BasePluginSource } from './base.js';
+/**
+ * SpigotSource implementation using Spiget API
+ */
+export declare class SpigotSource extends BasePluginSource {
+    readonly id = "spigot";
+    readonly name = "SpigotMC";
+    readonly type: SourceType;
+    private static readonly API_BASE;
+    /**
+     * Get plugin info by resource ID
+     */
+    getPluginInfo(resourceId: string): Promise<PluginInfo | null>;
+    /**
+     * Search for plugins
+     */
+    searchPlugins(query: string, limit?: number): Promise<PluginInfo[]>;
+    /**
+     * Get latest version for a resource
+     */
+    getLatestVersion(resourceId: string): Promise<string | null>;
+    /**
+     * Build download URL for a resource
+     */
+    buildDownloadUrl(resourceId: string): string;
+    /**
+     * Check if source supports a Minecraft version
+     */
+    supportsMinecraftVersion(mcVersion: string): Promise<boolean>;
+    /**
+     * Parse Spiget resource response into PluginInfo
+     */
+    /**
+     * Build SpigotMC resource page URL
+     */
+    private buildResourceUrl;
+    /**
+     * Parse Spiget resource response into PluginInfo
+     */
+    private parseResource;
+}
+//# sourceMappingURL=spigot.d.ts.map

package/dist/core/sources/spigot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spigot.d.ts","sourceRoot":"","sources":["../../../src/core/sources/spigot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAe,MAAM,WAAW,CAAC;AAgD1D;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAY;IAErC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IAE/D;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAuBnE;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsBrE;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASlE;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACY,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5E;;OAEG;IACH;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,aAAa;CAoBtB"}

package/dist/core/sources/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Source Utilities
+ *
+ * Common utilities for plugin source implementations.
+ *
+ * @since v1.37.0
+ */
+export { SourceRequestBuilder, createSourceRequestBuilder, type AuthType, type RequestBuilderOptions, type RequestOptions, } from './request-builder.js';
+export { withRetry, retryable, executeWithRetry, isRetryableError, DEFAULT_RETRY_OPTIONS, type RetryOptions, } from './retry-decorator.js';
+export { SourceCache, createSourceCache, type CacheEntryData, type CacheStats, type SourceCacheOptions, } from './source-cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/sources/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/sources/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC"}