@capawesome/cli 4.20.0 → 4.21.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [4.21.0](https://github.com/capawesome-team/cli/compare/v4.20.0...v4.21.0) (2026-09-22)
+
+
+### Features
+
+* **apps:** link repositories via git connections ([#222](https://github.com/capawesome-team/cli/issues/222)) ([f567ea6](https://github.com/capawesome-team/cli/commit/f567ea6d0e836b4aea8e4d57ff10d934a6788fe2))
+
+
+### Bug Fixes
+
+* retry rate limited requests ([#223](https://github.com/capawesome-team/cli/issues/223)) ([47d9733](https://github.com/capawesome-team/cli/commit/47d9733ec28bf0bb3235b8dccdd5b353ec24d0b5))
+
 ## [4.20.0](https://github.com/capawesome-team/cli/compare/v4.19.0...v4.20.0) (2026-09-22)
 
 

package/dist/commands/apps/import.js

@@ -15,6 +15,7 @@ import { withAuth } from '../../utils/auth.js';
 import { isInteractive } from '../../utils/environment.js';
 import { getMessageFromUnknownError, UserError } from '../../utils/error.js';
 import { isReadable } from '../../utils/file.js';
+import { getGitRepositoryPath } from '../../utils/git.js';
 import { prompt, promptOrganizationSelection } from '../../utils/prompt.js';
 import zip from '../../utils/zip.js';
 import { defineCommand, defineOptions } from 'zodline';
@@ -24,8 +25,6 @@ import os from 'os';
 import path from 'path';
 import { z } from 'zod';
 const SIGNALS = ['SIGHUP', 'SIGINT', 'SIGTERM'];
-// Maps the providers of `parseGitRemoteUrl` to the providers of git connections.
-const GIT_CONNECTION_PROVIDERS = { azure: 'azure_devops' };
 export default defineCommand({
     description: 'Import apps from an Ionic Appflow export.',
     options: defineOptions(z.object({
@@ -102,8 +101,11 @@ export default defineCommand({
             const { resolvedApps, skippedApps: unresolvedApps } = await resolveIonicAppTypes(selectedApps, ionicAppType);
             selectedSkippedApps.push(...unresolvedApps);
             await assignUniqueAppNames(resolvedApps, organizationId);
-            const unconnectedGitProviders = await findUnconnectedGitProviders(resolvedApps, organizationId);
-            for (const provider of unconnectedGitProviders) {
+            const gitConnectionIds = await findGitConnectionIds(resolvedApps, organizationId);
+            for (const provider of getGitProviders(resolvedApps)) {
+                if (gitConnectionIds.has(provider)) {
+                    continue;
+                }
                 const appCount = resolvedApps.filter((app) => app.repository?.provider === provider).length;
                 consola.warn(`The organization has no \`${provider}\` git connection, so the repositories of ${appCount} app(s) will not be linked. Connect the git provider at ${DEFAULT_CONSOLE_BASE_URL}/organizations/${organizationId}/git before running the import to link them automatically, or link the repositories manually in the Capawesome Cloud Console afterwards.`);
             }
@@ -125,7 +127,7 @@ export default defineCommand({
                 if (dryRun) {
                     continue;
                 }
-                await importApp(organizationId, outcome, unconnectedGitProviders);
+                await importApp(organizationId, outcome, gitConnectionIds);
             }
             const errorCount = outcomes.reduce((count, outcome) => count + outcome.errors.length, 0);
             if (json) {
@@ -234,22 +236,23 @@ const assignUniqueAppNames = async (apps, organizationId) => {
         }
     }
 };
-const findUnconnectedGitProviders = async (apps, organizationId) => {
-    const providers = new Set(apps.flatMap((app) => (app.repository ? [app.repository.provider] : [])));
-    const unconnectedProviders = new Set();
-    for (const provider of providers) {
-        const gitConnections = await gitConnectionsService.findAll({
+const getGitProviders = (apps) => new Set(apps.flatMap((app) => (app.repository ? [app.repository.provider] : [])));
+const findGitConnectionIds = async (apps, organizationId) => {
+    const gitConnectionIds = new Map();
+    for (const provider of getGitProviders(apps)) {
+        const [gitConnection] = await gitConnectionsService.findAll({
             organizationId,
-            provider: GIT_CONNECTION_PROVIDERS[provider] ?? provider,
+            provider,
+            restricted: false,
             limit: 1,
         });
-        if (gitConnections.length === 0) {
-            unconnectedProviders.add(provider);
+        if (gitConnection) {
+            gitConnectionIds.set(provider, gitConnection.id);
         }
     }
-    return unconnectedProviders;
+    return gitConnectionIds;
 };
-const importApp = async (organizationId, outcome, unconnectedGitProviders) => {
+const importApp = async (organizationId, outcome, gitConnectionIds) => {
     const { app } = outcome;
     consola.start(`Importing app \`${app.sourceName}\`...`);
     let appId;
@@ -426,22 +429,20 @@ const importApp = async (organizationId, outcome, unconnectedGitProviders) => {
             outcome.errors.push(`Failed to create automation \`${automation.name}\`: ${getMessageFromUnknownError(error)}`);
         }
     }
-    if (app.repository && unconnectedGitProviders.has(app.repository.provider)) {
-        app.notes.push(`The repository \`${app.repository.ownerSlug}/${app.repository.repositorySlug}\` was not linked because the organization has no \`${app.repository.provider}\` git connection.`);
-    }
-    else if (app.repository) {
-        try {
-            await appsService.linkRepository({
-                appId,
-                ownerSlug: app.repository.ownerSlug,
-                provider: app.repository.provider,
-                repositorySlug: app.repository.repositorySlug,
-                projectSlug: app.repository.projectSlug,
-            });
-            consola.success(`Linked repository \`${app.repository.ownerSlug}/${app.repository.repositorySlug}\`.`);
-        }
-        catch (error) {
-            app.notes.push(`The repository \`${app.repository.ownerSlug}/${app.repository.repositorySlug}\` could not be linked: ${getMessageFromUnknownError(error)} Make sure the git provider is connected in the Capawesome Cloud Console and link the repository manually.`);
+    if (app.repository) {
+        const gitConnectionId = gitConnectionIds.get(app.repository.provider);
+        const repositoryPath = getGitRepositoryPath(app.repository);
+        if (!gitConnectionId) {
+            app.notes.push(`The repository \`${repositoryPath}\` was not linked because the organization has no \`${app.repository.provider}\` git connection.`);
+        }
+        else {
+            try {
+                await appsService.linkRepository({ appId, gitConnectionId, path: repositoryPath });
+                consola.success(`Linked repository \`${repositoryPath}\`.`);
+            }
+            catch (error) {
+                app.notes.push(`The repository \`${repositoryPath}\` could not be linked: ${getMessageFromUnknownError(error)} Link the repository manually in the Capawesome Cloud Console.`);
+            }
         }
     }
 };

package/dist/commands/apps/import.test.js

@@ -153,12 +153,11 @@ describe('apps-import', () => {
         })
             .reply(201, { id: 'automation-1', name: 'Android Release' })
             .get(`/v1/organizations/${organizationId}/git-connections`)
-            .query({ provider: 'github', limit: 1 })
+            .query({ provider: 'github', restricted: 'false', limit: 1 })
             .reply(200, [{ id: 'git-connection-1', provider: 'github' }])
             .put(`/v1/apps/${appId}/repository`, {
-            ownerSlug: 'robingenz',
-            provider: 'github',
-            repositorySlug: 'appflow-export-test',
+            gitConnectionId: 'git-connection-1',
+            path: 'robingenz/appflow-export-test',
         })
             .reply(200, { id: appId });
         await importCommand.action({ file: exportFile, organizationId, json: true }, undefined);
@@ -409,19 +408,14 @@ describe('apps-import', () => {
             .query({ organizationId, limit: 50, offset: 0 })
             .reply(200, [])
             .get(`/v1/organizations/${organizationId}/git-connections`)
-            .query({ provider: 'azure_devops', limit: 1 })
+            .query({ provider: 'azure_devops', restricted: 'false', limit: 1 })
             .reply(200, [{ id: 'git-connection-1', provider: 'azure_devops' }])
             .post('/v1/apps', { name: 'My App', type: 'capacitor' })
             .query({ organizationId })
             .reply(201, { id: 'app-1', name: 'My App', type: 'capacitor' })
             .get('/v1/apps/app-1/channels')
             .reply(200, [])
-            .put('/v1/apps/app-1/repository', {
-            ownerSlug: 'my-org',
-            provider: 'azure',
-            repositorySlug: 'my-repo',
-            projectSlug: 'my-project',
-        })
+            .put('/v1/apps/app-1/repository', { gitConnectionId: 'git-connection-1', path: 'my-org/my-project/my-repo' })
             .reply(200, { id: 'app-1' });
         await importCommand.action({ file: exportFile, organizationId, json: true }, undefined);
         expect(scope.isDone()).toBe(true);
@@ -445,7 +439,7 @@ describe('apps-import', () => {
             .query({ organizationId, limit: 50, offset: 0 })
             .reply(200, [])
             .get(`/v1/organizations/${organizationId}/git-connections`)
-            .query({ provider: 'github', limit: 1 })
+            .query({ provider: 'github', restricted: 'false', limit: 1 })
             .reply(200, [])
             .post('/v1/apps', { name: 'My App', type: 'capacitor' })
             .query({ organizationId })

package/dist/commands/apps/link.js

@@ -1,7 +1,9 @@
+import { DEFAULT_CONSOLE_BASE_URL } from '../../config/consts.js';
 import appsService from '../../services/apps.js';
+import gitConnectionsService from '../../services/git-connections.js';
 import { withAuth } from '../../utils/auth.js';
 import { isInteractive } from '../../utils/environment.js';
-import { getGitRemoteInfo } from '../../utils/git.js';
+import { getGitRemoteInfo, getGitRepositoryPath } from '../../utils/git.js';
 import { promptAppSelection, promptOrganizationSelection } from '../../utils/prompt.js';
 import consola from 'consola';
 import { z } from 'zod';
@@ -10,9 +12,13 @@ export default defineCommand({
     description: 'Connect a git repository to an app.',
     options: defineOptions(z.object({
         appId: z.string().optional().describe('ID of the app.'),
+        gitConnectionId: z
+            .string()
+            .optional()
+            .describe('ID of the git connection to use. Defaults to the first git connection of the organization for the git provider of the repository.'),
     })),
     action: withAuth(async (options, args) => {
-        let { appId } = options;
+        let { appId, gitConnectionId } = options;
         if (!appId) {
             if (!isInteractive()) {
                 consola.error('You must provide the app ID when running in non-interactive environment.');
@@ -22,12 +28,24 @@ export default defineCommand({
             appId = await promptAppSelection(organizationId);
         }
         const gitRemoteInfo = getGitRemoteInfo();
+        if (!gitConnectionId) {
+            const app = await appsService.findOne({ appId });
+            const [gitConnection] = await gitConnectionsService.findAll({
+                organizationId: app.organizationId,
+                provider: gitRemoteInfo.provider,
+                restricted: false,
+                limit: 1,
+            });
+            if (!gitConnection) {
+                consola.error(`No \`${gitRemoteInfo.provider}\` git connection found in the organization. Connect the git provider first at ${DEFAULT_CONSOLE_BASE_URL}/organizations/${app.organizationId}/git.`);
+                process.exit(1);
+            }
+            gitConnectionId = gitConnection.id;
+        }
         await appsService.linkRepository({
             appId,
-            ownerSlug: gitRemoteInfo.ownerSlug,
-            provider: gitRemoteInfo.provider,
-            repositorySlug: gitRemoteInfo.repositorySlug,
-            projectSlug: gitRemoteInfo.projectSlug,
+            gitConnectionId,
+            path: getGitRepositoryPath(gitRemoteInfo),
         });
         consola.success('Repository connected successfully.');
     }),

package/dist/commands/apps/link.test.js

@@ -13,7 +13,8 @@ vi.mock('consola');
 vi.mock('@/utils/environment.js', () => ({
     isInteractive: () => true,
 }));
-vi.mock('@/utils/git.js', () => ({
+vi.mock('@/utils/git.js', async (importOriginal) => ({
+    ...(await importOriginal()),
     getGitRemoteInfo: () => ({
         ownerSlug: 'capawesome-team',
         provider: 'github',
@@ -26,10 +27,13 @@ describe('apps-link', () => {
     const mockPromptAppSelection = vi.mocked(promptAppSelection);
     const mockConsola = vi.mocked(consola);
     const mockAuthorizationService = vi.mocked(authorizationService);
+    const appId = 'app-123';
+    const organizationId = 'org-1';
+    const testToken = 'test-token';
     beforeEach(() => {
         vi.clearAllMocks();
-        mockUserConfig.read.mockReturnValue({ token: 'test-token' });
-        mockAuthorizationService.getCurrentAuthorizationToken.mockReturnValue('test-token');
+        mockUserConfig.read.mockReturnValue({ token: testToken });
+        mockAuthorizationService.getCurrentAuthorizationToken.mockReturnValue(testToken);
         mockAuthorizationService.hasAuthorizationToken.mockReturnValue(true);
         vi.spyOn(process, 'exit').mockImplementation((code) => {
             throw new Error(`Process exited with code ${code}`);
@@ -39,56 +43,50 @@ describe('apps-link', () => {
         nock.cleanAll();
         vi.restoreAllMocks();
     });
-    it('should link repository with provided app ID', async () => {
-        const appId = 'app-123';
-        const testToken = 'test-token';
-        const options = { appId };
-        const scope = nock(DEFAULT_API_BASE_URL)
-            .put(`/v1/apps/${appId}/repository`, {
-            ownerSlug: 'capawesome-team',
-            provider: 'github',
-            repositorySlug: 'cli',
-        })
+    const mockGitConnectionLookup = (gitConnections) => nock(DEFAULT_API_BASE_URL)
+        .get(`/v1/apps/${appId}`)
+        .reply(200, { id: appId, name: 'Test App', organizationId, type: 'capacitor' })
+        .get(`/v1/organizations/${organizationId}/git-connections`)
+        .query({ provider: 'github', restricted: 'false', limit: 1 })
+        .reply(200, gitConnections);
+    it('should link repository using the git connection of the organization', async () => {
+        const scope = mockGitConnectionLookup([{ id: 'git-connection-1' }])
+            .put(`/v1/apps/${appId}/repository`, { gitConnectionId: 'git-connection-1', path: 'capawesome-team/cli' })
             .matchHeader('Authorization', `Bearer ${testToken}`)
             .reply(200, { id: appId, name: 'Test App' });
-        await linkCommand.action(options, undefined);
+        await linkCommand.action({ appId }, undefined);
         expect(scope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Repository connected successfully.');
     });
+    it('should link repository using the provided git connection ID', async () => {
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .put(`/v1/apps/${appId}/repository`, { gitConnectionId: 'git-connection-2', path: 'capawesome-team/cli' })
+            .reply(200, { id: appId, name: 'Test App' });
+        await linkCommand.action({ appId, gitConnectionId: 'git-connection-2' }, undefined);
+        expect(scope.isDone()).toBe(true);
+    });
     it('should prompt for organization and app when app ID is not provided', async () => {
-        const appId = 'app-123';
-        const orgId = 'org-1';
-        const testToken = 'test-token';
-        const options = {};
-        mockPromptOrganizationSelection.mockResolvedValueOnce(orgId);
+        mockPromptOrganizationSelection.mockResolvedValueOnce(organizationId);
         mockPromptAppSelection.mockResolvedValueOnce(appId);
-        const scope = nock(DEFAULT_API_BASE_URL)
-            .put(`/v1/apps/${appId}/repository`, {
-            ownerSlug: 'capawesome-team',
-            provider: 'github',
-            repositorySlug: 'cli',
-        })
-            .matchHeader('Authorization', `Bearer ${testToken}`)
+        const scope = mockGitConnectionLookup([{ id: 'git-connection-1' }])
+            .put(`/v1/apps/${appId}/repository`, { gitConnectionId: 'git-connection-1', path: 'capawesome-team/cli' })
             .reply(200, { id: appId, name: 'Test App' });
-        await linkCommand.action(options, undefined);
+        await linkCommand.action({}, undefined);
         expect(scope.isDone()).toBe(true);
         expect(mockPromptOrganizationSelection).toHaveBeenCalled();
-        expect(mockPromptAppSelection).toHaveBeenCalledWith(orgId);
-        expect(mockConsola.success).toHaveBeenCalledWith('Repository connected successfully.');
+        expect(mockPromptAppSelection).toHaveBeenCalledWith(organizationId);
+    });
+    it('should error if the organization has no git connection for the provider', async () => {
+        const scope = mockGitConnectionLookup([]);
+        await expect(linkCommand.action({ appId }, undefined)).rejects.toThrow('Process exited with code 1');
+        expect(scope.isDone()).toBe(true);
+        expect(mockConsola.error).toHaveBeenCalledWith(expect.stringContaining('No `github` git connection found'));
     });
     it('should handle API error', async () => {
-        const appId = 'app-123';
-        const testToken = 'test-token';
-        const options = { appId };
-        const scope = nock(DEFAULT_API_BASE_URL)
-            .put(`/v1/apps/${appId}/repository`, {
-            ownerSlug: 'capawesome-team',
-            provider: 'github',
-            repositorySlug: 'cli',
-        })
-            .matchHeader('Authorization', `Bearer ${testToken}`)
-            .reply(400, { message: 'Git provider not connected' });
-        await expect(linkCommand.action(options, undefined)).rejects.toThrow();
+        const scope = mockGitConnectionLookup([{ id: 'git-connection-1' }])
+            .put(`/v1/apps/${appId}/repository`, { gitConnectionId: 'git-connection-1', path: 'capawesome-team/cli' })
+            .reply(400, { message: 'Repository not found' });
+        await expect(linkCommand.action({ appId }, undefined)).rejects.toThrow();
         expect(scope.isDone()).toBe(true);
     });
 });

package/dist/services/git-connections.js

@@ -16,6 +16,9 @@ class GitConnectionsServiceImpl {
         if (dto.provider !== undefined) {
             params.provider = dto.provider;
         }
+        if (dto.restricted !== undefined) {
+            params.restricted = dto.restricted.toString();
+        }
         const response = await this.httpClient.get(`/v1/organizations/${dto.organizationId}/git-connections`, {
             headers: {
                 Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,

package/dist/utils/git.js

@@ -4,8 +4,8 @@ const HOSTNAME_TO_PROVIDER = {
     'github.com': 'github',
     'gitlab.com': 'gitlab',
     'bitbucket.org': 'bitbucket',
-    'dev.azure.com': 'azure',
-    'ssh.dev.azure.com': 'azure',
+    'dev.azure.com': 'azure_devops',
+    'ssh.dev.azure.com': 'azure_devops',
 };
 export const getGitRemoteInfo = () => {
     const remoteUrl = getGitRemoteUrl();
@@ -25,7 +25,7 @@ export const parseGitRemoteUrl = (remoteUrl) => {
     if (azureHttpsMatch && azureHttpsMatch[1] && azureHttpsMatch[2] && azureHttpsMatch[3]) {
         return {
             ownerSlug: azureHttpsMatch[1],
-            provider: 'azure',
+            provider: 'azure_devops',
             repositorySlug: azureHttpsMatch[3],
             projectSlug: azureHttpsMatch[2],
         };
@@ -35,7 +35,7 @@ export const parseGitRemoteUrl = (remoteUrl) => {
     if (azureSshMatch && azureSshMatch[1] && azureSshMatch[2] && azureSshMatch[3]) {
         return {
             ownerSlug: azureSshMatch[1],
-            provider: 'azure',
+            provider: 'azure_devops',
             repositorySlug: azureSshMatch[3],
             projectSlug: azureSshMatch[2],
         };
@@ -45,7 +45,7 @@ export const parseGitRemoteUrl = (remoteUrl) => {
     if (vsHttpsMatch && vsHttpsMatch[1] && vsHttpsMatch[2] && vsHttpsMatch[3]) {
         return {
             ownerSlug: vsHttpsMatch[1],
-            provider: 'azure',
+            provider: 'azure_devops',
             repositorySlug: vsHttpsMatch[3],
             projectSlug: vsHttpsMatch[2],
         };
@@ -90,3 +90,4 @@ export const parseGitRemoteUrl = (remoteUrl) => {
     }
     throw new UserError('Could not parse git remote URL.');
 };
+export const getGitRepositoryPath = (remoteInfo) => [remoteInfo.ownerSlug, remoteInfo.projectSlug, remoteInfo.repositorySlug].filter(Boolean).join('/');

package/dist/utils/git.test.js

@@ -87,7 +87,7 @@ describe('parseGitRemoteUrl', () => {
         const result = parseGitRemoteUrl('https://dev.azure.com/my-org/my-project/_git/my-repo');
         expect(result).toEqual({
             ownerSlug: 'my-org',
-            provider: 'azure',
+            provider: 'azure_devops',
             repositorySlug: 'my-repo',
             projectSlug: 'my-project',
         });
@@ -96,7 +96,7 @@ describe('parseGitRemoteUrl', () => {
         const result = parseGitRemoteUrl('git@ssh.dev.azure.com:v3/my-org/my-project/my-repo');
         expect(result).toEqual({
             ownerSlug: 'my-org',
-            provider: 'azure',
+            provider: 'azure_devops',
             repositorySlug: 'my-repo',
             projectSlug: 'my-project',
         });
@@ -105,7 +105,7 @@ describe('parseGitRemoteUrl', () => {
         const result = parseGitRemoteUrl('https://my-org.visualstudio.com/my-project/_git/my-repo');
         expect(result).toEqual({
             ownerSlug: 'my-org',
-            provider: 'azure',
+            provider: 'azure_devops',
             repositorySlug: 'my-repo',
             projectSlug: 'my-project',
         });

package/dist/utils/http-client.js

@@ -2,19 +2,28 @@ import { createRequire } from 'module';
 import configService from '../services/config.js';
 import axios from 'axios';
 import axiosRetry from 'axios-retry';
+import consola from 'consola';
 import { HttpProxyAgent } from 'http-proxy-agent';
 import { HttpsProxyAgent } from 'https-proxy-agent';
 const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
+const isRateLimitError = (error) => error.response?.status === 429;
 // Register middleware to retry failed requests
 axiosRetry(axios, {
     retries: 3,
+    // Waits at least as long as the `Retry-After` header of rate limited responses
     retryDelay: axiosRetry.exponentialDelay,
     retryCondition: (error) => {
-        // Network errors and 5xx responses are retried
+        // Network errors, rate limited requests and 5xx responses are retried
         return (axiosRetry.isNetworkOrIdempotentRequestError(error) ||
+            isRateLimitError(error) ||
             (error.response?.status !== undefined && error.response.status >= 500));
     },
+    onRetry: (_retryCount, error) => {
+        if (isRateLimitError(error)) {
+            consola.warn('Rate limit reached. Retrying...');
+        }
+    },
 });
 /**
  * Gets the appropriate proxy agent based on the target URL protocol and environment variables.

package/dist/utils/http-client.test.js

@@ -1,4 +1,5 @@
 import configService from '../services/config.js';
+import consola from 'consola';
 import nock from 'nock';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 // Mock the config service
@@ -7,6 +8,7 @@ vi.mock('@/services/config.js', () => ({
         getValueForKey: vi.fn().mockResolvedValue('https://api.example.com'),
     },
 }));
+vi.mock('consola');
 describe('http-client', () => {
     let originalEnv;
     beforeEach(() => {
@@ -23,6 +25,7 @@ describe('http-client', () => {
     afterEach(() => {
         // Restore original environment variables
         process.env = originalEnv;
+        vi.useRealTimers();
     });
     it('should retry requests on 5xx status codes', async () => {
         // Mock the API_BASE_URL
@@ -50,6 +53,29 @@ describe('http-client', () => {
         await expect(httpClient.get('/not-found')).rejects.toThrow();
         expect(nock.isDone()).toBe(true);
     });
+    it('should retry rate limited requests after the `Retry-After` delay', async () => {
+        vi.mocked(configService.getValueForKey).mockResolvedValue('https://api.example.com');
+        // Mock a 429 response followed by success
+        nock('https://api.example.com')
+            .post('/rate-limited')
+            .reply(429, { error: 'Too Many Requests' }, { 'Retry-After': '10' })
+            .post('/rate-limited')
+            .reply(200, { success: true });
+        const { default: httpClient } = await import('./http-client.js');
+        // Only fake `setTimeout` so the request itself is still served by nock
+        vi.useFakeTimers({ toFake: ['setTimeout'] });
+        const responsePromise = httpClient.post('/rate-limited');
+        // Wait until the retry has been scheduled
+        await vi.waitFor(() => expect(vi.getTimerCount()).toBe(1));
+        await vi.advanceTimersByTimeAsync(5000);
+        expect(nock.isDone()).toBe(false);
+        await vi.runAllTimersAsync();
+        const response = await responsePromise;
+        expect(response.status).toBe(200);
+        expect(response.data).toEqual({ success: true });
+        expect(nock.isDone()).toBe(true);
+        expect(consola.warn).toHaveBeenCalledWith('Rate limit reached. Retrying...');
+    });
     it('should eventually fail after maximum retries on persistent 5xx errors', async () => {
         vi.mocked(configService.getValueForKey).mockResolvedValue('https://api.example.com');
         // Mock 4 consecutive 500 responses (initial + 3 retries)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/cli",
-  "version": "4.20.0",
+  "version": "4.21.0",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {