allow vendord

vendor/google/gax/src/Middleware/CredentialsWrapperMiddleware.php

@@ -0,0 +1,67 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\Call;
+use Google\ApiCore\CredentialsWrapper;
+use Google\ApiCore\HeaderCredentialsInterface;
+
+/**
+* Middleware which adds a CredentialsWrapper object to the call options.
+*
+* @internal
+*/
+class CredentialsWrapperMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+
+    /** @var HeaderCredentialsInterface */
+    private HeaderCredentialsInterface  $credentialsWrapper;
+
+    public function __construct(
+        callable $nextHandler,
+        HeaderCredentialsInterface $credentialsWrapper
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->credentialsWrapper = $credentialsWrapper;
+    }
+
+    public function __invoke(Call $call, array $options)
+    {
+        $next = $this->nextHandler;
+        return $next(
+            $call,
+            $options + ['credentialsWrapper' => $this->credentialsWrapper]
+        );
+    }
+}

vendor/google/gax/src/Middleware/FixedHeaderMiddleware.php

@@ -0,0 +1,74 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\Call;
+
+/**
+ * Middleware to add fixed headers to an API call.
+ *
+ * @internal
+ */
+class FixedHeaderMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+    private array $headers;
+    private bool $overrideUserHeaders;
+
+    public function __construct(
+        callable $nextHandler,
+        array $headers,
+        bool $overrideUserHeaders = false
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->headers = $headers;
+        $this->overrideUserHeaders = $overrideUserHeaders;
+    }
+
+    public function __invoke(Call $call, array $options)
+    {
+        $userHeaders = $options['headers'] ?? [];
+        if ($this->overrideUserHeaders) {
+            $options['headers'] = $this->headers + $userHeaders;
+        } else {
+            $options['headers'] = $userHeaders + $this->headers;
+        }
+
+        $next = $this->nextHandler;
+        return $next(
+            $call,
+            $options
+        );
+    }
+}

vendor/google/gax/src/Middleware/MiddlewareInterface.php

@@ -0,0 +1,91 @@
+<?php
+/*
+ * Copyright 2023 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\BidiStream;
+use Google\ApiCore\Call;
+use Google\ApiCore\ClientStream;
+use Google\ApiCore\ServerStream;
+use GuzzleHttp\Promise\PromiseInterface;
+
+/**
+ * Middlewares must take a MiddlewareInterface as their first constructor
+ * argument {@see Google\ApiCore\Middleware\ResponseMetadataMiddleware}, which
+ * represents the next middleware in the chain. This next middleware MUST be
+ * invoked by this MiddlewareInterface, and the result must be returned as part
+ * of the `__invoke` method implementation.
+ *
+ * To create your own middleware, first implement the interface, as well as pass the handler
+ * in through the constructor:
+ *
+ * ```
+ * use Google\ApiCore\Call;
+ * use Google\ApiCore\Middleware\MiddlewareInterface;
+ *
+ * class MyTestMiddleware implements MiddlewareInterface
+ * {
+ *     public function __construct(MiddlewareInterface $handler)
+ *      {
+ *.         $this->handler = $handler;
+ *      }
+ *      public function __invoke(Call $call, array $options)
+ *      {
+ *          echo "Logging info about the call: " . $call->getMethod();
+ *          return ($this->handler)($call, $options);
+ *      }
+ * }
+ * ```
+ *
+ * Next, add the middleware to any class implementing `GapicClientTrait` by passing in a
+ * callable which returns the new middleware:
+ *
+ * ```
+ * $client = new ExampleGoogleApiServiceClient();
+ * $client->addMiddleware(function (MiddlewareInterface $handler) {
+ *     return new MyTestMiddleware($handler);
+ * });
+ * ```
+ */
+interface MiddlewareInterface
+{
+    /**
+     * Modify or observe the API call request and response.
+     * The returned value must include the result of the next MiddlewareInterface invocation in the
+     * chain.
+     *
+     * @param Call $call
+     * @param array $options
+     * @return PromiseInterface|ClientStream|ServerStream|BidiStream
+     */
+    public function __invoke(Call $call, array $options);
+}

vendor/google/gax/src/Middleware/OperationsMiddleware.php

