npm (Node Package Manager) hija l-għodda default ta' Node għall-installazzjoni u ġestjoni tal-pakkeġġi ta' partiti terzi (dipendenzi) u għall-ġirja tal-skritti tal-proġett. Żewġ fajls jiddefinixxu proġett: package.json (il-manifest) u package-lock.json (l-ihtar preċiż ta' l-arbolessenza tad-dipendenza).
{
"name": "my-app",
"version": "1.0.0",
"type": "module",
"scripts": {
"start": "node server.js",
"dev": "nodemon server.js",
"test": "vitest"
},
"dependencies": { // needed at RUNTIME
"express": "^4.18.0"
},
"devDependencies": { // needed only for DEVELOPMENT (testing, building)
"vitest": "^1.0.0"
}
}
Irreġistra metadati, skritti, u dipendenze. ^4.18.0 huwa firxa semver — ^ jippermetti l-aġornamenti minor/patch kompatibli (4.x.x iżda mhux 5.0.0).
package.json says: express ^4.18.0 (a RANGE — could install 4.18.0 or 4.19.2...)
package-lock.json: express 4.18.2 (the EXACT version + every nested dependency)
Il-lock file jippinn il-verżjoni preċiza ta' kull pakkeġġ (inkluż dipendenzi transittivi) li ġie installat. Dan jiggarantixxi li kulħadd fit-tim — u CI, u produzzjoni — jieħu l-istess siġra ta' dipendenza, u jipprevjeni l-iżbalji "jaħdem fuq il-magna tiegħi" mid-drift tal-verżjoni.
npm install # install all deps from package.json (updates lockfile)
npm install express # add a dependency
npm install -D vitest # add a devDependency
npm ci # install EXACTLY from the lockfile (used in CI — fast, strict)
npm run dev # run a script defined in package.json
npm ci (versus npm install) jinstalla strettament mill-lock file mingħajr ma jmodifikah — il-kmand korrett għar-riproduċibilità CI/produzzjoni.
✓ ALWAYS commit package-lock.json → reproducible installs across the team & CI
npm u dawn iż-żewġ fajls huma l-pedament ta' kull proġett Node.
L-għarfien ta' package.json (dipendenze vs devDependencies, firxiet semver, skritti) u partikolarment għaliex il-lock file jeżisti (installazzjonijiet deterministiċi u riprodubli ta' l-intira siġra ta' dipendenza) huwa essenzjali — il-ħelq ta' impegn fuq il-lock file u l-użu ta' npm ci f'CI jipprevjenu żbalji sottili u diffiċli biex idebugguwa kkawżati mit-timmates jew mill-produzzjoni li jieħdu verżjonijiet differenti tal-pakkeġġ.