TypeScript definitions

[antonvasin]

As mentioned in #126.

When writing I've used API.md as a reference.

Things I'm not sure about:

• MetadataContext seems to deserve stricter type than any
• Can context be nested? If so, then we should have some recursive type for it
• type and interface syntax. Some use both, some use only one, so those things can be very opinionated. Since the project itself is written in plain JS I've tried to write it “default” way
• Couldn't test this with require since we're not using it in TS projects at all

[vreynolds]

Thank you so much @antonvasin, this will definitely be appreciated!

I did my best to capture any discrepancies, combing through the code. As you can see, the docs are not super comprehensive, unfortunately.

Do you have bandwidth to address the changes?

[vreynolds]

Oh, as far as your questions:

• MetadataContext: I agree, it would be nice to nail down exactly the attribute types, but I think at this point, I'd rather err on the side of permissive/backwards-compatible way (aka any)
• nested context: I think I addressed that in the review comment, but let me know if you meant something else
• type and interface: LGTM
• I used require to import the beeline in my test TS service

[antonvasin]

Thanks for the feedback.

Do you have bandwidth to address the changes?

Sure, I'll look into them.

[DavidS]

see honeycombio/libhoney-js#90 for a similar effort.

[antonvasin]

I've updated this MR with comments above. Took me a while, sorry.

[vreynolds]

@antonvasin same here, took a while to come back to this. The changes look good to me 👍 Do you mind resolving the package conflict?