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 avecgetPackageManifest(plugin_name), c'est donc ce quenpm versiona produit la dernière fois que l'auteur a lancénpm publish. Lepackage.jsonde chaque plugin de première partie a un scriptpubpour cela :npm version patch --force && npm publish --access public. - Source de paquet
xuda_hosted(aucunnpm publishn'intervient, la copie de travail est empaquetée et hébergée par la plateforme elle-même) :doc.versionest ce qui a été envoyé dans la requête, ou0.1.0si 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.
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.