nitrostack 1.0.14 → 1.0.15

package/CHANGELOG.md

@@ -1,4 +1,3 @@
-
 # Changelog
 
 All notable changes to NitroStack will be documented in this file.
@@ -6,310 +5,45 @@ All notable changes to NitroStack will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
-
-## [1.0.7] - 2025-10-27
-
-### Fixed
-- **Critical**: Fixed webpack loader configuration error for Studio
-  - Switched from manual `next-swc-loader` configuration to Next.js's `defaultLoaders.babel`
-  - Resolves "TypeError [ERR_INVALID_ARG_TYPE]: The 'from' argument must be of type string" error
-  - Uses Next.js's pre-configured loader with all correct options
-
-### Technical Details
-- Previous manual loader configuration was passing incorrect options to `next-swc-loader`
-- New approach: use `defaultLoaders.babel` provided by Next.js webpack context
-- This ensures all TypeScript/JSX files in `lib/` and `components/` are processed with the correct Babel/SWC configuration
-
-## [1.0.6] - 2025-10-27
-
-### Fixed
-- **Critical**: Added explicit webpack rule for Studio TypeScript compilation
-  - Created dedicated webpack rule with `next-swc-loader` for `lib/` and `components/` directories
-  - Uses `include` directive to explicitly process TypeScript files in these directories
-  - Resolves "Module parse failed: Unexpected token" by ensuring proper TypeScript compilation
-  - Works correctly when Studio is installed from npm in `node_modules`
-
-### Technical Details
-- Previous approach of modifying `exclude` patterns wasn't working consistently
-- New approach: explicitly `push` a new webpack rule that includes our directories
-- Uses Next.js's internal `next-swc-loader` with proper configuration for both client and server builds
-
-## [1.0.5] - 2025-10-27
-
-### Fixed
-- **Critical**: Fixed webpack TypeScript loader for Studio `lib` and `components` directories
-  - Modified webpack exclude patterns to ensure TypeScript files in `lib/` and `components/` are processed
-  - Webpack now correctly applies the TypeScript/Babel loader to aliased paths
-  - Resolves "Module parse failed: Unexpected token" error for TypeScript syntax
-
-## [1.0.4] - 2025-10-27
-
-### Fixed
-- **Critical**: Fixed Studio webpack module resolution for `@/*` path aliases
-  - Added explicit webpack configuration in `src/studio/next.config.js`
-  - Webpack now correctly resolves `@/lib/*` and `@/components/*` imports
-  - Resolves "Module not found: Can't resolve '@/lib/store'" error definitively
-  - Studio now works correctly when installed from npm
-
-### Technical Details
-- The issue was that while TypeScript's `tsconfig.json` had `"paths": { "@/*": ["./"] }`, webpack (used by Next.js) wasn't respecting it
-- Added explicit `config.resolve.alias = { '@': __dirname }` to webpack configuration
-- This ensures webpack resolves `@/` to the Studio's root directory
-
-## [1.0.3] - 2025-10-27
-
-### Fixed
-- **Critical**: Fixed Studio TypeScript path resolution in Next.js webpack
-  - Changed `moduleResolution` from `"bundler"` to `"node"` in `src/studio/tsconfig.json`
-  - Added `"baseUrl": "."` to enable proper `@/*` path mapping
-  - Resolves "Module not found: Can't resolve '@/lib/store'" error when running `nitrostack dev`
-
-## [1.0.2] - 2025-10-27
+## [1.0.15] - 2025-10-28
 
 ### Fixed
