npm - nitrostack - Versions diffs - 1.0.0 → 1.0.1 - Mend

nitrostack 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (115) hide show

package/templates/typescript-oauth/src/widgets/app/calculator-result/page.tsx ADDED Viewed

@@ -0,0 +1,134 @@
+'use client';
+import { withToolData } from 'nitrostack/widgets';
+/**
+ * Widget Metadata (stored in widget-manifest.json)
+ *
+ * This widget displays calculation results with operation details.
+ *
+ * Examples defined in manifest:
+ * - Addition: 5 + 3 = 8
+ * - Multiplication: 6 × 7 = 42
+ * - Division: 20 ÷ 4 = 5
+ *
+ * Frontend developers: Edit widget-manifest.json to update examples
+ */
+interface CalculatorData {
+  operation: string;
+  a: number;
+  b: number;
+  result: number;
+  expression: string;
+}
+function CalculatorResult({ data }: { data: CalculatorData }) {
+  const getOperationColor = (op: string) => {
+    const colors: Record<string, string> = {
+      add: '#10b981',
+      subtract: '#f59e0b',
+      multiply: '#3b82f6',
+      divide: '#8b5cf6'
+    };
+    return colors[op] || '#6b7280';
+  };
+  const getOperationIcon = (op: string) => {
+    const icons: Record<string, string> = {
+      add: '➕',
+      subtract: '➖',
+      multiply: '✖️',
+      divide: '➗'
+    };
+    return icons[op] || '🔢';
+  };
+  const color = getOperationColor(data.operation);
+  return (
+    <div style={{
+      padding: '24px',
+      background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+      borderRadius: '16px',
+      color: 'white',
+      maxWidth: '400px',
+      boxShadow: '0 10px 30px rgba(0,0,0,0.2)'
+    }}>
+      <div style={{
+        display: 'flex',
+        alignItems: 'center',
+        gap: '12px',
+        marginBottom: '20px'
+      }}>
+        <span style={{ fontSize: '32px' }}>
+          {getOperationIcon(data.operation)}
+        </span>
+        <div>
+          <h3 style={{ margin: 0, fontSize: '18px', opacity: 0.9 }}>
+            Calculator Result
+          </h3>
+          <p style={{ margin: '4px 0 0 0', fontSize: '14px', opacity: 0.7 }}>
+            {data.operation.charAt(0).toUpperCase() + data.operation.slice(1)}
+          </p>
+        </div>
+      </div>
+      <div style={{
+        background: 'rgba(255, 255, 255, 0.15)',
+        borderRadius: '12px',
+        padding: '20px',
+        backdropFilter: 'blur(10px)',
+        marginBottom: '16px'
+      }}>
+        <div style={{
+          fontSize: '28px',
+          fontWeight: 'bold',
+          textAlign: 'center',
+          marginBottom: '12px',
+          fontFamily: 'monospace'
+        }}>
+          {data.expression}
+        </div>
+        <div style={{
+          display: 'flex',
+          justifyContent: 'space-around',
+          fontSize: '14px',
+          opacity: 0.9,
+          marginTop: '16px'
+        }}>
+          <div style={{ textAlign: 'center' }}>
+            <div style={{ fontSize: '12px', opacity: 0.7 }}>First</div>
+            <div style={{ fontWeight: 'bold', fontSize: '20px' }}>{data.a}</div>
+          </div>
+          <div style={{ textAlign: 'center' }}>
+            <div style={{ fontSize: '12px', opacity: 0.7 }}>Second</div>
+            <div style={{ fontWeight: 'bold', fontSize: '20px' }}>{data.b}</div>
+          </div>
+          <div style={{ textAlign: 'center' }}>
+            <div style={{ fontSize: '12px', opacity: 0.7 }}>Result</div>
+            <div style={{
+              fontWeight: 'bold',
+              fontSize: '24px',
+              color: '#fbbf24'
+            }}>
+              {data.result}
+            </div>
+          </div>
+        </div>
+      </div>
+      <div style={{
+        fontSize: '12px',
+        textAlign: 'center',
+        opacity: 0.7
+      }}>
+        ✨ NitroStack Calculator
+      </div>
+    </div>
+  );
+}
+export default withToolData(CalculatorResult);

package/templates/typescript-oauth/src/widgets/app/layout.tsx ADDED Viewed

@@ -0,0 +1,14 @@
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body style={{ margin: 0, padding: 0, fontFamily: 'system-ui, sans-serif' }}>
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/typescript-oauth/src/widgets/next.config.js ADDED Viewed