@@ -0,0 +1,75 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\Call;
+use Google\ApiCore\OperationResponse;
+use Google\Protobuf\Internal\Message;
+
+/**
+ * Middleware which wraps the response in an OperationResponse object.
+ *
+ * @internal
+ */
+class OperationsMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+    private object $operationsClient;
+    private array $descriptor;
+
+    public function __construct(
+        callable $nextHandler,
+        $operationsClient,
+        array $descriptor
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->operationsClient = $operationsClient;
+        $this->descriptor = $descriptor;
+    }
+
+    public function __invoke(Call $call, array $options)
+    {
+        $next = $this->nextHandler;
+        return $next(
+            $call,
+            $options
+        )->then(function (Message $response) {
+            $options = $this->descriptor + [
+                'lastProtoResponse' => $response
+            ];
+            $operationNameMethod = $options['operationNameMethod'] ?? 'getName';
+            $operationName = call_user_func([$response, $operationNameMethod]);
+            return new OperationResponse($operationName, $this->operationsClient, $options);
+        });
+    }
+}

vendor/google/gax/src/Middleware/OptionsFilterMiddleware.php

@@ -0,0 +1,67 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\ArrayTrait;
+use Google\ApiCore\Call;
+
+/**
+* Middleware which filters the $options array.
+*
+* @internal
+*/
+class OptionsFilterMiddleware implements MiddlewareInterface
+{
+    use ArrayTrait;
+
+    /** @var callable */
+    private $nextHandler;
+    private array $permittedOptions;
+
+    public function __construct(
+        callable $nextHandler,
+        array $permittedOptions
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->permittedOptions = $permittedOptions;
+    }
+
+    public function __invoke(Call $call, array $options)
+    {
+        $next = $this->nextHandler;
+        $filteredOptions = $this->pluckArray($this->permittedOptions, $options);
+        return $next(
+            $call,
+            $filteredOptions
+        );
+    }
+}

vendor/google/gax/src/Middleware/PagedMiddleware.php

@@ -0,0 +1,80 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\Call;
+use Google\ApiCore\Page;
+use Google\ApiCore\PagedListResponse;
+use Google\ApiCore\PageStreamingDescriptor;
+use Google\Protobuf\Internal\Message;
+
+/**
+* Middleware which wraps the response in an PagedListResponses object.
+*
+* @internal
+*/
+class PagedMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+    private PageStreamingDescriptor $descriptor;
+
+    /**
+     * @param callable $nextHandler
+     * @param PageStreamingDescriptor $descriptor
+     */
+    public function __construct(
+        callable $nextHandler,
+        PageStreamingDescriptor $descriptor
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->descriptor = $descriptor;
+    }
+
+    public function __invoke(Call $call, array $options)
+    {
+        $next = $this->nextHandler;
+        $descriptor = $this->descriptor;
+        return $next($call, $options)->then(
+            function (Message $response) use ($call, $next, $options, $descriptor) {
+                $page = new Page(
+                    $call,
+                    $options,
+                    $next,
+                    $descriptor,
+                    $response
+                );
+                return new PagedListResponse($page);
+            }
+        );
+    }
+}

vendor/google/gax/src/Middleware/RequestAutoPopulationMiddleware.php

@@ -0,0 +1,104 @@
+<?php
+/*
+ * Copyright 2024 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\Api\FieldInfo\Format;
+use Google\ApiCore\Call;
+use GuzzleHttp\Promise\PromiseInterface;
+use Ramsey\Uuid\Uuid;
+
+/**
+ * Middleware that adds autopopulation functionality. This middlware is
+ * added iff auto population settings are present in the resource
+ * descriptor config for the rpc method in context.
+ *
+ * @internal
+ */
+class RequestAutoPopulationMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+
+    /** @var array<string, string> */
+    private $autoPopulationSettings;
+
+    public function __construct(
+        callable $nextHandler,
+        array $autoPopulationSettings
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->autoPopulationSettings = $autoPopulationSettings;
+    }
+
+    /**
+     * @param Call $call
+     * @param array $options
+     *
+     * @return PromiseInterface
+     */
+    public function __invoke(Call $call, array $options)
+    {
+        $next = $this->nextHandler;
+
+        if (empty($this->autoPopulationSettings)) {
+            return $next($call, $options);
+        }
+
+        $request = $call->getMessage();
+        foreach ($this->autoPopulationSettings as $fieldName => $valueType) {
+            $getFieldName = 'get' . ucwords($fieldName);
+            // We use a getter instead of a hazzer here because there's no need to
+            // differentiate between isset and an empty default value. Even if a
+            // field is explicitly set to an empty string, we want to autopopulate it.
+            if (empty($request->$getFieldName())) {
+                $setFieldName = 'set' . ucwords($fieldName);
+                switch ($valueType) {
+                    case Format::UUID4:
+                        $request->$setFieldName(Uuid::uuid4()->toString());
+                        break;
+                    default:
+                        throw new \UnexpectedValueException(sprintf(
+                            'Value type %s::%s not supported for auto population of the field %s',
+                            Format::class,
+                            Format::name($valueType),
+                            $fieldName
+                        ));
+                }
+            }
+        }
+        $call = $call->withMessage($request);
+        return $next(
+            $call,
+            $options
+        );
+    }
+}