-- **Critical**: Fixed CLI `--version` command to read version dynamically from `package.json`
-  - Was showing hardcoded `1.0.0` instead of actual package version
-  - Now correctly displays the installed version
-- **Critical**: Fixed `src/studio` not being included in npm package
-  - Studio files are now properly included (47 files)
-  - Users can now run `nitrostack dev` without Studio installation errors
-  - Changed `.npmignore` to exclude specific `/src/` subdirectories while keeping `/src/studio/`
-
-### Changed
-- Updated `.npmignore` to specifically exclude `/src/auth/`, `/src/cli/`, `/src/core/`, etc. instead of blanket `/src/` exclusion
-- CLI now uses `createRequire` to load `package.json` for dynamic version reading
-
-## [1.0.1] - 2025-10-27
-
-### Fixed
-- **Critical**: Fixed `.npmignore` to include template `src/` folders
-  - Changed `src/` to `/src/` to only exclude root source files
-  - Template source files are now properly included in the package
-  - Users can now successfully generate projects with all necessary files
-
-### Changed
-- Updated `.npmignore` patterns to use leading slashes for root-only exclusions
-- Keep template `.env.example` files by excluding only root `.env` files
-
-## [1.0.0] - 2025-10-27
-
-### Changed
-- **License**: Changed from MIT to Apache License 2.0
-- **Copyright**: Copyright holder is Abhishek Pandit
-- **Author**: Updated author to Abhishek Pandit
-- **Package Name**: Renamed from hypermcp to nitrostack
-- Updated all documentation links to official website (https://nitrostack.vercel.app/) and docs (https://nitrostack-docs.vercel.app/)
-- Added NOTICE file for Apache 2.0 compliance with dependency attributions
-- Updated CONTRIBUTING.md with Apache 2.0 license headers and contributor agreement
-
-## [3.1.0] - 2025-01-XX
-
-### 🎉 Major Release - Production Features
-
-This release transforms NitroStack into a production-grade, enterprise-ready framework with 11 major features inspired by NestJS.
+- **Node.js Compatibility**: Fixed compatibility issues with Node.js versions 18.x and 20.x (< 20.10.0)
+  - Downgraded `ora` from v9.0.0 to v8.1.1 to avoid `import ... with {type: 'json'}` syntax
+  - Downgraded `inquirer` from v12.10.0 to v9.3.7 for broader Node.js compatibility
+  - Added `@types/inquirer` v9.0.7 as dev dependency for TypeScript support
+  - Resolved `SyntaxError: Unexpected token 'with'` error on older Node.js versions
 
 ### Added
-
-#### Core Features
-- **Middleware System** (`@Middleware`, `@UseMiddleware`) - Cross-cutting concerns like logging, timing, authentication
-- **Interceptors** (`@Interceptor`, `@UseInterceptors`) - Transform requests/responses before/after execution
-- **Pipes** (`@Pipe`, `@UsePipes`, `@Body`, `@Validated`) - Input validation and transformation
-- **Exception Filters** (`@ExceptionFilter`, `@UseFilters`) - Centralized error handling
-- **Dependency Injection** (`@Injectable`, `DIContainer`, `@Inject`) - Constructor-based DI for testability
-
-#### Utility Features
-- **Caching** (`@Cache`) - Automatic caching with TTL and custom key generation
-- **Rate Limiting** (`@RateLimit`) - Per-user or global rate limiting with time windows
-- **Health Checks** (`@HealthCheck`) - Monitor system health with periodic checks
-
-#### Additional Features
-- **Event System** (`@OnEvent`, `EventEmitter`) - Event-driven architecture for decoupled modules
-- **CLI Generator** (`nitrostack generate`) - Generate boilerplate for all component types
-- **Testing Utilities** (`nitrostack/testing`) - `TestingModule`, mock helpers, test contexts
-
-### Enhanced
-
-- **Execution Pipeline** - New pipeline with guards → rate limiting → middleware → interceptors → pipes → cache → handler → filters
-- **Tool Class** - Completely rewritten to support the full execution pipeline
-- **DI Container** - Simple but powerful singleton-based DI container
-- **Template** - `typescript-auth` template now demonstrates all V3.1 features
-- **Documentation** - 7 comprehensive guides covering all features
-
-### Files Added
-
-#### Core SDK (src/core/)
-- `middleware/middleware.interface.ts` - Middleware interface
-- `middleware/middleware.decorator.ts` - Middleware decorators
-- `interceptors/interceptor.interface.ts` - Interceptor interface
-- `interceptors/interceptor.decorator.ts` - Interceptor decorators
-- `pipes/pipe.interface.ts` - Pipe interface
-- `pipes/pipe.decorator.ts` - Pipe decorators
-- `filters/exception-filter.interface.ts` - Exception filter interface
-- `filters/exception-filter.decorator.ts` - Exception filter decorators
-- `di/container.ts` - DI container implementation
-- `di/injectable.decorator.ts` - Injectable and Inject decorators
-- `events/event-emitter.ts` - Event emitter singleton
-- `events/event.decorator.ts` - OnEvent decorator
-- `decorators/cache.decorator.ts` - Cache decorator
-- `decorators/rate-limit.decorator.ts` - Rate limit decorator
-- `decorators/health-check.decorator.ts` - Health check decorator
-
-#### Testing Module (src/testing/)
-- `index.ts` - Complete testing utilities
-
-#### CLI (src/cli/)
-- `commands/generate.ts` - Code generator with 11 templates
-
-#### Template Examples (templates/typescript-auth/src/)
-- `services/database.service.ts` - DI service example
-- `middleware/logging.middleware.ts` - Logging middleware
-- `interceptors/transform.interceptor.ts` - Response transformer
-- `pipes/validation.pipe.ts` - Validation pipe
-- `filters/global-exception.filter.ts` - Global error handler
-- `health/database.health.ts` - Database health check
-- `events/notification.service.ts` - Email notification service
-- `events/analytics.service.ts` - Analytics event tracking
-
-#### Documentation
-- `V3_ADVANCED_FEATURES.md` - Complete feature guide (1,200+ lines)
-- `V3_QUICK_REFERENCE.md` - Quick decorator reference
-- `V3_1_RELEASE_NOTES.md` - Release notes
-- `V3_1_COMPLETE_SUMMARY.md` - Implementation summary
-- `CLI_GENERATOR_GUIDE.md` - CLI generator usage guide
-- `templates/typescript-auth/V3_1_FEATURES_GUIDE.md` - Template guide
-- `V3_1_FINAL_SUMMARY.md` - Final comprehensive summary
+- `NODE_COMPATIBILITY.md` - Comprehensive guide for Node.js version compatibility
+- Updated README with Node.js version requirements
 
 ### Changed
+- Improved developer experience for users on different Node.js versions
+- Package now works reliably on Node.js 18.0.0 and later
 
-- **package.json** - Version bumped to 3.1.0
-- **src/core/tool.ts** - Complete rewrite to support execution pipeline
-- **src/core/builders.ts** - Updated to extract all metadata and support DI
-- **src/core/index.ts** - Added exports for all new features
-- **src/core/types.ts** - Removed deprecated ServerHooks and Middleware types
-- **src/core/server.ts** - Removed generic middleware system (replaced by @Middleware)
-- **src/cli/index.ts** - Added `generate` command
-- **templates/typescript-auth/src/index.ts** - Full integration of all features
-- **templates/typescript-auth/src/modules/products/products.tools.ts** - Demonstrates all features
-
-### Performance
-
-- Execution pipeline overhead: < 1ms per request with all features enabled
-- DI container: O(1) lookup after registration
-- Event emitter: Async execution doesn't block responses
-- Caching: In-memory with automatic expiration
-- Rate limiting: In-memory with automatic cleanup
-
-### Migration from 3.0
-
-**100% backward compatible!** All V3.0 code works without changes. New features are opt-in via decorators.
-
-Before:
-```typescript
-@Tool({ name: 'get_user', ... })
-async getUser(input: any) {
-  return db.query('SELECT * FROM users');
-}
-```
-
-After (enhanced, opt-in):
-```typescript
-@Tool({ name: 'get_user', ... })
-@UseMiddleware(LoggingMiddleware)
-@UseInterceptors(TransformInterceptor)
-@UsePipes(ValidationPipe)
-@Cache({ ttl: 60 })
-@RateLimit({ requests: 100, window: '1m' })
-async getUser(input: any) {
-  return db.query('SELECT * FROM users');
-}
-```
-
-### Breaking Changes
-
-None - fully backward compatible with V3.0.
-
-### Documentation
-
-- 7 new comprehensive documentation files
-- Complete API reference for all features
-- Step-by-step integration guide
-- CLI generator usage guide
-- Template walkthrough with examples
-- Testing guide with utilities
-- Migration guide from V3.0
-
-### Statistics
-
-- **Features**: 11 major features implemented
-- **Files**: 30+ new files created
-- **Code**: ~4,000 lines of production code
-- **Documentation**: ~3,500 lines across 7 guides
-- **Tests**: Full testing utilities suite
-
----
-
-## [3.0.0] - 2024-XX-XX
+## [1.0.14] - 2025-10-27
 
 ### Added
-
-- Decorator-based architecture (`@Tool`, `@Resource`, `@Prompt`, `@Module`, `@Widget`)
-- Guard system (`@UseGuards`, `Guard` interface)
-- JWT authentication module (`JWTModule.forRoot()`)
-- Module system for organizing code
-- Auto-registration of tools, resources, and prompts
-- Widget integration with Next.js
-- Enhanced TypeScript support with metadata
-- OAuth 2.1 support for OpenAI Apps SDK
-- API Key authentication
-- Comprehensive examples in `typescript-auth` template
-
-### Changed
-
-- Complete rewrite of core architecture
-- Tool definition moved to decorators
-- Server configuration simplified
-- CLI improved with better templates
-
----
-
-## [2.0.0] - 2024-XX-XX
-
-### Added
-
-- Function-based tool creation
-- Widget support with React components
-- CLI for project scaffolding
-- TypeScript templates
-- Better error handling
-
----
-
-## [1.0.0] - 2024-XX-XX
-
-### Added
-
-- Initial release
-- Basic MCP server implementation
-- Tool registration
-- STDIO transport
-- Simple examples
-
----
-
-## Upcoming Features (V3.2 Roadmap)
-
-- Database decorators (`@Transaction`)
-- Metrics collection (Prometheus)
-- OpenAPI generation
-- Bulk operations (`@Bulk`)
-- Request context propagation
-- Hot reload
-- Schema registry
-- Widget state management
-- Conditional tool registration
-- Built-in observability
+- Initial public release to npm
+- Full MCP server framework with decorators
+- Built-in Studio for visual testing
+- Authentication modules (JWT, OAuth 2.1, API Keys)
+- Widget system for interactive UIs
+- CLI with project generation and hot reload
+- Multiple starter templates
+- Comprehensive documentation
+
+### Features
+- Declarative programming model with decorators
+- Runtime pipeline (Guards, Middleware, Interceptors, Pipes, Filters)
+- Type generation from tool definitions
+- Caching and rate limiting support
+- Hot reload development workflow
+- Production-grade tooling
 
 ---
 
+## Version History
 
+For older versions and detailed changes, see [GitHub Releases](https://github.com/abhishekpanditofficial/nitrostack/releases).

package/README.md

@@ -44,6 +44,14 @@ NitroStack solves these pain points out of the box.
 - **Dev experience**
   - Hot reload, templates, code generators, dual transport support for OAuth metadata
 
+## Requirements
+
+- **Node.js**: >= 18.0.0 (LTS versions recommended)
+- **npm**: >= 9.0.0
+
+✅ Tested on Node.js 18.x, 20.x, and 22.x
+
+
 ## Install
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nitrostack",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "NitroStack - Build powerful MCP servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",
@@ -65,12 +65,12 @@
     "express": "^4.21.2",
     "fs-extra": "^11.3.2",
     "http-proxy-middleware": "^3.0.3",
-    "inquirer": "^12.10.0",
+    "inquirer": "^9.3.7",
     "jose": "^6.1.0",
     "jsonwebtoken": "^9.0.2",
-    "open": "^10.2.0",
+    "open": "^10.1.0",
     "openai": "^6.5.0",
-    "ora": "^9.0.0",
+    "ora": "^8.1.1",
     "reflect-metadata": "^0.2.1",
     "uuid": "^11.0.5",
     "winston": "^3.17.0",
@@ -84,6 +84,7 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
     "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
     "@types/jest": "^29.5.14",
     "@types/jsonwebtoken": "^9.0.7",
     "@types/node": "^22.10.5",
@@ -95,7 +96,8 @@
     "typescript": "^5.7.2"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
   },
   "repository": {
     "type": "git",
@@ -105,4 +107,4 @@
     "url": "https://github.com/abhishekpanditofficial/nitrostack/issues"
   },
   "homepage": "https://nitrostack.vercel.app"
-}
+}