Aller au contenu
Vérifié

Gestion des versions

La version d'un plugin est une simple comparaison de chaînes entre le document de catalogue et ce qu'un projet a installé, il n'y a aucune correspondance de plage semver.

La version d'un plugin vit à deux endroits : doc.version dans le document de catalogue (la dernière version envoyée), et app_plugins_purchased[plugin_name].version dans chaque projet qui l'a installé (la version que ce projet possède réellement). Rien ne les synchronise automatiquement.

D'où vient la version

upload_plugin définit doc.version différemment selon l'endroit où se trouve le paquet :

  • Source de paquet npm : lue directement sur le registre avec getPackageManifest(plugin_name), c'est donc ce que npm version a produit la dernière fois que l'auteur a lancé npm publish. Le package.json de chaque plugin de première partie a un script pub pour cela : npm version patch --force && npm publish --access public.
  • Source de paquet xuda_hosted (aucun npm publish n'intervient, la copie de travail est empaquetée et hébergée par la plateforme elle-même) : doc.version est ce qui a été envoyé dans la requête, ou 0.1.0 si rien n'a été envoyé.

install_plugin copie doc.version dans l'entrée app_plugins_purchased du projet au moment de l'installation. Un upload_plugin ultérieur qui incrémente la version du document de catalogue ne touche pas les projets qui ont déjà installé une version antérieure : ils gardent la version qu'ils ont installée jusqu'à ce que quelque chose installe la nouvelle par-dessus.

Comment une installation périmée est signalée

Il n'y a aucune mise à jour automatique. Ce qui existe est une comparaison visuelle : le badge de version de la carte du plugin compare app_plugins_purchased[plugin_name].version (ce qui est installé) à la version du document de catalogue (la dernière), en affichant le numéro installé en vert quand ils correspondent et en orange quand ils diffèrent. Rien ne force la réinstallation : c'est un propriétaire (ou un installateur) qui relance install_plugin sur le même projet qui fait venir la version plus récente, le même appel que pour une première installation.

Mettre à jour un plugin dont vous êtes propriétaire

Le bouton Mettre à jour avec l'IA du tableau de bord, affiché sur la carte d'un plugin à son propriétaire, n'incrémente pas lui-même la version. Il ouvre l'assistant Demander à l'IA prérempli avec metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } et une invite nommant le plugin (updateWithAi() dans Tab_plugins.vue), ce qui pilote le générateur de plugins IA (ai_module.create_plugin_via_ai, le même générateur qu'appelle directement utils/create_plugin_via_ai.mjs) pour modifier le code du plugin et le renvoyer ; c'est cet envoi qui fait avancer doc.version.

Une mise à jour de code ou npm ne repasse jamais en revue

upload_plugin traite toute mise à jour où visibility vaut déjà 'private', ou où skip_publish_review est défini, comme un changement de code privé : il reporte tel quel les visibility et publish_stat existants du plugin au lieu de le soumettre à nouveau à la revue de la place de marché. Passer de privé à public se fait uniquement par publish_plugin, une action distincte et explicite ; voir la publication.