[![Version](https://img.shields.io/npm/v/@meetup/lambda-xray?label=npm%20version)](https://www.npmjs.com/package/@meetup/lambda-xray)

## lambda-xray

`lambda-xray` is a library that provides a wrapper around `aws-xray-sdk-core` extending it with additional methods.
The goal is to use `lambda-xray` in place of the original `aws-xray-sdk-core`.

### Install

```bash
npm install @meetup/lambda-xray
```

### Use

```js
import { fetch, Response } from 'node-fetch';
import XRay from '@meetup/lambda-xray';

// Does everything(*) that 'aws-xray-sdk-core' can
const tracedHttps = XRay.captureHTTPs(require('https'));
tracedHttps.get('https://www.meetup.com');

// ...and something that 'aws-xray-sdk-core' can't
const tracedFetch = XRay.captureAsync('Fetch www.meetup.com', (): Promise<Response> => fetch('www.meetup.com'));
await tracedFetch();
```

\* `lambda-xray` provides all main tracing methods of `aws-xray-sdk-core`. If you didn't find the method you need
(but it exists in `aws-xray-sdk-core`), feel free to extend `aws-xray-sdk-core` [type definitions](@types/aws-xray-sdk-core/index.d.ts).

### Enjoy!

Made with :heart: by Member Payments team, and published by Comms Tools :heart:
