From b76e2ff898b23745d4c9aaee49eeb7d88f2896ab Mon Sep 17 00:00:00 2001
From: Carson Fleming <cflems@cflems.net>
Date: Thu, 2 Mar 2017 22:49:24 -0500
Subject: Updated mailgun plugin

---
 inc/mailgun/php-http/promise/src/Promise.php | 69 ++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 inc/mailgun/php-http/promise/src/Promise.php

(limited to 'inc/mailgun/php-http/promise/src/Promise.php')

diff --git a/inc/mailgun/php-http/promise/src/Promise.php b/inc/mailgun/php-http/promise/src/Promise.php
new file mode 100644
index 0000000..e2cf5f8
--- /dev/null
+++ b/inc/mailgun/php-http/promise/src/Promise.php
@@ -0,0 +1,69 @@
+<?php
+
+namespace Http\Promise;
+
+/**
+ * Promise represents a value that may not be available yet, but will be resolved at some point in future.
+ * It acts like a proxy to the actual value.
+ *
+ * This interface is an extension of the promises/a+ specification.
+ *
+ * @see https://promisesaplus.com/
+ *
+ * @author Joel Wurtz <joel.wurtz@gmail.com>
+ * @author Márk Sági-Kazár <mark.sagikazar@gmail.com>
+ */
+interface Promise
+{
+    /**
+     * Promise has not been fulfilled or rejected.
+     */
+    const PENDING = 'pending';
+
+    /**
+     * Promise has been fulfilled.
+     */
+    const FULFILLED = 'fulfilled';
+
+    /**
+     * Promise has been rejected.
+     */
+    const REJECTED = 'rejected';
+
+    /**
+     * Adds behavior for when the promise is resolved or rejected (response will be available, or error happens).
+     *
+     * If you do not care about one of the cases, you can set the corresponding callable to null
+     * The callback will be called when the value arrived and never more than once.
+     *
+     * @param callable $onFulfilled Called when a response will be available.
+     * @param callable $onRejected  Called when an exception occurs.
+     *
+     * @return Promise A new resolved promise with value of the executed callback (onFulfilled / onRejected).
+     */
+    public function then(callable $onFulfilled = null, callable $onRejected = null);
+
+    /**
+     * Returns the state of the promise, one of PENDING, FULFILLED or REJECTED.
+     *
+     * @return string
+     */
+    public function getState();
+
+    /**
+     * Wait for the promise to be fulfilled or rejected.
+     *
+     * When this method returns, the request has been resolved and if callables have been
+     * specified, the appropriate one has terminated.
+     *
+     * When $unwrap is true (the default), the response is returned, or the exception thrown
+     * on failure. Otherwise, nothing is returned or thrown.
+     *
+     * @param bool $unwrap Whether to return resolved value / throw reason or not
+     *
+     * @return mixed Resolved value, null if $unwrap is set to false
+     *
+     * @throws \Exception The rejection reason if $unwrap is set to true and the request failed.
+     */
+    public function wait($unwrap = true);
+}
-- 
cgit v1.2.3