vendor/google/gax/src/Middleware/ResponseMetadataMiddleware.php

@@ -0,0 +1,73 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\Call;
+use GuzzleHttp\Promise\Promise;
+use GuzzleHttp\Promise\PromiseInterface;
+
+/**
+ * Middleware which transforms $response into [$response, $metadata]
+ *
+ * @internal
+ */
+class ResponseMetadataMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+
+    /**
+     * @param callable $nextHandler
+     */
+    public function __construct(callable $nextHandler)
+    {
+        $this->nextHandler = $nextHandler;
+    }
+
+    public function __invoke(Call $call, array $options)
+    {
+        $metadataReceiver = new Promise();
+        $options['metadataCallback'] = function ($metadata) use ($metadataReceiver) {
+            $metadataReceiver->resolve($metadata);
+        };
+        $next = $this->nextHandler;
+        return $next($call, $options)->then(
+            function ($response) use ($metadataReceiver) {
+                if ($metadataReceiver->getState() === PromiseInterface::FULFILLED) {
+                    return [$response, $metadataReceiver->wait()];
+                } else {
+                    return [$response, []];
+                }
+            }
+        );
+    }
+}

vendor/google/gax/src/Middleware/RetryMiddleware.php

@@ -0,0 +1,201 @@
+<?php
+/*
+ * Copyright 2018 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\ApiException;
+use Google\ApiCore\ApiStatus;
+use Google\ApiCore\Call;
+use Google\ApiCore\RetrySettings;
+use GuzzleHttp\Promise\PromiseInterface;
+
+/**
+ * Middleware that adds retry functionality.
+ *
+ * @internal
+ */
+class RetryMiddleware implements MiddlewareInterface
+{
+    /** @var callable */
+    private $nextHandler;
+    private RetrySettings $retrySettings;
+    private ?float $deadlineMs;
+
+    /*
+     * The number of retries that have already been attempted.
+     * The original API call will have $retryAttempts set to 0.
+     */
+    private int $retryAttempts;
+
+    public function __construct(
+        callable $nextHandler,
+        RetrySettings $retrySettings,
+        $deadlineMs = null,
+        $retryAttempts = 0
+    ) {
+        $this->nextHandler = $nextHandler;
+        $this->retrySettings = $retrySettings;
+        $this->deadlineMs = $deadlineMs;
+        $this->retryAttempts = $retryAttempts;
+    }
+
+    /**
+     * @param Call $call
+     * @param array $options
+     *
+     * @return PromiseInterface
+     */
+    public function __invoke(Call $call, array $options)
+    {
+        $nextHandler = $this->nextHandler;
+
+        if (!isset($options['timeoutMillis'])) {
+            // default to "noRetriesRpcTimeoutMillis" when retries are disabled, otherwise use "initialRpcTimeoutMillis"
+            if (!$this->retrySettings->retriesEnabled() && $this->retrySettings->getNoRetriesRpcTimeoutMillis() > 0) {
+                $options['timeoutMillis'] = $this->retrySettings->getNoRetriesRpcTimeoutMillis();
+            } elseif ($this->retrySettings->getInitialRpcTimeoutMillis() > 0) {
+                $options['timeoutMillis'] = $this->retrySettings->getInitialRpcTimeoutMillis();
+            }
+        }
+
+        // Setting the retry attempt for logging
+        if ($this->retryAttempts > 0) {
+            $options['retryAttempt'] = $this->retryAttempts;
+        }
+
+        // Call the handler immediately if retry settings are disabled.
+        if (!$this->retrySettings->retriesEnabled()) {
+            return $nextHandler($call, $options);
+        }
+
+        return $nextHandler($call, $options)->then(null, function ($e) use ($call, $options) {
+            $retryFunction = $this->getRetryFunction();
+
+            // If the number of retries has surpassed the max allowed retries
+            // then throw the exception as we normally would.
+            // If the maxRetries is set to 0, then we don't check this condition.
+            if (0 !== $this->retrySettings->getMaxRetries()
+                && $this->retryAttempts >= $this->retrySettings->getMaxRetries()
+            ) {
+                throw $e;
+            }
+            // If the retry function returns false then throw the
+            // exception as we normally would.
+            if (!$retryFunction($e, $options)) {
+                throw $e;
+            }
+
+            // Retry function returned true, so we attempt another retry
+            return $this->retry($call, $options, $e->getStatus());
+        });
+    }
+
+    /**
+     * @param Call $call
+     * @param array $options
+     * @param string $status
+     *
+     * @return PromiseInterface
+     * @throws ApiException
+     */
+    private function retry(Call $call, array $options, string $status)
+    {
+        $delayMult = $this->retrySettings->getRetryDelayMultiplier();
+        $maxDelayMs = $this->retrySettings->getMaxRetryDelayMillis();
+        $timeoutMult = $this->retrySettings->getRpcTimeoutMultiplier();
+        $maxTimeoutMs = $this->retrySettings->getMaxRpcTimeoutMillis();
+        $totalTimeoutMs = $this->retrySettings->getTotalTimeoutMillis();
+
+        $delayMs = $this->retrySettings->getInitialRetryDelayMillis();
+        $timeoutMs = $options['timeoutMillis'];
+        $currentTimeMs = $this->getCurrentTimeMs();
+        $deadlineMs = $this->deadlineMs ?: $currentTimeMs + $totalTimeoutMs;
+
+        if ($currentTimeMs >= $deadlineMs) {
+            throw new ApiException(
+                'Retry total timeout exceeded.',
+                \Google\Rpc\Code::DEADLINE_EXCEEDED,
+                ApiStatus::DEADLINE_EXCEEDED
+            );
+        }
+
+        $delayMs = min($delayMs * $delayMult, $maxDelayMs);
+        $timeoutMs = (int) min(
+            $timeoutMs * $timeoutMult,
+            $maxTimeoutMs,
+            $deadlineMs - $this->getCurrentTimeMs()
+        );
+
+        $nextHandler = new RetryMiddleware(
+            $this->nextHandler,
+            $this->retrySettings->with([
+                'initialRetryDelayMillis' => $delayMs,
+            ]),
+            $deadlineMs,
+            $this->retryAttempts + 1
+        );
+
+        // Set the timeout for the call
+        $options['timeoutMillis'] = $timeoutMs;
+
+        return $nextHandler(
+            $call,
+            $options
+        );
+    }
+
+    protected function getCurrentTimeMs()
+    {
+        return microtime(true) * 1000.0;
+    }
+
+    /**
+     * This is the default retry behaviour.
+     */
+    private function getRetryFunction()
+    {
+        return $this->retrySettings->getRetryFunction() ??
+            function (\Throwable $e, array $options): bool {
+                // This is the default retry behaviour, i.e. we don't retry an ApiException
+                // and for other exception types, we only retry when the error code is in
+                // the list of retryable error codes.
+                if (!$e instanceof ApiException) {
+                    return false;
+                }
+
+                if (!in_array($e->getStatus(), $this->retrySettings->getRetryableCodes())) {
+                    return false;
+                }
+
+                return true;
+            };
+    }
+}

vendor/google/gax/src/Middleware/TransportCallMiddleware.php

@@ -0,0 +1,60 @@
+<?php
+/*
+ * Copyright 2025 Google LLC
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+namespace Google\ApiCore\Middleware;
+
+use Google\ApiCore\Call;
+use Google\ApiCore\Transport\TransportInterface;
+
+/**
+ * A Middleware in charge of handling the end of the callstack to call the transport layer.
+ * This middleware is made so the callstack in the GapicClientTrait is always a middleware.
+ *
+ * @internal
+ */
+class TransportCallMiddleware implements MiddlewareInterface
+{
+    /*
+     * @param TransportInterface $transport
+     * @param array $transportCallMethods
+     */
+    public function __construct(
+        private TransportInterface $transport,
+        private array $transportCallMethods
+    )
+    {}
+
+    public function __invoke(Call $call, array $options)
+    {
+        $startCallMethod = $this->transportCallMethods[$call->getCallType()];
+        return $this->transport->$startCallMethod($call, $options);
+    }
+}