Merge pull request #1247 from php-api-clients/GitHubEnterpriseCloud/from-1.1.4-f3cad7b63e4151c8567d2e9a4b0e26a6-from-1.1.4-f3cad7b63e4151c8567d2e9a4b0e26a6

Author: WyriHaximus

clients/GitHubEnterpriseCloud/README.md

@@ -2294,6 +2294,66 @@ $client->operations()->billing()->getGithubBillingUsageReportGhe(        enterpr
 You can find more about this operation over at the [API method documentation](https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-billing-usage-report-for-an-enterprise).
 
 
+### copilot/usage-metrics-for-enterprise-team
+
+Get a summary of Copilot usage for an enterprise team
+
+Using the `call` method:
+```php
+$client->call('GET /enterprises/{enterprise}/team/{team_slug}/copilot/usage', [
+        'enterprise' => 'generated',
+        'team_slug' => 'generated',
+        'since' => 'generated',
+        'until' => 'generated',
+        'page' => 1,
+        'per_page' => 8,
+]);
+```
+
+Operations method:
+```php
+$client->operations()->copilot()->usageMetricsForEnterpriseTeam(        enterprise: 'generated',
+        team_slug: 'generated',
+        since: 'generated',
+        until: 'generated',
+        page: 1,
+        per_page: 8,
+);
+```
+
+You can find more about this operation over at the [API method documentation](https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-usage#get-a-summary-of-copilot-usage-for-an-enterprise-team).
+
+
+### copilot/usage-metrics-for-enterprise-team
+
+Get a summary of Copilot usage for an enterprise team
+
+Using the `call` method:
+```php
+$client->call('LIST /enterprises/{enterprise}/team/{team_slug}/copilot/usage', [
+        'enterprise' => 'generated',
+        'team_slug' => 'generated',
+        'since' => 'generated',
+        'until' => 'generated',
+        'page' => 1,
+        'per_page' => 8,
+]);
+```
+
+Operations method:
+```php
+$client->operations()->copilot()->usageMetricsForEnterpriseTeamListing(        enterprise: 'generated',
+        team_slug: 'generated',
+        since: 'generated',
+        until: 'generated',
+        page: 1,
+        per_page: 8,
+);
+```
+
+You can find more about this operation over at the [API method documentation](https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-usage#get-a-summary-of-copilot-usage-for-an-enterprise-team).
+
+
 ### secret-scanning/post-security-product-enablement-for-enterprise
 
 Enable or disable a security feature

clients/GitHubEnterpriseCloud/etc/openapi-client-generator.state

@@ -231,18 +231,18 @@ public function call(string $call, array $params = []): \ApiClients\Client\GitHu
                 }
 
                 return $this->router[Internal\Router\List\Five::class]->call($call, $params, $pathChunks);
-            } elseif ($pathChunksCount === 6) {
-                if (\array_key_exists(Internal\Router\List\Six::class, $this->router) === false) {
-                    $this->router[Internal\Router\List\Six::class] = new Internal\Router\List\Six(routers: $this->routers);
-                }
-
-                return $this->router[Internal\Router\List\Six::class]->call($call, $params, $pathChunks);
             } elseif ($pathChunksCount === 7) {
                 if (\array_key_exists(Internal\Router\List\Seven::class, $this->router) === false) {
                     $this->router[Internal\Router\List\Seven::class] = new Internal\Router\List\Seven(routers: $this->routers);
                 }
 
                 return $this->router[Internal\Router\List\Seven::class]->call($call, $params, $pathChunks);
+            } elseif ($pathChunksCount === 6) {
+                if (\array_key_exists(Internal\Router\List\Six::class, $this->router) === false) {
+                    $this->router[Internal\Router\List\Six::class] = new Internal\Router\List\Six(routers: $this->routers);
+                }
+
+                return $this->router[Internal\Router\List\Six::class]->call($call, $params, $pathChunks);
             } elseif ($pathChunksCount === 8) {
                 if (\array_key_exists(Internal\Router\List\Eight::class, $this->router) === false) {
                     $this->router[Internal\Router\List\Eight::class] = new Internal\Router\List\Eight(routers: $this->routers);

clients/GitHubEnterpriseCloud/src/Client.php

@@ -31,20 +31,6 @@ public function cast(mixed $value, ObjectMapper $hydrator): mixed
                 } catch (Throwable) {
                 }
             }
-
-            if ($signature === 'description|html_url|id|members_url|name|node_id|notification_setting|parent|permission|permissions|privacy|repositories_url|slug|url') {
-                try {
-                    return $hydrator->hydrateObject(Schema\Team::class, $value);
-                } catch (Throwable) {
-                }
-            }
-
-            if ($signature === 'avatar_url|blog|company|created_at|description|email|events_url|followers|following|has_organization_projects|has_repository_projects|hooks_url|html_url|id|is_verified|issues_url|location|login|members_url|name|node_id|plan|public_gists|public_members_url|public_repos|repos_url|type|updated_at|url') {
-                try {
-                    return $hydrator->hydrateObject(Schema\Organization::class, $value);
-                } catch (Throwable) {
-                }
-            }
         }
 
         return $value;

