feat: data sharing config

Author: maximerenou

README.md

@@ -78,6 +78,19 @@ $summary = $conversation->getSummary();
 
 </details> 
 
+<details>
+  <summary>Turn off data sharing</summary>
+
+HuggingChat share your conversations to improve the model. You can turn on/off data sharing:
+
+```php
+$conversation->enableSharing(); // on (default)
+
+$conversation->disableSharing(); // off
+```
+
+</details>
+
 <details>
   <summary>Handle HuggingChat errors</summary>
 

examples/chat.php

@@ -5,7 +5,7 @@
 
 $ai = new \MaximeRenou\HuggingChat\Client();
 
-$conversation = $ai->createConversation();
+$conversation = $ai->createConversation()->disableSharing();
 
 echo 'Type "q" to quit' . PHP_EOL;
 

src/Conversation.php

@@ -86,7 +86,7 @@ public function ask(Prompt $message, $callback = null)
                 'top_k' => $message->top_k,
                 'top_p' => $message->top_p,
                 'truncate' => $message->truncate,
-                'watermark' => $message->watermark, 
+                'watermark' => $message->watermark,
             ],
             'stream' => true
         ];
@@ -102,7 +102,7 @@ public function ask(Prompt $message, $callback = null)
             CURLOPT_POST => 1,
             CURLOPT_POSTFIELDS => json_encode($data)
         ]);
-        
+
         $es->onMessage(function (Event $event) use ($es, &$callback) {
             if ($es === 4) {
                 $es->abort();
@@ -130,7 +130,7 @@ public function ask(Prompt $message, $callback = null)
 
             $callback($this->current_text, $tokens);
         });
-        
+
         @$es->connect();
 
         return $this->current_text;
@@ -155,7 +155,7 @@ protected function handlePacket($raw)
         }
 
         $text = $data['token']['special'] ? $data['generated_text'] : $data['token']['text'];
-        
+
         if (($pos = strpos($text, self::END_CHAR)) !== false) {
             $text = substr($text, 0, $pos);
         }
@@ -184,4 +184,36 @@ public function getSummary()
 
         return trim($data['title'], '"');
     }
+
+    public function enableSharing()
+    {
+        return $this->withSettings([
+            'shareConversationsWithModelAuthors' => true
+        ]);
+    }
+
+    public function disableSharing()
+    {
+        return $this->withSettings([
+            'shareConversationsWithModelAuthors' => false
+        ]);
+    }
+
+    public function withSettings($settings)
+    {
+        $headers = [
+            'method: PATCH',
+            'accept: application/json',
+            "origin: https://huggingface.co",
+            "referer: https://huggingface.co/chat/privacy",
+            'content-type: application/json',
+            "cookie: hf-chat={$this->cookie}"
+        ];
+
+        $data = json_encode($settings);
+
+        Tools::request("https://huggingface.co/chat/settings", $headers, $data);
+
+        return $this;
+    }
 }