@mcp-consultant-tools/github-enterprise 1.0.0

package/build/GitHubEnterpriseService.d.ts

@@ -0,0 +1,179 @@
+/**
+ * GitHub Enterprise Repository Configuration
+ */
+export interface GitHubRepoConfig {
+    id: string;
+    owner: string;
+    repo: string;
+    defaultBranch?: string;
+    active: boolean;
+    description?: string;
+}
+/**
+ * GitHub Enterprise Service Configuration
+ */
+export interface GitHubEnterpriseConfig {
+    baseUrl: string;
+    apiVersion: string;
+    authMethod: 'pat' | 'github-app';
+    pat?: string;
+    appId?: string;
+    appPrivateKey?: string;
+    appInstallationId?: string;
+    repos: GitHubRepoConfig[];
+    enableWrite: boolean;
+    enableCreate: boolean;
+    enableCache: boolean;
+    cacheTtl: number;
+    maxFileSize: number;
+    maxSearchResults: number;
+}
+/**
+ * Branch Selection Result
+ */
+export interface BranchSelection {
+    branch: string;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+    alternatives?: string[];
+    message?: string;
+}
+/**
+ * GitHub Enterprise Service
+ * Manages authentication, API requests, caching, and branch selection for GitHub Enterprise Cloud
+ */
+export declare class GitHubEnterpriseService {
+    private config;
+    private readonly baseApiUrl;
+    private octokit;
+    private accessToken;
+    private tokenExpirationTime;
+    private cache;
+    constructor(config: GitHubEnterpriseConfig);
+    /**
+     * Initialize Octokit client based on authentication method
+     */
+    private initializeOctokit;
+    /**
+     * Get access token with caching (for GitHub App auth)
+     * Implements 5-minute buffer pattern before expiry
+     */
+    private getAccessToken;
+    /**
+     * Get cache key for a request
+     */
+    private getCacheKey;
+    /**
+     * Get cached response
+     */
+    private getCached;
+    /**
+     * Set cache entry
+     */
+    private setCache;
+    /**
+     * Clear cache entries
+     * @param pattern Optional pattern to match cache keys
+     * @param repoId Optional repo ID to clear cache for specific repo
+     * @returns Number of cache entries cleared
+     */
+    clearCache(pattern?: string, repoId?: string): number;
+    /**
+     * Make API request with error handling and caching
+     */
+    private makeRequest;
+    /**
+     * Get all configured repositories
+     */
+    getAllRepos(): GitHubRepoConfig[];
+    /**
+     * Get active repositories only
+     */
+    getActiveRepos(): GitHubRepoConfig[];
+    /**
+     * Get repository by ID with validation
+     */
+    getRepoById(repoId: string): GitHubRepoConfig;
+    /**
+     * List all branches for a repository
+     */
+    listBranches(repoId: string, protectedOnly?: boolean): Promise<any[]>;
+    /**
+     * Auto-detect default branch for a repository
+     * Handles typos gracefully and provides alternatives
+     */
+    getDefaultBranch(repoId: string, userSpecified?: string): Promise<BranchSelection>;
+    /**
+     * Get file content from a repository
+     */
+    getFile(repoId: string, path: string, branch?: string): Promise<any>;
+    /**
+     * Search code across repositories
+     */
+    searchCode(query: string, repoId?: string, path?: string, extension?: string): Promise<any>;
+    /**
+     * List files in a directory
+     */
+    listFiles(repoId: string, path?: string, branch?: string): Promise<any>;
+    /**
+     * Get commit history for a branch
+     */
+    getCommits(repoId: string, branch?: string, since?: string, until?: string, author?: string, path?: string, limit?: number): Promise<any[]>;
+    /**
+     * Get commit details
+     */
+    getCommitDetails(repoId: string, sha: string): Promise<any>;
+    /**
+     * Search commits by message
+     */
+    searchCommits(query: string, repoId?: string, author?: string, since?: string, until?: string): Promise<any>;
+    /**
+     * Compare two branches
+     */
+    compareBranches(repoId: string, base: string, head: string): Promise<any>;
+    /**
+     * Get branch details
+     */
+    getBranchDetails(repoId: string, branch: string): Promise<any>;
+    /**
+     * List pull requests
+     */
+    listPullRequests(repoId: string, state?: 'open' | 'closed' | 'all', base?: string, head?: string, sort?: 'created' | 'updated' | 'popularity', limit?: number): Promise<any[]>;
+    /**
+     * Get pull request details
+     */
+    getPullRequest(repoId: string, prNumber: number): Promise<any>;
+    /**
+     * Get pull request files
+     */
+    getPullRequestFiles(repoId: string, prNumber: number): Promise<any[]>;
+    /**
+     * Create a new branch (requires GHE_ENABLE_CREATE=true)
+     */
+    createBranch(repoId: string, branchName: string, fromBranch?: string): Promise<any>;
+    /**
+     * Update file content (requires GHE_ENABLE_WRITE=true)
+     */
+    updateFile(repoId: string, path: string, content: string, message: string, branch: string, sha: string): Promise<any>;
+    /**
+     * Create a new file (requires GHE_ENABLE_CREATE=true)
+     */
+    createFile(repoId: string, path: string, content: string, message: string, branch: string): Promise<any>;
+    /**
+     * Search repositories
+     */
+    searchRepositories(query: string, owner?: string): Promise<any>;
+    /**
+     * Get directory structure recursively
+     */
+    getDirectoryStructure(repoId: string, path?: string, branch?: string, depth?: number): Promise<any>;
+    /**
+     * Get file commit history
+     */
+    getFileHistory(repoId: string, path: string, branch?: string, limit?: number): Promise<any[]>;
+    /**
+     * Get commit diff
+     */
+    getCommitDiff(repoId: string, sha: string, format?: 'diff' | 'patch'): Promise<string>;
+}
+//# sourceMappingURL=GitHubEnterpriseService.d.ts.map

package/build/GitHubEnterpriseService.d.ts.map

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