En aquest tema, aprendrem com crear i publicar paquets a NPM (Node Package Manager). Els paquets són una manera excel·lent de compartir codi reutilitzable amb la comunitat o dins de la teva organització. Aquest procés inclou la creació del paquet, la configuració del fitxer package.json, la publicació a NPM i la gestió de versions.

1. Crea una nova carpeta per al teu paquet:

   mkdir my-awesome-package
   cd my-awesome-package
   

2. Inicialitza un nou projecte Node.js:

   npm init
   

   Aquest comandament et guiarà a través d'una sèrie de preguntes per crear el fitxer package.json. Pots acceptar els valors per defecte o personalitzar-los segons les teves necessitats.

Organitza el teu projecte de manera que sigui fàcil de mantenir i utilitzar. Una estructura típica podria ser:

Crea el fitxer principal del teu paquet a lib/index.js:

És important proporcionar una bona documentació perquè altres desenvolupadors puguin entendre com utilitzar el teu paquet. Crea un fitxer README.md a l'arrel del teu projecte:

npm install my-awesome-package

const greet = require('my-awesome-package');

console.log(greet('World')); // Output: Hello, World!

Si encara no tens un compte a NPM, crea'n un a npmjs.com.

Inicia sessió al teu compte de NPM des de la línia de comandaments:

Publica el teu paquet a NPM:

Si tot ha anat bé, el teu paquet estarà disponible a NPM i altres desenvolupadors podran instal·lar-lo utilitzant:

El versionat semàntic (SemVer) és una convenció per versionar paquets que utilitza el format MAJOR.MINOR.PATCH. Aquí tens una breu explicació:

• MAJOR: Canvis incompatibles amb versions anteriors.
• MINOR: Noves funcionalitats que són compatibles amb versions anteriors.
• PATCH: Correccions d'errors que són compatibles amb versions anteriors.

Per actualitzar la versió del teu paquet, pots utilitzar el comandament npm version:

Després d'actualitzar la versió, publica el paquet de nou:

1. Crea un nou paquet que contingui una funció per sumar dos números.
2. Escriu la documentació necessària.
3. Publica el paquet a NPM.

1. Crea la carpeta i inicialitza el projecte:

   mkdir sum-package
   cd sum-package
   npm init -y
   

2. Crea el fitxer lib/index.js:

   // lib/index.js
   function sum(a, b) {
       return a + b;
   }
   
   module.exports = sum;
   

3. Crea el fitxer README.md:

   # Sum Package
   
   A simple package to sum two numbers.
   
   ## Installation
   
   ```bash
   npm install sum-package
   

   Usage

   const sum = require('sum-package');
   
   console.log(sum(2, 3)); // Output: 5
   

4. Publica el paquet:

   npm login
   npm publish
   

1. Afegeix una nova funció per restar dos números al teu paquet.
2. Actualitza la versió del paquet.
3. Publica la nova versió a NPM.

1. Actualitza el fitxer lib/index.js:

   // lib/index.js
   function sum(a, b) {
       return a + b;
   }
   
   function subtract(a, b) {
       return a - b;
   }
   
   module.exports = { sum, subtract };
   

2. Actualitza la documentació a README.md:

   # Sum Package
   
   A simple package to sum and subtract two numbers.
   
   ## Installation
   
   ```bash
   npm install sum-package
   

   Usage

   const { sum, subtract } = require('sum-package');
   
   console.log(sum(2, 3)); // Output: 5
   console.log(subtract(5, 3)); // Output: 2
   

3. Actualitza la versió i publica:

   npm version minor
   npm publish
   

En aquest tema, hem après com crear, documentar i publicar paquets a NPM. També hem vist com gestionar les versions dels nostres paquets utilitzant el versionat semàntic. Aquestes habilitats són essencials per compartir codi reutilitzable i col·laborar amb altres desenvolupadors.