@dollhousemcp/mcp-server 1.5.2 → 1.6.0

package/dist/portfolio/GitHubPortfolioIndexer.d.ts

@@ -0,0 +1,129 @@
+/**
+ * GitHub Portfolio Indexer - Fetches and indexes user's GitHub portfolio for fast searching
+ *
+ * Features:
+ * - Singleton pattern for efficient resource usage
+ * - Smart caching with TTL and invalidation after user actions
+ * - GraphQL/REST API integration for efficient fetching
+ * - Rate limiting and authentication handling
+ * - Fallback strategy for resilient operation
+ * - Performance optimized for 1000+ portfolio elements
+ */
+import { ElementType } from './types.js';
+export interface GitHubIndexEntry {
+    path: string;
+    name: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    elementType: ElementType;
+    sha: string;
+    htmlUrl: string;
+    downloadUrl: string;
+    lastModified: Date;
+    size: number;
+}
+export interface GitHubPortfolioIndex {
+    username: string;
+    repository: string;
+    lastUpdated: Date;
+    elements: Map<ElementType, GitHubIndexEntry[]>;
+    totalElements: number;
+    sha: string;
+    rateLimitInfo?: {
+        remaining: number;
+        resetTime: Date;
+    };
+}
+export interface GitHubFetchOptions {
+    force?: boolean;
+    maxElements?: number;
+    elementTypes?: ElementType[];
+    useGraphQL?: boolean;
+}
+export declare class GitHubPortfolioIndexer {
+    private static instance;
+    private static instanceLock;
+    private cache;
+    private lastFetch;
+    private readonly ttl;
+    private recentUserAction;
+    private actionTimestamp;
+    private readonly actionGracePeriod;
+    private githubClient;
+    private portfolioRepoManager;
+    private apiCache;
+    private rateLimitTracker;
+    private constructor();
+    /**
+     * Singleton pattern with thread safety
+     */
+    static getInstance(): GitHubPortfolioIndexer;
+    /**
+     * Main method to get GitHub portfolio index
+     */
+    getIndex(force?: boolean): Promise<GitHubPortfolioIndex>;
+    /**
+     * Invalidate cache after user actions
+     */
+    invalidateAfterAction(action: string): void;
+    /**
+     * Clear all cached data
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        hasCachedData: boolean;
+        lastFetch: Date | null;
+        isStale: boolean;
+        recentUserAction: boolean;
+        totalElements: number;
+    };
+    /**
+     * Fetch fresh data from GitHub
+     */
+    private fetchFresh;
+    /**
+     * Fetch repository content from GitHub API
+     */
+    private fetchRepositoryContent;
+    /**
+     * Fetch using GraphQL for better performance
+     */
+    private fetchWithGraphQL;
+    /**
+     * Fetch using REST API with pagination
+     */
+    private fetchWithREST;
+    /**
+     * Fetch content for a specific element type
+     */
+    private fetchElementTypeContent;
+    /**
+     * Create GitHub index entry from API response
+     */
+    private createGitHubIndexEntry;
+    /**
+     * Parse metadata from file content (frontmatter)
+     */
+    private parseMetadataFromContent;
+    /**
+     * Get GitHub username from authenticated token
+     */
+    private getGitHubUsername;
+    /**
+     * Check if cache is valid
+     */
+    private isCacheValid;
+    /**
+     * Determine if we should fetch fresh data
+     */
+    private shouldFetchFresh;
+    /**
+     * Create empty index when no portfolio exists
+     */
+    private createEmptyIndex;
+}
+//# sourceMappingURL=GitHubPortfolioIndexer.d.ts.map

package/dist/portfolio/GitHubPortfolioIndexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubPortfolioIndexer.d.ts","sourceRoot":"","sources":["../../src/portfolio/GitHubPortfolioIndexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOzC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,IAAI,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IAEpC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IAEnD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,gBAAgB,CAAwB;IAEhD,OAAO;IASP;;OAEG;WACW,WAAW,IAAI,sBAAsB;IAgBnD;;OAEG;IACU,QAAQ,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkDnE;;OAEG;IACI,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgBlD;;OAEG;IACI,UAAU,IAAI,IAAI;IAUzB;;OAEG;IACI,aAAa,IAAI;QACtB,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACvB;IAUD;;OAEG;YACW,UAAU;IAmDxB;;OAEG;YACW,sBAAsB;IAapC;;OAEG;YACW,gBAAgB;IAwD9B;;OAEG;YACW,aAAa;IA4C3B;;OAEG;YACW,uBAAuB;IAkDrC;;OAEG;YACW,sBAAsB;IAoDpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;YACW,iBAAiB;IAS/B;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}