carto-cli 0.1.0-rc.1

package/dist/commands/connections.js

@@ -0,0 +1,412 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectionsList = connectionsList;
+exports.connectionsGet = connectionsGet;
+exports.connectionsCreate = connectionsCreate;
+exports.connectionsUpdate = connectionsUpdate;
+exports.connectionsDelete = connectionsDelete;
+exports.connectionsBrowse = connectionsBrowse;
+exports.connectionsDescribe = connectionsDescribe;
+const api_1 = require("../api");
+const colors_1 = require("../colors");
+const prompt_1 = require("../prompt");
+async function connectionsList(options, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        let result;
+        if (options.all || options.page || options.pageSize || options.search) {
+            // Fetch with parameters - workspace API doesn't support pagination the same way
+            // For now, fetch from workspace API without pagination
+            const params = new URLSearchParams();
+            if (options.search)
+                params.append('search', options.search);
+            const queryString = params.toString();
+            const path = `/connections${queryString ? '?' + queryString : ''}`;
+            result = await client.getWorkspace(path);
+        }
+        else {
+            // Fetch default (no pagination)
+            result = await client.getWorkspace('/connections');
+        }
+        if (jsonOutput) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            const connections = Array.isArray(result) ? result : (result.data || result.results || result);
+            const total = result.total || connections.length;
+            console.log((0, colors_1.bold)(`\nConnections (${total}):\n`));
+            connections.forEach((conn) => {
+                console.log((0, colors_1.bold)('ID: ') + conn.id);
+                console.log('  Name: ' + conn.name);
+                console.log('  Type: ' + (conn.provider_id || conn.type));
+                console.log('  Privacy: ' + (conn.privacy || 'unknown'));
+                // Show sharing scope if available
+                if (conn.sharingScope) {
+                    console.log('  Sharing: ' + conn.sharingScope);
+                }
+                // Show owner email from workspace API
+                if (conn.ownerEmail) {
+                    console.log('  Owner: ' + conn.ownerEmail);
+                }
+                else if (conn.config?.credentials?.client_email) {
+                    console.log('  Owner: ' + conn.config.credentials.client_email);
+                }
+                else if (conn.user_id) {
+                    console.log('  User ID: ' + conn.user_id);
+                }
+                // Show map count if available
+                if (conn.mapcount !== undefined) {
+                    console.log('  Maps using: ' + conn.mapcount);
+                }
+                if (conn.description)
+                    console.log('  Description: ' + conn.description);
+                console.log('  Created: ' + new Date(conn.created_at).toLocaleString());
+                console.log('  Updated: ' + new Date(conn.updated_at).toLocaleString());
+                console.log('');
+            });
+            if (options.all) {
+                console.log((0, colors_1.dim)(`Fetched all ${total} connections`));
+            }
+            else if (result.total && result.page_size) {
+                const totalPages = Math.ceil(result.total / result.page_size);
+                console.log((0, colors_1.dim)(`Page ${result.page || 1} of ${totalPages} (use --all to fetch all pages)`));
+            }
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            if (err.message.includes('401') || err.message.includes('Token not defined')) {
+                console.log((0, colors_1.error)('✗ Authentication required'));
+                console.log('Please run: carto auth login');
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to list connections: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+async function connectionsGet(connectionId, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        const result = await client.getWorkspace(`/connections/${connectionId}`);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log((0, colors_1.bold)('\nConnection Details:\n'));
+            console.log((0, colors_1.bold)('ID: ') + result.id);
+            console.log((0, colors_1.bold)('Name: ') + result.name);
+            console.log((0, colors_1.bold)('Type: ') + (result.provider_id || result.type));
+            console.log((0, colors_1.bold)('Privacy: ') + (result.privacy || 'unknown'));
+            // Show sharing scope if available
+            if (result.sharingScope) {
+                console.log((0, colors_1.bold)('Sharing: ') + result.sharingScope);
+            }
+            // Show owner email from workspace API
+            if (result.ownerEmail) {
+                console.log((0, colors_1.bold)('Owner: ') + result.ownerEmail);
+            }
+            else if (result.config?.credentials?.client_email) {
+                console.log((0, colors_1.bold)('Owner: ') + result.config.credentials.client_email);
+            }
+            else if (result.user_id) {
+                console.log((0, colors_1.bold)('User ID: ') + result.user_id);
+            }
+            // Show map count if available
+            if (result.mapcount !== undefined) {
+                console.log((0, colors_1.bold)('Maps using: ') + result.mapcount);
+            }
+            if (result.description)
+                console.log((0, colors_1.bold)('Description: ') + result.description);
+            console.log((0, colors_1.bold)('Created: ') + new Date(result.created_at).toLocaleString());
+            console.log((0, colors_1.bold)('Updated: ') + new Date(result.updated_at).toLocaleString());
+            if (result.parameters) {
+                console.log((0, colors_1.bold)('\nParameters:'));
+                Object.entries(result.parameters).forEach(([key, value]) => {
+                    console.log(`  ${key}: ${value}`);
+                });
+            }
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            console.log((0, colors_1.error)('✗ Failed to get connection: ' + err.message));
+        }
+        process.exit(1);
+    }
+}
+async function connectionsCreate(body, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        const result = await client.post('/v3/connections', body);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log((0, colors_1.success)('✓ Connection created successfully'));
+            console.log((0, colors_1.bold)('\nID: ') + result.id);
+            console.log((0, colors_1.bold)('Name: ') + result.name);
+            console.log((0, colors_1.bold)('Type: ') + result.type);
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            console.log((0, colors_1.error)('✗ Failed to create connection: ' + err.message));
+        }
+        process.exit(1);
+    }
+}
+async function connectionsUpdate(connectionId, body, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        const result = await client.patch(`/v3/connections/${connectionId}`, body);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log((0, colors_1.success)('✓ Connection updated successfully'));
+            console.log((0, colors_1.bold)('\nID: ') + result.id);
+            console.log((0, colors_1.bold)('Name: ') + result.name);
+            console.log((0, colors_1.bold)('Type: ') + result.type);
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            console.log((0, colors_1.error)('✗ Failed to update connection: ' + err.message));
+        }
+        process.exit(1);
+    }
+}
+async function connectionsDelete(connectionId, token, baseUrl, jsonOutput, debug = false, profile, yes) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        // Skip confirmation if --yes or --json flag is set
+        const skipConfirmation = yes || jsonOutput;
+        if (!skipConfirmation) {
+            // Fetch connection details to show in confirmation prompt
+            let connectionDetails;
+            try {
+                connectionDetails = await client.getWorkspace(`/connections/${connectionId}`);
+            }
+            catch (err) {
+                // If we can't fetch details, proceed with generic message
+                console.log((0, colors_1.warning)('\n⚠️  Warning: This will permanently delete this connection.'));
+                console.log((0, colors_1.warning)(`   Connection ID: ${connectionId}`));
+            }
+            if (connectionDetails) {
+                console.log((0, colors_1.warning)('\n⚠️  Warning: This will permanently delete:'));
+                console.log(`   Connection: "${connectionDetails.name}"`);
+                console.log(`   Type: ${connectionDetails.provider_id || connectionDetails.type}`);
+                console.log(`   ID: ${connectionId}`);
+                if (connectionDetails.mapcount !== undefined && connectionDetails.mapcount > 0) {
+                    console.log((0, colors_1.warning)(`   ⚠️  This connection is used by ${connectionDetails.mapcount} map(s)`));
+                }
+            }
+            console.log('');
+            const confirmed = await (0, prompt_1.promptForConfirmation)("Type 'delete' to confirm: ", 'delete');
+            if (!confirmed) {
+                console.log('\nDeletion cancelled');
+                process.exit(0);
+            }
+            console.log('');
+        }
+        await client.delete(`/v3/connections/${connectionId}`);
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: true, message: 'Connection deleted successfully', id: connectionId }));
+        }
+        else {
+            console.log((0, colors_1.success)(`✓ Connection ${connectionId} deleted successfully`));
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            console.log((0, colors_1.error)('✗ Failed to delete connection: ' + err.message));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Helper function to resolve connection name to ID
+ */
+async function resolveConnectionId(client, nameOrId) {
+    // If it looks like a UUID, return it as-is
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(nameOrId)) {
+        return nameOrId;
+    }
+    // Otherwise, look up by name
+    const connections = await client.getWorkspace('/connections');
+    const connectionsList = Array.isArray(connections) ? connections : (connections.data || connections.results || []);
+    const found = connectionsList.find((c) => c.name === nameOrId);
+    if (!found) {
+        throw new Error(`Connection "${nameOrId}" not found`);
+    }
+    return found.id;
+}
+async function connectionsBrowse(connectionName, path, options, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        // Resolve connection name to ID
+        const connectionId = await resolveConnectionId(client, connectionName);
+        // Build the resource path
+        let resourcePath = `/connections/${connectionId}/resources/`;
+        if (path) {
+            // URL encode the path
+            resourcePath += encodeURIComponent(path);
+        }
+        // Add pagination parameters
+        const params = new URLSearchParams();
+        params.append('pageSize', options.pageSize || '30');
+        params.append('page', options.page || '1');
+        resourcePath += '?' + params.toString();
+        const result = await client.getWorkspace(resourcePath);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            const children = result.children || [];
+            const type = result.type || 'connection';
+            const provider = result.provider || 'unknown';
+            console.log((0, colors_1.bold)(`\n${connectionName} (${provider}):`));
+            if (path) {
+                console.log((0, colors_1.dim)(`Path: ${path}\n`));
+            }
+            else {
+                console.log('');
+            }
+            if (children.length === 0) {
+                console.log((0, colors_1.dim)('No resources found'));
+            }
+            else {
+                children.forEach((child) => {
+                    const icon = child.type === 'project' ? '📁' :
+                        child.type === 'dataset' ? '📂' :
+                            child.type === 'table' ? '📊' :
+                                child.type === 'view' ? '👁️ ' : '•';
+                    console.log(`${icon} ${(0, colors_1.bold)(child.name)} ${(0, colors_1.dim)(`(${child.type})`)}`);
+                    if (child.location) {
+                        console.log(`  Location: ${child.location}`);
+                    }
+                    if (child._links?.resources) {
+                        console.log((0, colors_1.dim)(`  Path: ${child.id}`));
+                    }
+                    console.log('');
+                });
+                console.log((0, colors_1.dim)(`Total: ${result.totalChildren || children.length} ${type === 'connection' ? 'projects' : type === 'project' ? 'datasets' : 'resources'}`));
+                if (result.totalChildren > children.length) {
+                    const currentPage = result.page || 1;
+                    const pageSize = result.pageSize || 30;
+                    const totalPages = Math.ceil(result.totalChildren / pageSize);
+                    console.log((0, colors_1.dim)(`Page ${currentPage} of ${totalPages} (use --page <n> to see more)`));
+                }
+            }
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            if (err.message.includes('401') || err.message.includes('Token not defined')) {
+                console.log((0, colors_1.error)('✗ Authentication required'));
+                console.log('Please run: carto auth login');
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to browse connection: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+async function connectionsDescribe(connectionName, tablePath, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        // Resolve connection name to ID
+        const connectionId = await resolveConnectionId(client, connectionName);
+        // Build the resource path with type=table to get schema details
+        const resourcePath = `/connections/${connectionId}/resources/${encodeURIComponent(tablePath)}?type=table`;
+        const result = await client.getWorkspace(resourcePath);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log((0, colors_1.bold)('\nTable Details:\n'));
+            console.log((0, colors_1.bold)('ID: ') + result.id);
+            console.log((0, colors_1.bold)('Name: ') + result.name);
+            console.log((0, colors_1.bold)('Type: ') + result.type);
+            console.log((0, colors_1.bold)('Provider: ') + result.provider);
+            if (result.geomField) {
+                console.log((0, colors_1.bold)('Geometry Column: ') + result.geomField);
+            }
+            if (result.nrows !== undefined) {
+                console.log((0, colors_1.bold)('Rows: ') + result.nrows.toLocaleString());
+            }
+            if (result.size !== undefined) {
+                const sizeMB = (result.size / (1024 * 1024)).toFixed(2);
+                console.log((0, colors_1.bold)('Size: ') + `${sizeMB} MB`);
+            }
+            if (result.tableRegion) {
+                console.log((0, colors_1.bold)('Region: ') + result.tableRegion);
+            }
+            if (result.lastModified) {
+                console.log((0, colors_1.bold)('Last Modified: ') + new Date(result.lastModified).toLocaleString());
+            }
+            // Display schema
+            if (result.schema && result.schema.length > 0) {
+                console.log((0, colors_1.bold)('\nSchema:'));
+                console.log('');
+                result.schema.forEach((col) => {
+                    const isGeom = col.name === result.geomField;
+                    const colName = isGeom ? `${col.name} 🗺️` : col.name;
+                    console.log(`  ${(0, colors_1.bold)(colName)}`);
+                    console.log(`    Type: ${col.type}`);
+                    // Show original type if available
+                    const originalCol = result.originalSchema?.find((c) => c.name === col.name);
+                    if (originalCol && originalCol.type !== col.type) {
+                        console.log((0, colors_1.dim)(`    Original: ${originalCol.type}`));
+                    }
+                    console.log('');
+                });
+                console.log((0, colors_1.dim)(`Total columns: ${result.schema.length}`));
+            }
+            // Display optimization info if available
+            if (result.optimization?.actions) {
+                console.log((0, colors_1.bold)('\nOptimization:'));
+                result.optimization.actions.forEach((action) => {
+                    const status = action.enabled ? '✓' : '✗';
+                    console.log(`  ${status} ${action.type}`);
+                });
+            }
+        }
+    }
+    catch (err) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: err.message }));
+        }
+        else {
+            if (err.message.includes('401') || err.message.includes('Token not defined')) {
+                console.log((0, colors_1.error)('✗ Authentication required'));
+                console.log('Please run: carto auth login');
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to describe table: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}