Saltar al contenido
Verificada

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 con getPackageManifest(plugin_name), así que es lo que produjo npm version cuando el autor ejecutó npm publish por última vez. El package.json de cada plugin propio tiene un script pub para 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.version es lo que se envió en la petición, o 0.1.0 si 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.

Una actualización de código o npm nunca vuelve a entrar en revisión

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.