npm ਕੀ ਹੈ ਅਤੇ package.json ਅਤੇ lockfile ਕੀ ਕਰਦੇ ਹਨ?

Question

Accepted Answer

**npm** (Node Package Manager) Node ਦਾ ਡਿਫਾਲਟ ਟੂਲ ਹੈ ਤੀਜੀ-ਪੱਖ ਪੈਕੇਜਾਂ (dependencies) ਨੂੰ ਸਥਾਪਿਤ ਅਤੇ ਪ੍ਰਬੰਧਿਤ ਕਰਨ ਅਤੇ ਪ੍ਰੋਜੈਕਟ ਸਕ੍ਰਿਪਟਾਂ ਨੂੰ ਚਲਾਉਣ ਲਈ। ਦੋ ਫਾਈਲਾਂ ਇੱਕ ਪ੍ਰੋਜੈਕਟ ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੀਆਂ ਹਨ: **`package.json`** (manifest) ਅਤੇ **`package-lock.json`** (ਸਹੀ dependency ਰੁੱਖ)।

## package.json — ਪ੍ਰੋਜੈਕਟ 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, ਸਕ੍ਰਿਪਟਾਂ ਅਤੇ dependencies ਨੂੰ ਰਿਕਾਰਡ ਕਰਦਾ ਹੈ। `^4.18.0` ਇੱਕ **semver ਰੇਂਜ** ਹੈ — `^` ਅਨੁਕੂਲ minor/patch ਅੱਪਡੇਟਾਂ ਦੀ ਆਗਿਆ ਦਿੰਦਾ ਹੈ (4.x.x ਪਰ 5.0.0 ਨਹੀਂ)।

## Lockfile — ਸਹੀ, ਦੁਬਾਰਾ ਪੈਦਾ ਕੀਤੇ ਜਾ ਸਕਣ ਵਾਲੀ ਸਥਾਪਨਾ

```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 ਹਰੇਕ ਪੈਕੇਜ ਦੇ (transitive dependencies ਸਮੇਤ) **ਸਹੀ** ਸੰਸਕਰਣ ਨੂੰ ਇਤਬਾਰ ਕਰਦਾ ਹੈ ਜੋ ਸਥਾਪਿਤ ਕੀਤਾ ਗਿਆ ਸੀ। ਇਹ ਗ੍ਰੇਰੰਟੀ ਦਿੰਦਾ ਹੈ ਕਿ ਪੂਰੀ ਟੀਮ — ਅਤੇ CI, ਅਤੇ ਉਤਪਾਦਨ — *ਇੱਕੋ ਜਿਹਾ* dependency ਰੁੱਖ ਪ੍ਰਾਪਤ ਕਰਦੇ ਹਨ, ਸੰਸਕਰਣ drift ਤੋਂ "ਮੇਰੀ ਮਸ਼ੀਨ ਉੱਤੇ ਕੰਮ ਕਰਦਾ ਹੈ" bugs ਨੂੰ ਰੋਕਦੇ ਹਨ।

## ਮੁੱਖ ਕਮਾਂਡਾਂ

```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 ਤੋਂ ਸਖ਼ਤੀ ਨਾਲ ਸਥਾਪਿਤ ਕਰਦਾ ਹੈ ਇਸ ਨੂੰ ਸੋਧੇ ਬਿਨਾ — CI/ਉਤਪਾਦਨ ਦੁਬਾਰਾ ਪੈਦਾ ਕਰਨਯੋਗਤਾ ਲਈ ਸਹੀ ਕਮਾਂਡ।

## Lockfile ਨੂੰ ਆਮ ਕਰੋ

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

## ਇਹ ਕਿਉਂ ਮਾਇਨੇ ਰੱਖਦਾ ਹੈ

npm ਅਤੇ ਇਹ ਦੋ ਫਾਈਲਾਂ ਹਰ Node ਪ੍ਰੋਜੈਕਟ ਦੀ ਬੁਨਿਆਦ ਹਨ।

`package.json` (dependencies vs devDependencies, semver ਰੇਂਜਾਂ, ਸਕ੍ਰਿਪਟਾਂ) ਨੂੰ ਸਮਝਣਾ ਅਤੇ ਖ਼ਾਸ ਕਰਕੇ **lockfile ਕਿਉਂ ਮੌਜੂਦ ਹੈ** (ਪੂਰੀ dependency ਰੁੱਖ ਦੀ ਨਿਰਧਾਰਕ, ਦੁਬਾਰਾ ਪੈਦਾ ਕੀਤੀ ਜਾ ਸਕਣ ਵਾਲੀ ਸਥਾਪਨਾ) ਸਾਹਮਣੇ ਹੈ — lockfile ਨੂੰ commit ਕਰਨਾ ਅਤੇ CI ਵਿੱਚ `npm ci` ਦੀ ਵਰਤੋਂ ਕਰਨਾ ਸੂਖਮ, ਮੁਸ਼ਕਲ-ਤੋਂ-debug ਅਸਫਲਤਾਵਾਂ ਨੂੰ ਰੋਕਦਾ ਹੈ ਜੋ ਟੀਮ ਮਿਤਰਾਂ ਜਾਂ ਉਤਪਾਦਨ ਨੂੰ ਵੱਖ-ਵੱਖ ਪੈਕੇਜ ਸੰਸਕਰਣ ਪ੍ਰਾਪਤ ਕਰਨ ਕਾਰਨ ਹੁੰਦੀਆਂ ਹਨ।