feat: add configurable timeouts and retry logic to REST and Restlet clients

- Implement connectTimeout() and timeout() using new BRIAR_ROSE_CONNECT_TIMEOUT and BRIAR_ROSE_TIMEOUT environment variables
- Add retry logic for GET and HEAD requests with configurable attempts and sleep duration
- Fix indentation for environment variable examples in README.md

Author: searsandrew

README.md

@@ -213,8 +213,8 @@ If you have a single RESTlet script deployed, you can set enviromental variables
 
 Set the deploy ID in the environment:
 ```env
-    NETSUITE_RESTLET_SCRIPT_ID=... // Script ID of the deployed RESTlet
-    NETSUITE_RESTLET_DEPLOY_ID=1   // Booleans are 1 or 0
+NETSUITE_RESTLET_SCRIPT_ID=... // Script ID of the deployed RESTlet
+NETSUITE_RESTLET_DEPLOY_ID=1   // Booleans are 1 or 0
 ```
 
 ```php
@@ -227,7 +227,7 @@ If you have a RESTlet base URL set, you can call it like this:
 
 Set the RESTlet base URL in the environment:
 ```env
-    NETSUITE_RESTLET_BASE_URL=... // Be sure to set the Script ID of the RESTlet in the URL.
+NETSUITE_RESTLET_BASE_URL=... // Be sure to set the Script ID of the RESTlet in the URL.
 ```
 
 ```php

src/Clients/RestClient.php

@@ -43,7 +43,17 @@ public function request(string $method, string $path, array $options = []): Resp
             'Authorization' => $authHeader,
             'Accept' => 'application/json',
             'Content-Type' => 'application/json',
-        ]);
+        ])->connectTimeout((int) env('BRIAR_ROSE_CONNECT_TIMEOUT', 10))
+        ->timeout((int) env('BRIAR_ROSE_TIMEOUT', 60))
+        ->retry(
+            (int) env('BRIAR_ROSE_RETRY', 3),
+            (int) env('BRIAR_ROSE_RETRY_SLEEP_MS', 250),
+            function ($exception, $request) use ($method) {
+                // Retry only safe/idempotent methods by default
+                return in_array($method, ['GET', 'HEAD'], true);
+            },
+            throw: false
+        );
 
         if (!empty($options['headers']) && is_array($options['headers'])) {
             $request = $request->withHeaders($options['headers']);

src/Clients/RestletClient.php

@@ -124,7 +124,17 @@ protected function send(string $method, string $url, array $data = []): Response
             'Authorization' => $authHeader,
             'Content-Type' => 'application/json',
             'Accept' => 'application/json',
-        ]);
+        ])->connectTimeout((int) env('BRIAR_ROSE_CONNECT_TIMEOUT', 10))
+        ->timeout((int) env('BRIAR_ROSE_TIMEOUT', 60))
+        ->retry(
+            (int) env('BRIAR_ROSE_RETRY', 3),
+            (int) env('BRIAR_ROSE_RETRY_SLEEP_MS', 250),
+            function ($exception, $request) use ($method) {
+                // Retry only safe/idempotent methods by default
+                return in_array($method, ['GET', 'HEAD'], true);
+            },
+            throw: false
+        );
 
         if ($method === 'GET') {
             if (! empty($data)) {