@nitrostack/cli 1.0.0

package/dist/mcp-dev-wrapper.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import chokidar from 'chokidar';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import http from 'http';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * MCP Server Hot Reload Wrapper
+ *
+ * This wrapper:
+ * 1. Starts the MCP server as a child process
+ * 2. Watches for changes in the dist/ directory
+ * 3. Restarts the server when changes are detected
+ * 4. Maintains stdio connection for Studio
+ * 5. Captures stderr from the MCP server and streams it over an SSE endpoint
+ *
+ * IMPORTANT: All logs go to stderr to avoid corrupting MCP JSON-RPC on stdout
+ */
+export async function run() {
+    const distPath = process.argv[2];
+    if (!distPath) {
+        console.error('Usage: mcp-dev-wrapper <path-to-dist/index.js>');
+        process.exit(1);
+        return;
+    }
+    const projectRoot = path.resolve(distPath, '../..');
+    const watchPath = path.join(projectRoot, 'dist');
+    let mcpProcess = null;
+    let isRestarting = false;
+    let consecutiveFailures = 0;
+    const maxConsecutiveFailures = 3;
+    let restartTimeout = null;
+    let sseClient = null;
+    const logCache = [];
+    // Create an HTTP server for SSE log streaming
+    const logServer = http.createServer((req, res) => {
+        if (req.url === '/mcp-logs') {
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+                'Access-Control-Allow-Origin': '*', // Allow all origins
+            });
+            sseClient = res;
+            // Send cached logs
+            logCache.forEach(log => {
+                sseClient?.write(`data: ${log}\n\n`);
+            });
+            req.on('close', () => {
+                sseClient = null;
+            });
+        }
+        else {
+            res.writeHead(404);
+            res.end();
+        }
+    });
+    const logServerPort = parseInt(process.env.MCP_LOG_PORT || '3004');
+    logServer.listen(logServerPort, () => {
+        console.error(`[NitroStack Hot Reload] Log streaming server running at http://localhost:${logServerPort}/mcp-logs`);
+    });
+    function startMCPServer() {
+        if (isRestarting)
+            return;
+        console.error(`[DEBUG] mcp-dev-wrapper.ts: MCP_SERVER_PORT is ${process.env.MCP_SERVER_PORT}`);
+        const mcpEnv = {
+            ...process.env,
+            NODE_ENV: 'development',
+            PORT: process.env.MCP_SERVER_PORT,
+        };
+        mcpProcess = spawn('node', [distPath], {
+            stdio: ['inherit', 'inherit', 'pipe'], // Pipe stderr to capture logs
+            env: mcpEnv,
+        });
+        if (!mcpProcess)
+            return;
+        let buffer = '';
+        if (mcpProcess.stderr) {
+            mcpProcess.stderr.on('data', (data) => {
+                buffer += data.toString();
+                let boundary = buffer.indexOf('\n');
+                while (boundary !== -1) {
+                    const line = buffer.substring(0, boundary);
+                    buffer = buffer.substring(boundary + 1);
+                    // Forward to the console for local debugging
+                    process.stderr.write(line + '\n');
+                    if (line.startsWith('NITRO_LOG::')) {
+                        const logJson = line.substring('NITRO_LOG::'.length);
+                        logCache.push(logJson);
+                        if (sseClient) {
+                            sseClient.write(`data: ${logJson}\n\n`);
+                        }
+                    }
+                    boundary = buffer.indexOf('\n');
+                }
+            });
+        }
+        mcpProcess.on('exit', (code) => {
+            if (!isRestarting) {
+                if (code !== 0) {
+                    consecutiveFailures++;
+                    if (consecutiveFailures >= maxConsecutiveFailures) {
+                        console.error(`[NitroStack Hot Reload] Server failed ${maxConsecutiveFailures} times in a row. Giving up.`);
+                        console.error('[NitroStack Hot Reload] Check your configuration and try again.');
+                        process.exit(1);
+                    }
+                    console.error(`[NitroStack Hot Reload] Server exited with code ${code} (attempt ${consecutiveFailures}/${maxConsecutiveFailures}), restarting...`);
+                }
+                else {
+                    consecutiveFailures = 0;
+                    console.error(`[NitroStack Hot Reload] Server exited with code ${code}, restarting...`);
+                }
+                mcpProcess = null;
+                setTimeout(startMCPServer, 1000);
+            }
+        });
+        mcpProcess.on('error', (err) => {
+            console.error('[NitroStack Hot Reload] Server error:', err);
+        });
+    }
+    function restartMCPServer() {
+        if (restartTimeout) {
+            clearTimeout(restartTimeout);
+        }
+        restartTimeout = setTimeout(() => {
+            if (isRestarting)
+                return;
+            isRestarting = true;
+            if (mcpProcess) {
+                console.error('[NitroStack Hot Reload] Changes detected, restarting server...');
+                mcpProcess.kill('SIGTERM');
+                setTimeout(() => {
+                    mcpProcess = null;
+                    isRestarting = false;
+                    startMCPServer();
+                    console.error('[NitroStack Hot Reload] Server restarted successfully');
+                }, 1500);
+            }
+            else {
+                isRestarting = false;
+                startMCPServer();
+            }
+        }, 1000);
+    }
+    // Start the server initially
+    startMCPServer();
+    const watcher = chokidar.watch(watchPath, {
+        ignoreInitial: true,
+        persistent: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 100,
+            pollInterval: 50,
+        },
+    });
+    watcher.on('change', (filepath) => {
+        console.error(`[NitroStack Hot Reload] File changed: ${path.relative(projectRoot, filepath)}`);
+        restartMCPServer();
+    });
+    watcher.on('add', (filepath) => {
+        console.error(`[NitroStack Hot Reload] File added: ${path.relative(projectRoot, filepath)}`);
+        restartMCPServer();
+    });
+    const shutdown = () => {
+        console.error('[NitroStack Hot Reload] Shutting down...');
+        watcher.close();
+        if (mcpProcess) {
+            mcpProcess.kill('SIGTERM');
+        }
+        logServer.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+// Run if main
+const currentFilePath = fileURLToPath(import.meta.url);
+if (process.argv[1] && (process.argv[1] === currentFilePath ||
+    process.argv[1].endsWith('mcp-dev-wrapper.js') ||
+    process.argv[1].endsWith('mcp-dev-wrapper.ts') ||
+    process.argv[1].endsWith('mcp-dev-wrapper'))) {
+    run().catch(err => {
+        console.error(err);
+        process.exit(1);
+    });
+}

package/dist/ui/branding.d.ts

@@ -0,0 +1,31 @@
+export declare const brand: {
+    accent: import("chalk").ChalkInstance;
+    accentBold: import("chalk").ChalkInstance;
+    accentLight: import("chalk").ChalkInstance;
+    accentLighter: import("chalk").ChalkInstance;
+};
+export declare const NITRO_BANNER_FULL: string;
+export declare function createHeader(title: string, subtitle?: string): string;
+export declare function createBox(lines: string[], type?: 'success' | 'error' | 'info' | 'warning'): string;
+export declare function createSuccessBox(title: string, items: string[]): string;
+export declare function createErrorBox(title: string, message: string): string;
+export declare function createInfoBox(items: {
+    label: string;
+    value: string;
+}[]): string;
+export declare class NitroSpinner {
+    private spinner;
+    constructor(text: string);
+    start(): this;
+    update(text: string): this;
+    succeed(text?: string): this;
+    fail(text?: string): this;
+    info(text?: string): this;
+    warn(text?: string): this;
+    stop(): this;
+}
+export declare function log(message: string, type?: 'success' | 'error' | 'info' | 'warning' | 'dim'): void;
+export declare function divider(): void;
+export declare function spacer(): void;
+export declare function nextSteps(steps: string[]): void;
+//# sourceMappingURL=branding.d.ts.map

package/dist/ui/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/ui/branding.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,KAAK;;;;;CAKjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAa7B,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASrE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAkB,GAAG,MAAM,CAoB1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAK/E;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAM;gBAET,IAAI,EAAE,MAAM;IAQxB,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAK5B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzB,IAAI,IAAI,IAAI;CAIb;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,KAAc,GAAG,IAAI,CAU1G;AAED,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAM/C"}

package/dist/ui/branding.js

@@ -0,0 +1,136 @@
+import chalk from 'chalk';
+import ora from 'ora';
+// ═══════════════════════════════════════════════════════════════════════════
+// NITROSTACK CLI BRANDING
+// ═══════════════════════════════════════════════════════════════════════════
+const ACCENT = '#FF6B35';
+const ACCENT_LIGHT = '#FF8C42';
+const ACCENT_LIGHTER = '#FFA94D';
+export const brand = {
+    accent: chalk.hex(ACCENT),
+    accentBold: chalk.hex(ACCENT).bold,
+    accentLight: chalk.hex(ACCENT_LIGHT),
+    accentLighter: chalk.hex(ACCENT_LIGHTER),
+};
+export const NITRO_BANNER_FULL = `
+${brand.accentBold('╔══════════════════════════════════════════════════════════════════╗')}
+${brand.accentBold('║')}                                                                  ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${brand.accentBold('███╗   ██╗██╗████████╗██████╗  ██████╗ ')}                       ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${brand.accentLight('████╗  ██║██║╚══██╔══╝██╔══██╗██╔═══██╗')}                       ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${brand.accentLighter('██╔██╗ ██║██║   ██║   ██████╔╝██║   ██║')}                       ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${chalk.hex('#FFCC80')('██║╚██╗██║██║   ██║   ██╔══██╗██║   ██║')}                       ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${chalk.hex('#FFE0B2')('██║ ╚████║██║   ██║   ██║  ██║╚██████╔╝')}                       ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${chalk.dim('╚═╝  ╚═══╝╚═╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ')}                       ${brand.accentBold('║')}
+${brand.accentBold('║')}                                                                  ${brand.accentBold('║')}
+${brand.accentBold('║')}   ${chalk.white.bold('S T A C K')}   ${chalk.dim('─────────────────────────────────────────')}   ${brand.accentBold('║')}
+${brand.accentBold('║')}                                                                  ${brand.accentBold('║')}
+${brand.accentBold('╚══════════════════════════════════════════════════════════════════╝')}
+`;
+export function createHeader(title, subtitle) {
+    const paddedTitle = title.padEnd(40);
+    const paddedSubtitle = (subtitle || '').padEnd(40);
+    return `
+${brand.accentBold('┌──────────────────────────────────────────────────────────────────┐')}
+${brand.accentBold('│')}  ${brand.accentBold('NITRO')}${chalk.white.bold('STACK')} ${chalk.dim('━━')} ${chalk.white.bold(paddedTitle)}  ${brand.accentBold('│')}
+${subtitle ? brand.accentBold('│') + '  ' + chalk.dim(paddedSubtitle) + '                        ' + brand.accentBold('│') + '\n' : ''}${brand.accentBold('└──────────────────────────────────────────────────────────────────┘')}
+`;
+}
+export function createBox(lines, type = 'info') {
+    const colors = {
+        success: { border: chalk.green, title: chalk.green.bold },
+        error: { border: chalk.red, title: chalk.red.bold },
+        info: { border: brand.accent, title: brand.accentBold },
+        warning: { border: chalk.yellow, title: chalk.yellow.bold },
+    };
+    const { border } = colors[type];
+    let output = border('┌──────────────────────────────────────────────────────────────────┐\n');
+    for (const line of lines) {
+        const paddedLine = line.padEnd(64);
+        output += border('│') + '  ' + paddedLine + '  ' + border('│') + '\n';
+    }
+    output += border('└──────────────────────────────────────────────────────────────────┘');
+    return output;
+}
+export function createSuccessBox(title, items) {
+    const lines = [
+        chalk.green.bold(`✓ ${title}`),
+        '',
+        ...items.map(item => chalk.dim(`  ${item}`)),
+        '',
+    ];
+    return createBox(lines, 'success');
+}
+export function createErrorBox(title, message) {
+    const lines = [
+        chalk.red.bold(`✗ ${title}`),
+        '',
+        chalk.white(message.substring(0, 60)),
+        '',
+    ];
+    return createBox(lines, 'error');
+}
+export function createInfoBox(items) {
+    const lines = items.map(({ label, value }) => `${chalk.white.bold(label.padEnd(14))} ${chalk.cyan(value)}`);
+    return createBox(['', ...lines, ''], 'info');
+}
+export class NitroSpinner {
+    spinner;
+    constructor(text) {
+        this.spinner = ora({
+            text: chalk.dim(text),
+            color: 'yellow',
+            spinner: 'dots12',
+        });
+    }
+    start() {
+        this.spinner.start();
+        return this;
+    }
+    update(text) {
+        this.spinner.text = chalk.dim(text);
+        return this;
+    }
+    succeed(text) {
+        this.spinner.succeed(text ? chalk.green('✓ ') + chalk.dim(text) : undefined);
+        return this;
+    }
+    fail(text) {
+        this.spinner.fail(text ? chalk.red('✗ ') + chalk.dim(text) : undefined);
+        return this;
+    }
+    info(text) {
+        this.spinner.info(text ? chalk.blue('ℹ ') + chalk.dim(text) : undefined);
+        return this;
+    }
+    warn(text) {
+        this.spinner.warn(text ? chalk.yellow('⚠ ') + chalk.dim(text) : undefined);
+        return this;
+    }
+    stop() {
+        this.spinner.stop();
+        return this;
+    }
+}
+export function log(message, type = 'info') {
+    const icons = {
+        success: chalk.green('✓'),
+        error: chalk.red('✗'),
+        info: chalk.blue('ℹ'),
+        warning: chalk.yellow('⚠'),
+        dim: chalk.dim('·'),
+    };
+    console.log(`  ${icons[type]} ${type === 'dim' ? chalk.dim(message) : message}`);
+}
+export function divider() {
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+}
+export function spacer() {
+    console.log('');
+}
+export function nextSteps(steps) {
+    console.log(chalk.white.bold('\n  Next steps:\n'));
+    steps.forEach((step, i) => {
+        console.log(chalk.dim(`  ${i + 1}.`) + ' ' + chalk.cyan(step));
+    });
+    console.log('');
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@nitrostack/cli",
+  "version": "1.0.0",
+  "description": "CLI for NitroStack - Create and manage MCP server projects",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nitrostack-cli": "dist/index.js",
+    "@nitrostack/cli": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nitrostack",
+    "cli",
+    "mcp",
+    "create",
+    "scaffold",
+    "generator"
+  ],
+  "author": "Abhishek Pandit <abhishekpanditofficial@gmail.com>",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "chokidar": "^3.6.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.3.2",
+    "inquirer": "^9.3.7",
+    "open": "^10.1.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.5",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.7.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abhishekpanditofficial/nitrostack.git",
+    "directory": "typescript/packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/abhishekpanditofficial/nitrostack/issues"
+  },
+  "homepage": "https://nitrostack.vercel.app"
+}
+

