FM / lib

/home/techb158/dev.balacoffee.com/vendor/stripe/stripe-php/lib/

/home/techb158/dev.balacoffee.com/vendor/stripe/stripe-php/lib

Name	Size	Mode	Actions
ApiOperations/	-	0755	rm
BillingPortal/	-	0755	rm
Checkout/	-	0755	rm
Exception/	-	0755	rm
FinancialConnections/	-	0755	rm
HttpClient/	-	0755	rm
Identity/	-	0755	rm
Issuing/	-	0755	rm
Radar/	-	0755	rm
Reporting/	-	0755	rm
Service/	-	0755	rm
Sigma/	-	0755	rm
Terminal/	-	0755	rm
TestHelpers/	-	0755	rm
Util/	-	0755	rm
Account.php	17025	0644	edit dl rm
AccountLink.php	830	0644	edit dl rm
AlipayAccount.php	2386	0644	edit dl rm
ApiRequestor.php	19141	0644	edit dl rm
ApiResource.php	3490	0644	edit dl rm
ApiResponse.php	712	0644	edit dl rm
ApplePayDomain.php	1016	0644	edit dl rm
ApplicationFee.php	4255	0644	edit dl rm
ApplicationFeeRefund.php	2503	0644	edit dl rm
Balance.php	2362	0644	edit dl rm
BalanceTransaction.php	5674	0644	edit dl rm
BankAccount.php	7298	0644	edit dl rm
BaseStripeClient.php	11436	0644	edit dl rm
BaseStripeClientInterface.php	990	0644	edit dl rm
BitcoinReceiver.php	4263	0644	edit dl rm
BitcoinTransaction.php	885	0644	edit dl rm
Capability.php	2992	0644	edit dl rm
Card.php	8754	0644	edit dl rm
CashBalance.php	2358	0644	edit dl rm
Charge.php	13220	0644	edit dl rm
Collection.php	8470	0644	edit dl rm
CountrySpec.php	1784	0644	edit dl rm
Coupon.php	2991	0644	edit dl rm
CreditNote.php	5837	0644	edit dl rm
CreditNoteLineItem.php	1897	0644	edit dl rm
Customer.php	15894	0644	edit dl rm
CustomerBalanceTransaction.php	5336	0644	edit dl rm
Discount.php	1570	0644	edit dl rm
Dispute.php	5195	0644	edit dl rm
EphemeralKey.php	1586	0644	edit dl rm
ErrorObject.php	8790	0644	edit dl rm
Event.php	15479	0644	edit dl rm
ExchangeRate.php	1446	0644	edit dl rm
File.php	3897	0644	edit dl rm
FileLink.php	1486	0644	edit dl rm
FundingInstructions.php	1413	0644	edit dl rm
Invoice.php	20614	0644	edit dl rm
InvoiceItem.php	3876	0644	edit dl rm
InvoiceLineItem.php	3011	0644	edit dl rm
LineItem.php	1192	0644	edit dl rm
LoginLink.php	426	0644	edit dl rm
Mandate.php	1104	0644	edit dl rm
OAuth.php	3393	0644	edit dl rm
OAuthErrorObject.php	861	0644	edit dl rm
Order.php	5260	0644	edit dl rm
OrderItem.php	333	0644	edit dl rm
OrderReturn.php	1689	0644	edit dl rm
PaymentIntent.php	13999	0644	edit dl rm
PaymentLink.php	4445	0644	edit dl rm
PaymentMethod.php	4047	0644	edit dl rm
Payout.php	6847	0644	edit dl rm
Person.php	5832	0644	edit dl rm
Plan.php	5689	0644	edit dl rm
Price.php	5740	0644	edit dl rm
Product.php	4757	0644	edit dl rm
PromotionCode.php	2253	0644	edit dl rm
Quote.php	9005	0644	edit dl rm
Recipient.php	2773	0644	edit dl rm
RecipientTransfer.php	918	0644	edit dl rm
Refund.php	4853	0644	edit dl rm
RequestTelemetry.php	539	0644	edit dl rm
Review.php	3425	0644	edit dl rm
SearchResult.php	6515	0644	edit dl rm
SetupAttempt.php	2449	0644	edit dl rm
SetupIntent.php	7729	0644	edit dl rm
ShippingRate.php	2391	0644	edit dl rm
SingletonApiResource.php	959	0644	edit dl rm
SKU.php	2786	0644	edit dl rm
Source.php	8573	0644	edit dl rm
SourceTransaction.php	408	0644	edit dl rm
Stripe.php	7221	0644	edit dl rm
StripeClient.php	4059	0644	edit dl rm
StripeClientInterface.php	586	0644	edit dl rm
StripeObject.php	19029	0644	edit dl rm
StripeStreamingClientInterface.php	238	0644	edit dl rm
Subscription.php	12154	0644	edit dl rm
SubscriptionItem.php	5641	0644	edit dl rm
SubscriptionSchedule.php	4166	0644	edit dl rm
TaxCode.php	668	0644	edit dl rm
TaxId.php	5298	0644	edit dl rm
TaxRate.php	3008	0644	edit dl rm
ThreeDSecure.php	2606	0644	edit dl rm
Token.php	3629	0644	edit dl rm
Topup.php	4003	0644	edit dl rm
Transfer.php	6381	0644	edit dl rm
TransferReversal.php	3323	0644	edit dl rm
UsageRecord.php	980	0644	edit dl rm
UsageRecordSummary.php	812	0644	edit dl rm
Webhook.php	1515	0644	edit dl rm
WebhookEndpoint.php	2311	0644	edit dl rm
WebhookSignature.php	4377	0644	edit dl rm

