feat(response): Add resource method to retrieve PHP resource

- Implement `resource` method in Response class
- Returns the body of the response as a PHP resource
- Uses `StreamWrapper` for resource conversion

src/Http/Response.php

@@ -12,6 +12,7 @@
 use Saloon\Helpers\ArrayHelpers;
 use Saloon\Helpers\ObjectHelpers;
 use Saloon\XmlWrangler\XmlReader;
+use GuzzleHttp\Psr7\StreamWrapper;
 use Illuminate\Support\Collection;
 use Saloon\Contracts\FakeResponse;
 use Saloon\Repositories\ArrayStore;
@@ -299,6 +300,18 @@ public function collect(string|int|null $key = null): Collection
         return Collection::make([$data]);
     }
 
+    /**
+     * Get the body of the response as a PHP resource.
+     *
+     * @return resource
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function resource(): mixed
+    {
+        return StreamWrapper::getResource($this->stream());
+    }
+
     /**
      * Cast the response to a DTO.
      */

tests/Unit/ResponseTest.php

@@ -171,6 +171,17 @@
     expect($response->collect('age'))->toBeEmpty();
 });
 
+test('it can convert the response to a resource', function () {
+    $mockClient = new MockClient([
+        MockResponse::make(['foo' => 'bar'], 200, ['Content-Type' => 'application/json;encoding=utf-8']),
+    ]);
+
+    $response = connector()->send(new UserRequest, $mockClient);
+
+    expect($response->resource())->toBeResource();
+    expect(stream_get_contents($response->resource()))->toBe($response->body());
+});
+
 test('the json method will return empty array if body is empty', function () {
     $mockClient = new MockClient([
         MockResponse::make('', 404),