Skip to main content

AWS EventBridge

Enterprise event system using AWS EventBridge for cloud-native event routing.

Installation​

import '@unchainedshop/plugins/events/aws-eventbridge';

Requires the AWS SDK as a peer dependency:

npm install @aws-sdk/client-eventbridge
Explicit Configuration Required

Unlike the Node.js event emitter (which is the default), this plugin requires explicit configuration. You must call setEmitAdapter() to activate EventBridge as your event system:

import { setEmitAdapter } from '@unchainedshop/events';
import { EventBridgeEventEmitter } from '@unchainedshop/plugins/events/aws-eventbridge';

const adapter = await EventBridgeEventEmitter({
  region: 'us-east-1',
  source: 'com.mycompany.unchained',
  busName: 'unchained-events',
});
setEmitAdapter(adapter);

Environment Variables​

VariableDefaultDescription
EVENT_BRIDGE_REGION-AWS region (required)
EVENT_BRIDGE_SOURCE-Event source identifier (required)
EVENT_BRIDGE_BUS_NAME-EventBridge custom bus name (required)
AWS_ACCESS_KEY_ID-AWS access key
AWS_SECRET_ACCESS_KEY-AWS secret key

Features​

  • Cloud Native: Fully managed AWS service
  • Event Routing: Advanced event routing and filtering
  • Integrations: Native integration with AWS services
  • Scalability: Automatic scaling and reliability
  • Event Replay: Built-in event replay capabilities
  • Schema Registry: Event schema management

Use Cases​

  • AWS Environments: Applications deployed on AWS
  • Enterprise Integration: Complex event routing requirements
  • External Integrations: Integration with AWS services and external systems
  • Event Sourcing: When you need event replay and auditing
  • Compliance: When you need audit trails and compliance features

AWS Setup​

1. Create EventBridge Custom Bus​

aws events create-event-bus --name "unchained-events"

2. Create IAM Policy​

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents",
        "events:List*",
        "events:Describe*"
      ],
      "Resource": "*"
    }
  ]
}

3. Configure Environment​

EVENT_BRIDGE_REGION=us-east-1
EVENT_BRIDGE_SOURCE=com.mycompany.unchained
EVENT_BRIDGE_BUS_NAME=unchained-events
AWS_ACCESS_KEY_ID=AKIA...
AWS_SECRET_ACCESS_KEY=...

Usage​

Publishing Events​

import { emit } from '@unchainedshop/events';

// Events are sent to EventBridge
await emit('ORDER_CREATE', {
  orderId: '12345',
  userId: 'user123',
  total: 99.99
});

Subscribing to Events​

EventBridge does not support direct subscription from the application. Use EventBridge rules to route events to:

  • Lambda functions
  • SQS queues
  • SNS topics
  • API Gateway endpoints
  • Other AWS services

Performance​

  • Pros: Fully managed, highly scalable, feature-rich
  • Cons: AWS dependency, higher cost, potential latency

When to Use​

Use AWS EventBridge for:

  • AWS-based deployments
  • Complex event routing needs
  • Integration with AWS services
  • Enterprise compliance requirements
  • Event sourcing and replay needs

Adapter Details​

PropertyValue
Sourceevents/aws-eventbridge.ts