Deps Npm

---
name: deps_npm
router_kit: FullStackKit
description: npm/yarn dependency management, package.json best practices ve version control.
metadata:
  skillport:
    category: development
    tags: [architecture, automation, best practices, clean code, coding, collaboration, compliance, debugging, deps npm, design patterns, development, documentation, efficiency, git, optimization, productivity, programming, project management, quality assurance, refactoring, software engineering, standards, testing, utilities, version control, workflow]      - deps-security
---

# 📦 Deps NPM

> npm dependency management ve best practices.

---

## 📋 package.json Best Practices

```json
{
  "name": "my-app",
  "version": "1.0.0",
  "engines": { "node": ">=20.0.0" },
  "scripts": {
    "dev": "vite",
    "build": "tsc && vite build",
    "lint": "eslint .",
    "test": "vitest"
  }
}
```

---

## 🔒 Version Control

| Prefix | Anlamı | Örnek |
|--------|--------|-------|
| `^1.2.3` | Minor updates OK | 1.x.x |
| `~1.2.3` | Patch only | 1.2.x |
| `1.2.3` | Exact version | 1.2.3 |

```bash
# Lock file ZORUNLU
npm ci  # package-lock.json kullan
```

---

## 📊 Dependency Types

```json
{
  "dependencies": {},      // Production
  "devDependencies": {},   // Development only
  "peerDependencies": {}   // Consumer provides
}
```

---

*Deps NPM v1.1 - Enhanced*

## 🔄 Workflow

> **Kaynak:** [NPM Security Best Practices](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)

### Aşama 1: Audit & Analysis
- [ ] **Lockfile**: `package-lock.json` var ve güncel mi?
- [ ] **Security**: `npm audit` çalıştır ve kritik açıkları gider.
- [ ] **Licenses**: Production bağımlılıklarının lisanslarını kontrol et.

### Aşama 2: Update Strategy
- [ ] **Minor/Patch**: `npm outdated` ile güvenli güncellemeleri yap.
- [ ] **Major**: Breaking change'leri release note'lardan oku ve tek tek güncelle.
- [ ] **Clean**: Kullanılmayan paketleri `depcheck` ile bul ve sil.

### Aşama 3: CI/CD Protection
- [ ] **Immutable**: CI'da mutlaka `npm ci` kullan (asla `npm install` değil).
- [ ] **Vulnerability**: Pipeline'a audit step ekle (`npm audit --audit-level=high`).

### Kontrol Noktaları
| Aşama | Doğrulama |
|-------|-----------|
| 1 | `node_modules` silinip `npm ci` yapılınca proje çalışıyor mu? |
| 2 | Production build, `devDependencies` olmadan çalışıyor mu? |
| 3 | Tüm versiyonlar 'Exact' veya 'Tilde/Caret' stratejisine uygun mu? |