Echo Service

An HTTP echo service that mirrors back request details. Available as a Docker image for containerized deployment, as well as an NPM package for both CLI usage and library integration.

⭐ Quick Start

# Using Docker
docker run -p 3000:3000 junjiewu0/echo-service

# Using NPM (with CLI)
npx @junjie-wu/echo-service

# Using NPM (as library)
npm install @junjie-wu/echo-service

📚 Usage

🐳 Docker

# Using Pre-built Image
docker pull junjiewu0/echo-service
docker run -p 3000:3000 junjiewu0/echo-service

# Using Docker Compose
docker compose up -d

# Building Locally
docker build -t echo-service .
docker run -p 3000:3000 echo-service

📦 NPM Package

CLI Usage

npx @junjie-wu/echo-service --port 3000

Library Integration

import { createServer } from '@junjie-wu/echo-service';
const server = createServer(3000);

🧪 Test the Service

# Check service health
http://localhost:3000/health

# Echo back request details
http://localhost:3000/echo

# Supports all HTTP methods and parameters
http://localhost:3000/echo?name=test

📋 Examples

For complete working examples of all usage methods, check out the examples directory:

git clone https://github.com/junjie-w/echo-service.git
cd echo-service/examples

# Try different examples
npm install
npm run start:docker     # Docker usage
npm run start:cli        # CLI usage
npm run start:lib        # Library usage

⚡ API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | Service info | | /health | GET | Health check | | /echo | ALL | Request mirror |

🛠️ Development

Setup

1. Clone the repository:

git clone https://github.com/junjie-w/echo-service.git
cd echo-service

2. Install dependencies:

npm install

Commit Convention

This project follows Conventional Commits:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Types: feat, fix, docs, style, refactor, test, chore

🤝 Contributing

Contributions, issues, and feature requests are welcome. Feel free to check issues page.

🚀 Distribution

• Docker Hub: junjiewu0/echo-service
• NPM Registry: @junjie-wu/echo-service

📄 License

MIT