npm क्या है और package.json तथा lockfile क्या करते हैं?

Question

Accepted Answer

**npm** (Node Package Manager) Node का डिफ़ॉल्ट टूल है जो third-party packages (dependencies) को install और manage करने और project scripts को चलाने के लिए है। दो फ़ाइलें एक project को परिभाषित करती हैं: **`package.json`** (manifest) और **`package-lock.json`** (exact 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 को record करता है। `^4.18.0` एक **semver range** है — `^` compatible minor/patch updates की अनुमति देता है (4.x.x लेकिन 5.0.0 नहीं)।

## lockfile — exact, 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 हर package (transitive dependencies सहित) के **precise** version को pin करता है जो install किया गया था। यह guarantee देता है कि team में सभी लोग — और CI, और production — को *identical* dependency tree मिलता है, जो version drift से "works on my machine" bugs को रोकता है।

## Key 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 से strictly install करता है इसे modify किए बिना — CI/production reproducibility के लिए सही command है।

## lockfile को commit करें

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

## यह क्यों महत्वपूर्ण है

npm और ये दोनों फ़ाइलें हर Node project की foundation हैं।

`package.json` को समझना (dependencies vs devDependencies, semver ranges, scripts) और खासकर **lockfile क्यों exist करता है** (deterministic, reproducible installs of entire dependency tree) essential है — lockfile को commit करना और CI में `npm ci` का use करना subtle, hard-to-debug failures को रोकता है जो teammates या production को different package versions से हो सकती हैं।