carto-cli 0.1.0-rc.1

package/dist/commands/users.js

@@ -0,0 +1,459 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usersList = usersList;
+exports.usersGet = usersGet;
+exports.usersInvite = usersInvite;
+exports.usersResendInvitation = usersResendInvitation;
+exports.usersCancelInvitation = usersCancelInvitation;
+exports.usersDelete = usersDelete;
+exports.usersInvitations = usersInvitations;
+const api_1 = require("../api");
+const colors_1 = require("../colors");
+/**
+ * List all users in the organization
+ */
+async function usersList(options, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        let users;
+        if (options.all) {
+            // Fetch all pages automatically
+            // Note: We'll use a simple pagination approach since we don't know the exact API pagination format
+            let page = 1;
+            const pageSize = 100;
+            const allUsers = [];
+            let hasMore = true;
+            while (hasMore) {
+                const params = new URLSearchParams();
+                params.append('page', page.toString());
+                params.append('page_size', pageSize.toString());
+                if (options.role)
+                    params.append('role', options.role);
+                if (options.search)
+                    params.append('search', options.search);
+                const queryString = params.toString();
+                const url = `/accounts/users${queryString ? '?' + queryString : ''}`;
+                const result = await client.getAccounts(url, true);
+                const pageUsers = Array.isArray(result) ? result : (result.data || result.results || []);
+                if (pageUsers.length === 0) {
+                    hasMore = false;
+                }
+                else {
+                    allUsers.push(...pageUsers);
+                    if (pageUsers.length < pageSize) {
+                        hasMore = false;
+                    }
+                    page++;
+                }
+            }
+            users = allUsers;
+        }
+        else {
+            // Fetch with pagination parameters or defaults
+            const params = new URLSearchParams();
+            if (options.page)
+                params.append('page', options.page);
+            if (options.pageSize)
+                params.append('page_size', options.pageSize);
+            if (options.role)
+                params.append('role', options.role);
+            if (options.search)
+                params.append('search', options.search);
+            const queryString = params.toString();
+            const url = `/accounts/users${queryString ? '?' + queryString : ''}`;
+            const result = await client.getAccounts(url, true);
+            users = Array.isArray(result) ? result : (result.data || result.results || []);
+        }
+        if (jsonOutput) {
+            console.log(JSON.stringify(users));
+        }
+        else {
+            console.log((0, colors_1.bold)(`\nUsers (${users.length}):\n`));
+            users.forEach((user) => {
+                console.log((0, colors_1.bold)('Name: ') + (user.name || 'N/A'));
+                console.log('  Email: ' + user.email);
+                console.log('  User ID: ' + user.user_id);
+                if (user.app_metadata?.roles && user.app_metadata.roles.length > 0) {
+                    console.log('  Roles: ' + user.app_metadata.roles.join(', '));
+                }
+                console.log('  Verified: ' + (user.email_verified ? 'Yes' : 'No'));
+                console.log('  Created: ' + new Date(user.created_at).toLocaleString());
+                if (user.user_metadata) {
+                    console.log('  Organization: ' + user.user_metadata.account_name + ' (' + user.user_metadata.account_id + ')');
+                }
+                if (user.groups && user.groups.length > 0) {
+                    console.log('  Groups: ' + user.groups.join(', '));
+                }
+                console.log('');
+            });
+            if (options.all) {
+                console.log((0, colors_1.dim)(`Fetched all ${users.length} users`));
+            }
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to view users.');
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to list users: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Get detailed information about a specific user
+ */
+async function usersGet(userIdOrEmail, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        // Search for the user (works for both email and user_id)
+        let searchTerm = userIdOrEmail;
+        // For user IDs, we need to search through all users since there's no GET /accounts/users/{id} endpoint
+        const searchUrl = `/accounts/users${searchTerm.includes('@') ? '?search=' + encodeURIComponent(searchTerm) : ''}`;
+        const searchResults = await client.getAccounts(searchUrl, true);
+        const users = Array.isArray(searchResults) ? searchResults : (searchResults.data || searchResults.results || []);
+        // Find exact match (by email or user_id)
+        let user;
+        if (userIdOrEmail.includes('@')) {
+            user = users.find((u) => u.email.toLowerCase() === userIdOrEmail.toLowerCase());
+        }
+        else {
+            user = users.find((u) => u.user_id === userIdOrEmail);
+        }
+        if (!user) {
+            throw new Error(`User not found: ${userIdOrEmail}`);
+        }
+        if (jsonOutput) {
+            console.log(JSON.stringify(user));
+        }
+        else {
+            console.log((0, colors_1.bold)('\n=== User Details ===\n'));
+            console.log((0, colors_1.bold)('User ID: ') + user.user_id);
+            console.log((0, colors_1.bold)('Name: ') + (user.name || 'N/A'));
+            console.log((0, colors_1.bold)('Email: ') + user.email);
+            console.log((0, colors_1.bold)('Nickname: ') + (user.nickname || 'N/A'));
+            console.log((0, colors_1.bold)('Email Verified: ') + (user.email_verified ? 'Yes' : 'No'));
+            console.log((0, colors_1.bold)('Created: ') + new Date(user.created_at).toLocaleString());
+            if (user.picture) {
+                console.log((0, colors_1.bold)('Picture: ') + user.picture);
+            }
+            if (user.user_metadata) {
+                console.log((0, colors_1.bold)('\nOrganization:'));
+                console.log('  Account ID: ' + user.user_metadata.account_id);
+                console.log('  Account Name: ' + user.user_metadata.account_name);
+                console.log('  Tenant: ' + user.user_metadata.tenant_domain + ' (' + user.user_metadata.tenant_id + ')');
+            }
+            if (user.app_metadata?.roles && user.app_metadata.roles.length > 0) {
+                console.log((0, colors_1.bold)('\nRoles: ') + user.app_metadata.roles.join(', '));
+            }
+            if (user.groups && user.groups.length > 0) {
+                console.log((0, colors_1.bold)('\nGroups: ') + user.groups.join(', '));
+            }
+            if (user.identities && user.identities.length > 0) {
+                console.log((0, colors_1.bold)('\nIdentities:'));
+                user.identities.forEach((identity) => {
+                    console.log(`  - ${identity.provider} (${identity.connection})`);
+                });
+            }
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to view this user.');
+            }
+            else if (err.message.includes('404')) {
+                console.log((0, colors_1.error)('✗ User not found: ' + userIdOrEmail));
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to get user details: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Invite new users to the organization
+ */
+async function usersInvite(emails, role, token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        // Validate role
+        const validRoles = ['Builder', 'Viewer', 'Guest'];
+        if (!validRoles.includes(role)) {
+            throw new Error(`Invalid role: ${role}. Valid roles are: ${validRoles.join(', ')}`);
+        }
+        // Prepare request body
+        const body = {
+            email: emails,
+            target_role: role
+        };
+        const url = `/accounts/invite`;
+        const results = await client.postAccounts(url, body, true);
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: true, results }));
+        }
+        else {
+            console.log((0, colors_1.success)('\n✓ Invitation(s) sent\n'));
+            results.forEach((result) => {
+                if (result.code === 200 && result.status === 'sent') {
+                    console.log((0, colors_1.success)('✓ ') + result.destination + ' - ' + (0, colors_1.info)(result.status));
+                }
+                else {
+                    console.log((0, colors_1.error)('✗ ') + result.destination + ' - ' + (0, colors_1.error)(result.status));
+                    if (result.message) {
+                        console.log('    ' + (0, colors_1.dim)(result.message));
+                    }
+                }
+            });
+            console.log('');
+            console.log((0, colors_1.info)(`Role: ${role}`));
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to invite users.');
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to invite users: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Resend a pending invitation
+ */
+async function usersResendInvitation(token, apiToken, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(apiToken, baseUrl, debug, profile);
+        const url = `/accounts/invitations/re-send`;
+        const body = { token };
+        const result = await client.postAccounts(url, body, true);
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: true, ...result }));
+        }
+        else {
+            console.log((0, colors_1.success)('\n✓ Invitation resent successfully\n'));
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to resend invitations.');
+            }
+            else if (err.message.includes('404')) {
+                console.log((0, colors_1.error)('✗ Invitation not found'));
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to resend invitation: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Cancel a pending invitation
+ */
+async function usersCancelInvitation(token, apiToken, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(apiToken, baseUrl, debug, profile);
+        const url = `/accounts/invite/${token}`;
+        const response = await client.deleteAccounts(url, true);
+        if (jsonOutput) {
+            console.log(JSON.stringify({ success: true, ...response }));
+        }
+        else {
+            console.log((0, colors_1.success)('\n✓ Invitation cancelled successfully\n'));
+            if (response.status) {
+                console.log((0, colors_1.info)(`Status: ${response.status}`));
+            }
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to cancel invitations.');
+            }
+            else if (err.message.includes('404')) {
+                console.log((0, colors_1.error)('✗ Invitation not found'));
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to cancel invitation: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Helper function to resolve user identifier (email or user_id) to user_id
+ */
+async function resolveUserId(userIdOrEmail, client) {
+    // If it's already a user ID format, return it directly
+    if (!userIdOrEmail.includes('@')) {
+        return { userId: userIdOrEmail, email: '' };
+    }
+    // It's an email, search for the user
+    const searchUrl = `/accounts/users?search=${encodeURIComponent(userIdOrEmail)}`;
+    const searchResults = await client.getAccounts(searchUrl, true);
+    const users = Array.isArray(searchResults) ? searchResults : (searchResults.data || searchResults.results || []);
+    const user = users.find((u) => u.email.toLowerCase() === userIdOrEmail.toLowerCase());
+    if (!user) {
+        throw new Error(`User not found: ${userIdOrEmail}`);
+    }
+    return { userId: user.user_id, email: user.email };
+}
+/**
+ * Delete a user from the organization
+ */
+async function usersDelete(userIdOrEmail, receiverUserIdOrEmail, apiToken, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(apiToken, baseUrl, debug, profile);
+        // Resolve both user identifiers to user IDs
+        const userToDelete = await resolveUserId(userIdOrEmail, client);
+        const receiverUser = await resolveUserId(receiverUserIdOrEmail, client);
+        // URL encode the user IDs
+        const encodedUserId = encodeURIComponent(userToDelete.userId);
+        const encodedReceiverUserId = encodeURIComponent(receiverUser.userId);
+        const url = `/users/${encodedUserId}?resourcesReceiverUserId=${encodedReceiverUserId}`;
+        const response = await client.deleteAccounts(url, true);
+        if (jsonOutput) {
+            console.log(JSON.stringify({
+                success: true,
+                deletedUserId: userToDelete.userId,
+                deletedUserEmail: userToDelete.email || userIdOrEmail,
+                receiverUserId: receiverUser.userId,
+                receiverUserEmail: receiverUser.email || receiverUserIdOrEmail,
+                ...response
+            }));
+        }
+        else {
+            console.log((0, colors_1.success)('\n✓ User deleted successfully\n'));
+            console.log((0, colors_1.info)(`Deleted user: ${userToDelete.email || userToDelete.userId}`));
+            console.log((0, colors_1.info)(`Resources transferred to: ${receiverUser.email || receiverUser.userId}`));
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to delete users.');
+            }
+            else if (err.message.includes('404') || err.message.includes('User not found')) {
+                console.log((0, colors_1.error)('✗ User not found: ' + err.message));
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to delete user: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * List pending invitations
+ */
+async function usersInvitations(token, baseUrl, jsonOutput, debug = false, profile) {
+    try {
+        const client = await api_1.ApiClient.create(token, baseUrl, debug, profile);
+        const url = `/accounts/invitations/in-progress`;
+        const invitations = await client.getAccounts(url, true);
+        if (jsonOutput) {
+            console.log(JSON.stringify(invitations));
+        }
+        else {
+            const invitationList = invitations.invitations || [];
+            if (invitationList.length === 0) {
+                console.log((0, colors_1.info)('\nNo pending invitations'));
+            }
+            else {
+                console.log((0, colors_1.bold)(`\nPending Invitations (${invitationList.length}):\n`));
+                invitationList.forEach((invitation) => {
+                    console.log((0, colors_1.bold)('Email: ') + invitation.recipient);
+                    if (invitation.targetRole) {
+                        console.log('  Role: ' + invitation.targetRole);
+                    }
+                    if (invitation.requestedAt) {
+                        console.log('  Sent: ' + new Date(invitation.requestedAt).toLocaleString());
+                    }
+                    if (invitation.status) {
+                        console.log('  Status: ' + invitation.status);
+                    }
+                    if (invitation.expired !== undefined) {
+                        console.log('  Expired: ' + (invitation.expired ? 'Yes' : 'No'));
+                    }
+                    console.log('');
+                });
+            }
+        }
+    }
+    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 if (err.message.includes('403')) {
+                console.log((0, colors_1.error)('✗ Access denied'));
+                console.log('You may not have sufficient permissions to view invitations.');
+            }
+            else {
+                console.log((0, colors_1.error)('✗ Failed to list invitations: ' + err.message));
+            }
+        }
+        process.exit(1);
+    }
+}