Added API processRequestFromContext

Summary:
Added API processRequestFromContext

details in
https://docs.google.com/document/d/1JsLrmdiPxD4VFwKp3Kn5Tm7d7gUyYehXaOGU5PH03Xk/edit?tab=t.0#heading=h.jbvrsywtudzt

Reviewed By: hongj-src

Differential Revision: D91829181

fbshipit-source-id: 3ad27489a18655c2024dc488b3a177e1ac77c5b8

Author: Jiaming You

php/capi-param-builder/src/ParamBuilder.php

@@ -11,8 +11,10 @@
 require_once 'model/Constants.php';
 require_once 'model/FbcParamConfig.php';
 require_once 'model/CookieSettings.php';
+require_once 'model/PlainDataObject.php';
 require_once 'piiUtil/PIIUtils.php';
 require_once 'util/AppendixProvider.php';
+require_once 'util/RequestAdaptor.php';
 
 final class ParamBuilder
 {
@@ -69,7 +71,8 @@ public function __construct(
         }
     }
 
-    private function validateAppendix($appendix_value) {
+    private function validateAppendix($appendix_value)
+    {
         $appendix_length = strlen($appendix_value);
 
         // Backward compatible V1 format: 2-character language token
@@ -291,6 +294,25 @@ public function processRequest(
         return $this->cookies_to_set_array;
     }
 
+    public function processRequestFromContext($context = null)
+    {
+        // 1. Normalize input into PlainDataObject
+        $data = ($context instanceof PlainDataObject)
+            ? $context
+            : RequestAdaptor::extract($context);
+
+        // 2. Delegate to the existing API
+        // This prevents code duplication by reusing existing logic.
+        return $this->processRequest(
+            $data->host,
+            $data->query_params,
+            $data->cookies,
+            $data->referer,
+            $data->x_forwarded_for,
+            $data->remote_address
+        );
+    }
+
     public function getCookiesToSet()
     {
         return $this->cookies_to_set_array;