Bump DataTable from 2.3.3 to 2.3.4, TinyMCE 8.0.2 to 8.2.0, Stripe-PHP 17.6.0 to 18.1.0, PHPMailer from 6.10.0 to 7.0.0, chartjs from 4.5.0 to 4.5.1

plugins/stripe-php/lib/V2/Core/EventNotification.php

@@ -0,0 +1,131 @@
+<?php
+
+namespace Stripe\V2\Core;
+
+use Stripe\Events\UnknownEventNotification;
+use Stripe\Reason;
+use Stripe\RelatedObject;
+use Stripe\Util\EventNotificationTypes;
+
+/**
+ * EventNotification represents the json that's delivered from an Event Destination.
+ * It's a basic class with no additional methods or properties. Use it to check basic information about a delivered event.
+ * If you want more details, use `$stripeClient->v2->core->events->retrieve(thin_event.id)` to fetch the full event object.
+ *
+ * @property string             $id       Unique identifier for the event.
+ * @property string             $type     The type of the event.
+ * @property string             $created  Time at which the object was created.
+ * @property null|\Stripe\StripeContext        $context  Authentication context needed to fetch the event or related object.
+ * @property null|Reason $reason Reason for the event.
+ * @property bool $livemode Livemode indicates if the event is from a production(true) or test(false) account.
+ */
+abstract class EventNotification
+{
+    public $id;
+    public $type;
+    public $created;
+    public $context;
+    public $reason;
+    public $livemode;
+
+    protected $client;
+    // only available on children
+    protected $related_object;
+
+    /**
+     * @param array $json the raw json body
+     * @param \Stripe\StripeClient $client a StripeClient instance that this can use to make requests
+     */
+    public function __construct($json, $client)
+    {
+        $this->client = $client;
+
+        if (\array_key_exists('id', $json)) {
+            $this->id = $json['id'];
+        }
+        if (\array_key_exists('type', $json)) {
+            $this->type = $json['type'];
+        }
+        if (\array_key_exists('created', $json)) {
+            $this->created = $json['created'];
+        }
+        if (\array_key_exists('context', $json) && null !== $json['context']) {
+            $this->context = \Stripe\StripeContext::parse($json['context']);
+        }
+        if (\array_key_exists('livemode', $json)) {
+            $this->livemode = $json['livemode'];
+        }
+        if (\array_key_exists('related_object', $json)) {
+            $this->related_object = new RelatedObject($json['related_object']);
+        }
+        if (\array_key_exists('reason', $json)) {
+            $this->reason = new Reason($json['reason']);
+        }
+    }
+
+    /**
+     * Helper for constructing an Event Notification. Doesn't perform signature validation, so you
+     * should use \Stripe\BaseStripeClient#parseEventNotification instead for
+     * initial handling. This is useful in unit tests and working with EventNotifications that you've
+     * already validated the authenticity of.
+     *
+     * @param string $jsonStr the raw json payload
+     * @param \Stripe\StripeClient $client a StripeClient instance that this can use to make requests
+     *
+     * @return EventNotification
+     */
+    public static function fromJson($jsonStr, $client)
+    {
+        $json = json_decode($jsonStr, true);
+
+        $class = UnknownEventNotification::class;
+        $eventNotificationTypes = EventNotificationTypes::v2EventMapping;
+        if (\array_key_exists($json['type'], $eventNotificationTypes)) {
+            $class = $eventNotificationTypes[$json['type']];
+        }
+
+        return new $class($json, $client);
+    }
+
+    /**
+     * Retrieve the full Event from the Stripe API.
+     *
+     * @return Event
+     */
+    public function fetchEvent()
+    {
+        $response = $this->client->rawRequest(
+            'get',
+            "/v2/core/events/{$this->id}",
+            null,
+            ['stripe_context' => $this->context],
+            null,
+            ['fetch_event']
+        );
+
+        return $this->client->deserialize($response->body, 'v2');
+    }
+
+    protected function fetchRelatedObject()
+    {
+        if (null === $this->related_object) {
+            return null;
+        }
+
+        $options = [];
+        if (null !== $this->context) {
+            $options['stripe_context'] = $this->context;
+        }
+
+        $response = $this->client->rawRequest(
+            'get',
+            $this->related_object->url,
+            null,
+            $options,
+            null,
+            ['fetch_related_object']
+        );
+
+        return $this->client->deserialize($response->body, \Stripe\Util\Util::getApiMode($this->related_object->url));
+    }
+}