@asterflow/request

Unified HTTP request adapter system for AsterFlow.

📦 Installation

npm install @asterflow/request
# or
bun install @asterflow/request

💡 About

@asterflow/request is an adapter system that provides a unified interface for handling HTTP requests across different runtimes (Bun, Express, Fastify, and Node.js) in the AsterFlow ecosystem. It standardizes access to request properties and methods, regardless of the runtime being used.

✨ Features

• Multiple Adapters: Support for Bun, Express, Fastify, and Node.js
• Unified Interface: Consistent API for request handling
• Type Safety: Full TypeScript support
• AsterFlow Integration: Designed to work seamlessly with the AsterFlow framework
• Body Handling: Support for different request body types
• Headers Management: Unified interface for header manipulation

🚀 Usage

Express Adapter

import { ExpressRequest } from '@asterflow/request'
import express from 'express'

const app = express()

app.use(async (req, res) => {
  const request = new ExpressRequest(req)
  
  // Unified access to request properties
  const body = await request.getBody()
  const headers = request.getHeaders()
  const method = request.getMethod()
  const pathname = request.getPathname()
})

Bun Adapter

import { BunRequest } from '@asterflow/request'

Bun.serve({
  async fetch(req) {
    const request = new BunRequest(req)
    
    // Same interface as other adapters
    const body = await request.getBody()
    const headers = request.getHeaders()
    const method = request.getMethod()
    const pathname = request.getPathname()
  }
})

Fastify Adapter

import { FastifyRequest } from '@asterflow/request'
import Fastify from 'fastify'

const app = Fastify()

app.all('*', async (req) => {
  const request = new FastifyRequest(req)
  
  // Consistent interface
  const body = await request.getBody()
  const headers = request.getHeaders()
  const method = request.getMethod()
  const pathname = request.getPathname()
})

Node.js Adapter

import { NodeRequest } from '@asterflow/request'
import { createServer } from 'http'

createServer(async (req, res) => {
  const request = new NodeRequest(req)
  
  // Same methods across all adapters
  const body = await request.getBody()
  const headers = request.getHeaders()
  const method = request.getMethod()
  const pathname = request.getPathname()
})

🔗 Related Packages

• asterflow - Core framework
• @asterflow/router - Type-safe routing system
• @asterflow/adapter - HTTP adapters for different runtimes
• @asterflow/response - Type-safe HTTP response system
• @asterflow/plugin - A modular and typed plugin system

📄 License

MIT - See LICENSE for more details.