Add 'list' and 'connect' commands to CLI, update README, and adjust versioning

Author: Kinin-Code-Offical

README.md

@@ -27,7 +27,9 @@ cloudsqlctl [command] [options]
 | :-------- | :------------------------------------------------------- |
 | `install` | Download and install the Cloud SQL Proxy binary.         |
 | `update`  | Update the Cloud SQL Proxy binary to the latest version. |
+| `list`    | List available Cloud SQL instances.                      |
 | `select`  | Interactively select a Cloud SQL instance to proxy.      |
+| `connect` | Connect to a specific instance directly.                 |
 | `start`   | Start the proxy for the selected instance.               |
 | `stop`    | Stop the running proxy process.                          |
 | `restart` | Restart the proxy process.                               |
@@ -45,7 +47,11 @@ cloudsqlctl install
 # 2. Select your database instance
 cloudsqlctl select
 
-# 3. Start the proxy
+# Or list and connect directly
+cloudsqlctl list
+cloudsqlctl connect project:region:instance
+
+# 3. Start the proxy (if using select)
 cloudsqlctl start
 
 # 4. Check status

package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudsqlctl",
-  "version": "1.0.0",
+  "version": "0.2.0",
   "description": "Windows-native CLI tool that installs, updates, and manages Google Cloud SQL Auth Proxy via gcloud CLI.",
   "main": "dist/cli.js",
   "type": "module",

src/cli.ts

@@ -3,6 +3,8 @@ import { Command } from 'commander';
 import { installCommand } from './commands/install.js';
 import { updateCommand } from './commands/update.js';
 import { selectCommand } from './commands/select.js';
+import { listCommand } from './commands/list.js';
+import { connectCommand } from './commands/connect.js';
 import { startCommand } from './commands/start.js';
 import { stopCommand } from './commands/stop.js';
 import { statusCommand } from './commands/status.js';
@@ -21,6 +23,8 @@ program
 program.addCommand(installCommand);
 program.addCommand(updateCommand);
 program.addCommand(selectCommand);
+program.addCommand(listCommand);
+program.addCommand(connectCommand);
 program.addCommand(startCommand);
 program.addCommand(stopCommand);
 program.addCommand(statusCommand);

src/commands/connect.ts

@@ -0,0 +1,23 @@
+import { Command } from 'commander';
+import { startProxy, isRunning } from '../core/proxy.js';
+import { logger } from '../core/logger.js';
+
+export const connectCommand = new Command('connect')
+    .description('Connect to a specific Cloud SQL instance')
+    .argument('<instance>', 'Instance connection name (e.g., project:region:instance)')
+    .option('-p, --port <port>', 'Port to listen on', parseInt, 5432)
+    .action(async (instance, options) => {
+        try {
+            if (await isRunning()) {
+                logger.warn('Proxy is already running. Please stop it first using "cloudsqlctl stop".');
+                return;
+            }
+
+            logger.info(`Starting proxy for ${instance} on port ${options.port}...`);
+            const pid = await startProxy(instance, options.port);
+            logger.info(`Proxy started with PID ${pid}`);
+        } catch (error) {
+            logger.error('Failed to start proxy', error);
+            process.exit(1);
+        }
+    });

src/commands/list.ts

@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import { listInstances } from '../core/gcloud.js';
+import { logger } from '../core/logger.js';
+
+export const listCommand = new Command('list')
+    .description('List available Cloud SQL instances')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+        try {
+            const instances = await listInstances();
+            
+            if (options.json) {
+                console.log(JSON.stringify(instances, null, 2));
+                return;
+            }
+
+            if (instances.length === 0) {
+                logger.info('No instances found.');
+                return;
+            }
+
+            console.table(instances.map(i => ({
+                Name: i.name,
+                'Connection Name': i.connectionName,
+                Region: i.region,
+                State: i.state,
+                Version: i.databaseVersion
+            })));
+
+        } catch (error) {
+            logger.error('Failed to list instances', error);
+            process.exit(1);
+        }
+    });

tests/gcloud.test.ts

@@ -0,0 +1,32 @@
+import { listInstances } from '../src/core/gcloud.js';
+import { execa } from 'execa';
+
+jest.mock('execa');
+
+describe('Gcloud Module', () => {
+    it('should list instances', async () => {
+        const mockInstances = [
+            {
+                connectionName: 'project:region:instance',
+                name: 'instance',
+                region: 'region',
+                project: 'project',
+                databaseVersion: 'POSTGRES_13',
+                state: 'RUNNABLE'
+            }
+        ];
+
+        (execa as any).mockResolvedValue({
+            stdout: JSON.stringify(mockInstances)
+        });
+
+        const instances = await listInstances();
+        expect(instances).toEqual(mockInstances);
+        expect(execa).toHaveBeenCalledWith('gcloud', ['sql', 'instances', 'list', '--format=json']);
+    });
+
+    it('should throw error if gcloud fails', async () => {
+        (execa as any).mockRejectedValue(new Error('gcloud failed'));
+        await expect(listInstances()).rejects.toThrow('gcloud failed');
+    });
+});