clients/GitHubEnterpriseCloud/src/Internal/Attribute/CastUnionToType/Schema/CopilotSeatDetails/Assignee.php

@@ -0,0 +1,286 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ApiClients\Client\GitHubEnterpriseCloud\Internal\Hydrator\Operation\Enterprises\Enterprise\Team\TeamSlug\Copilot;
+
+use ApiClients\Client\GitHubEnterpriseCloud\Schema\BasicError;
+use EventSauce\ObjectHydrator\IterableList;
+use EventSauce\ObjectHydrator\ObjectMapper;
+use EventSauce\ObjectHydrator\PropertySerializers\SerializeArrayItems;
+use EventSauce\ObjectHydrator\PropertySerializers\SerializeDateTime;
+use EventSauce\ObjectHydrator\PropertySerializers\SerializeUuidToString;
+use EventSauce\ObjectHydrator\UnableToHydrateObject;
+use EventSauce\ObjectHydrator\UnableToSerializeObject;
+use Generator;
+use LogicException;
+use Throwable;
+
+use function assert;
+use function count;
+use function is_a;
+
+class Usage implements ObjectMapper
+{
+    private array $hydrationStack = [];
+
+    public function __construct()
+    {
+    }
+
+    /**
+     * @param class-string<T> $className
+     *
+     * @return T
+     *
+     * @template T of object
+     */
+    public function hydrateObject(string $className, array $payload): object
+    {
+        return match ($className) {
+            'ApiClients\Client\GitHubEnterpriseCloud\Schema\BasicError' => $this->hydrateApiClients⚡️Client⚡️GitHubEnterpriseCloud⚡️Schema⚡️BasicError($payload),
+            default => throw UnableToHydrateObject::noHydrationDefined($className, $this->hydrationStack),
+        };
+    }
+
+    private function hydrateApiClients⚡️Client⚡️GitHubEnterpriseCloud⚡️Schema⚡️BasicError(array $payload): BasicError
+    {
+        $properties    = [];
+        $missingFields = [];
+        try {
+            $value = $payload['message'] ?? null;
+
+            if ($value === null) {
+                $properties['message'] = null;
+                goto after_message;
+            }
+
+            $properties['message'] = $value;
+
+            after_message:
+
+            $value = $payload['documentation_url'] ?? null;
+
+            if ($value === null) {
+                $properties['documentationUrl'] = null;
+                goto after_documentationUrl;
+            }
+
+            $properties['documentationUrl'] = $value;
+
+            after_documentationUrl:
+
+            $value = $payload['url'] ?? null;
+
+            if ($value === null) {
+                $properties['url'] = null;
+                goto after_url;
+            }
+
+            $properties['url'] = $value;
+
+            after_url:
+
+            $value = $payload['status'] ?? null;
+
+            if ($value === null) {
+                $properties['status'] = null;
+                goto after_status;
+            }
+
+            $properties['status'] = $value;
+
+            after_status:
+        } catch (Throwable $exception) {
+            throw UnableToHydrateObject::dueToError('ApiClients\Client\GitHubEnterpriseCloud\Schema\BasicError', $exception, stack: $this->hydrationStack);
+        }
+
+        if (count($missingFields) > 0) {
+            throw UnableToHydrateObject::dueToMissingFields(BasicError::class, $missingFields, stack: $this->hydrationStack);
+        }
+
+        try {
+            return new BasicError(...$properties);
+        } catch (Throwable $exception) {
+            throw UnableToHydrateObject::dueToError('ApiClients\Client\GitHubEnterpriseCloud\Schema\BasicError', $exception, stack: $this->hydrationStack);
+        }
+    }
+
+    private function serializeViaTypeMap(string $accessor, object $object, array $payloadToTypeMap): array
+    {
+        foreach ($payloadToTypeMap as $payloadType => [$valueType, $method]) {
+            if (is_a($object, $valueType)) {
+                return [$accessor => $payloadType] + $this->{$method}($object);
+            }
+        }
+
+        throw new LogicException('No type mapped for object of class: ' . $object::class);
+    }
+
+    public function serializeObject(object $object): mixed
+    {
+        return $this->serializeObjectOfType($object, $object::class);
+    }
+
+    /**
+     * @param T               $object
+     * @param class-string<T> $className
+     *
+     * @template T
+     */
+    public function serializeObjectOfType(object $object, string $className): mixed
+    {
+        try {
+            return match ($className) {
+                'array' => $this->serializeValuearray($object),
+                'Ramsey\Uuid\UuidInterface' => $this->serializeValueRamsey⚡️Uuid⚡️UuidInterface($object),
+                'DateTime' => $this->serializeValueDateTime($object),
+                'DateTimeImmutable' => $this->serializeValueDateTimeImmutable($object),
+                'DateTimeInterface' => $this->serializeValueDateTimeInterface($object),
+                'ApiClients\Client\GitHubEnterpriseCloud\Schema\BasicError' => $this->serializeObjectApiClients⚡️Client⚡️GitHubEnterpriseCloud⚡️Schema⚡️BasicError($object),
+                default => throw new LogicException('No serialization defined for $className'),
+            };
+        } catch (Throwable $exception) {
+            throw UnableToSerializeObject::dueToError($className, $exception);
+        }
+    }
+
+    private function serializeValuearray(mixed $value): mixed
+    {
+        static $serializer;
+
+        if ($serializer === null) {
+            $serializer = new SerializeArrayItems(...[]);
+        }
+
+        return $serializer->serialize($value, $this);
+    }
+
+    private function serializeValueRamsey⚡️Uuid⚡️UuidInterface(mixed $value): mixed
+    {
+        static $serializer;
+
+        if ($serializer === null) {
+            $serializer = new SerializeUuidToString(...[]);
+        }
+
+        return $serializer->serialize($value, $this);
+    }
+
+    private function serializeValueDateTime(mixed $value): mixed
+    {
+        static $serializer;
+
+        if ($serializer === null) {
+            $serializer = new SerializeDateTime(...[]);
+        }
+
+        return $serializer->serialize($value, $this);
+    }
+
+    private function serializeValueDateTimeImmutable(mixed $value): mixed
+    {
+        static $serializer;
+
+        if ($serializer === null) {
+            $serializer = new SerializeDateTime(...[]);
+        }
+
+        return $serializer->serialize($value, $this);
+    }
+
+    private function serializeValueDateTimeInterface(mixed $value): mixed
+    {
+        static $serializer;
+
+        if ($serializer === null) {
+            $serializer = new SerializeDateTime(...[]);
+        }
+
+        return $serializer->serialize($value, $this);
+    }
+
+    private function serializeObjectApiClients⚡️Client⚡️GitHubEnterpriseCloud⚡️Schema⚡️BasicError(mixed $object): mixed
+    {
+        assert($object instanceof BasicError);
+        $result = [];
+
+        $message = $object->message;
+
+        if ($message === null) {
+            goto after_message;
+        }
+
+        after_message:        $result['message'] = $message;
+
+        $documentationUrl = $object->documentationUrl;
+
+        if ($documentationUrl === null) {
+            goto after_documentationUrl;
+        }
+
+        after_documentationUrl:        $result['documentation_url'] = $documentationUrl;
+
+        $url = $object->url;
+
+        if ($url === null) {
+            goto after_url;
+        }
+
+        after_url:        $result['url'] = $url;
+
+        $status = $object->status;
+
+        if ($status === null) {
+            goto after_status;
+        }
+
+        after_status:        $result['status'] = $status;
+
+        return $result;
+    }
+
+    /**
+     * @param class-string<T> $className
+     * @param iterable<array> $payloads;
+     *
+     * @return IterableList<T>
+     *
+     * @throws UnableToHydrateObject
+     *
+     * @template T
+     */
+    public function hydrateObjects(string $className, iterable $payloads): IterableList
+    {
+        return new IterableList($this->doHydrateObjects($className, $payloads));
+    }
+
+    private function doHydrateObjects(string $className, iterable $payloads): Generator
+    {
+        foreach ($payloads as $index => $payload) {
+            yield $index => $this->hydrateObject($className, $payload);
+        }
+    }
+
+    /**
+     * @param class-string<T> $className
+     * @param iterable<array> $payloads;
+     *
+     * @return IterableList<T>
+     *
+     * @throws UnableToSerializeObject
+     *
+     * @template T
+     */
+    public function serializeObjects(iterable $payloads): IterableList
+    {
+        return new IterableList($this->doSerializeObjects($payloads));
+    }
+
+    private function doSerializeObjects(iterable $objects): Generator
+    {
+        foreach ($objects as $index => $object) {
+            yield $index => $this->serializeObject($object);
+        }
+    }
+}