Cad is npm agus cad a dhéanann package.json agus an comhad foluain?

Question

Accepted Answer

**npm** (Node Package Manager) is an uirlis réamhshocraithe Node chun pacáistí tríú páirtí (spleáchais) a shuiteáil agus a bhainistiú agus script an tionscadail a rith. Sainítear tionscadal de réir dhá chomhad: **`package.json`** (an manifest) agus **`package-lock.json`** (an crann spleáchais beacht).

## package.json — manifest an tionscadail

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

Taifeadann sé meiteashonraí, scripteanna agus spleáchais. `^4.18.0` is raon **semver** é — tugann `^` deis do nuashonruithe comhoiriúnacha minor/patch (4.x.x ach ní 5.0.0).

## An comhad foluain — suiteálacha beachta, inathágáilte

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

Fhixeálann an comhad foluain an leagan **beacht** de gach pacáiste (lena n-áirítear spleáchais thrasuíochta) a suiteáladh. Thistigeann sé go bhfaigheann gach duine ar an bhfoireann — agus CI, agus táirgean — an crann spleáchais **comhionann** ar fad, ag cosc ar ghearrthíona "oibríonn sé ar mo dhroichead" ó shnádmhéalachán leagan.

## Príomhdhordanna

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

Suiteálann `npm ci` (i bhfreagras ar `npm install`) go docht ón gcomhad foluain gan é a mhodhnú — an t-ordú ceart do inathágáilteacht CI/táirgean.

## Tiomáint an comhad foluain

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

## Cén fáth ar chóir dúinn a bheith i ndiaidh

npm agus an dá chomhad seo is bonn gach tionscadail Node.

Tá tuiscint ar `package.json` (spleáchais i gcoinne devDependencies, raonta semver, scripteanna) agus go háirithe **cén fáth go bhfuil an comhad foluain ann** (suiteálacha dhinochtúth, inathágáilte ar an chrann spleáchais ar fad) riachtanach — an comhad foluain a thiomáint agus `npm ci` a úsáid i CI a chosc ar lochtanna finte, deacair a dhífhabhtú a dhéantar ar dhreoraí timpeall agus tháirgean a bhfaigheann leaganacha pacáiste éagsúil.