.jpg)
Hace poco publiqué una pequeña herramienta CLI llamada Repository-Context-Packager en el registro de npm. El proceso de liberación siguió pasos sencillos pero importantes que quiero compartir para que otros equipos, clientes o desarrolladores puedan replicarlo sin sorpresas.
Preparación del paquete: actualicé package.json poniendo la versión a 1.0.0, añadí un array files para controlar qué se publica, configuré el campo bin para el comando CLI y setting engines para definir la versión mínima de Node. También añadí un script prepublishOnly que ejecuta npm test && npm run lint para evitar publicar código roto por error. Creé un archivo .npmignore para excluir tests, workflows de GitHub y documentación de desarrollo, manteniendo el paquete pequeño, alrededor de 27 KB con 11 archivos.
Comprobaciones previas: usé npm pack --dry-run para previsualizar el contenido del paquete. Me aseguré de que los 76 tests pasaran con npm test y verifiqué la calidad del código con npm run lint antes de cada publicación. Después hice commit de package.json y creé una etiqueta git con git tag -a v1.0.0 -m Release v1.0.0, empujé el commit y la etiqueta al remoto y ejecuté npm publish para subir el paquete al registro. Finalmente verifiqué la publicación en la página del paquete en npm y probé la instalación global con npm install -g repository-context-packager.
Lección sobre git tags y versiones de npm: aprendí que las etiquetas de git y la versión que muestra npm son sistemas separados. npm lee la versión desde package.json, no desde las tags. Por eso, si creas una etiqueta antes de actualizar package.json, la versión en npm puede quedar desincronizada. El flujo correcto es actualizar package.json, hacer commit, crear la tag, empujar y después publicar.
Manejo de conflictos al empujar: al intentar push recibí un rechazo porque el remoto tenía commits nuevos. La solución fue git pull --rebase origin main para actualizar mi rama y resolver conflictos localmente. También me vi obligado a borrar una etiqueta creada en el commit equivocado con git tag -d v1.0.0 y git push origin --delete v1.0.0, y luego recrearla sobre el commit correcto.
Buenas prácticas que consolidé: añadir prepublishOnly con npm test && npm run lint evita publicar código roto y es una protección simple pero muy efectiva. Mis cambios fueron mínimos y centrados en el empaquetado: versión en package.json, files, bin, engines, prepublishOnly, keywords para mejorar la visibilidad y .npmignore. Actualicé README.md con instrucciones de instalación por npm y el historial de versiones. El código fuente en src y bin no necesitó cambios.
Experiencia al enseñar el proceso: cuando mi compañera replicó la liberación se atascaron en dos puntos principales. Primero la confusión entre la etiqueta git v1.0.0 y la versión real en npm que seguía siendo 0.9.0 porque package.json no estaba actualizado. Segundo el rechazo al git push por commits remotos. Mostrarles el flujo correcto y el uso de git pull --rebase origin main aclaró la mayoría de dudas. Quedó claro que hace falta mejor documentación que explique la relación entre tags y versiones de paquete.
Uso tras la publicación: una vez publicado, los usuarios pueden instalarlo globalmente con npm install -g repository-context-packager y usar el comando repomaster desde cualquier ubicación. Comandos comunes son repomaster --version para comprobar la versión, repomaster --help para ver opciones, repomaster . para empaquetar el directorio actual y repomaster . -o output.txt para guardar la salida en un fichero.
Sobre nosotros: en Q2BSTUDIO somos una empresa de desarrollo de software que ofrece aplicaciones a medida y software a medida, especialistas en inteligencia artificial, ciberseguridad y servicios cloud aws y azure. Diseñamos soluciones empresariales que integran servicios inteligencia de negocio y power bi, además de crear agentes IA y proyectos de ia para empresas que optimizan procesos y generan valor. Si buscas desarrollo de aplicaciones a medida visita nuestra página de desarrollo de aplicaciones y software multicanal y si te interesa integrar inteligencia artificial en tus proyectos consulta nuestros servicios de inteligencia artificial.
Palabras clave relevantes para posicionamiento: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi.
Si necesitas que documentemos este proceso para tu equipo, o que organicemos una sesión práctica para liberar paquetes npm sin riesgos, en Q2BSTUDIO podemos ayudarte a implantar buenas prácticas de release, integración continua y seguridad en el ciclo de vida del software.