@@ -0,0 +1,37 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  transpilePackages: ['nitrostack'],
+  // Development optimizations to prevent cache corruption
+  ...(process.env.NODE_ENV === 'development' && {
+    // Use memory cache instead of filesystem cache in dev to avoid stale chunks
+    webpack: (config, { isServer }) => {
+      // Disable persistent caching in development to prevent chunk reference errors
+      if (config.cache && config.cache.type === 'filesystem') {
+        config.cache = {
+          type: 'memory',
+        };
+      }
+      // Improve cache busting for new files
+      if (!isServer) {
+        config.cache = false; // Disable cache completely on client in dev
+      }
+      return config;
+    },
+    // Disable build activity indicator which can cause issues
+    devIndicators: {
+      buildActivity: false,
+      buildActivityPosition: 'bottom-right',
+    },
+    // Faster dev server
+    compress: false,
+  }),
+};
+export default nextConfig;

package/templates/typescript-oauth/src/widgets/package.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "name": "calculator-widgets",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "next dev -p 3001",
+    "build": "next build",
+    "start": "next start -p 3001"
+  },
+  "dependencies": {
+    "next": "^14.2.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "nitrostack": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "@types/react": "^18",
+    "@types/react-dom": "^18",
+    "typescript": "^5"
+  }
+}

package/templates/typescript-oauth/src/widgets/tsconfig.json ADDED Viewed

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/typescript-oauth/src/widgets/widget-manifest.json ADDED Viewed

@@ -0,0 +1,48 @@
+{
+  "version": "1.0.0",
+  "widgets": [
+    {
+      "uri": "/calculator-result",
+      "name": "Calculator Result",
+      "description": "Displays the result of a calculation with operation details",
+      "examples": [
+        {
+          "name": "Addition Example",
+          "description": "Shows the result of adding 5 + 3",
+          "data": {
+            "operation": "add",
+            "a": 5,
+            "b": 3,
+            "result": 8,
+            "expression": "5 + 3 = 8"
+          }
+        },
+        {
+          "name": "Multiplication Example",
+          "description": "Shows the result of multiplying 6 × 7",
+          "data": {
+            "operation": "multiply",
+            "a": 6,
+            "b": 7,
+            "result": 42,
+            "expression": "6 × 7 = 42"
+          }
+        },
+        {
+          "name": "Division Example",
+          "description": "Shows the result of dividing 20 ÷ 4",
+          "data": {
+            "operation": "divide",
+            "a": 20,
+            "b": 4,
+            "result": 5,
+            "expression": "20 ÷ 4 = 5"
+          }
+        }
+      ],
+      "tags": ["calculator", "math", "result"]
+    }
+  ],
+  "generatedAt": "2025-01-01T00:00:00.000Z"
+}

package/templates/typescript-oauth/tsconfig.json ADDED Viewed

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "src/widgets"]
+}

package/templates/typescript-starter/.env.example ADDED Viewed

@@ -0,0 +1,4 @@
+# Server Configuration
+NODE_ENV=development
+PORT=3000

package/templates/typescript-starter/src/app.module.ts ADDED Viewed

@@ -0,0 +1,34 @@
+import { McpApp, Module, ConfigModule } from 'nitrostack';
+import { CalculatorModule } from './modules/calculator/calculator.module.js';
+import { SystemHealthCheck } from './health/system.health.js';
+/**
+ * Root Application Module
+ *
+ * This is the main module that bootstraps the MCP server.
+ * It registers all feature modules and health checks.
+ */
+@McpApp({
+  module: AppModule,
+  server: {
+    name: 'calculator-server',
+    version: '1.0.0'
+  },
+  logging: {
+    level: 'info'
+  }
+})
+@Module({
+  name: 'app',
+  description: 'Root application module',
+  imports: [
+    ConfigModule.forRoot(),
+    CalculatorModule
+  ],
+  providers: [
+    // Health Checks
+    SystemHealthCheck,
+  ]
+})
+export class AppModule {}

