bitbucket-mcp-server 1.0.0

package/build/bitbucket-api.test.js

@@ -0,0 +1,203 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock node-fetch using vi.hoisted to avoid hoisting issues
+const mockFetch = vi.hoisted(() => vi.fn());
+vi.mock('node-fetch', () => ({
+    default: mockFetch,
+}));
+import { BitbucketAPI } from './bitbucket-api.js';
+describe('BitbucketAPI', () => {
+    let api;
+    beforeEach(() => {
+        // Mock console.error to avoid noise in tests before creating the API instance
+        vi.spyOn(console, 'error').mockImplementation(() => { });
+        api = new BitbucketAPI();
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('listRepositories', () => {
+        it('should return repositories for a workspace', async () => {
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: vi.fn().mockResolvedValue({
+                    values: [
+                        {
+                            uuid: 'test-uuid',
+                            name: 'test-repo',
+                            full_name: 'workspace/test-repo',
+                            description: 'A test repository',
+                            is_private: false,
+                            created_on: '2023-01-01T00:00:00Z',
+                            updated_on: '2023-01-02T00:00:00Z',
+                            size: 1024,
+                            language: 'TypeScript',
+                            owner: {
+                                display_name: 'Test User',
+                                username: 'testuser',
+                            },
+                            links: {
+                                html: { href: 'https://bitbucket.org/workspace/test-repo' },
+                                clone: [
+                                    { name: 'https', href: 'https://bitbucket.org/workspace/test-repo.git' },
+                                    { name: 'ssh', href: 'git@bitbucket.org:workspace/test-repo.git' },
+                                ],
+                            },
+                        }
+                    ],
+                    next: null,
+                }),
+            };
+            mockFetch.mockResolvedValue(mockResponse);
+            const result = await api.listRepositories('testworkspace');
+            expect(result.repositories).toHaveLength(1);
+            expect(result.repositories[0].name).toBe('test-repo');
+            expect(result.hasMore).toBe(false);
+            expect(mockFetch).toHaveBeenCalledWith('https://api.bitbucket.org/2.0/repositories/testworkspace', expect.objectContaining({
+                headers: expect.objectContaining({
+                    'Accept': 'application/json',
+                    'User-Agent': 'bitbucket-mcp-server/1.0',
+                }),
+                signal: expect.any(AbortSignal),
+            }));
+        });
+        it('should handle authentication when credentials are provided', async () => {
+            // Set up authenticated API
+            const authenticatedApi = new BitbucketAPI('testuser', 'testpass');
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: vi.fn().mockResolvedValue({ values: [], next: null }),
+            };
+            mockFetch.mockResolvedValue(mockResponse);
+            await authenticatedApi.listRepositories('testworkspace');
+            expect(mockFetch).toHaveBeenCalledWith('https://api.bitbucket.org/2.0/repositories/testworkspace', expect.objectContaining({
+                headers: expect.objectContaining({
+                    'Authorization': 'Basic dGVzdHVzZXI6dGVzdHBhc3M=', // base64 of testuser:testpass
+                }),
+            }));
+        });
+        it('should handle API errors gracefully', async () => {
+            const errorResponse = {
+                ok: false,
+                status: 404,
+                statusText: 'Not Found',
+                json: vi.fn().mockResolvedValue({ error: { message: 'Workspace not found' } }),
+            };
+            mockFetch.mockResolvedValue(errorResponse);
+            await expect(api.listRepositories('nonexistent')).rejects.toThrow();
+        });
+    });
+    describe('getRepository', () => {
+        it('should return repository details', async () => {
+            const mockRepo = {
+                uuid: 'test-uuid',
+                name: 'test-repo',
+                full_name: 'workspace/test-repo',
+                description: 'A test repository',
+                is_private: false,
+                created_on: '2023-01-01T00:00:00Z',
+                updated_on: '2023-01-02T00:00:00Z',
+                size: 1024,
+                language: 'TypeScript',
+                owner: {
+                    display_name: 'Test User',
+                    username: 'testuser',
+                },
+                links: {
+                    html: { href: 'https://bitbucket.org/workspace/test-repo' },
+                    clone: [
+                        { name: 'https', href: 'https://bitbucket.org/workspace/test-repo.git' },
+                        { name: 'ssh', href: 'git@bitbucket.org:workspace/test-repo.git' },
+                    ],
+                },
+            };
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: vi.fn().mockResolvedValue(mockRepo),
+            };
+            mockFetch.mockResolvedValue(mockResponse);
+            const result = await api.getRepository('testworkspace', 'test-repo');
+            expect(result).toEqual(mockRepo);
+            expect(mockFetch).toHaveBeenCalledWith('https://api.bitbucket.org/2.0/repositories/testworkspace/test-repo', expect.any(Object));
+        });
+    });
+    describe('getPullRequest', () => {
+        it('should return pull request details', async () => {
+            const mockPullRequest = {
+                id: 123,
+                title: 'Fix critical bug',
+                state: 'OPEN',
+                author: {
+                    display_name: 'John Doe',
+                    username: 'johndoe',
+                },
+                created_on: '2023-12-01T10:00:00Z',
+                updated_on: '2023-12-01T15:30:00Z',
+                source: {
+                    branch: {
+                        name: 'feature/fix-bug',
+                    },
+                    repository: {
+                        name: 'test-repo',
+                    },
+                },
+                destination: {
+                    branch: {
+                        name: 'main',
+                    },
+                    repository: {
+                        name: 'test-repo',
+                    },
+                },
+                links: {
+                    html: {
+                        href: 'https://bitbucket.org/workspace/test-repo/pull-requests/123',
+                    },
+                },
+                description: 'This PR fixes a critical bug in the authentication system.',
+            };
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: vi.fn().mockResolvedValue(mockPullRequest),
+            };
+            mockFetch.mockResolvedValue(mockResponse);
+            const result = await api.getPullRequest('testworkspace', 'test-repo', 123);
+            expect(result).toEqual(mockPullRequest);
+            expect(mockFetch).toHaveBeenCalledWith('https://api.bitbucket.org/2.0/repositories/testworkspace/test-repo/pullrequests/123', expect.any(Object));
+        });
+        it('should handle pull request not found error', async () => {
+            const errorResponse = {
+                ok: false,
+                status: 404,
+                statusText: 'Not Found',
+                json: vi.fn().mockResolvedValue({ error: { message: 'Pull request not found' } }),
+            };
+            mockFetch.mockResolvedValue(errorResponse);
+            await expect(api.getPullRequest('testworkspace', 'test-repo', 999)).rejects.toThrow();
+        });
+        it('should handle authentication when getting pull request', async () => {
+            const authenticatedApi = new BitbucketAPI('testuser', 'testpass');
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: vi.fn().mockResolvedValue({
+                    id: 123,
+                    title: 'Test PR',
+                    state: 'OPEN',
+                }),
+            };
+            mockFetch.mockResolvedValue(mockResponse);
+            await authenticatedApi.getPullRequest('testworkspace', 'test-repo', 123);
+            expect(mockFetch).toHaveBeenCalledWith('https://api.bitbucket.org/2.0/repositories/testworkspace/test-repo/pullrequests/123', expect.objectContaining({
+                headers: expect.objectContaining({
+                    'Authorization': 'Basic dGVzdHVzZXI6dGVzdHBhc3M=',
+                }),
+            }));
+        });
+    });
+});
+//# sourceMappingURL=bitbucket-api.test.js.map

