1.0.0 • Published 5 months ago

connectrix v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
5 months ago

README.md

Connectrix - NoSQL Connector Generator CLI 🚀

NPM Version License: MIT

Professional CLI tool for generating production-ready NoSQL connectors with automatic environment configuration.

📦 Features

  • Multi-Database Support: MongoDB, Cassandra, Couchbase, DynamoDB
  • Environment First: Automatic .env file management
  • Type Safety: Built-in TypeScript definitions
  • Security Focused: Never stores credentials in code
  • Validation: Comprehensive input validation
  • CI/CD Ready: Pre-configured testing and linting

🚀 Quick Start

Installation

npm install -g connectrix
# or
npx connectrix generate

Usage

connectrix generate

? Select database type: MongoDB
? Enter database host: localhost
? Enter database port: 27017
? Enter database name: production_db
? Enable SSL? (y/N): N

CLI Demo

🔧 Configuration

Environment Variables

The generated .env file follows this pattern:

DB_[DBTYPE]_HOST=your-host
DB_[DBTYPE]_PORT=your-port
DB_NAME=your-db-name

Supported Databases

DatabaseTemplate VersionRequired Fields
MongoDB2.4.1host, port, ssl
Cassandra1.2.0hosts, keyspace
Couchbase1.1.0cluster, bucket
DynamoDB1.3.0region, accessKeyId

🛠 Development

Contributing

  1. Fork the repository
  2. Create feature branch: git checkout -b feature/new-db-support
  3. Commit changes: git commit -am 'Add new database support'
  4. Push to branch: git push origin feature/new-db-support
  5. Submit pull request

Testing

npm test        # Run all tests with coverage
npm run test:watch  # Watch mode for TDD

Security

Report vulnerabilities via SECURITY.md

📚 Documentation

Full API documentation available at docs.connectrix

📜 License

MIT © Kunaal Gadhalay

**Key Advanced Features in package.json**:
1. **Security Tooling**: ESLint security plugin, npm audit script
2. **Modern JS Support**: ES Modules (`"type": "module"`)
3. **Release Management**: Standard-version for changelog generation
4. **Git Hooks**: Husky for pre-commit linting
5. **Type Safety**: TypeScript definitions and TS-Jest integration
6. **CI/CD Ready**: Test coverage integration with Coveralls
7. **Node Version Control**: Engines field for Node >=18

**Key Advanced Features in README.md**:
1. **Badge Ecosystem**: CI/CD, coverage, version, and license badges
2. **Visual Hierarchy**: Clear section organization with emojis
3. **Interactive Documentation**: Animated GIF demo
4. **Version Matrix**: Database support table
5. **Security Reporting**: Dedicated security section
6. **Developer Workflow**: Detailed contribution guidelines
7. **Documentation Links**: External API docs reference

This implementation follows industry best practices for:
- **Production Readiness**: Test coverage, CI/CD integration
- **Developer Experience**: TypeScript support, watch modes
- **Security**: Vulnerability scanning, secure credential handling
- **Maintainability**: Conventional commits, automated releases
- **Discoverability**: SEO-friendly keywords, proper metadata