package/templates/typescript-starter/src/health/system.health.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import { HealthCheck, HealthCheckInterface, HealthCheckResult } from 'nitrostack';
+/**
+ * System Health Check
+ *
+ * Monitors system resources and uptime
+ */
+@HealthCheck({
+  name: 'system',
+  description: 'System resource and uptime check',
+  interval: 30 // Check every 30 seconds
+})
+export class SystemHealthCheck implements HealthCheckInterface {
+  private startTime: number;
+  constructor() {
+    this.startTime = Date.now();
+  }
+  async check(): Promise<HealthCheckResult> {
+    try {
+      const memoryUsage = process.memoryUsage();
+      const uptime = Date.now() - this.startTime;
+      const uptimeSeconds = Math.floor(uptime / 1000);
+      // Convert memory to MB
+      const memoryUsedMB = Math.round(memoryUsage.heapUsed / 1024 / 1024);
+      const memoryTotalMB = Math.round(memoryUsage.heapTotal / 1024 / 1024);
+      // Consider unhealthy if memory usage is > 90%
+      const memoryPercent = (memoryUsage.heapUsed / memoryUsage.heapTotal) * 100;
+      const isHealthy = memoryPercent < 90;
+      return {
+        status: isHealthy ? 'up' : 'degraded',
+        message: isHealthy
+          ? 'System is healthy'
+          : 'High memory usage detected',
+        details: {
+          uptime: `${uptimeSeconds}s`,
+          memory: `${memoryUsedMB}MB / ${memoryTotalMB}MB (${Math.round(memoryPercent)}%)`,
+          pid: process.pid,
+          nodeVersion: process.version,
+        },
+      };
+    } catch (error: any) {
+      return {
+        status: 'down',
+        message: 'System health check failed',
+        details: error.message,
+      };
+    }
+  }
+}

package/templates/typescript-starter/src/index.ts ADDED Viewed

@@ -0,0 +1,27 @@
+/**
+ * Calculator MCP Server
+ *
+ * Main entry point for the MCP server.
+ * Uses the @McpApp decorator pattern for clean, NestJS-style architecture.
+ */
+import { McpApplicationFactory } from 'nitrostack';
+import { AppModule } from './app.module.js';
+/**
+ * Bootstrap the application
+ */
+async function bootstrap() {
+  // Create and start the MCP server from AppModule
+  const server = await McpApplicationFactory.create(AppModule);
+  // Start the server
+  await server.start();
+}
+// Start the application
+bootstrap().catch((error) => {
+  console.error('❌ Failed to start server:', error);
+  process.exit(1);
+});

package/templates/typescript-starter/src/modules/calculator/calculator.module.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { Module } from 'nitrostack';
+import { CalculatorTools } from './calculator.tools.js';
+import { CalculatorResources } from './calculator.resources.js';
+import { CalculatorPrompts } from './calculator.prompts.js';
+@Module({
+  name: 'calculator',
+  description: 'Basic arithmetic calculator',
+  controllers: [CalculatorTools, CalculatorResources, CalculatorPrompts]
+})
+export class CalculatorModule {}

package/templates/typescript-starter/src/modules/calculator/calculator.prompts.ts ADDED Viewed

@@ -0,0 +1,73 @@
+import { PromptDecorator as Prompt, ExecutionContext } from 'nitrostack';
+export class CalculatorPrompts {
+  @Prompt({
+    name: 'calculator_help',
+    description: 'Get help with calculator operations',
+    arguments: [
+      {
+        name: 'operation',
+        description: 'The operation to get help with (optional)',
+        required: false
+      }
+    ]
+  })
+  async getHelp(args: any, ctx: ExecutionContext) {
+    ctx.logger.info('Generating calculator help prompt');
+    const operation = args.operation;
+    if (operation) {
+      // Help for specific operation
+      const helpText = this.getOperationHelp(operation);
+      return [
+        {
+          role: 'user' as const,
+          content: `How do I use the ${operation} operation in the calculator?`
+        },
+        {
+          role: 'assistant' as const,
+          content: helpText
+        }
+      ];
+    }
+    // General help
+    return [
+      {
+        role: 'user' as const,
+        content: 'How do I use the calculator?'
+      },
+      {
+        role: 'assistant' as const,
+        content: `The calculator supports four basic operations:
+1. **Addition** - Add two numbers together
+   Example: calculate(operation="add", a=5, b=3) = 8
+2. **Subtraction** - Subtract one number from another
+   Example: calculate(operation="subtract", a=10, b=4) = 6
+3. **Multiplication** - Multiply two numbers
+   Example: calculate(operation="multiply", a=6, b=7) = 42
+4. **Division** - Divide one number by another
+   Example: calculate(operation="divide", a=20, b=5) = 4
+Just call the 'calculate' tool with the operation and two numbers!`
+      }
+    ];
+  }
+  private getOperationHelp(operation: string): string {
+    const helps: Record<string, string> = {
+      add: 'Use addition to sum two numbers. Call calculate(operation="add", a=5, b=3) to get 8.',
+      subtract: 'Use subtraction to find the difference. Call calculate(operation="subtract", a=10, b=4) to get 6.',
+      multiply: 'Use multiplication to find the product. Call calculate(operation="multiply", a=6, b=7) to get 42.',
+      divide: 'Use division to find the quotient. Call calculate(operation="divide", a=20, b=5) to get 4. Note: Cannot divide by zero!'
+    };
+    return helps[operation] || 'Unknown operation. Available operations: add, subtract, multiply, divide.';
+  }
+}

