@nindroidsystems/pluginator 2.3.0

package/dist/core/sources/utils/request-builder.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Source Request Builder
+ *
+ * Fluent builder for constructing HTTP requests with consistent
+ * headers, authentication, and timeout handling.
+ *
+ * @since v1.37.0
+ */
+import type { ZodSchema } from 'zod';
+/**
+ * Authentication type for requests
+ */
+export type AuthType = 'bearer' | 'api-key' | 'basic';
+/**
+ * Request builder options
+ */
+export interface RequestBuilderOptions {
+    /** Base URL for all requests */
+    baseUrl?: string;
+    /** Default timeout in milliseconds */
+    timeout?: number;
+    /** Default User-Agent header */
+    userAgent?: string;
+    /** Source name for error context */
+    sourceName?: string;
+}
+/**
+ * Request options for individual requests
+ */
+export interface RequestOptions {
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Request body (for POST/PUT) */
+    body?: unknown;
+    /** HTTP method */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+}
+/**
+ * Fluent request builder for source API calls
+ *
+ * @example
+ * ```typescript
+ * const builder = new SourceRequestBuilder({
+ *   baseUrl: 'https://api.modrinth.com/v2',
+ *   userAgent: 'Pluginator/1.0',
+ * });
+ *
+ * const data = await builder
+ *   .withAuth('bearer', token)
+ *   .get('/project/sodium', ProjectSchema);
+ * ```
+ */
+export declare class SourceRequestBuilder {
+    private baseUrl;
+    private timeout;
+    private userAgent;
+    private sourceName;
+    private headers;
+    constructor(options?: RequestBuilderOptions);
+    /**
+     * Clone the builder with current settings
+     */
+    clone(): SourceRequestBuilder;
+    /**
+     * Set authentication header
+     */
+    withAuth(type: AuthType, credentials: string, keyHeader?: string): this;
+    /**
+     * Set custom User-Agent
+     */
+    withUserAgent(userAgent: string): this;
+    /**
+     * Set request timeout
+     */
+    withTimeout(ms: number): this;
+    /**
+     * Set base URL
+     */
+    withBaseUrl(baseUrl: string): this;
+    /**
+     * Set source name for error context
+     */
+    withSourceName(name: string): this;
+    /**
+     * Add custom header
+     */
+    withHeader(key: string, value: string): this;
+    /**
+     * Add multiple headers
+     */
+    withHeaders(headers: Record<string, string>): this;
+    /**
+     * Build the full URL
+     */
+    private buildUrl;
+    /**
+     * Execute a fetch request with error handling
+     */
+    private fetchWithErrorHandling;
+    /**
+     * Make a GET request
+     *
+     * @param path - URL path (will be appended to baseUrl)
+     * @param schema - Optional Zod schema for response validation
+     */
+    get<T>(path: string, schema?: ZodSchema<T>): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T>(path: string, body?: unknown, schema?: ZodSchema<T>): Promise<T>;
+    /**
+     * Make a raw request without JSON parsing (for binary data)
+     */
+    getRaw(path: string): Promise<Response>;
+    /**
+     * Make a HEAD request (useful for checking if a resource exists)
+     */
+    head(path: string): Promise<Response>;
+}
+/**
+ * Create a pre-configured request builder for a specific source
+ */
+export declare function createSourceRequestBuilder(sourceName: string, options?: Omit<RequestBuilderOptions, 'sourceName'>): SourceRequestBuilder;
+//# sourceMappingURL=request-builder.d.ts.map

package/dist/core/sources/utils/request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../../../src/core/sources/utils/request-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAK,MAAM,KAAK,CAAC;AAGxC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;CACtD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA8B;gBAEjC,OAAO,GAAE,qBAA0B;IAa/C;;OAEG;IACH,KAAK,IAAI,oBAAoB;IAW7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAevE;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMtC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKlD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;YACW,sBAAsB;IAoCpC;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB7D;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB9E;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ7C;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAO5C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAM,GAAG,oBAAoB,CAM5I"}

