npm என்றால் என்ன மற்றும் package.json மற்றும் lockfile எதற்கு உபயோகம்?

Question

Accepted Answer

**npm** (Node Package Manager) என்பது Node-இன் முன்னிருப்பு கருவியாகும், இது மூன்றாம் পক்ष பாக்கேஜ்களை (dependencies) நிறுவுதல் மற்றும் நிர்வகித்தல், மற்றும் project scripts-ஐ இயக்குவதற்குப் பயன்படுகிறது. இரண்டு கோப்புகள் ஒரு project-ஐ வரையறுக்கின்றன: **`package.json`** (manifest) மற்றும் **`package-lock.json`** (சரியான dependency tree).

## package.json — project manifest

```json
{
  "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"
  }
}
```

இது metadata, scripts, மற்றும் dependencies-ஐ பதிவு செய்கிறது. `^4.18.0` என்பது **semver range** ஆகும் — `^` compatible minor/patch updates-ஐ அனுமதிக்கிறது (4.x.x ஆனால் 5.0.0 அல்ல).

## lockfile — சரியான, reproducible installs

```text
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)
```

Lockfile ஒவ்வொரு பாக்கேஜின் **precise** பதிப்பையும் (transitive dependencies உட்பட) pin செய்கிறது, இது install செய்யப்பட்டது. இது குழுவில் உள்ள அனைவருக்கு — மற்றும் CI-க்கு, மற்றும் production-க்கு — *identical* dependency tree-ஐ உறுதிப்படுத்துகிறது, version drift-இலிருந்து "works on my machine" bugs-ஐ தடுக்கிறது.

## முக்கிய commands

```bash
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` (`npm install` க்கு பதிலாக) lockfile-இலிருந்து엄격히install செய்கிறது அதை மாற்றாமல் — CI/production reproducibility-க்கான சரியான command.

## lockfile-ஐ commit செய்யுங்கள்

```text
✓ ALWAYS commit package-lock.json → reproducible installs across the team & CI
```

## இது ஏன் முக்கியம்

npm மற்றும் இந்த இரண்டு கோப்புகள் ஒவ்வொரு Node project-இன் அடிப்படையாகும்.

`package.json`-ஐ புரிந்துகொள்ளுதல் (dependencies vs devDependencies, semver ranges, scripts) மற்றும் சிறப்பாக **lockfile ஏன் உள்ளது** (deterministic, reproducible installs of the entire dependency tree) இது அপরिहार्य ஆகும் — lockfile-ஐ commit செய்வதும் CI-இல் `npm ci`-ஐ பயன்படுத்துவதும் teammates அல்லது production different package versions பெறுவதால் ஏற்படும் subtle, hard-to-debug failures-ஐ தடுக்கிறது.