Initial Commit

dependencies/stripe/stripe-php/lib/Util/RequestOptions.php

@@ -0,0 +1,137 @@
+<?php
+
+namespace WP_Ultimo\Dependencies\Stripe\Util;
+
+class RequestOptions
+{
+    /**
+     * @var array<string> a list of headers that should be persisted across requests
+     */
+    public static $HEADERS_TO_PERSIST = ['Stripe-Account', 'Stripe-Version'];
+    /** @var array<string, string> */
+    public $headers;
+    /** @var null|string */
+    public $apiKey;
+    /** @var null|string */
+    public $apiBase;
+    /**
+     * @param null|string $key
+     * @param array<string, string> $headers
+     * @param null|string $base
+     */
+    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 null|array|RequestOptions|string $options a key => value array
+     * @param bool $strict when true, forbid string form and arbitrary keys in array form
+     *
+     * @return RequestOptions
+     */
+    public function merge($options, $strict = \false)
+    {
+        $other_options = self::parse($options, $strict);
+        if (null === $other_options->apiKey) {
+            $other_options->apiKey = $this->apiKey;
+        }
+        if (null === $other_options->apiBase) {
+            $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, \true)) {
+                unset($this->headers[$k]);
+            }
+        }
+    }
+    /**
+     * Unpacks an options array into an RequestOptions object.
+     *
+     * @param null|array|RequestOptions|string $options a key => value array
+     * @param bool $strict when true, forbid string form and arbitrary keys in array form
+     *
+     * @throws \Stripe\Exception\InvalidArgumentException
+     *
+     * @return RequestOptions
+     */
+    public static function parse($options, $strict = \false)
+    {
+        if ($options instanceof self) {
+            return clone $options;
+        }
+        if (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 \WP_Ultimo\Dependencies\Stripe\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('stripe_account', $options)) {
+                $headers['Stripe-Account'] = $options['stripe_account'];
+                unset($options['stripe_account']);
+            }
+            if (\array_key_exists('stripe_version', $options)) {
+                $headers['Stripe-Version'] = $options['stripe_version'];
+                unset($options['stripe_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 \WP_Ultimo\Dependencies\Stripe\Exception\InvalidArgumentException($message);
+            }
+            return new RequestOptions($key, $headers, $base);
+        }
+        $message = 'The second argument to Stripe 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 "Stripe::setApiKey(<apiKey>)")';
+        throw new \WP_Ultimo\Dependencies\Stripe\Exception\InvalidArgumentException($message);
+    }
+    /** @return string */
+    private function redactedApiKey()
+    {
+        if (null === $this->apiKey) {
+            return '';
+        }
+        $pieces = \explode('_', $this->apiKey, 3);
+        $last = \array_pop($pieces);
+        $redactedLast = \strlen($last) > 4 ? \str_repeat('*', \strlen($last) - 4) . \substr($last, -4) : $last;
+        $pieces[] = $redactedLast;
+        return \implode('_', $pieces);
+    }
+}