test(cli): add handlePredownloadAction test for coverage

Extract predownload action handler to named exported function and add
unit test to maintain function coverage levels.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Mossaka

src/cli.test.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { parseEnvironmentVariables, parseDomains, parseDomainsFile, escapeShellArg, joinShellArgs, parseVolumeMounts, isValidIPv4, isValidIPv6, parseDnsServers, validateAgentImage, isAgentImagePreset, AGENT_IMAGE_PRESETS, processAgentImageOption, processLocalhostKeyword, validateSkipPullWithBuildLocal, validateAllowHostPorts, validateFormat, validateApiProxyConfig, buildRateLimitConfig, validateRateLimitFlags } from './cli';
+import { parseEnvironmentVariables, parseDomains, parseDomainsFile, escapeShellArg, joinShellArgs, parseVolumeMounts, isValidIPv4, isValidIPv6, parseDnsServers, validateAgentImage, isAgentImagePreset, AGENT_IMAGE_PRESETS, processAgentImageOption, processLocalhostKeyword, validateSkipPullWithBuildLocal, validateAllowHostPorts, validateFormat, validateApiProxyConfig, buildRateLimitConfig, validateRateLimitFlags, handlePredownloadAction } from './cli';
 import { redactSecrets } from './redact-secrets';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -1539,4 +1539,28 @@ describe('cli', () => {
       expect(result.error).toBeUndefined();
     });
   });
+
+  describe('handlePredownloadAction', () => {
+    it('should delegate to predownloadCommand with correct options', async () => {
+      // Mock the predownload module that handlePredownloadAction dynamically imports
+      const mockPredownloadCommand = jest.fn().mockResolvedValue(undefined);
+      jest.mock('./commands/predownload', () => ({
+        predownloadCommand: mockPredownloadCommand,
+      }));
+
+      await handlePredownloadAction({
+        imageRegistry: 'ghcr.io/test',
+        imageTag: 'v1.0',
+        agentImage: 'default',
+        enableApiProxy: false,
+      });
+
+      expect(mockPredownloadCommand).toHaveBeenCalledWith({
+        imageRegistry: 'ghcr.io/test',
+        imageTag: 'v1.0',
+        agentImage: 'default',
+        enableApiProxy: false,
+      });
+    });
+  });
 });

src/cli.ts

@@ -1282,6 +1282,22 @@ export function validateFormat(format: string, validFormats: string[]): void {
   }
 }
 
+// Predownload action handler - exported for testing
+export async function handlePredownloadAction(options: {
+  imageRegistry: string;
+  imageTag: string;
+  agentImage: string;
+  enableApiProxy: boolean;
+}): Promise<void> {
+  const { predownloadCommand } = await import('./commands/predownload');
+  await predownloadCommand({
+    imageRegistry: options.imageRegistry,
+    imageTag: options.imageTag,
+    agentImage: options.agentImage,
+    enableApiProxy: options.enableApiProxy,
+  });
+}
+
 // Predownload subcommand - pre-pull container images
 program
   .command('predownload')
@@ -1298,15 +1314,7 @@ program
     'default'
   )
   .option('--enable-api-proxy', 'Also download the API proxy image', false)
-  .action(async (options) => {
-    const { predownloadCommand } = await import('./commands/predownload');
-    await predownloadCommand({
-      imageRegistry: options.imageRegistry,
-      imageTag: options.imageTag,
-      agentImage: options.agentImage,
-      enableApiProxy: options.enableApiProxy,
-    });
-  });
+  .action(handlePredownloadAction);
 
 // Logs subcommand - view Squid proxy logs
 const logsCmd = program