package/build/bitbucket-api.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-api.test.js","sourceRoot":"","sources":["../src/bitbucket-api.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEzE,4DAA4D;AAC5D,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAE5C,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3B,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,GAAiB,CAAC;IAEtB,UAAU,CAAC,GAAG,EAAE;QACd,8EAA8E;QAC9E,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxD,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QACzB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,YAAY,GAAG;gBACnB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBAC9B,MAAM,EAAE;wBACN;4BACE,IAAI,EAAE,WAAW;4BACjB,IAAI,EAAE,WAAW;4BACjB,SAAS,EAAE,qBAAqB;4BAChC,WAAW,EAAE,mBAAmB;4BAChC,UAAU,EAAE,KAAK;4BACjB,UAAU,EAAE,sBAAsB;4BAClC,UAAU,EAAE,sBAAsB;4BAClC,IAAI,EAAE,IAAI;4BACV,QAAQ,EAAE,YAAY;4BACtB,KAAK,EAAE;gCACL,YAAY,EAAE,WAAW;gCACzB,QAAQ,EAAE,UAAU;6BACrB;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,EAAE,IAAI,EAAE,2CAA2C,EAAE;gCAC3D,KAAK,EAAE;oCACL,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,+CAA+C,EAAE;oCACxE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,2CAA2C,EAAE;iCACnE;6BACF;yBACF;qBACF;oBACD,IAAI,EAAE,IAAI;iBACX,CAAC;aACH,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,0DAA0D,EAC1D,MAAM,CAAC,gBAAgB,CAAC;gBACtB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC;oBAC/B,QAAQ,EAAE,kBAAkB;oBAC5B,YAAY,EAAE,0BAA0B;iBACzC,CAAC;gBACF,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;aAChC,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,2BAA2B;YAC3B,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAElE,MAAM,YAAY,GAAG;gBACnB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aAC5D,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAE1C,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;YAEzD,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,0DAA0D,EAC1D,MAAM,CAAC,gBAAgB,CAAC;gBACtB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC;oBAC/B,eAAe,EAAE,gCAAgC,EAAE,8BAA8B;iBAClF,CAAC;aACH,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,aAAa,GAAG;gBACpB,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG;gBACX,UAAU,EAAE,WAAW;gBACvB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE,CAAC;aAC/E,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAE3C,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,qBAAqB;gBAChC,WAAW,EAAE,mBAAmB;gBAChC,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,sBAAsB;gBAClC,UAAU,EAAE,sBAAsB;gBAClC,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,YAAY;gBACtB,KAAK,EAAE;oBACL,YAAY,EAAE,WAAW;oBACzB,QAAQ,EAAE,UAAU;iBACrB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,EAAE,IAAI,EAAE,2CAA2C,EAAE;oBAC3D,KAAK,EAAE;wBACL,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,+CAA+C,EAAE;wBACxE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,2CAA2C,EAAE;qBACnE;iBACF;aACF,CAAC;YAEF,MAAM,YAAY,GAAG;gBACnB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;aAC1C,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;YAErE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,oEAAoE,EACpE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CACnB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,eAAe,GAAG;gBACtB,EAAE,EAAE,GAAG;gBACP,KAAK,EAAE,kBAAkB;gBACzB,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE;oBACN,YAAY,EAAE,UAAU;oBACxB,QAAQ,EAAE,SAAS;iBACpB;gBACD,UAAU,EAAE,sBAAsB;gBAClC,UAAU,EAAE,sBAAsB;gBAClC,MAAM,EAAE;oBACN,MAAM,EAAE;wBACN,IAAI,EAAE,iBAAiB;qBACxB;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,WAAW;qBAClB;iBACF;gBACD,WAAW,EAAE;oBACX,MAAM,EAAE;wBACN,IAAI,EAAE,MAAM;qBACb;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,WAAW;qBAClB;iBACF;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE;wBACJ,IAAI,EAAE,6DAA6D;qBACpE;iBACF;gBACD,WAAW,EAAE,4DAA4D;aAC1E,CAAC;YAEF,MAAM,YAAY,GAAG;gBACnB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC;aACjD,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,eAAe,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAE3E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACxC,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,qFAAqF,EACrF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CACnB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,aAAa,GAAG;gBACpB,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG;gBACX,UAAU,EAAE,WAAW;gBACvB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,EAAE,CAAC;aAClF,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAE3C,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACxF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAElE,MAAM,YAAY,GAAG;gBACnB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;oBAC9B,EAAE,EAAE,GAAG;oBACP,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,MAAM;iBACd,CAAC;aACH,CAAC;YACF,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAE1C,MAAM,gBAAgB,CAAC,cAAc,CAAC,eAAe,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAEzE,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,qFAAqF,EACrF,MAAM,CAAC,gBAAgB,CAAC;gBACtB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC;oBAC/B,eAAe,EAAE,gCAAgC;iBAClD,CAAC;aACH,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/cache.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Caching system for the Bitbucket MCP server
+ */
+export interface CacheEntry<T = any> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+    key: string;
+}
+export interface CacheOptions {
+    maxSize: number;
+    defaultTtl: number;
+    cleanupInterval: number;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    totalRequests: number;
+    hitRate: number;
+    cacheSize: number;
+    maxSize: number;
+}
+/**
+ * LRU Cache implementation with TTL support
+ */
+export declare class LRUCache<T = any> {
+    private options;
+    private cache;
+    private accessOrder;
+    private accessCounter;
+    private stats;
+    private cleanupTimer?;
+    constructor(options: CacheOptions);
+    /**
+     * Get an item from the cache
+     */
+    get(key: string): T | null;
+    /**
+     * Set an item in the cache
+     */
+    set(key: string, data: T, ttl?: number): void;
+    /**
+     * Delete an item from the cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Check if a key exists in the cache (without affecting access order)
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset cache statistics
+     */
+    resetStats(): void;
+    /**
+     * Get all cache keys
+     */
+    keys(): string[];
+    /**
+     * Get cache size
+     */
+    size(): number;
+    /**
+     * Get cache configuration
+     */
+    getConfig(): CacheOptions;
+    /**
+     * Update cache configuration
+     */
+    updateConfig(newOptions: Partial<CacheOptions>): void;
+    /**
+     * Cleanup expired entries
+     */
+    private cleanup;
+    /**
+     * Evict least recently used item
+     */
+    private evictLRU;
+    /**
+     * Update hit rate calculation
+     */
+    private updateHitRate;
+    /**
+     * Update cache size in stats
+     */
+    private updateCacheSize;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Cache key generator for API requests
+ */
+export declare class CacheKeyGenerator {
+    static forRepository(workspace: string, repoSlug: string): string;
+    static forRepositories(workspace: string, options?: Record<string, any>): string;
+    static forPullRequests(workspace: string, repoSlug: string, state?: string): string;
+    static forIssues(workspace: string, repoSlug: string, state?: string): string;
+    static forBranches(workspace: string, repoSlug: string): string;
+    static forCommits(workspace: string, repoSlug: string, branch?: string): string;
+    static forSearch(workspace: string, query: string, types: string[], limit: number): string;
+}
+/**
+ * Cache decorator for API methods
+ */
+export declare function cached<T extends (...args: any[]) => Promise<any>>(cache: LRUCache, keyGenerator: (...args: any[]) => string, ttl?: number): (target: any, propertyName: string, descriptor: TypedPropertyDescriptor<T>) => void;
+/**
+ * Cache management utilities
+ */
+export declare class CacheManager {
+    private caches;
+    /**
+     * Create a new cache instance
+     */
+    createCache(name: string, options: CacheOptions): LRUCache;
+    /**
+     * Get a cache instance by name
+     */
+    getCache(name: string): LRUCache | undefined;
+    /**
+     * Remove a cache instance
+     */
+    removeCache(name: string): boolean;
+    /**
+     * Get statistics for all caches
+     */
+    getAllStats(): Record<string, CacheStats>;
+    /**
+     * Clear all caches
+     */
+    clearAll(): void;
+    /**
+     * Reset statistics for all caches
+     */
+    resetAllStats(): void;
+    /**
+     * Destroy all caches
+     */
+    destroyAll(): void;
+}
+export declare const cacheManager: CacheManager;
+export declare const apiCache: LRUCache<any>;