Quick Start

import { createApp, createRouter, errorHandler, listen } from 'nextrush';
import { cors } from '@nextrush/cors';
import { json } from '@nextrush/body-parser';
import { helmet } from '@nextrush/helmet';
import { config } from './config/index.js';
import { logger } from './middleware/logger.js';
import { healthRouter } from './routes/health.routes.js';

const router = createRouter();
const app = createApp({ router });

// Error handling (first middleware — catches all downstream errors)
app.use(errorHandler({ includeStack: config.nodeEnv !== 'production' }));

// Request logging
app.use(logger());

// Middleware
app.use(cors());
app.use(helmet());
app.use(json());

// Routes
router.get('/', (ctx) => {
  ctx.json({ message: 'Welcome to NextRush!' });
});

app.route('/health', healthRouter);

await listen(app, config.port);

import { BadRequestError, NotFoundError } from 'nextrush';
import type { TodoRepository } from '../repositories/todos.repository.js';

export function createTodoService(repository: TodoRepository) {
  return {
    get(id: string) {
      const todo = repository.findById(id);
      if (!todo) throw new NotFoundError('Todo not found');
      return todo;
    },
    // ...create, list, remove
  };
}

import { createApp, createRouter, listen } from 'nextrush';
import { registerModule } from 'nextrush/class';
import { AppModule } from './app.module.js';

const router = createRouter();
const app = createApp({ router });

// Wire the root module — registers the whole module graph in one call
await registerModule(app, AppModule, { prefix: '/api' });

await listen(app, PORT);

import { Controller, Get } from 'nextrush/class';
import { HealthService } from './health.service.js';

@Controller('/health')
export class HealthController {
  constructor(private readonly health: HealthService) {}

  @Get()
  check() {
    return this.health.getHealth();
  }
}