fix(OpenAI): Allow bytes to be nullable on ContainerFileResponse (#705)

Author: knash94

src/Responses/Containers/Files/ContainerFileResponse.php

@@ -12,7 +12,7 @@
 use OpenAI\Testing\Responses\Concerns\Fakeable;
 
 /**
- * @phpstan-type ContainerFileType array{id: string, object: 'container.file', created_at: int, bytes: int, container_id: string, path: string, source: 'user'|'assistant'}
+ * @phpstan-type ContainerFileType array{id: string, object: 'container.file', created_at: int, bytes: int|null, container_id: string, path: string, source: 'user'|'assistant'}
  *
  * @implements ResponseContract<ContainerFileType>
  */
@@ -34,7 +34,7 @@ private function __construct(
         public readonly string $id,
         public readonly string $object,
         public readonly int $createdAt,
-        public readonly int $bytes,
+        public readonly ?int $bytes,
         public readonly string $containerId,
         public readonly string $path,
         public readonly string $source,

tests/Fixtures/ContainerFile.php

@@ -16,6 +16,22 @@ function containerFileResource(): array
     ];
 }
 
+/**
+ * @return array<string, mixed>
+ */
+function containerFileResourceAssistant(): array
+{
+    return [
+        'id' => 'cfile_68efad3233308191ae2aea6fdc172940',
+        'object' => 'container.file',
+        'created_at' => 1760537906,
+        'bytes' => null,
+        'container_id' => 'cntr_68efad24888881938f8d8a661b5036450ac07bb92e293373',
+        'path' => '/mnt/data/dummy_risk_priority_bar_chart.png',
+        'source' => 'assistant',
+    ];
+}
+
 /**
  * @return array<string, mixed>
  */

tests/Responses/Containers/Files/ContainerFileResponse.php

@@ -15,6 +15,19 @@
         ->source->toBe('user');
 });
 
+test('from response with null bytes', function () {
+    $result = ContainerFileResponse::from(containerFileResourceAssistant(), meta());
+
+    expect($result)
+        ->id->toBe('cfile_68efad3233308191ae2aea6fdc172940')
+        ->object->toBe('container.file')
+        ->createdAt->toBe(1760537906)
+        ->bytes->toBeNull()
+        ->containerId->toBe('cntr_68efad24888881938f8d8a661b5036450ac07bb92e293373')
+        ->path->toBe('/mnt/data/dummy_risk_priority_bar_chart.png')
+        ->source->toBe('assistant');
+});
+
 test('as array accessible', function () {
     $result = ContainerFileResponse::from(containerFileResource(), meta());