appwrite-utils-cli 1.2.5 → 1.2.6

package/dist/interactiveCLI.js

@@ -1660,6 +1660,7 @@ export class InteractiveCLI {
                     message: "Select what to transfer:",
                     choices: [
                         { name: "👥 Users", value: "users", checked: true },
+                        { name: "👥 Teams", value: "teams", checked: true },
                         { name: "🗄️ Databases", value: "databases", checked: true },
                         { name: "📦 Storage Buckets", value: "buckets", checked: true },
                         { name: "⚡ Functions", value: "functions", checked: true },
@@ -1746,6 +1747,7 @@ export class InteractiveCLI {
                 targetProject: targetConfig.targetProject,
                 targetKey: targetConfig.targetKey,
                 transferUsers: transferOptions.transferTypes.includes("users"),
+                transferTeams: transferOptions.transferTypes.includes("teams"),
                 transferDatabases: transferOptions.transferTypes.includes("databases"),
                 transferBuckets: transferOptions.transferTypes.includes("buckets"),
                 transferFunctions: transferOptions.transferTypes.includes("functions"),
@@ -1764,6 +1766,9 @@ export class InteractiveCLI {
                     MessageFormatter.info("Users with preserved password hashes can log in with their original passwords", { prefix: "Transfer" });
                     MessageFormatter.info("Users with temporary passwords will need to reset their passwords", { prefix: "Transfer" });
                 }
+                if (transferOptions.transferTypes.includes("teams") && results.teams.transferred > 0) {
+                    MessageFormatter.info("Team memberships have been transferred and may require user acceptance of invitations", { prefix: "Transfer" });
+                }
             }
         }
         catch (error) {

package/dist/migrations/comprehensiveTransfer.d.ts

@@ -6,6 +6,7 @@ export interface ComprehensiveTransferOptions {
     targetProject: string;
     targetKey: string;
     transferUsers?: boolean;
+    transferTeams?: boolean;
     transferDatabases?: boolean;
     transferBuckets?: boolean;
     transferFunctions?: boolean;
@@ -18,6 +19,11 @@ export interface TransferResults {
         skipped: number;
         failed: number;
     };
+    teams: {
+        transferred: number;
+        skipped: number;
+        failed: number;
+    };
     databases: {
         transferred: number;
         skipped: number;
@@ -41,6 +47,8 @@ export declare class ComprehensiveTransfer {
     private targetClient;
     private sourceUsers;
     private targetUsers;
+    private sourceTeams;
+    private targetTeams;
     private sourceDatabases;
     private targetDatabases;
     private sourceStorage;
@@ -57,6 +65,7 @@ export declare class ComprehensiveTransfer {
     constructor(options: ComprehensiveTransferOptions);
     execute(): Promise<TransferResults>;
     private transferAllUsers;
+    private transferAllTeams;
     private transferAllDatabases;
     /**
      * Phase 1: Create database structure (collections, attributes, indexes) without transferring documents
@@ -96,5 +105,17 @@ export declare class ComprehensiveTransfer {
      * Helper method to transfer documents between databases
      */
     private transferDocumentsBetweenDatabases;
+    /**
+     * Helper method to fetch all teams with pagination
+     */
+    private fetchAllTeams;
+    /**
+     * Helper method to fetch all memberships for a team with pagination
+     */
+    private fetchAllMemberships;
+    /**
+     * Helper method to transfer team memberships
+     */
+    private transferTeamMemberships;
     private printSummary;
 }

package/dist/migrations/comprehensiveTransfer.js

@@ -1,5 +1,5 @@
 import { converterFunctions, tryAwaitWithRetry, parseAttribute } from "appwrite-utils";
-import { Client, Databases, Storage, Users, Functions, Query, } from "node-appwrite";
+import { Client, Databases, Storage, Users, Functions, Teams, Query, } from "node-appwrite";
 import { InputFile } from "node-appwrite/file";
 import { MessageFormatter } from "../shared/messageFormatter.js";
 import { ProgressManager } from "../shared/progressManager.js";
@@ -17,6 +17,8 @@ export class ComprehensiveTransfer {
     targetClient;
     sourceUsers;
     targetUsers;
+    sourceTeams;
+    targetTeams;
     sourceDatabases;
     targetDatabases;
     sourceStorage;
@@ -36,6 +38,8 @@ export class ComprehensiveTransfer {
         this.targetClient = getClient(options.targetEndpoint, options.targetProject, options.targetKey);
         this.sourceUsers = new Users(this.sourceClient);
         this.targetUsers = new Users(this.targetClient);
+        this.sourceTeams = new Teams(this.sourceClient);
+        this.targetTeams = new Teams(this.targetClient);
         this.sourceDatabases = new Databases(this.sourceClient);
         this.targetDatabases = new Databases(this.targetClient);
         this.sourceStorage = new Storage(this.sourceClient);
@@ -51,6 +55,7 @@ export class ComprehensiveTransfer {
         this.fileLimit = pLimit(Math.max(1, Math.floor(baseLimit / 4)));
         this.results = {
             users: { transferred: 0, skipped: 0, failed: 0 },
+            teams: { transferred: 0, skipped: 0, failed: 0 },
             databases: { transferred: 0, skipped: 0, failed: 0 },
             buckets: { transferred: 0, skipped: 0, failed: 0 },
             functions: { transferred: 0, skipped: 0, failed: 0 },
@@ -78,6 +83,9 @@ export class ComprehensiveTransfer {
             if (this.options.transferUsers !== false) {
                 await this.transferAllUsers();
             }
+            if (this.options.transferTeams !== false) {
+                await this.transferAllTeams();
+            }
             if (this.options.transferDatabases !== false) {
                 await this.transferAllDatabases();
             }
@@ -124,6 +132,65 @@ export class ComprehensiveTransfer {
             this.results.users.failed = 1;
         }
     }
+    async transferAllTeams() {
+        MessageFormatter.info("Starting team transfer phase", { prefix: "Transfer" });
+        try {
+            // Fetch all teams from source with pagination
+            const allSourceTeams = await this.fetchAllTeams(this.sourceTeams);
+            const allTargetTeams = await this.fetchAllTeams(this.targetTeams);
+            if (this.options.dryRun) {
+                let totalMemberships = 0;
+                for (const team of allSourceTeams) {
+                    const memberships = await this.sourceTeams.listMemberships(team.$id, [Query.limit(1)]);
+                    totalMemberships += memberships.total;
+                }
+                MessageFormatter.info(`DRY RUN: Would transfer ${allSourceTeams.length} teams with ${totalMemberships} memberships`, { prefix: "Transfer" });
+                return;
+            }
+            const transferTasks = allSourceTeams.map(team => this.limit(async () => {
+                try {
+                    // Check if team exists in target
+                    const existingTeam = allTargetTeams.find(tt => tt.$id === team.$id);
+                    if (!existingTeam) {
+                        // Fetch all memberships to extract unique roles before creating team
+                        MessageFormatter.info(`Fetching memberships for team ${team.name} to extract roles`, { prefix: "Transfer" });
+                        const memberships = await this.fetchAllMemberships(team.$id);
+                        // Extract unique roles from all memberships
+                        const allRoles = new Set();
+                        memberships.forEach(membership => {
+                            membership.roles.forEach(role => allRoles.add(role));
+                        });
+                        const uniqueRoles = Array.from(allRoles);
+                        MessageFormatter.info(`Found ${uniqueRoles.length} unique roles for team ${team.name}: ${uniqueRoles.join(', ')}`, { prefix: "Transfer" });
+                        // Create team in target with the collected roles
+                        await this.targetTeams.create(team.$id, team.name, uniqueRoles);
+                        MessageFormatter.success(`Created team: ${team.name} with roles: ${uniqueRoles.join(', ')}`, { prefix: "Transfer" });
+                    }
+                    else {
+                        MessageFormatter.info(`Team ${team.name} already exists, updating if needed`, { prefix: "Transfer" });
+                        // Update team if needed
+                        if (existingTeam.name !== team.name) {
+                            await this.targetTeams.updateName(team.$id, team.name);
+                            MessageFormatter.success(`Updated team name: ${team.name}`, { prefix: "Transfer" });
+                        }
+                    }
+                    // Transfer team memberships
+                    await this.transferTeamMemberships(team.$id);
+                    this.results.teams.transferred++;
+                    MessageFormatter.success(`Team ${team.name} transferred successfully`, { prefix: "Transfer" });
+                }
+                catch (error) {
+                    MessageFormatter.error(`Team ${team.name} transfer failed`, error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+                    this.results.teams.failed++;
+                }
+            }));
+            await Promise.all(transferTasks);
+            MessageFormatter.success("Team transfer phase completed", { prefix: "Transfer" });
+        }
+        catch (error) {
+            MessageFormatter.error("Team transfer phase failed", error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+        }
+    }
     async transferAllDatabases() {
         MessageFormatter.info("Starting database transfer phase", { prefix: "Transfer" });
         try {
@@ -680,16 +747,118 @@ export class ComprehensiveTransfer {
         }
         MessageFormatter.info(`Transferred ${totalTransferred} documents from ${sourceCollectionId} to ${targetCollectionId}`, { prefix: "Transfer" });
     }
+    /**
+     * Helper method to fetch all teams with pagination
+     */
+    async fetchAllTeams(teams) {
+        const teamsList = [];
+        let lastId;
+        while (true) {
+            const queries = [Query.limit(100)];
+            if (lastId) {
+                queries.push(Query.cursorAfter(lastId));
+            }
+            const result = await tryAwaitWithRetry(async () => teams.list(queries));
+            if (result.teams.length === 0) {
+                break;
+            }
+            teamsList.push(...result.teams);
+            if (result.teams.length < 100) {
+                break;
+            }
+            lastId = result.teams[result.teams.length - 1].$id;
+        }
+        return teamsList;
+    }
+    /**
+     * Helper method to fetch all memberships for a team with pagination
+     */
+    async fetchAllMemberships(teamId) {
+        const membershipsList = [];
+        let lastId;
+        while (true) {
+            const queries = [Query.limit(100)];
+            if (lastId) {
+                queries.push(Query.cursorAfter(lastId));
+            }
+            const result = await tryAwaitWithRetry(async () => this.sourceTeams.listMemberships(teamId, queries));
+            if (result.memberships.length === 0) {
+                break;
+            }
+            membershipsList.push(...result.memberships);
+            if (result.memberships.length < 100) {
+                break;
+            }
+            lastId = result.memberships[result.memberships.length - 1].$id;
+        }
+        return membershipsList;
+    }
+    /**
+     * Helper method to transfer team memberships
+     */
+    async transferTeamMemberships(teamId) {
+        MessageFormatter.info(`Transferring memberships for team ${teamId}`, { prefix: "Transfer" });
+        try {
+            // Fetch all memberships for this team
+            const memberships = await this.fetchAllMemberships(teamId);
+            if (memberships.length === 0) {
+                MessageFormatter.info(`No memberships found for team ${teamId}`, { prefix: "Transfer" });
+                return;
+            }
+            MessageFormatter.info(`Found ${memberships.length} memberships for team ${teamId}`, { prefix: "Transfer" });
+            let totalTransferred = 0;
+            // Transfer memberships with rate limiting
+            const transferTasks = memberships.map(membership => this.userLimit(async () => {
+                try {
+                    // Check if membership already exists
+                    try {
+                        await this.targetTeams.getMembership(teamId, membership.$id);
+                        MessageFormatter.info(`Membership ${membership.$id} already exists, skipping`, { prefix: "Transfer" });
+                        return;
+                    }
+                    catch (error) {
+                        // Membership doesn't exist, proceed with creation
+                    }
+                    // Get user data from target (users should already be transferred)
+                    let userData = null;
+                    try {
+                        userData = await this.targetUsers.get(membership.userId);
+                    }
+                    catch (error) {
+                        MessageFormatter.warning(`User ${membership.userId} not found in target, membership ${membership.$id} may fail`, { prefix: "Transfer" });
+                    }
+                    // Create membership using the comprehensive user data
+                    await tryAwaitWithRetry(async () => this.targetTeams.createMembership(teamId, membership.roles, userData?.email || membership.userEmail, // Use target user email if available, fallback to membership email
+                    membership.userId, // User ID
+                    userData?.phone || undefined, // Use target user phone if available
+                    undefined, // Invitation URL placeholder
+                    userData?.name || membership.userName // Use target user name if available, fallback to membership name
+                    ));
+                    totalTransferred++;
+                    MessageFormatter.success(`Transferred membership ${membership.$id} for user ${userData?.name || membership.userName}`, { prefix: "Transfer" });
+                }
+                catch (error) {
+                    MessageFormatter.error(`Failed to transfer membership ${membership.$id}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+                }
+            }));
+            await Promise.all(transferTasks);
+            MessageFormatter.info(`Transferred ${totalTransferred} memberships for team ${teamId}`, { prefix: "Transfer" });
+        }
+        catch (error) {
+            MessageFormatter.error(`Failed to transfer memberships for team ${teamId}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+        }
+    }
     printSummary() {
         const duration = Math.round((Date.now() - this.startTime) / 1000);
         MessageFormatter.info("=== COMPREHENSIVE TRANSFER SUMMARY ===", { prefix: "Transfer" });
         MessageFormatter.info(`Total Time: ${duration}s`, { prefix: "Transfer" });
         MessageFormatter.info(`Users: ${this.results.users.transferred} transferred, ${this.results.users.skipped} skipped, ${this.results.users.failed} failed`, { prefix: "Transfer" });
+        MessageFormatter.info(`Teams: ${this.results.teams.transferred} transferred, ${this.results.teams.skipped} skipped, ${this.results.teams.failed} failed`, { prefix: "Transfer" });
         MessageFormatter.info(`Databases: ${this.results.databases.transferred} transferred, ${this.results.databases.skipped} skipped, ${this.results.databases.failed} failed`, { prefix: "Transfer" });
         MessageFormatter.info(`Buckets: ${this.results.buckets.transferred} transferred, ${this.results.buckets.skipped} skipped, ${this.results.buckets.failed} failed`, { prefix: "Transfer" });
         MessageFormatter.info(`Functions: ${this.results.functions.transferred} transferred, ${this.results.functions.skipped} skipped, ${this.results.functions.failed} failed`, { prefix: "Transfer" });
-        const totalTransferred = this.results.users.transferred + this.results.databases.transferred + this.results.buckets.transferred + this.results.functions.transferred;
-        const totalFailed = this.results.users.failed + this.results.databases.failed + this.results.buckets.failed + this.results.functions.failed;
+        const totalTransferred = this.results.users.transferred + this.results.teams.transferred + this.results.databases.transferred + this.results.buckets.transferred + this.results.functions.transferred;
+        const totalFailed = this.results.users.failed + this.results.teams.failed + this.results.databases.failed + this.results.buckets.failed + this.results.functions.failed;
         if (totalFailed === 0) {
             MessageFormatter.success(`All ${totalTransferred} items transferred successfully!`, { prefix: "Transfer" });
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "appwrite-utils-cli",
   "description": "Appwrite Utility Functions to help with database management, data conversion, data import, migrations, and much more. Meant to be used as a CLI tool, I do not recommend installing this in frontend environments.",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "main": "src/main.ts",
   "type": "module",
   "repository": {

package/src/interactiveCLI.ts

@@ -2202,6 +2202,7 @@ export class InteractiveCLI {
           message: "Select what to transfer:",
           choices: [
             { name: "👥 Users", value: "users", checked: true },
+            { name: "👥 Teams", value: "teams", checked: true },
             { name: "🗄️ Databases", value: "databases", checked: true },
             { name: "📦 Storage Buckets", value: "buckets", checked: true },
             { name: "⚡ Functions", value: "functions", checked: true },
@@ -2294,6 +2295,7 @@ export class InteractiveCLI {
         targetProject: targetConfig.targetProject,
         targetKey: targetConfig.targetKey,
         transferUsers: transferOptions.transferTypes.includes("users"),
+        transferTeams: transferOptions.transferTypes.includes("teams"),
         transferDatabases: transferOptions.transferTypes.includes("databases"),
         transferBuckets: transferOptions.transferTypes.includes("buckets"),
         transferFunctions: transferOptions.transferTypes.includes("functions"),
@@ -2313,6 +2315,9 @@ export class InteractiveCLI {
           MessageFormatter.info("Users with preserved password hashes can log in with their original passwords", { prefix: "Transfer" });
           MessageFormatter.info("Users with temporary passwords will need to reset their passwords", { prefix: "Transfer" });
         }
+        if (transferOptions.transferTypes.includes("teams") && results.teams.transferred > 0) {
+          MessageFormatter.info("Team memberships have been transferred and may require user acceptance of invitations", { prefix: "Transfer" });
+        }
       }
 
     } catch (error) {

package/src/migrations/comprehensiveTransfer.ts

@@ -5,6 +5,7 @@ import {
   Storage,
   Users,
   Functions,
+  Teams,
   type Models,
   Query,
 } from "node-appwrite";
@@ -36,6 +37,7 @@ export interface ComprehensiveTransferOptions {
   targetProject: string;
   targetKey: string;
   transferUsers?: boolean;
+  transferTeams?: boolean;
   transferDatabases?: boolean;
   transferBuckets?: boolean;
   transferFunctions?: boolean;
@@ -45,6 +47,7 @@ export interface ComprehensiveTransferOptions {
 
 export interface TransferResults {
   users: { transferred: number; skipped: number; failed: number };
+  teams: { transferred: number; skipped: number; failed: number };
   databases: { transferred: number; skipped: number; failed: number };
   buckets: { transferred: number; skipped: number; failed: number };
   functions: { transferred: number; skipped: number; failed: number };
@@ -56,6 +59,8 @@ export class ComprehensiveTransfer {
   private targetClient: Client;
   private sourceUsers: Users;
   private targetUsers: Users;
+  private sourceTeams: Teams;
+  private targetTeams: Teams;
   private sourceDatabases: Databases;
   private targetDatabases: Databases;
   private sourceStorage: Storage;
@@ -84,6 +89,8 @@ export class ComprehensiveTransfer {
 
     this.sourceUsers = new Users(this.sourceClient);
     this.targetUsers = new Users(this.targetClient);
+    this.sourceTeams = new Teams(this.sourceClient);
+    this.targetTeams = new Teams(this.targetClient);
     this.sourceDatabases = new Databases(this.sourceClient);
     this.targetDatabases = new Databases(this.targetClient);
     this.sourceStorage = new Storage(this.sourceClient);
@@ -101,6 +108,7 @@ export class ComprehensiveTransfer {
     this.fileLimit = pLimit(Math.max(1, Math.floor(baseLimit / 4)));
     this.results = {
       users: { transferred: 0, skipped: 0, failed: 0 },
+      teams: { transferred: 0, skipped: 0, failed: 0 },
       databases: { transferred: 0, skipped: 0, failed: 0 },
       buckets: { transferred: 0, skipped: 0, failed: 0 },
       functions: { transferred: 0, skipped: 0, failed: 0 },
@@ -135,6 +143,10 @@ export class ComprehensiveTransfer {
         await this.transferAllUsers();
       }
 
+      if (this.options.transferTeams !== false) {
+        await this.transferAllTeams();
+      }
+
       if (this.options.transferDatabases !== false) {
         await this.transferAllDatabases();
       }
@@ -193,6 +205,80 @@ export class ComprehensiveTransfer {
     }
   }
 
+  private async transferAllTeams(): Promise<void> {
+    MessageFormatter.info("Starting team transfer phase", { prefix: "Transfer" });
+
+    try {
+      // Fetch all teams from source with pagination
+      const allSourceTeams = await this.fetchAllTeams(this.sourceTeams);
+      const allTargetTeams = await this.fetchAllTeams(this.targetTeams);
+
+      if (this.options.dryRun) {
+        let totalMemberships = 0;
+        for (const team of allSourceTeams) {
+          const memberships = await this.sourceTeams.listMemberships(team.$id, [Query.limit(1)]);
+          totalMemberships += memberships.total;
+        }
+        MessageFormatter.info(`DRY RUN: Would transfer ${allSourceTeams.length} teams with ${totalMemberships} memberships`, { prefix: "Transfer" });
+        return;
+      }
+
+      const transferTasks = allSourceTeams.map(team => 
+        this.limit(async () => {
+          try {
+            // Check if team exists in target
+            const existingTeam = allTargetTeams.find(tt => tt.$id === team.$id);
+            
+            if (!existingTeam) {
+              // Fetch all memberships to extract unique roles before creating team
+              MessageFormatter.info(`Fetching memberships for team ${team.name} to extract roles`, { prefix: "Transfer" });
+              const memberships = await this.fetchAllMemberships(team.$id);
+              
+              // Extract unique roles from all memberships
+              const allRoles = new Set<string>();
+              memberships.forEach(membership => {
+                membership.roles.forEach(role => allRoles.add(role));
+              });
+              const uniqueRoles = Array.from(allRoles);
+              
+              MessageFormatter.info(`Found ${uniqueRoles.length} unique roles for team ${team.name}: ${uniqueRoles.join(', ')}`, { prefix: "Transfer" });
+              
+              // Create team in target with the collected roles
+              await this.targetTeams.create(
+                team.$id,
+                team.name,
+                uniqueRoles
+              );
+              MessageFormatter.success(`Created team: ${team.name} with roles: ${uniqueRoles.join(', ')}`, { prefix: "Transfer" });
+            } else {
+              MessageFormatter.info(`Team ${team.name} already exists, updating if needed`, { prefix: "Transfer" });
+              
+              // Update team if needed
+              if (existingTeam.name !== team.name) {
+                await this.targetTeams.updateName(team.$id, team.name);
+                MessageFormatter.success(`Updated team name: ${team.name}`, { prefix: "Transfer" });
+              }
+            }
+
+            // Transfer team memberships
+            await this.transferTeamMemberships(team.$id);
+
+            this.results.teams.transferred++;
+            MessageFormatter.success(`Team ${team.name} transferred successfully`, { prefix: "Transfer" });
+          } catch (error) {
+            MessageFormatter.error(`Team ${team.name} transfer failed`, error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+            this.results.teams.failed++;
+          }
+        })
+      );
+
+      await Promise.all(transferTasks);
+      MessageFormatter.success("Team transfer phase completed", { prefix: "Transfer" });
+    } catch (error) {
+      MessageFormatter.error("Team transfer phase failed", error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+    }
+  }
+
   private async transferAllDatabases(): Promise<void> {
     MessageFormatter.info("Starting database transfer phase", { prefix: "Transfer" });
 
@@ -987,18 +1073,151 @@ export class ComprehensiveTransfer {
     MessageFormatter.info(`Transferred ${totalTransferred} documents from ${sourceCollectionId} to ${targetCollectionId}`, { prefix: "Transfer" });
   }
 
+  /**
+   * Helper method to fetch all teams with pagination
+   */
+  private async fetchAllTeams(teams: Teams): Promise<Models.Team<Models.Preferences>[]> {
+    const teamsList: Models.Team<Models.Preferences>[] = [];
+    let lastId: string | undefined;
+
+    while (true) {
+      const queries = [Query.limit(100)];
+      if (lastId) {
+        queries.push(Query.cursorAfter(lastId));
+      }
+
+      const result = await tryAwaitWithRetry(async () => teams.list(queries));
+      
+      if (result.teams.length === 0) {
+        break;
+      }
+
+      teamsList.push(...result.teams);
+      
+      if (result.teams.length < 100) {
+        break;
+      }
+      
+      lastId = result.teams[result.teams.length - 1].$id;
+    }
+
+    return teamsList;
+  }
+
+  /**
+   * Helper method to fetch all memberships for a team with pagination
+   */
+  private async fetchAllMemberships(teamId: string): Promise<Models.Membership[]> {
+    const membershipsList: Models.Membership[] = [];
+    let lastId: string | undefined;
+
+    while (true) {
+      const queries = [Query.limit(100)];
+      if (lastId) {
+        queries.push(Query.cursorAfter(lastId));
+      }
+
+      const result = await tryAwaitWithRetry(async () => 
+        this.sourceTeams.listMemberships(teamId, queries)
+      );
+      
+      if (result.memberships.length === 0) {
+        break;
+      }
+
+      membershipsList.push(...result.memberships);
+      
+      if (result.memberships.length < 100) {
+        break;
+      }
+      
+      lastId = result.memberships[result.memberships.length - 1].$id;
+    }
+
+    return membershipsList;
+  }
+
+  /**
+   * Helper method to transfer team memberships
+   */
+  private async transferTeamMemberships(teamId: string): Promise<void> {
+    MessageFormatter.info(`Transferring memberships for team ${teamId}`, { prefix: "Transfer" });
+
+    try {
+      // Fetch all memberships for this team
+      const memberships = await this.fetchAllMemberships(teamId);
+      
+      if (memberships.length === 0) {
+        MessageFormatter.info(`No memberships found for team ${teamId}`, { prefix: "Transfer" });
+        return;
+      }
+
+      MessageFormatter.info(`Found ${memberships.length} memberships for team ${teamId}`, { prefix: "Transfer" });
+
+      let totalTransferred = 0;
+
+      // Transfer memberships with rate limiting
+      const transferTasks = memberships.map(membership => 
+        this.userLimit(async () => { // Use userLimit for team operations (more sensitive)
+          try {
+            // Check if membership already exists
+            try {
+              await this.targetTeams.getMembership(teamId, membership.$id);
+              MessageFormatter.info(`Membership ${membership.$id} already exists, skipping`, { prefix: "Transfer" });
+              return;
+            } catch (error) {
+              // Membership doesn't exist, proceed with creation
+            }
+
+            // Get user data from target (users should already be transferred)
+            let userData: Models.User<Record<string, any>> | null = null;
+            try {
+              userData = await this.targetUsers.get(membership.userId);
+            } catch (error) {
+              MessageFormatter.warning(`User ${membership.userId} not found in target, membership ${membership.$id} may fail`, { prefix: "Transfer" });
+            }
+
+            // Create membership using the comprehensive user data
+            await tryAwaitWithRetry(async () =>
+              this.targetTeams.createMembership(
+                teamId,
+                membership.roles,
+                userData?.email || membership.userEmail, // Use target user email if available, fallback to membership email
+                membership.userId, // User ID
+                userData?.phone || undefined, // Use target user phone if available
+                undefined, // Invitation URL placeholder
+                userData?.name || membership.userName // Use target user name if available, fallback to membership name
+              )
+            );
+
+            totalTransferred++;
+            MessageFormatter.success(`Transferred membership ${membership.$id} for user ${userData?.name || membership.userName}`, { prefix: "Transfer" });
+          } catch (error) {
+            MessageFormatter.error(`Failed to transfer membership ${membership.$id}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+          }
+        })
+      );
+
+      await Promise.all(transferTasks);
+      MessageFormatter.info(`Transferred ${totalTransferred} memberships for team ${teamId}`, { prefix: "Transfer" });
+    } catch (error) {
+      MessageFormatter.error(`Failed to transfer memberships for team ${teamId}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Transfer" });
+    }
+  }
+
   private printSummary(): void {
     const duration = Math.round((Date.now() - this.startTime) / 1000);
     
     MessageFormatter.info("=== COMPREHENSIVE TRANSFER SUMMARY ===", { prefix: "Transfer" });
     MessageFormatter.info(`Total Time: ${duration}s`, { prefix: "Transfer" });
     MessageFormatter.info(`Users: ${this.results.users.transferred} transferred, ${this.results.users.skipped} skipped, ${this.results.users.failed} failed`, { prefix: "Transfer" });
+    MessageFormatter.info(`Teams: ${this.results.teams.transferred} transferred, ${this.results.teams.skipped} skipped, ${this.results.teams.failed} failed`, { prefix: "Transfer" });
     MessageFormatter.info(`Databases: ${this.results.databases.transferred} transferred, ${this.results.databases.skipped} skipped, ${this.results.databases.failed} failed`, { prefix: "Transfer" });
     MessageFormatter.info(`Buckets: ${this.results.buckets.transferred} transferred, ${this.results.buckets.skipped} skipped, ${this.results.buckets.failed} failed`, { prefix: "Transfer" });
     MessageFormatter.info(`Functions: ${this.results.functions.transferred} transferred, ${this.results.functions.skipped} skipped, ${this.results.functions.failed} failed`, { prefix: "Transfer" });
     
-    const totalTransferred = this.results.users.transferred + this.results.databases.transferred + this.results.buckets.transferred + this.results.functions.transferred;
-    const totalFailed = this.results.users.failed + this.results.databases.failed + this.results.buckets.failed + this.results.functions.failed;
+    const totalTransferred = this.results.users.transferred + this.results.teams.transferred + this.results.databases.transferred + this.results.buckets.transferred + this.results.functions.transferred;
+    const totalFailed = this.results.users.failed + this.results.teams.failed + this.results.databases.failed + this.results.buckets.failed + this.results.functions.failed;
     
     if (totalFailed === 0) {
       MessageFormatter.success(`All ${totalTransferred} items transferred successfully!`, { prefix: "Transfer" });