new file mode 100644

@@ -0,0 +1,152 @@

+<?php

+

+namespace Telnyx\Util;

+

+use Telnyx\Exception;

+

+class RequestOptions

+{

+    /**

+     * @var array A list of headers that should be persisted across requests.

+     */

+    public static $HEADERS_TO_PERSIST = [

+        'Telnyx-Account',

+        'Telnyx-Version',

+    ];

+

+    public $headers;

+    public $apiKey;

+    public $apiBase;

+

+    public function __construct($key = null, $headers = [], $base = null)

+    {

+        $this->apiKey = $key;

+        $this->headers = $headers;

+        $this->apiBase = $base;

+    }

+

+    /**

+     * @return array<string, string>

+     */

+    public function __debugInfo()

+    {

+        return [

+            'apiKey' => $this->redactedApiKey(),

+            'headers' => $this->headers,

+            'apiBase' => $this->apiBase,

+        ];

+    }

+

+    /**

+     * Unpacks an options array and merges it into the existing RequestOptions

+     * object.

+     * @param array|string|null $options a key => value array

+     *

+     * @return RequestOptions

+     */

+    public function merge($options)

+    {

+        $other_options = self::parse($options);

+        if ($other_options->apiKey === null) {

+            $other_options->apiKey = $this->apiKey;

+        }

+        if ($other_options->apiBase === null) {

+            $other_options->apiBase = $this->apiBase;

+        }

+        $other_options->headers = array_merge($this->headers, $other_options->headers);

+        return $other_options;

+    }

+

+    /**

+     * Discards all headers that we don't want to persist across requests.

+     */

+    public function discardNonPersistentHeaders()

+    {

+        foreach ($this->headers as $k => $v) {

+            if (!in_array($k, self::$HEADERS_TO_PERSIST)) {

+                unset($this->headers[$k]);

+            }

+        }

+    }

+

+    /**

+     * Unpacks an options array into an RequestOptions object

+     * @param array|string|null $options a key => value array

+     *

+     * @return RequestOptions

+     */

+    public static function parse($options, $strict = false)

+    {

+        if ($options instanceof self) {

+            return $options;

+        }

+

+        if (is_null($options)) {

+            return new RequestOptions(null, [], null);

+        }

+

+        if (\is_string($options)) {

+            if ($strict) {

+                $message = 'Do not pass a string for request options. If you want to set the '

+                    . 'API key, pass an array like ["api_key" => <apiKey>] instead.';

+

+                throw new \Telnyx\Exception\InvalidArgumentException($message);

+            }

+

+            return new RequestOptions($options, [], null);

+        }

+

+        if (\is_array($options)) {

+            $headers = [];

+            $key = null;

+            $base = null;

+

+            if (\array_key_exists('api_key', $options)) {

+                $key = $options['api_key'];

+                unset($options['api_key']);

+            }

+            if (\array_key_exists('idempotency_key', $options)) {

+                $headers['Idempotency-Key'] = $options['idempotency_key'];

+                unset($options['idempotency_key']);

+            }

+            if (\array_key_exists('telnyx_account', $options)) {

+                $headers['Telnyx-Account'] = $options['telnyx_account'];

+                unset($options['telnyx_account']);

+            }

+            if (\array_key_exists('telnyx_version', $options)) {

+                $headers['Telnyx-Version'] = $options['telnyx_version'];

+                unset($options['telnyx_version']);

+            }

+            if (\array_key_exists('api_base', $options)) {

+                $base = $options['api_base'];

+                unset($options['api_base']);

+            }

+

+            if ($strict && !empty($options)) {

+                $message = 'Got unexpected keys in options array: ' . \implode(', ', \array_keys($options));

+

+                throw new \Telnyx\Exception\InvalidArgumentException($message);

+            }

+

+            return new RequestOptions($key, $headers, $base);

+        }

+

+        $message = 'The second argument to Telnyx API method calls is an '

+           . 'optional per-request apiKey, which must be a string, or '

+           . 'per-request options, which must be an array. (HINT: you can set '

+           . 'a global apiKey by "Telnyx::setApiKey(<apiKey>)")';

+        throw new \Telnyx\Exception\InvalidArgumentException($message);

+    }

+

+    private function redactedApiKey()

+    {

+        $pieces = \explode('_', $this->apiKey, 3);

+        $last = \array_pop($pieces);

+        $redactedLast = \strlen($last) > 4

+            ? (\str_repeat('*', \strlen($last) - 4) . \substr($last, -4))

+            : $last;

+        \array_push($pieces, $redactedLast);

+

+        return \implode('_', $pieces);

+    }

+}