Nodejs Backend Typescript

{
  "name": "nodejs-backend",
  "version": "1.0.0",
  "category": "toolchain",
  "toolchain": "typescript",
  "framework": "nodejs",
  "tags": [
    "backend",
    "nodejs",
    "express",
    "fastify",
    "rest-api",
    "typescript",
    "jwt",
    "authentication",
    "database",
    "orm"
  ],
  "entry_point_tokens": 75,
  "full_tokens": 5576,
  "related_skills": [
    "../../typescript-core",
    "../../data/drizzle",
    "../../data/kysely",
    "../../data/prisma"
  ],
  "author": "Claude MPM",
  "license": "MIT",
  "description": "Comprehensive TypeScript backend development with Express and Fastify, covering routing, middleware, authentication, database integration, testing, and production deployment patterns."
}


---
name: nodejs-backend-typescript
description: "Node.js backend development with TypeScript, Express/Fastify servers, routing, middleware, and database integration"
user-invocable: false
disable-model-invocation: true
progressive_disclosure:
  entry_point:
    summary: "Node.js backend development with TypeScript, Express/Fastify servers, routing, middleware, and database integration"
    when_to_use: "When working with nodejs-backend-typescript or related functionality."
    quick_start: "1. Review the core concepts below. 2. Apply patterns to your use case. 3. Follow best practices for implementation."
---
# Node.js Backend Development with TypeScript

---
progressive_disclosure:
  entry_point:
    summary: "TypeScript backend patterns with Express/Fastify, routing, middleware, database integration"
    when_to_use:
      - "When building REST APIs with TypeScript"
      - "When creating Express/Fastify servers"
      - "When needing server-side TypeScript"
      - "When building microservices"
    quick_start:
      - "npm init -y && npm install -D typescript @types/node tsx"
      - "npm install express @types/express zod"
      - "Create tsconfig.json with strict mode"
      - "npm run dev"
  token_estimate:
    entry: 75
    full: 4700
---

## TypeScript Setup

### Essential Configuration

**tsconfig.json** (strict mode recommended):
```json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true,
    "types": ["node"]
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}
```

**package.json scripts**:
```json
{
  "scripts": {
    "dev": "tsx watch src/server.ts",
    "build": "tsc",
    "start": "node dist/server.js",
    "test": "vitest"
  }
}
```

### Development Dependencies
```bash
npm install -D typescript @types/node tsx vitest
npm install -D @types/express  # or @types/node (Fastify has built-in types)
```

## Express Patterns

### Basic Express Server

**src/server.ts**:
```typescript
import express, { Request, Response, NextFunction } from 'express';
import { z } from 'zod';

const app = express();
const port = process.env.PORT || 3000;

// Middleware
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// Type-safe request handlers
interface TypedRequest<T> extends Request {
  body: T;
}

// Routes
app.get('/health', (req: Request, res: Response) => {
  res.json({ status: 'ok', timestamp: new Date().toISOString() });
});

// Start server
app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});
```

### Router Pattern

**src/routes/users.ts**:
```typescript
import { Router } from 'express';
import { z } from 'zod';
import { validateRequest } from '../middleware/validation';

const router = Router();

const createUserSchema = z.object({
  email: z.string().email(),
  name: z.string().min(2),
  age: z.number().int().positive().optional(),
});

router.post(
  '/users',
  validateRequest(createUserSchema),
  async (req, res, next) => {
    try {
      const userData = req.body; //