Versionado
La versión de un plugin es una simple comparación de cadenas entre el documento del catálogo y lo que tiene instalado un proyecto, no hay coincidencia por rangos semver.
La versión de un plugin vive en dos sitios: doc.version en el documento del catálogo (la última versión subida) y app_plugins_purchased[plugin_name].version en cada proyecto que lo instaló (la versión que ese proyecto tiene realmente). Nada las mantiene sincronizadas automáticamente.
De dónde sale la versión
upload_plugin establece doc.version de forma distinta según dónde viva el paquete:
- Origen de paquete
npm: se lee directamente del registro congetPackageManifest(plugin_name), así que es lo que produjonpm versioncuando el autor ejecutónpm publishpor última vez. Elpackage.jsonde cada plugin propio tiene un scriptpubpara esto:npm version patch --force && npm publish --access public. - Origen de paquete
xuda_hosted(sin publicación en npm, la copia de trabajo la empaqueta y aloja la propia plataforma):doc.versiones lo que se envió en la petición, o0.1.0si no se envió nada.
install_plugin copia doc.version a la entrada app_plugins_purchased del proyecto en el momento de instalar. Un upload_plugin posterior que suba la versión del documento del catálogo no toca los proyectos que ya instalaron una anterior: conservan la versión que instalaron hasta que algo instale encima la nueva.
Cómo se señala una instalación obsoleta
No hay actualización automática. Lo que existe es una comparación visual: la insignia de versión de la tarjeta del plugin compara app_plugins_purchased[plugin_name].version (lo instalado) con la version del documento del catálogo (la última), y muestra el número instalado en verde cuando coinciden y en ámbar cuando no. Nada fuerza la reinstalación, lo que trae la versión más nueva es que un propietario (o quien instala) vuelva a ejecutar install_plugin en el mismo proyecto, la misma llamada que se usa en una primera instalación.
Actualizar un plugin que posees
El botón Actualizar con IA del dashboard, que se muestra al propietario en la tarjeta de un plugin, no sube la versión por sí mismo. Abre el asistente Ask AI con metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } precargado y un prompt que nombra el plugin (updateWithAi() en Tab_plugins.vue), lo que activa el constructor de plugins con IA (ai_module.create_plugin_via_ai, el mismo generador al que llama directamente utils/create_plugin_via_ai.mjs) para editar el código del plugin y volver a subirlo; esa subida es lo que hace avanzar doc.version.
upload_plugin trata cualquier actualización en la que visibility ya sea 'private', o en la que esté establecido skip_publish_review, como un cambio de código privado: arrastra sin tocar el visibility y el publish_stat existentes del plugin en lugar de volver a enviarlo a revisión del marketplace. Pasar de privado a público es siempre publish_plugin, una acción aparte y explícita; consulta publicación.