Typescript toolbox for AWS EventBridge
npm install typebridgeTypescript toolbox for AWS EventBridge
- Programmatical definition of your application events
- Typed publish and consume APIs
- Automatically batches putEvents call when publishing more than 10 events at a time
- Check for event payload size before publishing
npm i typebridge --save
> Typebridge v1 and above is meant to be used with AWS SDK v3. If you want to use Typebridge with AWS SDK v2, you should install v0 versions of this package npm i typebridge@^0
``ts
import { EventBridgeClient } from '@aws-sdk/client-eventbridge';
import { Bus, Event } from 'typebridge';
export const MyBus = new Bus({
name: 'applicationBus',
EventBridge: new EventBridgeClient({}),
});
export const MyEventPayloadSchema = {
type: 'object',
properties: {
stringAttribute: { type: 'string' },
numberAttribute: { type: 'integer' },
},
required: ['stringAttribute'],
additionalProperties: false
} as const;
export const MyEvent = new Event({
name: 'MyEvent',
bus: MyBus,
schema: MyEventPayloadSchema,
source: 'mySource'
});
`
`ts
import { MyEvent } from './events.ts';
export const handler = async (event) => {
await MyEvent.publish({
stringAttribute: 'string',
numberAttribute: 12,
})
return 'Event published !'
};
`
Typechecking is automatically enabled:
`ts`
await MyEvent.publish({
stringAttribute: 'string',
numberAttribute: 12,
// the following line will trigger a Typescript error
anotherAttribute: 'wrong'
})$3
`ts
import { MyBus, MyEvent } from './events.ts';
export const handler = async (event) => {
const events = event.details.map(detail => MyEvent.create({
stringAttribute: detail.stringAttribute,
numberAttribute: detail.numberAttribute,
})
await MyBus.put(events);
return 'Event published !'
};
`
Using the serverless framework with serverless.ts service file:
`ts
import type { Serverless } from 'serverless/aws';
const serverlessConfiguration: Serverless = {
service: 'typebridge-test',
provider: {
name: 'aws',
runtime: 'nodejs12.x',
},
functions: {
hello: {
handler: 'MyEventHandler.handler',
events: [
{
eventBridge: {
eventBus: 'applicationBus',
pattern: NewUserConnectedEvent.pattern,
},
},
],
}
}
}
module.exports = serverlessConfiguration;
`
`ts
import { PublishedEvent } from 'typebridge';
import { MyEvent } from './events.ts';
export const handler = (event: PublishedEvent
// Typed as string
return event.detail.stringAttribute;
}
`
Using middy middleware stack in your lambda's handler, you can throw an error before your handler's code being executed if the input event source or detail-type were not expected, or if the detail property does not satisfy the JSON-schema used in MyEvent constructor.
`ts
import middy from '@middy/core';
import jsonValidator from '@middy/validator';
import { MyEvent } from './events.ts';
const handler = (event) => {
return 'Validation succeeded';
};
// If event.detail does not match the JSON-schema supplied to MyEvent constructor, the middleware will throw an error
export const main = middy(handler).use(
jsonValidator({ inputSchema: MyEvent.publishedEventSchema }),
);
``