|
|
""" |
|
|
👤 Outils de gestion du compte utilisateur et des équipes Figma |
|
|
""" |
|
|
import json |
|
|
from .config import figma_config, make_figma_request |
|
|
|
|
|
def get_figma_user_detailed_info() -> str: |
|
|
""" |
|
|
Récupère les informations détaillées de l'utilisateur connecté avec plus de données. |
|
|
|
|
|
Returns: |
|
|
str: Informations détaillées utilisateur au format JSON ou message d'erreur |
|
|
""" |
|
|
result = make_figma_request("me") |
|
|
|
|
|
if "error" in result: |
|
|
return f"❌ Erreur : {result['error']}" |
|
|
|
|
|
user_info = { |
|
|
"id": result.get("id", ""), |
|
|
"nom_utilisateur": result.get("handle", ""), |
|
|
"email": result.get("email", ""), |
|
|
"nom_affichage": result.get("img_url", "").split("/")[-1] if result.get("img_url") else "", |
|
|
"url_image": result.get("img_url", ""), |
|
|
"date_creation": result.get("created_at", ""), |
|
|
"derniere_connexion": result.get("last_activity_at", ""), |
|
|
"plan_actuel": "Non spécifié (utiliser get_figma_team_info pour plus de détails)" |
|
|
} |
|
|
|
|
|
return f"👤 **Informations détaillées utilisateur :**\n{json.dumps(user_info, indent=2, ensure_ascii=False)}" |
|
|
|
|
|
def get_figma_team_info(team_id: str = "") -> str: |
|
|
""" |
|
|
Récupère les informations détaillées d'une équipe Figma incluant le plan d'abonnement. |
|
|
|
|
|
Args: |
|
|
team_id (str): ID de l'équipe Figma (optionnel, utilise la configuration par défaut si vide) |
|
|
|
|
|
Returns: |
|
|
str: Informations équipe au format JSON ou message d'erreur |
|
|
""" |
|
|
team_id = team_id or figma_config.get("team_id", "") |
|
|
|
|
|
if not team_id: |
|
|
return "❌ ID de l'équipe requis. Utilisez d'abord list_figma_user_teams() pour trouver votre équipe." |
|
|
|
|
|
result = make_figma_request(f"teams/{team_id}") |
|
|
|
|
|
if "error" in result: |
|
|
return f"❌ Erreur : {result['error']}" |
|
|
|
|
|
team_info = { |
|
|
"id": result.get("id", ""), |
|
|
"nom": result.get("name", ""), |
|
|
"plan_abonnement": result.get("billing_plan", "Inconnu"), |
|
|
"limite_editeurs": result.get("editor_limit", "Non spécifié"), |
|
|
"editeurs_actifs": result.get("active_editors", 0), |
|
|
"stockage_utilise": result.get("storage_used", "Non spécifié"), |
|
|
"limite_stockage": result.get("storage_limit", "Non spécifié"), |
|
|
"fonctionnalites": result.get("features", []), |
|
|
"date_creation": result.get("created_at", ""), |
|
|
"statut": result.get("status", "") |
|
|
} |
|
|
|
|
|
return f"🏢 **Informations équipe :**\n{json.dumps(team_info, indent=2, ensure_ascii=False)}" |
|
|
|
|
|
def list_figma_user_teams() -> str: |
|
|
""" |
|
|
Liste toutes les équipes auxquelles l'utilisateur appartient. |
|
|
|
|
|
Returns: |
|
|
str: Liste des équipes avec rôles et plans ou message d'erreur |
|
|
""" |
|
|
result = make_figma_request("teams") |
|
|
|
|
|
if "error" in result: |
|
|
return f"❌ Erreur : {result['error']}" |
|
|
|
|
|
teams = result.get("teams", []) |
|
|
|
|
|
if not teams: |
|
|
return "🏢 Aucune équipe trouvée pour cet utilisateur" |
|
|
|
|
|
team_list = [] |
|
|
for team in teams: |
|
|
team_id = team.get("id", "") |
|
|
name = team.get("name", "Sans nom") |
|
|
role = team.get("role", "Membre") |
|
|
plan = team.get("billing_plan", "Plan inconnu") |
|
|
team_list.append(f"🏢 **{name}** (ID: {team_id})\n - Rôle: {role}\n - Plan: {plan}") |
|
|
|
|
|
return f"🏢 **Équipes de l'utilisateur :**\n\n" + "\n\n".join(team_list) |
|
|
|
|
|
def get_figma_current_user_permissions() -> str: |
|
|
""" |
|
|
Récupère les permissions et capacités de l'utilisateur actuel dans un fichier. |
|
|
|
|
|
Returns: |
|
|
str: Code JavaScript pour récupérer les permissions ou message d'erreur |
|
|
""" |
|
|
if not figma_config["file_id"]: |
|
|
return "❌ ID du fichier requis. Utilisez configure_figma_file_id() d'abord." |
|
|
|
|
|
comment_text = f"""👥 **Informations utilisateur actuel (Plugin API) :** |
|
|
|
|
|
📋 **Code Plugin Figma pour récupérer les infos utilisateur :** |
|
|
```javascript |
|
|
// Informations utilisateur actuel |
|
|
const currentUser = figma.currentUser |
|
|
if (currentUser) {{ |
|
|
console.log('Utilisateur:', {{ |
|
|
id: currentUser.id, |
|
|
nom: currentUser.name, |
|
|
email: currentUser.email || 'Non disponible', |
|
|
couleur: currentUser.color, |
|
|
sessionId: currentUser.sessionId, |
|
|
photoUrl: currentUser.photoUrl || 'Pas de photo' |
|
|
}}) |
|
|
}} else {{ |
|
|
console.log('Aucun utilisateur connecté') |
|
|
}} |
|
|
|
|
|
// Type d'éditeur actuel |
|
|
console.log('Type éditeur:', figma.editorType) // 'figma' | 'figjam' | 'dev' | 'slides' |
|
|
|
|
|
// Mode du plugin |
|
|
console.log('Mode plugin:', figma.mode) // 'default' | 'textreview' | 'inspect' | etc. |
|
|
|
|
|
// Utilisateurs actifs (FigJam uniquement) |
|
|
if (figma.editorType === 'figjam' && figma.activeUsers) {{ |
|
|
console.log('Utilisateurs actifs:', figma.activeUsers.map(user => ({{ |
|
|
id: user.id, |
|
|
nom: user.name, |
|
|
couleur: user.color, |
|
|
sessionId: user.sessionId |
|
|
}}))) |
|
|
}} |
|
|
|
|
|
// Clé du fichier (plugins privés uniquement) |
|
|
if (figma.fileKey) {{ |
|
|
console.log('Clé fichier:', figma.fileKey) |
|
|
}} |
|
|
```""" |
|
|
|
|
|
comment_data = { |
|
|
"message": comment_text, |
|
|
"client_meta": {"x": 0, "y": 0} |
|
|
} |
|
|
|
|
|
result = make_figma_request(f"files/{figma_config['file_id']}/comments", "POST", comment_data) |
|
|
|
|
|
if "error" in result: |
|
|
return f"❌ Erreur lors de la création du commentaire : {result['error']}" |
|
|
|
|
|
return f"✅ Code généré pour récupérer les permissions et infos utilisateur" |
|
|
|
|
|
def get_figma_workspace_usage_stats() -> str: |
|
|
""" |
|
|
Récupère les statistiques d'utilisation de l'espace de travail. |
|
|
|
|
|
Returns: |
|
|
str: Statistiques d'utilisation au format JSON ou message d'erreur |
|
|
""" |
|
|
if not figma_config.get("team_id"): |
|
|
return "❌ ID de l'équipe requis. Utilisez list_figma_user_teams() pour trouver votre équipe puis configurez figma_config['team_id']" |
|
|
|
|
|
|
|
|
projects_result = make_figma_request(f"teams/{figma_config['team_id']}/projects") |
|
|
|
|
|
if "error" in projects_result: |
|
|
return f"❌ Erreur : {projects_result['error']}" |
|
|
|
|
|
projects = projects_result.get("projects", []) |
|
|
|
|
|
stats = { |
|
|
"nombre_projets": len(projects), |
|
|
"projets_recents": [], |
|
|
"statistiques_utilisation": "Disponible via l'API Team (nécessite permissions admin)" |
|
|
} |
|
|
|
|
|
|
|
|
for project in projects[:5]: |
|
|
stats["projets_recents"].append({ |
|
|
"nom": project.get("name", ""), |
|
|
"id": project.get("id", ""), |
|
|
"derniere_modification": project.get("modified_at", "") |
|
|
}) |
|
|
|
|
|
return f"📊 **Statistiques d'utilisation :**\n{json.dumps(stats, indent=2, ensure_ascii=False)}" |
|
|
|
|
|
def get_figma_api_limitations_info() -> str: |
|
|
""" |
|
|
Explique les limitations de l'API Plugin Figma vs l'API REST pour la gestion des projets. |
|
|
|
|
|
Returns: |
|
|
str: Documentation détaillée des limitations et capacités des APIs Figma |
|
|
""" |
|
|
|
|
|
limitations_info = { |
|
|
"api_plugin_limitations": { |
|
|
"titre": "🚫 Limitations de l'API Plugin Figma", |
|
|
"description": "L'API Plugin Figma ne peut PAS :", |
|
|
"limitations": [ |
|
|
"Lister tous les projets d'un utilisateur", |
|
|
"Naviguer entre différents fichiers Figma", |
|
|
"Accéder aux informations de facturation/abonnement", |
|
|
"Créer ou supprimer des projets", |
|
|
"Gérer les permissions d'équipe" |
|
|
], |
|
|
"contexte": "Le plugin s'exécute uniquement dans le contexte du fichier actuel" |
|
|
}, |
|
|
"api_rest_capacites": { |
|
|
"titre": "✅ Capacités de l'API REST Figma", |
|
|
"description": "L'API REST Figma peut :", |
|
|
"capacites": [ |
|
|
"Lister les équipes de l'utilisateur", |
|
|
"Lister les projets d'une équipe", |
|
|
"Lister les fichiers d'un projet", |
|
|
"Accéder aux informations de profil utilisateur", |
|
|
"Récupérer les commentaires des fichiers", |
|
|
"Exporter des assets (avec limitations)" |
|
|
], |
|
|
"note": "Nécessite un token d'accès personnel" |
|
|
}, |
|
|
"recommendation": { |
|
|
"titre": "💡 Approche hybride recommandée", |
|
|
"description": "Utiliser les deux APIs en complémentarité :", |
|
|
"strategies": [ |
|
|
"API REST : Navigation, gestion des projets, informations utilisateur", |
|
|
"API Plugin : Création/modification d'éléments dans le fichier actuel", |
|
|
"Plugin avec code JavaScript : Manipulation avancée des objets" |
|
|
] |
|
|
}, |
|
|
"workarounds": { |
|
|
"titre": "🔧 Solutions de contournement", |
|
|
"alternatives": [ |
|
|
"Utiliser l'API REST pour lister les projets (comme nous faisons)", |
|
|
"Stocker les IDs de fichiers dans le clientStorage du plugin", |
|
|
"Utiliser des plugins privés pour accéder à figma.fileKey", |
|
|
"Implémenter un système de cache des informations projets" |
|
|
] |
|
|
} |
|
|
} |
|
|
|
|
|
return f"📚 **Limitations et capacités des APIs Figma :**\n{json.dumps(limitations_info, indent=2, ensure_ascii=False)}" |
|
|
|
|
|
def list_figma_team_projects(team_id: str = "") -> str: |
|
|
""" |
|
|
Liste les projets d'une équipe Figma. |
|
|
|
|
|
Args: |
|
|
team_id (str): ID de l'équipe Figma (optionnel, utilise la configuration par défaut si vide) |
|
|
|
|
|
Returns: |
|
|
str: Liste des projets de l'équipe ou message d'erreur |
|
|
""" |
|
|
team_id = team_id or figma_config["team_id"] |
|
|
|
|
|
if not team_id: |
|
|
return "❌ ID de l'équipe requis. Configurez-le avec figma_config['team_id'] = 'VOTRE_TEAM_ID'" |
|
|
|
|
|
result = make_figma_request(f"teams/{team_id}/projects") |
|
|
|
|
|
if "error" in result: |
|
|
return f"❌ Erreur : {result['error']}" |
|
|
|
|
|
projects = result.get("projects", []) |
|
|
|
|
|
if not projects: |
|
|
return "📁 Aucun projet trouvé dans cette équipe" |
|
|
|
|
|
project_list = [] |
|
|
for project in projects[:10]: |
|
|
name = project.get("name", "Sans nom") |
|
|
project_id = project.get("id", "") |
|
|
project_list.append(f"📁 {name} (ID: {project_id})") |
|
|
|
|
|
return f"📁 **Projets de l'équipe :**\n" + "\n".join(project_list) |
