@jaypie/express

Express.js handlers, CORS, and route utilities.

Overview

@jaypie/express provides Express.js integration for the Jaypie library, including:

• Express handler wrapper with lifecycle management
• CORS configuration
• Route utilities
• Request/response helpers

Installation

npm install @jaypie/express

Key Features

Express Handler

Wraps Express.js routes with Jaypie’s handler lifecycle:

import { expressHandler } from "@jaypie/express";

app.get("/api/users", expressHandler(async (req, res) => {
  // Handler logic
  return { users: [] };
}));

Lifecycle Phases

The expressHandler extends the base handler lifecycle with an additional locals phase:

1. Validate - Request validation
2. Locals - Populate req.locals with static values or function results
3. Setup - Resource initialization
4. Handler - Business logic
5. Teardown - Cleanup (always runs)

CORS Support

Built-in CORS configuration for Express applications.

Supertest Integration

Supports testing mode for use with supertest:

import { mock } from "@jaypie/testkit";
import request from "supertest";

const app = mock.expressHandler(handler);
await request(app).get("/api/users").expect(200);

API Documentation

API documentation will be generated from TypeScript definitions.

Related Packages

• @jaypie/core - Core utilities
• @jaypie/lambda - AWS Lambda integration
• @jaypie/testkit - Testing utilities