package/templates/typescript-starter/src/modules/calculator/calculator.resources.ts ADDED Viewed

@@ -0,0 +1,60 @@
+import { ResourceDecorator as Resource, Widget, ExecutionContext } from 'nitrostack';
+export class CalculatorResources {
+  @Resource({
+    uri: 'calculator://operations',
+    name: 'Calculator Operations',
+    description: 'List of available calculator operations',
+    mimeType: 'application/json',
+    examples: {
+      response: {
+        operations: [
+          { name: 'add', symbol: '+', description: 'Addition' },
+          { name: 'subtract', symbol: '-', description: 'Subtraction' },
+          { name: 'multiply', symbol: '×', description: 'Multiplication' },
+          { name: 'divide', symbol: '÷', description: 'Division' }
+        ]
+      }
+    }
+  })
+  @Widget('calculator-operations')
+  async getOperations(uri: string, ctx: ExecutionContext) {
+    ctx.logger.info('Fetching calculator operations');
+    const operations = [
+      {
+        name: 'add',
+        symbol: '+',
+        description: 'Addition',
+        example: '5 + 3 = 8'
+      },
+      {
+        name: 'subtract',
+        symbol: '-',
+        description: 'Subtraction',
+        example: '10 - 4 = 6'
+      },
+      {
+        name: 'multiply',
+        symbol: '×',
+        description: 'Multiplication',
+        example: '6 × 7 = 42'
+      },
+      {
+        name: 'divide',
+        symbol: '÷',
+        description: 'Division',
+        example: '20 ÷ 5 = 4'
+      }
+    ];
+    return {
+      contents: [{
+        uri,
+        mimeType: 'application/json',
+        text: JSON.stringify({ operations }, null, 2)
+      }]
+    };
+  }
+}

package/templates/typescript-starter/src/modules/calculator/calculator.tools.ts ADDED Viewed

@@ -0,0 +1,71 @@
+import { ToolDecorator as Tool, Widget, ExecutionContext, z } from 'nitrostack';
+export class CalculatorTools {
+  @Tool({
+    name: 'calculate',
+    description: 'Perform basic arithmetic calculations',
+    inputSchema: z.object({
+      operation: z.enum(['add', 'subtract', 'multiply', 'divide']).describe('The operation to perform'),
+      a: z.number().describe('First number'),
+      b: z.number().describe('Second number')
+    }),
+    examples: {
+      request: {
+        operation: 'add',
+        a: 5,
+        b: 3
+      },
+      response: {
+        operation: 'add',
+        a: 5,
+        b: 3,
+        result: 8,
+        expression: '5 + 3 = 8'
+      }
+    }
+  })
+  @Widget('calculator-result')
+  async calculate(input: any, ctx: ExecutionContext) {
+    ctx.logger.info('Performing calculation', {
+      operation: input.operation,
+      a: input.a,
+      b: input.b
+    });
+    let result: number;
+    let symbol: string;
+    switch (input.operation) {
+      case 'add':
+        result = input.a + input.b;
+        symbol = '+';
+        break;
+      case 'subtract':
+        result = input.a - input.b;
+        symbol = '-';
+        break;
+      case 'multiply':
+        result = input.a * input.b;
+        symbol = '×';
+        break;
+      case 'divide':
+        if (input.b === 0) {
+          throw new Error('Cannot divide by zero');
+        }
+        result = input.a / input.b;
+        symbol = '÷';
+        break;
+      default:
+        throw new Error('Invalid operation');
+    }
+    return {
+      operation: input.operation,
+      a: input.a,
+      b: input.b,
+      result,
+      expression: `${input.a} ${symbol} ${input.b} = ${result}`
+    };
+  }
+}