რა არის npm და რას აკეთებენ package.json და lockfile?

Question

Accepted Answer

**npm** (Node Package Manager) არის Node-ის ნაგულისხმი ინსტრუმენტი მესამე მხარის პაკეტების (dependencies) დასაყენებლად და მართვისთვის, ასევე პროექტის სკრიპტების გასაშვებად. ორი ფайل განსაზღვრავს პროექტს: **`package.json`** (მანიფესტი) და **`package-lock.json`** (ზუსტი dependencies ხე).

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

ის აწერთ მეტამონაცემებს, სკრიპტებს და dependencies-ს. `^4.18.0` არის **semver ფარგლები** — `^` ნებას რთავს თავსებად მცირე/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 აკრეფს **ზუსტ** ვერსიას ყოველი პაკეტის (ტრანზიტული dependencies ჩათვლით), რომელიც დადგენილი იყო. ეს გარანტიას აძლევს, რომ ყველამ გუნდში — და CI-ში, და ოპერაციული სისტემაში — მიიღოს *იდენტური* dependencies ხე, რაც თავიდან აქცევს "works on my machine" ხარვეზებს ვერსიის დრიფტიდან.

## მთავარი ბრძანებები

```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` (vs `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** (განმსაზღვრელი, გამეორებადი მთელი dependencies ხის დაყენება) სავალდებულოა — lockfile-ის ჩადება და `npm ci` გამოყენება CI-ში აფერხებს 섭세, რთულ-გამართულ ხარვეზებს, რომელთა მიზეზია გუნდის ცდილობები ან ოპერაციული სისტემა, რომელიც იღებს განსხვავებულ პაკეტის ვერსიებს.