npm package: @raphaellcs/dep-checker
Description: A simple tool to check and update npm dependencies
Author: Dream Heart
Latest version: 1.0.0

# @raphaellcs/dep-checker

A simple tool to check and update npm dependencies with ease.

## Features

- 🔍 **Check** outdated dependencies
- 🔄 **Update** dependencies interactively
- 📊 **Generate** dependency reports
- 💡 **Colorful** and friendly output
- ⚡ **Fast** and lightweight

## Installation

```bash
# Use with npx (no installation needed)
npx @raphaellcs/dep-checker --help

# Or install globally
npm install -g @raphaellcs/dep-checker
```

## Usage

### Check for Outdated Dependencies

```bash
# Check all dependencies
npx @raphaellcs/dep-checker check

# Check only production dependencies
npx @raphaellcs/dep-checker check --type prod

# Check only dev dependencies
npx @raphaellcs/dep-checker check --type dev

# Check a specific directory
npx @raphaellcs/dep-checker check --directory /path/to/project
```

### Update Dependencies

```bash
# Update interactively (ask for confirmation)
npx @raphaellcs/dep-checker update

# Update all without confirmation
npx @raphaellcs/dep-checker update --yes

# Update only production dependencies
npx @raphaellcs/dep-checker update --type prod
```

### Generate Report

```bash
# Generate a JSON report
npx @raphaellcs/dep-checker report

# Save to custom file
npx @raphaellcs/dep-checker report --output my-report.json
```

## Examples

### Example 1: Check Dependencies

```bash
$ npx @raphaellcs/dep-checker check
✔ Checking dependencies...
✔ Checking express...
✔ express: ^4.18.0 → 4.19.0
✔ Checking lodash...
✔ lodash: ^4.17.21 (latest)

✔ Checked 2 dependencies.

📦 Outdated Dependencies:

  ⬆️ express
     Current: ^4.18.0
     Latest:  4.19.0

1 updates available (0 major updates)
```

### Example 2: Update Dependencies

```bash
$ npx @raphaellcs/dep-checker update
✔ Finding outdated dependencies...

1. express
   ^4.18.0 → 4.19.0

Update these dependencies? (y/n): y
✔ Updating dependencies...
✔ Dependencies updated successfully!
```

### Example 3: Generate Report

```bash
$ npx @raphaellcs/dep-checker report
✔ Generating report...
✔ Report saved to dep-report.json
```

Report format:
```json
{
  "generated": "2026-02-12T13:28:00.000Z",
  "project": "my-project",
  "total": 5,
  "dependencies": [
    {
      "name": "express",
      "current": "^4.18.0",
      "latest": "4.19.0",
      "type": "prod",
      "outdated": true
    },
    {
      "name": "lodash",
      "current": "^4.17.21",
      "latest": "4.17.21",
      "type": "prod",
      "outdated": false
    }
  ]
}
```

## Options

### Global Options

- `-d, --directory <path>` - Project directory (default: current directory)
- `-t, --type <type>` - Dependency type: `all|prod|dev` (default: `all`)

### Update Command Options

- `-y, --yes` - Update all without confirmation

### Report Command Options

- `-o, --output <file>` - Output file (default: `dep-report.json`)

## Use Cases

- 🚀 Before deploying to production
- 📅 Weekly dependency maintenance
- 🔒 Security vulnerability checks
- 📊 Project audit reports
- 🔄 Keeping dependencies up-to-date

## Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

## License

MIT

## Author

Dream Heart 🌙

## Links

- [npm](https://www.npmjs.com/package/@raphaellcs/dep-checker)
- [GitHub](https://github.com/RaphaelLcs-financial/dep-checker)