package/dist/core/sources/utils/retry-decorator.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Retry Decorator
+ *
+ * Reusable retry logic with exponential backoff for source operations.
+ *
+ * @since v1.37.0
+ */
+/**
+ * Retry configuration options
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts?: number;
+    /** Base delay in milliseconds (default: 1000) */
+    baseDelay?: number;
+    /** Maximum delay in milliseconds (default: 10000) */
+    maxDelay?: number;
+    /** Whether to add random jitter to delays (default: true) */
+    jitter?: boolean;
+    /** Custom function to determine if an error is retryable */
+    isRetryable?: (error: unknown) => boolean;
+    /** Callback invoked before each retry */
+    onRetry?: (attempt: number, error: unknown, delay: number) => void;
+}
+/**
+ * Default retry options
+ */
+export declare const DEFAULT_RETRY_OPTIONS: Required<Omit<RetryOptions, 'isRetryable' | 'onRetry'>>;
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Wrap a function with retry logic
+ *
+ * @example
+ * ```typescript
+ * const fetchWithRetry = withRetry(
+ *   async (url: string) => fetch(url),
+ *   { maxAttempts: 3, baseDelay: 1000 }
+ * );
+ *
+ * const response = await fetchWithRetry('https://api.example.com');
+ * ```
+ */
+export declare function withRetry<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: RetryOptions): T;
+/**
+ * Decorator for class methods to add retry logic
+ *
+ * @example
+ * ```typescript
+ * class ApiClient {
+ *   @retryable({ maxAttempts: 3 })
+ *   async fetchData(): Promise<Data> {
+ *     return fetch('/api/data');
+ *   }
+ * }
+ * ```
+ */
+export declare function retryable(options?: RetryOptions): <T extends (...args: unknown[]) => Promise<unknown>>(_target: unknown, _propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * Execute a function with retry logic (standalone version)
+ *
+ * @example
+ * ```typescript
+ * const result = await executeWithRetry(
+ *   () => fetch('https://api.example.com'),
+ *   { maxAttempts: 3 }
+ * );
+ * ```
+ */
+export declare function executeWithRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry-decorator.d.ts.map

package/dist/core/sources/utils/retry-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-decorator.d.ts","sourceRoot":"","sources":["../../../../src/core/sources/utils/retry-decorator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,SAAS,CAAC,CAKzF,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAwBxD;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,CAAC,CA+BlH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,YAAiB,IAC1C,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,cAAc,MAAM,EAAE,YAAY,uBAAuB,CAAC,CAAC,CAAC,KAAG,uBAAuB,CAAC,CAAC,CAAC,CAOxK;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAGtG"}

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

@@ -0,0 +1,124 @@
+/**
+ * Source Cache
+ *
+ * TTL-based in-memory cache for source API responses.
+ * Supports pattern-based invalidation and cache statistics.
+ *
+ * @since v1.37.0
+ */
+/**
+ * Cache entry with data and expiry
+ */
+export interface CacheEntryData<T> {
+    data: T;
+    expiry: number;
+    createdAt: number;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    hitRate: number;
+}
+/**
+ * Cache options
+ */
+export interface SourceCacheOptions {
+    /** Default TTL in milliseconds (default: 5 minutes) */
+    defaultTtl?: number;
+    /** Maximum cache size (default: 1000) */
+    maxSize?: number;
+    /** Whether to log cache operations (default: false) */
+    debug?: boolean;
+    /** Cache name for logging */
+    name?: string;
+}
+/**
+ * TTL-based in-memory cache for source data
+ *
+ * @example
+ * ```typescript
+ * const cache = new SourceCache<PluginInfo>({ defaultTtl: 5 * 60 * 1000 });
+ *
+ * // Set with default TTL
+ * cache.set('plugin:essentialsx', pluginInfo);
+ *
+ * // Get (returns undefined if expired or not found)
+ * const info = cache.get('plugin:essentialsx');
+ *
+ * // Invalidate by pattern
+ * cache.invalidate(/^plugin:/);
+ * ```
+ */
+export declare class SourceCache<T> {
+    private cache;
+    private readonly defaultTtl;
+    private readonly maxSize;
+    private readonly debug;
+    private readonly name;
+    private hits;
+    private misses;
+    constructor(options?: SourceCacheOptions);
+    /**
+     * Get a value from cache
+     * Returns undefined if not found or expired
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set a value in cache
+     */
+    set(key: string, data: T, ttlMs?: number): void;
+    /**
+     * Check if a key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a specific key
+     */
+    delete(key: string): boolean;
+    /**
+     * Invalidate cache entries matching a pattern
+     * If no pattern provided, clears entire cache
+     */
+    invalidate(pattern?: RegExp | string): number;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Get or set - returns cached value or fetches and caches new value
+     */
+    getOrSet(key: string, fetcher: () => Promise<T>, ttlMs?: number): Promise<T>;
+    /**
+     * Cleanup expired entries
+     */
+    cleanup(): number;
+    /**
+     * Evict oldest entries when at max size
+     */
+    private evictOldest;
+    /**
+     * Log debug message if debug mode is enabled
+     */
+    private logDebug;
+}
+/**
+ * Create a cache instance with common source defaults
+ */
+export declare function createSourceCache<T>(name: string, ttlMs?: number): SourceCache<T>;
+//# sourceMappingURL=source-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-cache.d.ts","sourceRoot":"","sources":["../../../../src/core/sources/utils/source-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW,CAAC,CAAC;IACxB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAG9B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,GAAE,kBAAuB;IAO5C;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAqB/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB/C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAsB7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,IAAI,UAAU;IAUtB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAWlF;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAKjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,CAOxF"}

package/dist/core/sources/web-manifest.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Web Manifest Source
+ *
+ * Fetches plugin information from custom JSON manifest files
+ * Used for self-hosted plugin repositories
+ */
+import type { PluginInfo, SourceType } from '../types/index.js';
+import { BasePluginSource } from './base.js';
+/**
+ * WebManifestSource implementation
+ */
+export declare class WebManifestSource extends BasePluginSource {
+    readonly id: string;
+    readonly name: string;
+    readonly type: SourceType;
+    private manifestUrl;
+    private manifestCache;
+    private cacheExpiry;
+    constructor(id: string, name: string, manifestUrl: string, cacheTtlSeconds?: number);
+    /**
+     * Get plugin info by name
+     */
+    getPluginInfo(pluginName: string): Promise<PluginInfo | null>;
+    /**
+     * Search for plugins in the manifest
+     */
+    searchPlugins(query: string, limit?: number): Promise<PluginInfo[]>;
+    /**
+     * Get latest version for a plugin
+     */
+    getLatestVersion(pluginName: string): Promise<string | null>;
+    /**
+     * Get all plugins from the manifest
+     */
+    listPlugins(): Promise<PluginInfo[]>;
+    /**
+     * Get the manifest URL
+     */
+    getManifestUrl(): string;
+    /**
+     * Set a new manifest URL
+     */
+    setManifestUrl(url: string): void;
+    /**
+     * Load and cache the manifest
+     */
+    private loadManifest;
+    /**
+     * Parse manifest plugin into PluginInfo
+     */
+    private parsePlugin;
+}
+/**
+ * Create a WebManifestSource from a config object
+ */
+export declare function createWebManifestSource(config: {
+    id: string;
+    name: string;
+    url: string;
+    cacheTtl?: number;
+}): WebManifestSource;
+//# sourceMappingURL=web-manifest.d.ts.map

package/dist/core/sources/web-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-manifest.d.ts","sourceRoot":"","sources":["../../../src/core/sources/web-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAe,MAAM,WAAW,CAAC;AAmC1D;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAS;IAElC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,WAAW,CAAU;gBAEjB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,SAAM;IAYhF;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqBnE;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAerE;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUlE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAS1C;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;YACW,YAAY;IAiB1B;;OAEG;IACH,OAAO,CAAC,WAAW;CA0BpB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,iBAAiB,CAEpB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Statistics Module Exports
+ *
+ * @since v1.23.0
+ */
+export { StatsService, getStatsService, resetStatsService, DEFAULT_STATS_CONFIG, type StatsConfig, } from './stats-service.js';
+export type { PluginStats, SourceStats, ServerStats, StatsStore, UpdateEvent, RecentError, HealthFactors, } from './stats-types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/stats/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,135 @@
+/**
+ * Statistics Service
+ *
+ * Tracks plugin update history, health metrics, and provides insights.
+ *
+ * @since v1.23.0
+ */
+import type { PluginSourceType } from '../types/index.js';
+import type { HealthFactors, PluginStats, RecentError, ServerStats, SourceStats, UpdateEvent } from './stats-types.js';
+/**
+ * Configuration for the stats service
+ */
+export interface StatsConfig {
+    /** Maximum update events to keep per plugin */
+    maxEventsPerPlugin: number;
+    /** Days to consider for "recent" errors */
+    recentErrorDays: number;
+    /** Days without update to consider "outdated" */
+    outdatedDays: number;
+}
+/**
+ * Default stats configuration
+ */
+export declare const DEFAULT_STATS_CONFIG: StatsConfig;
+/**
+ * Statistics Service
+ *
+ * Tracks and analyzes plugin management statistics.
+ */
+export declare class StatsService {
+    private store;
+    private storagePath;
+    private loaded;
+    private config;
+    constructor(storagePath?: string, config?: Partial<StatsConfig>);
+    /**
+     * Create an empty store
+     */
+    private createEmptyStore;
+    /**
+     * Load stats from disk
+     */
+    load(): Promise<void>;
+    /**
+     * Save stats to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Record an update check event
+     */
+    recordUpdateCheck(pluginName: string, source: PluginSourceType, responseTimeMs?: number): Promise<void>;
+    /**
+     * Record an update download event
+     */
+    recordUpdateDownload(pluginName: string, event: Omit<UpdateEvent, 'date'>): Promise<void>;
+    /**
+     * Record an error for a plugin
+     */
+    recordError(pluginName: string, error: string): Promise<void>;
+    /**
+     * Update server statistics
+     */
+    updateServerStats(stats: Partial<ServerStats>): Promise<void>;
+    /**
+     * Get statistics for a specific plugin
+     */
+    getPluginStats(pluginName: string): PluginStats | null;
+    /**
+     * Get statistics for a specific source
+     */
+    getSourceStats(source: PluginSourceType): SourceStats | null;
+    /**
+     * Get all source statistics
+     */
+    getAllSourceStats(): SourceStats[];
+    /**
+     * Get server statistics
+     */
+    getServerStats(): ServerStats;
+    /**
+     * Get all plugin statistics
+     */
+    getAllPluginStats(): PluginStats[];
+    /**
+     * Get outdated plugins (no update check in X days)
+     */
+    getOutdatedPlugins(daysSinceCheck?: number): PluginStats[];
+    /**
+     * Get most frequently updated plugins
+     */
+    getMostUpdatedPlugins(limit?: number): PluginStats[];
+    /**
+     * Get recent errors
+     */
+    getRecentErrors(limit?: number): RecentError[];
+    /**
+     * Get recent successful updates
+     */
+    getRecentUpdates(limit?: number): Array<UpdateEvent & {
+        pluginName: string;
+    }>;
+    /**
+     * Calculate health score
+     */
+    calculateHealthScore(): HealthFactors;
+    /**
+     * Get plugin count by source
+     */
+    getPluginCountBySource(): Record<string, number>;
+    /**
+     * Clear all statistics
+     */
+    clear(): Promise<void>;
+    /**
+     * Get the last updated timestamp
+     */
+    getLastUpdated(): Date | null;
+    /**
+     * Set plugin source for tracking
+     */
+    setPluginSource(pluginName: string, source: PluginSourceType): Promise<void>;
+    /**
+     * Recalculate total plugins per source
+     */
+    private recalculateSourcePluginCounts;
+}
+/**
+ * Get the singleton stats service instance
+ */
+export declare function getStatsService(): StatsService;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetStatsService(): void;
+//# sourceMappingURL=stats-service.d.ts.map

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

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

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

@@ -0,0 +1,130 @@
+/**
+ * Statistics Types
+ *
+ * Type definitions for plugin statistics tracking.
+ *
+ * @since v1.23.0
+ */
+import type { PluginSourceType } from '../types/index.js';
+/**
+ * Update event record
+ */
+export interface UpdateEvent {
+    /** When the update occurred */
+    date: string;
+    /** Version before update */
+    fromVersion: string;
+    /** Version after update */
+    toVersion: string;
+    /** Whether the update succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Download time in milliseconds */
+    downloadTimeMs?: number;
+    /** Downloaded file size in bytes */
+    fileSize?: number;
+}
+/**
+ * Statistics for a single plugin
+ */
+export interface PluginStats {
+    /** Plugin name (normalized) */
+    pluginName: string;
+    /** Source that provides updates */
+    source: PluginSourceType;
+    /** Current installed version */
+    currentVersion: string;
+    /** Last time update was checked */
+    lastChecked?: string;
+    /** Last time plugin was updated */
+    lastUpdated?: string;
+    /** Update history (most recent first) */
+    updateHistory: UpdateEvent[];
+    /** Number of errors encountered */
+    errorCount: number;
+    /** Number of successful downloads */
+    downloadCount: number;
+}
+/**
+ * Statistics for a plugin source
+ */
+export interface SourceStats {
+    /** Source identifier */
+    source: PluginSourceType;
+    /** Number of plugins from this source */
+    totalPlugins: number;
+    /** Number of update checks performed */
+    checksPerformed: number;
+    /** Number of updates downloaded */
+    updatesDownloaded: number;
+    /** Number of failures */
+    failures: number;
+    /** Last check timestamp */
+    lastCheck?: string;
+    /** Average API response time in ms */
+    averageResponseTimeMs?: number;
+}
+/**
+ * Overall server statistics
+ */
+export interface ServerStats {
+    /** Total number of plugins tracked */
+    totalPlugins: number;
+    /** Number of plugins with available updates */
+    totalUpdatesAvailable: number;
+    /** Total size of all plugins in bytes */
+    totalSizeBytes: number;
+    /** Last scan timestamp */
+    lastScanDate?: string;
+    /** Overall health score (0-100) */
+    healthScore: number;
+    /** Number of missing dependencies */
+    missingDependencies: number;
+    /** Number of conflicts detected */
+    conflicts: number;
+}
+/**
+ * Complete statistics store
+ */
+export interface StatsStore {
+    /** Schema version */
+    version: string;
+    /** Last modified timestamp */
+    lastUpdated: string;
+    /** Per-plugin statistics */
+    plugins: Record<string, PluginStats>;
+    /** Per-source statistics */
+    sources: Record<string, SourceStats>;
+    /** Server-wide statistics */
+    server: ServerStats;
+}
+/**
+ * Recent error entry
+ */
+export interface RecentError {
+    /** Plugin that encountered the error */
+    pluginName: string;
+    /** Error message */
+    error: string;
+    /** When the error occurred */
+    date: string;
+}
+/**
+ * Health score factors
+ */
+export interface HealthFactors {
+    /** Number of outdated plugins (30+ days) */
+    outdatedPlugins: number;
+    /** Number of missing dependencies */
+    missingDependencies: number;
+    /** Number of conflicts */
+    conflicts: number;
+    /** Number of recent errors (last 7 days) */
+    recentErrors: number;
+    /** Base score before deductions */
+    baseScore: number;
+    /** Final calculated score */
+    finalScore: number;
+}
+//# sourceMappingURL=stats-types.d.ts.map