Examples

Explore practical examples of using amqp-contract.

Available Examples

Basic Order Processing

A complete example demonstrating:

• Contract definition with exchanges, queues, and bindings
• Type-safe message publishing
• Type-safe message consuming
• Multiple consumers (pub/sub pattern)

Technologies: RabbitMQ • TypeScript • Zod

Running Examples

All examples are in the examples/ directory.

Prerequisites

1. RabbitMQ running on localhost:5672

docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:4-management

2. Build packages (in repository root)

pnpm build

Run Basic Order Processing

# Terminal 1: Start the worker
pnpm --filter @amqp-contract-examples/basic-order-processing-worker dev

# Terminal 2: Run the client
pnpm --filter @amqp-contract-examples/basic-order-processing-client dev

Example Structure

The basic order processing example uses three packages:

examples/
├── basic-order-processing-contract/
│   └── src/index.ts       # Shared contract
├── basic-order-processing-client/
│   └── src/index.ts       # Publisher
└── basic-order-processing-worker/
    └── src/index.ts       # Consumer

This separation mirrors real-world microservices architecture.

Architecture Overview

Next Steps

• Try the Basic Order Processing example
• Read the Getting Started guide