@hubblecommerce/overmind-core 0.1.3 → 0.1.5

package/dist/src/integrations/confluence/confluence.client.d.ts

@@ -19,6 +19,7 @@ export declare class ConfluenceClient {
      * Make HTTP request to Confluence API with retries
      */
     private request;
+    private paginate;
     /**
      * Get all spaces (with pagination)
      */
@@ -55,17 +56,10 @@ export declare class ConfluenceClient {
      * Returns only label names as strings
      */
     getPageLabels(pageId: string): Promise<string[]>;
-    /**
-     * Get numeric space ID from space key
-     * Helper method to convert space key to numeric ID required by v2 API
-     * @param spaceKey - The space key (e.g., "TEST")
-     * @returns The numeric space ID
-     */
-    getSpaceIdByKey(spaceKey: string): Promise<string>;
     /**
      * Create a new page in Confluence using REST API v2 with ADF (Atlassian Document Format)
      * This is the modern format for the new Confluence editor
-     * @param spaceId - The numeric space ID (not space key) - use getSpaceIdByKey() if you have a space key
+     * @param spaceId - The numeric space ID (not space key)
      * @param title - The page title
      * @param adfBody - The page content in ADF format (from @atlaskit/editor-markdown-transformer)
      * @param parentId - Optional parent page ID to create as child page

package/dist/src/integrations/confluence/confluence.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confluence.client.d.ts","sourceRoot":"","sources":["../../../../src/integrations/confluence/confluence.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EAEd,eAAe,EAKlB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,eAAe,CAAa;gBAExB,MAAM,EAAE,sBAAsB;IAS1C;;OAEG;YACW,gBAAgB;IAa9B;;OAEG;YACW,OAAO;IAwDrB;;OAEG;IACG,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAkB/D;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyBpF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,GAAG,kBAA8B,GAAG,OAAO,CAAC,cAAc,CAAC;IAKlH;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAW/D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAoBhE;;OAEG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYzF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BtD;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxD;;;;;;;;OAQG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,cAAc,CAAC;CAuC9B"}
+{"version":3,"file":"confluence.client.d.ts","sourceRoot":"","sources":["../../../../src/integrations/confluence/confluence.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EAEd,eAAe,EAKlB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,eAAe,CAAa;gBAExB,MAAM,EAAE,sBAAsB;IAS1C;;OAEG;YACW,gBAAgB;IAa9B;;OAEG;YACW,OAAO;YAwDP,QAAQ;IActB;;OAEG;IACG,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI/D;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKpF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,GAAG,kBAA8B,GAAG,OAAO,CAAC,cAAc,CAAC;IAKlH;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAW/D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAoBhE;;OAEG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYzF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BtD;;;;;;;;OAQG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,cAAc,CAAC;CAuC9B"}

package/dist/src/integrations/confluence/confluence.client.js

@@ -73,46 +73,29 @@ export class ConfluenceClient {
         }
         throw lastError || new Error('Request failed after max retries');
     }
+    async paginate(initialUrl) {
+        const items = [];
+        let nextUrl = initialUrl;
+        while (nextUrl) {
+            const response = await this.request(nextUrl);
+            items.push(...response.results);
+            nextUrl = response._links.next?.replace(this.baseUrl, '');
+        }
+        return items;
+    }
     /**
      * Get all spaces (with pagination)
      */
     async getSpaces(limit = 25) {
-        const spaces = [];
-        let nextUrl = `/wiki/api/v2/spaces?limit=${limit}`;
-        while (nextUrl) {
-            const response = await this.request(nextUrl);
-            const results = response.results;
-            spaces.push(...results);
-            // Extract cursor from next link if exists
-            const links = response._links;
-            const nextLink = links.next;
-            nextUrl = nextLink ? nextLink.replace(this.baseUrl, '') : undefined;
-        }
-        return spaces;
+        return this.paginate(`/wiki/api/v2/spaces?limit=${limit}`);
     }
     /**
      * Get all pages in a space (with pagination)
      * Note: Accepts space key and automatically resolves to space ID for API v2
      */
     async getSpacePages(spaceKey, limit = 25) {
-        // First, resolve space key to space ID (required by API v2)
         const space = await this.getSpaceByKey(spaceKey);
-        const spaceId = space.id;
-        const pages = [];
-        let nextUrl = `/wiki/api/v2/spaces/${spaceId}/pages?limit=${limit}&status=current`;
-        while (nextUrl) {
-            const response = await this.request(nextUrl);
-            const results = response.results;
-            pages.push(...results);
-            // Extract cursor from next link if exists
-            const links = response._links;
-            nextUrl = links.next || undefined;
-            if (nextUrl) {
-                // Convert full URL to relative path
-                nextUrl = nextUrl.replace(this.baseUrl, '');
-            }
-        }
-        return pages;
+        return this.paginate(`/wiki/api/v2/spaces/${space.id}/pages?limit=${limit}&status=current`);
     }
     /**
      * Get a single page by ID with content
@@ -197,20 +180,10 @@ export class ConfluenceClient {
         // Return only the label names (without prefix)
         return labels.map(label => label.name);
     }
-    /**
-     * Get numeric space ID from space key
-     * Helper method to convert space key to numeric ID required by v2 API
-     * @param spaceKey - The space key (e.g., "TEST")
-     * @returns The numeric space ID
-     */
-    async getSpaceIdByKey(spaceKey) {
-        const space = await this.getSpaceByKey(spaceKey);
-        return space.id;
-    }
     /**
      * Create a new page in Confluence using REST API v2 with ADF (Atlassian Document Format)
      * This is the modern format for the new Confluence editor
-     * @param spaceId - The numeric space ID (not space key) - use getSpaceIdByKey() if you have a space key
+     * @param spaceId - The numeric space ID (not space key)
      * @param title - The page title
      * @param adfBody - The page content in ADF format (from @atlaskit/editor-markdown-transformer)
      * @param parentId - Optional parent page ID to create as child page

package/dist/src/integrations/confluence/confluence.client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=confluence.client.test.d.ts.map

package/dist/src/integrations/confluence/confluence.client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence.client.test.d.ts","sourceRoot":"","sources":["../../../../src/integrations/confluence/confluence.client.test.ts"],"names":[],"mappings":""}

package/dist/src/integrations/confluence/confluence.client.test.js

@@ -0,0 +1,320 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { ConfluenceClient } from './confluence.client.js';
+const BASE_URL = 'https://example.atlassian.net';
+function makeClient() {
+    return new ConfluenceClient({
+        baseUrl: BASE_URL,
+        email: 'test@test.com',
+        apiToken: 'token',
+        rateLimit: 10000, // effectively no rate-limit delay in tests
+    });
+}
+function jsonResponse(data, status = 200) {
+    return new Response(JSON.stringify(data), {
+        status,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+const spaceFixture = {
+    id: 'space-id-1',
+    key: 'TEST',
+    name: 'Test Space',
+    type: 'global',
+    status: 'current',
+    authorId: 'author1',
+    createdAt: '2024-01-01T00:00:00.000Z',
+    _links: { webui: '/spaces/TEST' },
+};
+const spaceResponse = { results: [spaceFixture], _links: {} };
+function makePageFixture(id) {
+    return {
+        id,
+        status: 'current',
+        title: `Page ${id}`,
+        spaceId: spaceFixture.id,
+        authorId: 'author1',
+        createdAt: '2024-01-01T00:00:00.000Z',
+        version: { createdAt: '2024-01-01T00:00:00.000Z', message: '', number: 1, minorEdit: false, authorId: 'author1' },
+        _links: { webui: `/wiki/spaces/TEST/pages/${id}` },
+    };
+}
+describe('ConfluenceClient', () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.useRealTimers();
+    });
+    describe('getSpacePages', () => {
+        it('returns pages for a single-page response (no pagination)', async () => {
+            const pageResponse = { results: [makePageFixture('p1')], _links: {} };
+            fetchMock
+                .mockResolvedValueOnce(jsonResponse(spaceResponse))
+                .mockResolvedValueOnce(jsonResponse(pageResponse));
+            const promise = makeClient().getSpacePages('TEST');
+            await vi.runAllTimersAsync();
+            const pages = await promise;
+            expect(pages).toHaveLength(1);
+            expect(pages[0].id).toBe('p1');
+        });
+        it('follows pagination and combines results from multiple pages', async () => {
+            const page1Response = {
+                results: [makePageFixture('p1')],
+                _links: { next: `${BASE_URL}/wiki/api/v2/spaces/space-id-1/pages?cursor=abc` },
+            };
+            const page2Response = {
+                results: [makePageFixture('p2')],
+                _links: {},
+            };
+            fetchMock
+                .mockResolvedValueOnce(jsonResponse(spaceResponse))
+                .mockResolvedValueOnce(jsonResponse(page1Response))
+                .mockResolvedValueOnce(jsonResponse(page2Response));
+            const promise = makeClient().getSpacePages('TEST');
+            await vi.runAllTimersAsync();
+            const pages = await promise;
+            expect(pages).toHaveLength(2);
+            expect(pages[0].id).toBe('p1');
+            expect(pages[1].id).toBe('p2');
+        });
+        it('throws when space key is not found', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse({ results: [], _links: {} }));
+            const promise = makeClient().getSpacePages('UNKNOWN');
+            const assertion = expect(promise).rejects.toThrow('Space with key "UNKNOWN" not found');
+            await vi.runAllTimersAsync();
+            await assertion;
+        });
+    });
+    describe('getPageLabels', () => {
+        it('returns label names from the response', async () => {
+            const labelResponse = {
+                results: [
+                    { id: '1', name: 'project-info', prefix: 'global' },
+                    { id: '2', name: 'active', prefix: 'global' },
+                ],
+                start: 0, limit: 200, size: 2, _links: {},
+            };
+            fetchMock.mockResolvedValueOnce(jsonResponse(labelResponse));
+            const promise = makeClient().getPageLabels('page1');
+            await vi.runAllTimersAsync();
+            const labels = await promise;
+            expect(labels).toEqual(['project-info', 'active']);
+        });
+        it('returns empty array when page has no labels', async () => {
+            const labelResponse = { results: [], start: 0, limit: 200, size: 0, _links: {} };
+            fetchMock.mockResolvedValueOnce(jsonResponse(labelResponse));
+            const promise = makeClient().getPageLabels('page1');
+            await vi.runAllTimersAsync();
+            const labels = await promise;
+            expect(labels).toEqual([]);
+        });
+    });
+    describe('createPageWithADF', () => {
+        const createPageResponse = {
+            id: 'new-page-1',
+            status: 'current',
+            title: 'My New Page',
+            spaceId: spaceFixture.id,
+            authorId: 'author1',
+            createdAt: '2024-01-01T00:00:00.000Z',
+            version: { createdAt: '2024-01-01T00:00:00.000Z', message: '', number: 1, minorEdit: false, authorId: 'author1' },
+            _links: { webui: '/wiki/spaces/TEST/pages/new-page-1' },
+        };
+        it('sends correct body structure with ADF content', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse(createPageResponse));
+            const adfBody = { type: 'doc', version: 1, content: [] };
+            const promise = makeClient().createPageWithADF({ spaceId: 'S1', title: 'My New Page', adfBody });
+            await vi.runAllTimersAsync();
+            await promise;
+            const [, options] = fetchMock.mock.calls[0];
+            const body = JSON.parse(options.body);
+            expect(body.title).toBe('My New Page');
+            expect(body.spaceId).toBe('S1');
+            expect(body.body.representation).toBe('atlas_doc_format');
+            expect(JSON.parse(body.body.value)).toEqual(adfBody);
+        });
+        it('includes parentId in payload when provided', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse(createPageResponse));
+            const promise = makeClient().createPageWithADF({ spaceId: 'S1', title: 'Child', adfBody: {}, parentId: 'parent-1' });
+            await vi.runAllTimersAsync();
+            await promise;
+            const [, options] = fetchMock.mock.calls[0];
+            const body = JSON.parse(options.body);
+            expect(body.parentId).toBe('parent-1');
+        });
+        it('omits parentId from payload when not provided', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse(createPageResponse));
+            const promise = makeClient().createPageWithADF({ spaceId: 'S1', title: 'Root Page', adfBody: {} });
+            await vi.runAllTimersAsync();
+            await promise;
+            const [, options] = fetchMock.mock.calls[0];
+            const body = JSON.parse(options.body);
+            expect(body.parentId).toBeUndefined();
+        });
+        it('returns the created page', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse(createPageResponse));
+            const promise = makeClient().createPageWithADF({ spaceId: 'S1', title: 'My New Page', adfBody: {} });
+            await vi.runAllTimersAsync();
+            const page = await promise;
+            expect(page.id).toBe('new-page-1');
+            expect(page.title).toBe('My New Page');
+        });
+    });
+    describe('getSpaces', () => {
+        it('returns spaces from paginated response', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse({ results: [spaceFixture], _links: {} }));
+            const promise = makeClient().getSpaces();
+            await vi.runAllTimersAsync();
+            const spaces = await promise;
+            expect(spaces).toHaveLength(1);
+            expect(spaces[0].key).toBe('TEST');
+        });
+    });
+    describe('getPageById', () => {
+        it('returns the page for a given id', async () => {
+            const page = makePageFixture('p42');
+            fetchMock.mockResolvedValueOnce(jsonResponse(page));
+            const promise = makeClient().getPageById('p42');
+            await vi.runAllTimersAsync();
+            const result = await promise;
+            expect(result.id).toBe('p42');
+        });
+        it('uses default body format storage', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse(makePageFixture('p1')));
+            const promise = makeClient().getPageById('p1');
+            await vi.runAllTimersAsync();
+            await promise;
+            const [url] = fetchMock.mock.calls[0];
+            expect(url).toContain('body-format=storage');
+        });
+        it('accepts atlas_doc_format body format', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse(makePageFixture('p1')));
+            const promise = makeClient().getPageById('p1', 'atlas_doc_format');
+            await vi.runAllTimersAsync();
+            await promise;
+            const [url] = fetchMock.mock.calls[0];
+            expect(url).toContain('body-format=atlas_doc_format');
+        });
+    });
+    describe('getPageContent', () => {
+        it('returns body storage value', async () => {
+            const page = { ...makePageFixture('p1'), body: { storage: { value: '<p>Hello</p>' } } };
+            fetchMock.mockResolvedValueOnce(jsonResponse(page));
+            const promise = makeClient().getPageContent('p1');
+            await vi.runAllTimersAsync();
+            const content = await promise;
+            expect(content).toBe('<p>Hello</p>');
+        });
+        it('throws when page has no body', async () => {
+            const page = makePageFixture('p1'); // no body field
+            fetchMock.mockResolvedValueOnce(jsonResponse(page));
+            const promise = makeClient().getPageContent('p1');
+            const assertion = expect(promise).rejects.toThrow('no content');
+            await vi.runAllTimersAsync();
+            await assertion;
+        });
+    });
+    describe('getChildPages', () => {
+        it('returns child pages in a single request when below limit', async () => {
+            const results = [{ id: 'c1' }, { id: 'c2' }];
+            fetchMock.mockResolvedValueOnce(jsonResponse({ results, size: 2 }));
+            const promise = makeClient().getChildPages('parent1');
+            await vi.runAllTimersAsync();
+            const pages = await promise;
+            expect(pages).toHaveLength(2);
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+        });
+        it('paginates when first response returns exactly the limit', async () => {
+            const fullPage = Array.from({ length: 250 }, (_, i) => ({ id: `c${i}` }));
+            fetchMock
+                .mockResolvedValueOnce(jsonResponse({ results: fullPage, size: 250 }))
+                .mockResolvedValueOnce(jsonResponse({ results: [{ id: 'c250' }], size: 1 }));
+            const promise = makeClient().getChildPages('parent1');
+            await vi.runAllTimersAsync();
+            const pages = await promise;
+            expect(pages).toHaveLength(251);
+            expect(fetchMock).toHaveBeenCalledTimes(2);
+            const [secondUrl] = fetchMock.mock.calls[1];
+            expect(secondUrl).toContain('start=250');
+        });
+    });
+    describe('getRecentPages', () => {
+        it('returns pages without space filter when no spaceKeys provided', async () => {
+            const pageResponse = { results: [makePageFixture('p1')] };
+            fetchMock.mockResolvedValueOnce(jsonResponse(pageResponse));
+            const promise = makeClient().getRecentPages();
+            await vi.runAllTimersAsync();
+            const pages = await promise;
+            expect(pages).toHaveLength(1);
+            const [url] = fetchMock.mock.calls[0];
+            expect(url).not.toContain('space-key');
+        });
+        it('adds space-key filter when spaceKeys provided', async () => {
+            const pageResponse = { results: [makePageFixture('p1')] };
+            fetchMock.mockResolvedValueOnce(jsonResponse(pageResponse));
+            const promise = makeClient().getRecentPages(['TEST', 'PROJ']);
+            await vi.runAllTimersAsync();
+            await promise;
+            const [url] = fetchMock.mock.calls[0];
+            expect(url).toContain('space-key=TEST');
+            expect(url).toContain('space-key=PROJ');
+        });
+        it('respects custom limit', async () => {
+            fetchMock.mockResolvedValueOnce(jsonResponse({ results: [] }));
+            const promise = makeClient().getRecentPages(undefined, 50);
+            await vi.runAllTimersAsync();
+            await promise;
+            const [url] = fetchMock.mock.calls[0];
+            expect(url).toContain('limit=50');
+        });
+    });
+    describe('getPageLabels pagination', () => {
+        it('fetches next page when first response fills the limit', async () => {
+            const fullPage = Array.from({ length: 200 }, (_, i) => ({ id: `${i}`, name: `label-${i}`, prefix: 'global' }));
+            const secondPage = { results: [{ id: '200', name: 'extra', prefix: 'global' }], start: 200, limit: 200, size: 1, _links: {} };
+            fetchMock
+                .mockResolvedValueOnce(jsonResponse({ results: fullPage, start: 0, limit: 200, size: 200, _links: {} }))
+                .mockResolvedValueOnce(jsonResponse(secondPage));
+            const promise = makeClient().getPageLabels('page1');
+            await vi.runAllTimersAsync();
+            const labels = await promise;
+            expect(labels).toHaveLength(201);
+            expect(labels[200]).toBe('extra');
+        });
+    });
+    describe('error handling', () => {
+        it('throws on 4xx error without retrying', async () => {
+            fetchMock.mockResolvedValue(new Response('Not Found', { status: 404, statusText: 'Not Found' }));
+            const promise = makeClient().getPageById('page1');
+            const assertion = expect(promise).rejects.toThrow();
+            await vi.runAllTimersAsync();
+            await assertion;
+            // Only 1 fetch call (no retries for 4xx)
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+        });
+        it('retries on 5xx error and eventually throws', async () => {
+            fetchMock.mockResolvedValue(new Response('Server Error', { status: 500, statusText: 'Internal Server Error' }));
+            const promise = makeClient().getPageById('page1');
+            const assertion = expect(promise).rejects.toThrow();
+            await vi.runAllTimersAsync();
+            await assertion;
+            // 3 attempts total (initial + 2 retries)
+            expect(fetchMock).toHaveBeenCalledTimes(3);
+        });
+        it('succeeds on retry after transient 5xx', async () => {
+            const page = makePageFixture('p1');
+            fetchMock
+                .mockResolvedValueOnce(new Response('Server Error', { status: 500, statusText: 'Internal Server Error' }))
+                .mockResolvedValueOnce(jsonResponse(page));
+            const promise = makeClient().getPageById('p1');
+            await vi.runAllTimersAsync();
+            const result = await promise;
+            expect(result.id).toBe('p1');
+            expect(fetchMock).toHaveBeenCalledTimes(2);
+        });
+    });
+});

package/dist/src/integrations/gitlab/gitlab.client.d.ts

@@ -1,3 +1,11 @@
 import { Gitlab } from '@gitbeaker/rest';
 export declare function getGitlabClient(): InstanceType<typeof Gitlab>;
+/**
+ * Get the SHA of the latest commit on the default branch.
+ */
+export declare function getLatestCommitSha(client: InstanceType<typeof Gitlab>, projectId: number | string): Promise<string>;
+/**
+ * Download the repository archive as a Buffer.
+ */
+export declare function downloadArchive(client: InstanceType<typeof Gitlab>, projectId: number | string): Promise<Buffer>;
 //# sourceMappingURL=gitlab.client.d.ts.map

package/dist/src/integrations/gitlab/gitlab.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitlab.client.d.ts","sourceRoot":"","sources":["../../../../src/integrations/gitlab/gitlab.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAKzC,wBAAgB,eAAe,IAAI,YAAY,CAAC,OAAO,MAAM,CAAC,CAa7D"}
+{"version":3,"file":"gitlab.client.d.ts","sourceRoot":"","sources":["../../../../src/integrations/gitlab/gitlab.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAMzC,wBAAgB,eAAe,IAAI,YAAY,CAAC,OAAO,MAAM,CAAC,CAa7D;AAGD;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,MAAM,EAAE,YAAY,CAAC,OAAO,MAAM,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,YAAY,CAAC,OAAO,MAAM,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/src/integrations/gitlab/gitlab.client.js

@@ -1,5 +1,6 @@
 import { Gitlab } from '@gitbeaker/rest';
 import { config } from '../../config/app.config.js';
+/* v8 ignore start -- gitbeaker singleton wiring, no custom logic */
 let gitlabClient = null;
 export function getGitlabClient() {
     if (!gitlabClient) {
@@ -13,3 +14,22 @@ export function getGitlabClient() {
     }
     return gitlabClient;
 }
+/* v8 ignore stop */
+/**
+ * Get the SHA of the latest commit on the default branch.
+ */
+export async function getLatestCommitSha(client, projectId) {
+    const commits = await client.Commits.all(projectId, { perPage: 1, maxPages: 1 });
+    if (commits.length === 0) {
+        throw new Error(`No commits found for project ${projectId}`);
+    }
+    return commits[0].id;
+}
+/**
+ * Download the repository archive as a Buffer.
+ */
+export async function downloadArchive(client, projectId) {
+    const blob = await client.Repositories.showArchive(projectId, { fileType: 'tar.gz' });
+    const arrayBuffer = await blob.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}

package/dist/src/integrations/gitlab/gitlab.client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gitlab.client.test.d.ts.map

package/dist/src/integrations/gitlab/gitlab.client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.client.test.d.ts","sourceRoot":"","sources":["../../../../src/integrations/gitlab/gitlab.client.test.ts"],"names":[],"mappings":""}

package/dist/src/integrations/gitlab/gitlab.client.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getLatestCommitSha, downloadArchive } from './gitlab.client.js';
+function makeMockClient(overrides = {}) {
+    const commitsAll = overrides.commitsAll ?? vi.fn();
+    const repositoriesShowArchive = overrides.repositoriesShowArchive ?? vi.fn();
+    const client = {
+        Commits: { all: commitsAll },
+        Repositories: { showArchive: repositoriesShowArchive },
+    };
+    return { client, mocks: { commitsAll, repositoriesShowArchive } };
+}
+describe('getLatestCommitSha', () => {
+    it('returns the SHA of the latest commit', async () => {
+        const { client, mocks } = makeMockClient({
+            commitsAll: vi.fn().mockResolvedValue([
+                { id: 'abc123def456', short_id: 'abc123d', title: 'Latest commit' },
+            ]),
+        });
+        const sha = await getLatestCommitSha(client, 42);
+        expect(sha).toBe('abc123def456');
+        expect(mocks.commitsAll).toHaveBeenCalledWith(42, { perPage: 1, maxPages: 1 });
+    });
+    it('accepts string project IDs', async () => {
+        const { client, mocks } = makeMockClient({
+            commitsAll: vi.fn().mockResolvedValue([
+                { id: 'sha999', short_id: 'sha999' },
+            ]),
+        });
+        const sha = await getLatestCommitSha(client, 'group%2Fproject');
+        expect(sha).toBe('sha999');
+        expect(mocks.commitsAll).toHaveBeenCalledWith('group%2Fproject', { perPage: 1, maxPages: 1 });
+    });
+    it('throws when the commits array is empty', async () => {
+        const { client } = makeMockClient({
+            commitsAll: vi.fn().mockResolvedValue([]),
+        });
+        await expect(getLatestCommitSha(client, 42))
+            .rejects.toThrow('No commits found');
+    });
+});
+describe('downloadArchive', () => {
+    it('returns a Buffer with the archive contents', async () => {
+        const archiveData = new Uint8Array([0x1f, 0x8b, 0x08, 0x00]);
+        const blob = new Blob([archiveData]);
+        const { client, mocks } = makeMockClient({
+            repositoriesShowArchive: vi.fn().mockResolvedValue(blob),
+        });
+        const result = await downloadArchive(client, 42);
+        expect(result).toBeInstanceOf(Buffer);
+        expect(result.length).toBe(4);
+        expect(result[0]).toBe(0x1f);
+        expect(mocks.repositoriesShowArchive).toHaveBeenCalledWith(42, { fileType: 'tar.gz' });
+    });
+    it('accepts string project IDs', async () => {
+        const blob = new Blob([new Uint8Array([0x00])]);
+        const { client, mocks } = makeMockClient({
+            repositoriesShowArchive: vi.fn().mockResolvedValue(blob),
+        });
+        await downloadArchive(client, 'group%2Fproject');
+        expect(mocks.repositoriesShowArchive).toHaveBeenCalledWith('group%2Fproject', { fileType: 'tar.gz' });
+    });
+});

package/dist/src/integrations/jira/jira.client.d.ts

@@ -48,9 +48,10 @@ export interface JiraClientConfig {
     apiToken: string;
 }
 export declare class JiraClient {
-    private baseUrl;
-    private authHeader;
+    private readonly baseUrl;
+    private readonly authHeader;
     constructor(config: JiraClientConfig);
+    private request;
     /**
      * Parse Atlassian Document Format (ADF) to plain text
      */

package/dist/src/integrations/jira/jira.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jira.client.d.ts","sourceRoot":"","sources":["../../../../src/integrations/jira/jira.client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAkBD,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;SACd,CAAC;QACF,SAAS,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;SACd,CAAC;QACF,OAAO,EAAE;YACL,GAAG,EAAE,MAAM,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,QAAQ,CAAC,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;SACvB,GAAG,IAAI,CAAC;QACT,QAAQ,CAAC,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;SACvB,GAAG,IAAI,CAAC;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;IACF,QAAQ,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,gBAAgB;IAKpC;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAuI3D"}
+{"version":3,"file":"jira.client.d.ts","sourceRoot":"","sources":["../../../../src/integrations/jira/jira.client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAkBD,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;SACd,CAAC;QACF,SAAS,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;SACd,CAAC;QACF,OAAO,EAAE;YACL,GAAG,EAAE,MAAM,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,QAAQ,CAAC,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;SACvB,GAAG,IAAI,CAAC;QACT,QAAQ,CAAC,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;SACvB,GAAG,IAAI,CAAC;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;IACF,QAAQ,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,gBAAgB;YAKtB,OAAO;IAgBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CA4B3D"}