npm কী এবং package.json এবং lockfile কী করে?

Question

Accepted Answer

**npm** (Node Package Manager) হল Node-এর ডিফল্ট টুল যা তৃতীয় পক্ষের প্যাকেজ (নির্ভরতা) ইনস্টল এবং পরিচালনা করতে এবং প্রকল্পের স্ক্রিপ্ট চালাতে ব্যবহৃত হয়। দুটি ফাইল একটি প্রকল্প সংজ্ঞায়িত করে: **`package.json`** (ম্যানিফেস্ট) এবং **`package-lock.json`** (সঠিক নির্ভরতা গাছ)।

## package.json — প্রকল্প ম্যানিফেস্ট

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

এটি মেটাডেটা, স্ক্রিপ্ট এবং নির্ভরতা রেকর্ড করে। `^4.18.0` হল একটি **semver রেঞ্জ** — `^` সামঞ্জস্যপূর্ণ মাইনর/প্যাচ আপডেটের অনুমতি দেয় (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 নির্ভরতা সহ) যা ইনস্টল করা হয়েছিল তা সংরক্ষণ করে। এটি নিশ্চিত করে যে দলের সবাই — এবং CI, এবং উৎপাদন — একই নির্ভরতা গাছ পায়, সংস্করণ পরিবর্তন থেকে "আমার মেশিনে কাজ করে" বাগ প্রতিরোধ করে।

## মূল আদেশগুলি

```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` বোঝা (নির্ভরতা বনাম devDependencies, semver রেঞ্জ, স্ক্রিপ্ট) এবং বিশেষত **কেন lockfile বিদ্যমান** (সংজ্ঞায়িত, সম্পূর্ণ নির্ভরতা গাছের পুনরাবৃত্তিযোগ্য ইনস্টল) অপরিহার্য — lockfile প্রতিশ্রুতি করা এবং CI-তে `npm ci` ব্যবহার করা সূক্ষ্ম, কঠিন-ডিবাগ ব্যর্থতা প্রতিরোধ করে যা দলের সদস্যদের বা উৎপাদনের বিভিন্ন প্যাকেজ সংস্করণ পাওয়ার কারণে ঘটে।