package/templates/typescript-oauth/.env.example

@@ -0,0 +1,27 @@
+
+# OAuth 2.1 MCP Server Configuration
+# =============================================================================
+# TRANSPORT MODE (AUTO-CONFIGURED)
+# =============================================================================
+# When OAuth is configured, the server automatically runs in DUAL mode:
+# - STDIO: For MCP protocol communication with Studio/Claude
+# - HTTP: For OAuth metadata endpoints (/.well-known/oauth-protected-resource)
+# Both transports run simultaneously on different channels.
+# =============================================================================
+# REQUIRED: Server Configuration
+# =============================================================================
+# =============================================================================
+# Auth0 Configuration
+# =============================================================================
+# After creating your API and Application in Auth0, fill in these values:
+# Your Auth0 API Identifier (from APIs → MCP Server → Identifier)
+# This MUST match exactly what you set when creating the API
+RESOURCE_URI=https://mcplocal
+# Your Auth0 tenant domain (authorization server)
+AUTH_SERVER_URL=https://dev-5dt0utuk31h13tjm.us.auth0.com
+# Expected token audience (should match RESOURCE_URI)
+TOKEN_AUDIENCE=https://mcplocal
+# Expected token issuer (your Auth0 tenant domain with trailing slash)
+TOKEN_ISSUER=https://dev-5dt0utuk31h13tjm.us.auth0.com/
+
+DUFFEL_API_KEY=duffel_test_-w0wGDHB0M3DU9k-sBeUbxLqwcibUQqfEbjWDTKNnlf