epd

A smart CLI tool that intelligently resolves peer dependency conflicts across npm, yarn, and pnpm projects.

🌟 Features

• Intelligent Resolution: Automatically finds the best version that satisfies the most peer dependency requirements
• Multi-Package Manager Support: Works with npm, yarn, and pnpm
• Workspace Aware: Handles monorepo structures with multiple packages
• Registry Integration: Queries npm registry for available versions
• Detailed Reporting: Shows conflicts and resolution strategies
• Non-Destructive: Preserves your original package.json
• Zero Configuration: Works out of the box

📦 Installation

# Install globally
npm install -g epd

# Or with yarn
yarn global add epd

# Or with pnpm
pnpm add -g epd

🚀 Usage

Use epd as a drop-in replacement for your package manager's install command:

Installing Dependencies from package.json

# Install all dependencies from package.json
epd install

# Or simply
epd

Adding New Packages

# Add a new package
epd add react

# Add multiple packages
epd add react react-dom

# Add with specific version
epd add [email protected]

Enhanced Features

# Scan for unused dependencies
epd scan

# Check for security vulnerabilities
epd security

# Check for outdated dependencies
epd outdated

# Interactive dependency resolution
epd interactive

# View current configuration
epd config

Specifying Package Manager

By default, epd automatically detects your package manager based on lockfiles or availability. You can override this with the --pm flag:

# Force using npm
epd install --pm=npm

# Force using yarn
epd add react --pm=yarn

# Force using pnpm
epd add react --pm=pnpm

🔍 How It Works

When you run epd, it:

1. Analyzes your project structure and detects workspaces
2. Collects all peer dependencies from all packages
3. Resolves version conflicts using a sophisticated algorithm:
   • First tries to find a version that satisfies all requirements
   • If none exists, queries the npm registry for available versions
   • Selects the version that satisfies the most requirements
4. Creates a temporary package.json with the resolved dependencies
5. Installs packages using your preferred package manager
6. Restores your original package.json

🛠️ Command Line Options

| Option | Description | |--------|-------------| | --pm=<manager> | Force a specific package manager (npm, yarn, pnpm) | | --debug | Enable debug mode with verbose logging | | --interactive | Enable interactive conflict resolution | | --config=<path> | Use custom configuration file |

⚙️ Configuration

Create a .epdrc file in your project root:

{
  "packageManager": "npm",
  "autoResolve": true,
  "interactive": false,
  "ignorePackages": ["@types/node"],
  "preferredVersions": {
    "react": "^18.0.0"
  },
  "timeout": 30000,
  "retries": 3
}

⚠️ Troubleshooting

Package Manager Not Found

If you see an error like:

❌ Forced package manager pnpm is not installed or not in PATH

Make sure the specified package manager is installed and available in your PATH.

Registry Connection Issues

If you encounter registry connection problems:

❌ Error fetching versions for react: HTTP error! Status: 404

Check your internet connection and ensure you have access to the npm registry. If you're using a custom registry, verify it's correctly configured in your npm settings.

Command Not Found

If you see:

Command 'epd' not found

Ensure the package is properly installed globally. You may need to add the npm global bin directory to your PATH.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

• Inspired by npm's --legacy-peer-deps flag
• Built with love for the JavaScript community

📚 Documentation

• Complete Documentation - Comprehensive guide with all commands and examples
• API Reference - TypeScript interfaces and programmatic usage
• Examples - Real-world usage scenarios and workflows
• Contributing - Development setup and contribution guidelines

🔄 Recent Updates

• Complete Feature Set: All advanced functionality implemented including smart resolution, health scoring, workspace optimization, and more
• TypeScript Migration: Full TypeScript codebase with comprehensive type definitions
• Enhanced CLI: 15+ commands covering all aspects of dependency management
• Comprehensive Testing: Full test suite with Node's native test runner
• Complete Documentation: Extensive docs with examples and API reference