Τι είναι το npm και τι κάνουν το package.json και το αρχείο κλειδώματος;

Question

Accepted Answer

**npm** (Node Package Manager) είναι το προεπιλεγμένο εργαλείο του Node για την εγκατάσταση και τη διαχείριση πακέτων τρίτων (εξαρτήσεων) και την εκτέλεση σεναρίων έργου. Δύο αρχεία ορίζουν ένα έργο: **`package.json`** (το manifest) και **`package-lock.json`** (το ακριβές δέντρο εξαρτήσεων).

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

Καταγράφει μεταδεδομένα, σενάρια και εξαρτήσεις. Το `^4.18.0` είναι ένα **εύρος semver** — το `^` επιτρέπει συμβατές ενημερώσεις minor/patch (4.x.x αλλά όχι 5.0.0).

## Το αρχείο κλειδώματος — ακριβείς, αναπαραγώγιμες εγκαταστάσεις

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

Το αρχείο κλειδώματος καθορίζει την **ακριβή** έκδοση κάθε πακέτου (συμπεριλαμβανομένων των μεταβατικών εξαρτήσεων) που εγκαταστάθηκε. Αυτό εγγυάται ότι ο καθένας στην ομάδα — και 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`) εγκαθιστά αυστηρά από το αρχείο κλειδώματος χωρίς να το τροποποιεί — η σωστή εντολή για αναπαραγωγιμότητα CI/παραγωγής.

## Commit το αρχείο κλειδώματος

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

## Γιατί έχει σημασία

Το npm και αυτά τα δύο αρχεία είναι το θεμέλιο κάθε έργου Node.

Η κατανόηση του `package.json` (εξαρτήσεις έναντι devDependencies, εύρη semver, σενάρια) και ιδιαίτερα **γιατί υπάρχει το αρχείο κλειδώματος** (ντετερμινιστικές, αναπαραγώγιμες εγκαταστάσεις ολόκληρου του δέντρου εξαρτήσεων) είναι απαραίτητη — το commit του αρχείου κλειδώματος και η χρήση του `npm ci` στο CI αποτρέπει λεπτά, δύσκολα προς εντοπισμό σφάλματα που προκαλούνται από τις συναδέλφους ή την παραγωγή να λαμβάνουν διαφορετικές εκδόσεις πακέτων.