mirror of
https://github.com/tuanngocptn/nport.git
synced 2026-04-26 05:35:48 +03:00
-
v2.1.0 Stable
released this
2026-01-27 12:34:07 +03:00 | 35 commits to main since this release📅 Originally published on GitHub: Tue, 27 Jan 2026 09:35:39 GMT
🏷️ Git tag created: Tue, 27 Jan 2026 09:34:07 GMT[2.1.0] - 2026-01-27
Added
- 🔷 Full TypeScript Migration: Complete rewrite of CLI and Server in TypeScript
- Strict type checking enabled across the entire codebase
- All modules converted from JavaScript to TypeScript
- Type-safe interfaces for configuration, tunnels, analytics, and i18n
- Better IDE support with IntelliSense and autocompletion
- 📚 Comprehensive Documentation: New docs folder with detailed guides
docs/ARCHITECTURE.md: System overview, component diagrams, and data flowdocs/API.md: Complete API reference with endpoints and examplesdocs/CONTRIBUTING.md: Contribution guidelines and development setup
- 🤖 AI Context Support: Added
.ai/context.mdfor AI-assisted development- Project structure and key patterns documented
- Coding conventions and architecture decisions
- Makes AI pair programming more effective
- 🧪 Unit Testing with Vitest: Comprehensive test suite for CLI
- Tests for argument parsing (
tests/args.test.ts) - Tests for version comparison (
tests/version.test.ts) - Tests for state management (
tests/state.test.ts) - Easy to run with
npm test
- Tests for argument parsing (
- 📋 Code Ownership: Added
.github/CODEOWNERSfile- Clear ownership for code review assignments
- Faster PR reviews with automatic reviewer assignment
- 📝 Cursor Rules: Added
.cursorrulesfor consistent AI assistance- Project-specific coding conventions
- TypeScript and naming guidelines
- Common patterns and anti-patterns
- 🔄 Auto-download Cloudflared: Binary downloads automatically on first run
- No need to run separate install commands
- Seamless first-time user experience
- Progress indicator during download
- 🔒 Protected Subdomain Support: Enhanced error handling for reserved subdomains
- User-friendly error message when trying to create protected subdomains (like
api) - Formatted error output matching existing error style
- Helpful suggestions to use alternative subdomain names
- Prevents accidental use of backend service subdomains
- User-friendly error message when trying to create protected subdomains (like
- 📋 TODO Management: Added
TODO.mdfor tracking planned features- Move time limit enforcement to backend
- Update README powered-by section
- Track terminal link clicks
Changed
- 🏗️ Project Structure: Reorganized for better maintainability
- All source code in
src/directory - Type definitions in
src/types/ - Shared constants in
src/constants.ts - Tests in
tests/directory
- All source code in
- 📦 Build System: Updated to TypeScript compilation
- Uses
tscfor compilation - Output to
dist/directory - Source maps for debugging
- Uses
- 🔧 Development Workflow: Improved developer experience
npm run devfor watch modenpm run buildfor productionnpm testfor running testsnpm run lintfor type checking
- ⚙️ System Requirements: Updated to Node.js 20+
- Minimum Node.js version: 20.0.0
- Minimum npm version: 10.0.0
- Better security and performance with latest LTS
Improved
- ✨ Better Error Messages: Enhanced user feedback for protected subdomains
- Catches
SUBDOMAIN_PROTECTEDerrors from backend - Formats error messages consistently with other error types
- Shows actionable options when subdomain is reserved
- Catches
Fixed
- 🐛 Intel Mac Binary Download: Fixed cloudflared binary download on Intel Macs
- Node.js reports architecture as
x64, notamd64- now correctly mapped - Fixed ARM64 Macs to download the correct
cloudflared-darwin-arm64.tgzbinary - Previously ARM64 Macs were incorrectly downloading the AMD64 binary
- Node.js reports architecture as
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- 🔷 Full TypeScript Migration: Complete rewrite of CLI and Server in TypeScript