Update EventSub Documentation and fix non-existent type

[ghostzero]

Hey, I have revised the documentation a bit, so that everyone can understand how to use the EventSub.

Also I fixed a type. There had been a typo in it. It should be channel.follow instead of user.follow.

[ghostzero]

I also added a fix for the EventSubSignature class. The timestamp header provided by Twitch has a special date format Y-m-d\TH:i:s.u\Z. I correct this, but cannot validate this with the real api, since Twitch has a Bug. Currently chatting with PooPooKitty from Twitch to verify the right time format.

[ghostzero]

I resolved this. Twitch switched to nanoseconds. Thanks to Dkamps18, he provied a regex for the datetime parser.

[romanzipp]

I don't feel comfortable with that much hacky regex in the getTimestamp method. Could you show an example payload you receive from twitch including the timestamps?

[ghostzero]

The header looks like this:

{
    "host":["redacted.ngrok.io"],
    "user-agent":["Go-http-client\/1.1"],
    "content-length":["389"],
    "accept-encoding":["gzip"],
    "content-type":["application\/json"],
    "twitch-eventsub-message-id":["6b38997e-eed1-4162-b36f-redacted"],
    "twitch-eventsub-message-retry":["0"],
    "twitch-eventsub-message-signature":["sha256=09803813bd4163ad66e05413c8296d65b3f28ba58b164acc08290eaad57c1ac4"],
    "twitch-eventsub-message-timestamp":["2021-02-05T20:07:58.288209337Z"],
    "twitch-eventsub-message-type":["webhook_callback_verification"],
    "twitch-eventsub-subscription-type":["channel.follow"],
    "twitch-eventsub-subscription-version":["1"],
    "x-forwarded-for":["redacted"],
    "x-forwarded-proto":["https"]
}

[romanzipp]

Wow this is insane. I don't see any reason whatsoever to use a non-standard date format...

Anyways how about a more flexible expression like /^(?<pre>[\d\-:.T]+)\.(?<nano>\d{6,9})Z$/? (Regex 101 playground)

We would receive the following named matching groups

  "pre" => "2021-02-05T20:07:58"
  "nano" => "288209337"

preg_match('/^(?<pre>[\d\-:.T]+)\.(?<nano>\d{6,9})Z$/', $timestamp, $matches);

Carbon::createFromFormat(
    'Y-m-d\TH:i:s.u\Z',
    sprintf('%s.%dZ', $matches['pre'], substr($matches['nano'], 0, 6))
)

[ghostzero]

They use RFC3339Nano in go lang.
This Regex looks more clear 👍

[Xety]

Any news on this PR ?

[ghostzero]

Yes, i updated the regex, as requested. Hope this will be merged soon :)

[ghostzero]

I now deploy this branch to Production and subscribe to 2.2 million webhooks. Let's see :D

[romanzipp]

Alright, looks good! Could you at least squash the latest commits to remove the merge commit? I'd like to keep the history clean 😄

[ghostzero]

@romanzipp can you check it again. 🙏