Edit: /home/techb158/dev.balacoffee.com/vendor/stripe/stripe-php/lib/StripeObject.php (19029B)

<?php

namespace Stripe;

/**
 * Class StripeObject.
 */
class StripeObject implements \ArrayAccess, \Countable, \JsonSerializable
{
    /** @var Util\RequestOptions */
    protected $_opts;

/** @var array */
    protected $_originalValues;

/** @var array */
    protected $_values;

/** @var Util\Set */
    protected $_unsavedValues;

/** @var Util\Set */
    protected $_transientValues;

/** @var null|array */
    protected $_retrieveOptions;

/** @var null|ApiResponse */
    protected $_lastResponse;

/**
     * @return Util\Set Attributes that should not be sent to the API because
     *    they're not updatable (e.g. ID).
     */
    public static function getPermanentAttributes()
    {
        static $permanentAttributes = null;
        if (null === $permanentAttributes) {
            $permanentAttributes = new Util\Set([
                'id',
            ]);
        }

return $permanentAttributes;
    }

/**
     * Additive objects are subobjects in the API that don't have the same
     * semantics as most subobjects, which are fully replaced when they're set.
     *
     * This is best illustrated by example. The `source` parameter sent when
     * updating a subscription is *not* additive; if we set it:
     *
     *     source[object]=card&source[number]=123
     *
     * We expect the old `source` object to have been overwritten completely. If
     * the previous source had an `address_state` key associated with it and we
     * didn't send one this time, that value of `address_state` is gone.
     *
     * By contrast, additive objects are those that will have new data added to
     * them while keeping any existing data in place. The only known case of its
     * use is for `metadata`, but it could in theory be more general. As an
     * example, say we have a `metadata` object that looks like this on the
     * server side:
     *
     *     metadata = ["old" => "old_value"]
     *
     * If we update the object with `metadata[new]=new_value`, the server side
     * object now has *both* fields:
     *
     *     metadata = ["old" => "old_value", "new" => "new_value"]
     *
     * This is okay in itself because usually users will want to treat it as
     * additive:
     *
     *     $obj->metadata["new"] = "new_value";
     *     $obj->save();
     *
     * However, in other cases, they may want to replace the entire existing
     * contents:
     *
     *     $obj->metadata = ["new" => "new_value"];
     *     $obj->save();
     *
     * This is where things get a little bit tricky because in order to clear
     * any old keys that may have existed, we actually have to send an explicit
     * empty string to the server. So the operation above would have to send
     * this form to get the intended behavior:
     *
     *     metadata[old]=&metadata[new]=new_value
     *
     * This method allows us to track which parameters are considered additive,
     * and lets us behave correctly where appropriate when serializing
     * parameters to be sent.
     *
     * @return Util\Set Set of additive parameters
     */
    public static function getAdditiveParams()
    {
        static $additiveParams = null;
        if (null === $additiveParams) {
            // Set `metadata` as additive so that when it's set directly we remember
            // to clear keys that may have been previously set by sending empty
            // values for them.
            //
            // It's possible that not every object has `metadata`, but having this
            // option set when there is no `metadata` field is not harmful.
            $additiveParams = new Util\Set([
                'metadata',
            ]);
        }

return $additiveParams;
    }

public function __construct($id = null, $opts = null)
    {
        list($id, $this->_retrieveOptions) = Util\Util::normalizeId($id);
        $this->_opts = Util\RequestOptions::parse($opts);
        $this->_originalValues = [];
        $this->_values = [];
        $this->_unsavedValues = new Util\Set();
        $this->_transientValues = new Util\Set();
        if (null !== $id) {
            $this->_values['id'] = $id;
        }
    }

// Standard accessor magic methods
    public function __set($k, $v)
    {
        if (static::getPermanentAttributes()->includes($k)) {
            throw new Exception\InvalidArgumentException(
                "Cannot set {$k} on this object. HINT: you can't set: " .
                \implode(', ', static::getPermanentAttributes()->toArray())
            );
        }

if ('' === $v) {
            throw new Exception\InvalidArgumentException(
                'You cannot set \'' . $k . '\'to an empty string. '
                . 'We interpret empty strings as NULL in requests. '
                . 'You may set obj->' . $k . ' = NULL to delete the property'
            );
        }

$this->_values[$k] = Util\Util::convertToStripeObject($v, $this->_opts);
        $this->dirtyValue($this->_values[$k]);
        $this->_unsavedValues->add($k);
    }

public function __isset($k)
    {
        return isset($this->_values[$k]);
    }

public function __unset($k)
    {
        unset($this->_values[$k]);
        $this->_transientValues->add($k);
        $this->_unsavedValues->discard($k);
    }

public function &__get($k)
    {
        // function should return a reference, using $nullval to return a reference to null
        $nullval = null;
        if (!empty($this->_values) && \array_key_exists($k, $this->_values)) {
            return $this->_values[$k];
        }
        if (!empty($this->_transientValues) && $this->_transientValues->includes($k)) {
            $class = static::class;
            $attrs = \implode(', ', \array_keys($this->_values));
            $message = "Stripe Notice: Undefined property of {$class} instance: {$k}. "
                    . "HINT: The {$k} attribute was set in the past, however. "
                    . 'It was then wiped when refreshing the object '
                    . "with the result returned by Stripe's API, "
                    . 'probably as a result of a save(). The attributes currently '
                    . "available on this object are: {$attrs}";
            Stripe::getLogger()->error($message);

return $nullval;
        }
        $class = static::class;
        Stripe::getLogger()->error("Stripe Notice: Undefined property of {$class} instance: {$k}");

return $nullval;
    }

// Magic method for var_dump output. Only works with PHP >= 5.6
    public function __debugInfo()
    {
        return $this->_values;
    }

// ArrayAccess methods
    #[\ReturnTypeWillChange]
    public function offsetSet($k, $v)
    {
        $this->{$k} = $v;
    }

#[\ReturnTypeWillChange]
    public function offsetExists($k)
    {
        return \array_key_exists($k, $this->_values);
    }

#[\ReturnTypeWillChange]
    public function offsetUnset($k)
    {
        unset($this->{$k});
    }

#[\ReturnTypeWillChange]
    public function offsetGet($k)
    {
        return \array_key_exists($k, $this->_values) ? $this->_values[$k] : null;
    }

/**
     * @return int
     */
    #[\ReturnTypeWillChange]
    public function count()
    {
        return \count($this->_values);
    }

public function keys()
    {
        return \array_keys($this->_values);
    }

public function values()
    {
        return \array_values($this->_values);
    }

/**
     * This unfortunately needs to be public to be used in Util\Util.
     *
     * @param array $values
     * @param null|array|string|Util\RequestOptions $opts
     *
     * @return static the object constructed from the given values
     */
    public static function constructFrom($values, $opts = null)
    {
        $obj = new static(isset($values['id']) ? $values['id'] : null);
        $obj->refreshFrom($values, $opts);

return $obj;
    }

/**
     * Refreshes this object using the provided values.
     *
     * @param array $values
     * @param null|array|string|Util\RequestOptions $opts
     * @param bool $partial defaults to false
     */
    public function refreshFrom($values, $opts, $partial = false)
    {
        $this->_opts = Util\RequestOptions::parse($opts);

$this->_originalValues = self::deepCopy($values);

if ($values instanceof StripeObject) {
            $values = $values->toArray();
        }

// Wipe old state before setting new.  This is useful for e.g. updating a
        // customer, where there is no persistent card parameter.  Mark those values
        // which don't persist as transient
        if ($partial) {
            $removed = new Util\Set();
        } else {
            $removed = new Util\Set(\array_diff(\array_keys($this->_values), \array_keys($values)));
        }

foreach ($removed->toArray() as $k) {
            unset($this->{$k});
        }

$this->updateAttributes($values, $opts, false);
        foreach ($values as $k => $v) {
            $this->_transientValues->discard($k);
            $this->_unsavedValues->discard($k);
        }
    }

/**
     * Mass assigns attributes on the model.
     *
     * @param array $values
     * @param null|array|string|Util\RequestOptions $opts
     * @param bool $dirty defaults to true
     */
    public function updateAttributes($values, $opts = null, $dirty = true)
    {
        foreach ($values as $k => $v) {
            // Special-case metadata to always be cast as a StripeObject
            // This is necessary in case metadata is empty, as PHP arrays do
            // not differentiate between lists and hashes, and we consider
            // empty arrays to be lists.
            if (('metadata' === $k) && (\is_array($v))) {
                $this->_values[$k] = StripeObject::constructFrom($v, $opts);
            } else {
                $this->_values[$k] = Util\Util::convertToStripeObject($v, $opts);
            }
            if ($dirty) {
                $this->dirtyValue($this->_values[$k]);
            }
            $this->_unsavedValues->add($k);
        }
    }

/**
     * @param bool $force defaults to false
     *
     * @return array a recursive mapping of attributes to values for this object,
     *    including the proper value for deleted attributes
     */
    public function serializeParameters($force = false)
    {
        $updateParams = [];

foreach ($this->_values as $k => $v) {
            // There are a few reasons that we may want to add in a parameter for
            // update:
            //
            //   1. The `$force` option has been set.
            //   2. We know that it was modified.
            //   3. Its value is a StripeObject. A StripeObject may contain modified
            //      values within in that its parent StripeObject doesn't know about.
            //
            $original = \array_key_exists($k, $this->_originalValues) ? $this->_originalValues[$k] : null;
            $unsaved = $this->_unsavedValues->includes($k);
            if ($force || $unsaved || $v instanceof StripeObject) {
                $updateParams[$k] = $this->serializeParamsValue(
                    $this->_values[$k],
                    $original,
                    $unsaved,
                    $force,
                    $k
                );
            }
        }

// a `null` that makes it out of `serializeParamsValue` signals an empty
        // value that we shouldn't appear in the serialized form of the object
        return \array_filter(
            $updateParams,
            function ($v) {
                return null !== $v;
            }
        );
    }

public function serializeParamsValue($value, $original, $unsaved, $force, $key = null)
    {
        // The logic here is that essentially any object embedded in another
        // object that had a `type` is actually an API resource of a different
        // type that's been included in the response. These other resources must
        // be updated from their proper endpoints, and therefore they are not
        // included when serializing even if they've been modified.
        //
        // There are _some_ known exceptions though.
        //
        // For example, if the value is unsaved (meaning the user has set it), and
        // it looks like the API resource is persisted with an ID, then we include
        // the object so that parameters are serialized with a reference to its
        // ID.
        //
        // Another example is that on save API calls it's sometimes desirable to
        // update a customer's default source by setting a new card (or other)
        // object with `->source=` and then saving the customer. The
        // `saveWithParent` flag to override the default behavior allows us to
        // handle these exceptions.
        //
        // We throw an error if a property was set explicitly but we can't do
        // anything with it because the integration is probably not working as the
        // user intended it to.
        if (null === $value) {
            return '';
        }
        if (($value instanceof ApiResource) && (!$value->saveWithParent)) {
            if (!$unsaved) {
                return null;
            }
            if (isset($value->id)) {
                return $value;
            }

throw new Exception\InvalidArgumentException(
                "Cannot save property `{$key}` containing an API resource of type " .
                    \get_class($value) . ". It doesn't appear to be persisted and is " .
                    'not marked as `saveWithParent`.'
            );
        }
        if (\is_array($value)) {
            if (Util\Util::isList($value)) {
                // Sequential array, i.e. a list
                $update = [];
                foreach ($value as $v) {
                    $update[] = $this->serializeParamsValue($v, null, true, $force);
                }
                // This prevents an array that's unchanged from being resent.
                if ($update !== $this->serializeParamsValue($original, null, true, $force, $key)) {
                    return $update;
                }
            } else {
                // Associative array, i.e. a map
                return Util\Util::convertToStripeObject($value, $this->_opts)->serializeParameters();
            }
        } elseif ($value instanceof StripeObject) {
            $update = $value->serializeParameters($force);
            if ($original && $unsaved && $key && static::getAdditiveParams()->includes($key)) {
                $update = \array_merge(self::emptyValues($original), $update);
            }

return $update;
        } else {
            return $value;
        }
    }

/**
     * @return mixed
     */
    #[\ReturnTypeWillChange]
    public function jsonSerialize()
    {
        return $this->toArray();
    }

/**
     * Returns an associative array with the key and values composing the
     * Stripe object.
     *
     * @return array the associative array
     */
    public function toArray()
    {
        $maybeToArray = function ($value) {
            if (null === $value) {
                return null;
            }

return \is_object($value) && \method_exists($value, 'toArray') ? $value->toArray() : $value;
        };

return \array_reduce(\array_keys($this->_values), function ($acc, $k) use ($maybeToArray) {
            if ('_' === \substr((string) $k, 0, 1)) {
                return $acc;
            }
            $v = $this->_values[$k];
            if (Util\Util::isList($v)) {
                $acc[$k] = \array_map($maybeToArray, $v);
            } else {
                $acc[$k] = $maybeToArray($v);
            }

return $acc;
        }, []);
    }

/**
     * Returns a pretty JSON representation of the Stripe object.
     *
     * @return string the JSON representation of the Stripe object
     */
    public function toJSON()
    {
        return \json_encode($this->toArray(), \JSON_PRETTY_PRINT);
    }

public function __toString()
    {
        $class = static::class;

return $class . ' JSON: ' . $this->toJSON();
    }

/**
     * Sets all keys within the StripeObject as unsaved so that they will be
     * included with an update when `serializeParameters` is called. This
     * method is also recursive, so any StripeObjects contained as values or
     * which are values in a tenant array are also marked as dirty.
     */
    public function dirty()
    {
        $this->_unsavedValues = new Util\Set(\array_keys($this->_values));
        foreach ($this->_values as $k => $v) {
            $this->dirtyValue($v);
        }
    }

protected function dirtyValue($value)
    {
        if (\is_array($value)) {
            foreach ($value as $v) {
                $this->dirtyValue($v);
            }
        } elseif ($value instanceof StripeObject) {
            $value->dirty();
        }
    }

/**
     * Produces a deep copy of the given object including support for arrays
     * and StripeObjects.
     *
     * @param mixed $obj
     */
    protected static function deepCopy($obj)
    {
        if (\is_array($obj)) {
            $copy = [];
            foreach ($obj as $k => $v) {
                $copy[$k] = self::deepCopy($v);
            }

return $copy;
        }
        if ($obj instanceof StripeObject) {
            return $obj::constructFrom(
                self::deepCopy($obj->_values),
                clone $obj->_opts
            );
        }

return $obj;
    }

/**
     * Returns a hash of empty values for all the values that are in the given
     * StripeObject.
     *
     * @param mixed $obj
     */
    public static function emptyValues($obj)
    {
        if (\is_array($obj)) {
            $values = $obj;
        } elseif ($obj instanceof StripeObject) {
            $values = $obj->_values;
        } else {
            throw new Exception\InvalidArgumentException(
                'empty_values got unexpected object type: ' . \get_class($obj)
            );
        }

return \array_fill_keys(\array_keys($values), '');
    }

/**
     * @return null|ApiResponse The last response from the Stripe API
     */
    public function getLastResponse()
    {
        return $this->_lastResponse;
    }

/**
     * Sets the last response from the Stripe API.
     *
     * @param ApiResponse $resp
     */
    public function setLastResponse($resp)
    {
        $this->_lastResponse = $resp;
    }

/**
     * Indicates whether or not the resource has been deleted on the server.
     * Note that some, but not all, resources can indicate whether they have
     * been deleted.
     *
     * @return bool whether the resource is deleted
     */
    public function isDeleted()
    {
        return isset($this->_values['deleted']) ? $this->_values['deleted'] : false;
    }
}

cmd: