feat(client): add raw methods

Author: stainless-app[bot]

src/CasGenerator/CasGeneratorGenerateCasResponse.php

@@ -12,7 +12,7 @@
  * @phpstan-type cas_generator_generate_cas_response = array{
  *   msg?: string, status?: string
  * }
- * When used in a response, this type parameter can be used to define a $rawResponse property.
+ * When used in a response, this type parameter can define a $rawResponse property.
  * @template TRawResponse of object = object{}
  *
  * @mixin TRawResponse

src/CasParser/UnifiedResponse.php

@@ -23,7 +23,7 @@
  *   mutualFunds?: list<MutualFund>,
  *   summary?: Summary,
  * }
- * When used in a response, this type parameter can be used to define a $rawResponse property.
+ * When used in a response, this type parameter can define a $rawResponse property.
  * @template TRawResponse of object = object{}
  *
  * @mixin TRawResponse

src/ServiceContracts/CasGeneratorContract.php

@@ -6,6 +6,7 @@
 
 use CasParser\CasGenerator\CasGeneratorGenerateCasParams\CasAuthority;
 use CasParser\CasGenerator\CasGeneratorGenerateCasResponse;
+use CasParser\Core\Exceptions\APIException;
 use CasParser\Core\Implementation\HasRawResponse;
 use CasParser\RequestOptions;
 
@@ -24,6 +25,8 @@ interface CasGeneratorContract
      * @param string $panNo PAN number (optional for some CAS authorities)
      *
      * @return CasGeneratorGenerateCasResponse<HasRawResponse>
+     *
+     * @throws APIException
      */
     public function generateCas(
         $email,
@@ -34,4 +37,18 @@ public function generateCas(
         $panNo = omit,
         ?RequestOptions $requestOptions = null,
     ): CasGeneratorGenerateCasResponse;
+
+    /**
+     * @api
+     *
+     * @param array<string, mixed> $params
+     *
+     * @return CasGeneratorGenerateCasResponse<HasRawResponse>
+     *
+     * @throws APIException
+     */
+    public function generateCasRaw(
+        array $params,
+        ?RequestOptions $requestOptions = null
+    ): CasGeneratorGenerateCasResponse;
 }

src/ServiceContracts/CasParserContract.php

@@ -5,6 +5,7 @@
 namespace CasParser\ServiceContracts;
 
 use CasParser\CasParser\UnifiedResponse;
+use CasParser\Core\Exceptions\APIException;
 use CasParser\Core\Implementation\HasRawResponse;
 use CasParser\RequestOptions;
 
@@ -20,6 +21,8 @@ interface CasParserContract
      * @param string $pdfURL URL to the CAS PDF file
      *
      * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
      */
     public function camsKfintech(
         $password = omit,
@@ -28,6 +31,20 @@ public function camsKfintech(
         ?RequestOptions $requestOptions = null,
     ): UnifiedResponse;
 
+    /**
+     * @api
+     *
+     * @param array<string, mixed> $params
+     *
+     * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
+     */
+    public function camsKfintechRaw(
+        array $params,
+        ?RequestOptions $requestOptions = null
+    ): UnifiedResponse;
+
     /**
      * @api
      *
@@ -36,6 +53,8 @@ public function camsKfintech(
      * @param string $pdfURL URL to the CAS PDF file
      *
      * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
      */
     public function cdsl(
         $password = omit,
@@ -44,6 +63,20 @@ public function cdsl(
         ?RequestOptions $requestOptions = null,
     ): UnifiedResponse;
 
+    /**
+     * @api
+     *
+     * @param array<string, mixed> $params
+     *
+     * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
+     */
+    public function cdslRaw(
+        array $params,
+        ?RequestOptions $requestOptions = null
+    ): UnifiedResponse;
+
     /**
      * @api
      *
@@ -52,6 +85,8 @@ public function cdsl(
      * @param string $pdfURL URL to the CAS PDF file
      *
      * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
      */
     public function nsdl(
         $password = omit,
@@ -60,6 +95,20 @@ public function nsdl(
         ?RequestOptions $requestOptions = null,
     ): UnifiedResponse;
 
+    /**
+     * @api
+     *
+     * @param array<string, mixed> $params
+     *
+     * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
+     */
+    public function nsdlRaw(
+        array $params,
+        ?RequestOptions $requestOptions = null
+    ): UnifiedResponse;
+
     /**
      * @api
      *
@@ -68,11 +117,27 @@ public function nsdl(
      * @param string $pdfURL URL to the CAS PDF file
      *
      * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
      */
     public function smartParse(
         $password = omit,
         $pdfFile = omit,
         $pdfURL = omit,
         ?RequestOptions $requestOptions = null,
     ): UnifiedResponse;
+
+    /**
+     * @api
+     *
+     * @param array<string, mixed> $params
+     *
+     * @return UnifiedResponse<HasRawResponse>
+     *
+     * @throws APIException
+     */
+    public function smartParseRaw(
+        array $params,
+        ?RequestOptions $requestOptions = null
+    ): UnifiedResponse;
 }

src/Services/CasGeneratorService.php

@@ -8,6 +8,7 @@
 use CasParser\CasGenerator\CasGeneratorGenerateCasParams\CasAuthority;
 use CasParser\CasGenerator\CasGeneratorGenerateCasResponse;
 use CasParser\Client;
+use CasParser\Core\Exceptions\APIException;
 use CasParser\Core\Implementation\HasRawResponse;
 use CasParser\RequestOptions;
 use CasParser\ServiceContracts\CasGeneratorContract;
@@ -35,6 +36,8 @@ public function __construct(private Client $client) {}
      * @param string $panNo PAN number (optional for some CAS authorities)
      *
      * @return CasGeneratorGenerateCasResponse<HasRawResponse>
+     *
+     * @throws APIException
      */
     public function generateCas(
         $email,
@@ -44,17 +47,35 @@ public function generateCas(
         $casAuthority = omit,
         $panNo = omit,
         ?RequestOptions $requestOptions = null,
+    ): CasGeneratorGenerateCasResponse {
+        $params = [
+            'email' => $email,
+            'fromDate' => $fromDate,
+            'password' => $password,
+            'toDate' => $toDate,
+            'casAuthority' => $casAuthority,
+            'panNo' => $panNo,
+        ];
+
+        return $this->generateCasRaw($params, $requestOptions);
+    }
+
+    /**
+     * @api
+     *
+     * @param array<string, mixed> $params
+     *
+     * @return CasGeneratorGenerateCasResponse<HasRawResponse>
+     *
+     * @throws APIException
+     */
+    public function generateCasRaw(
+        array $params,
+        ?RequestOptions $requestOptions = null
     ): CasGeneratorGenerateCasResponse {
         [$parsed, $options] = CasGeneratorGenerateCasParams::parseRequest(
-            [
-                'email' => $email,
-                'fromDate' => $fromDate,
-                'password' => $password,
-                'toDate' => $toDate,
-                'casAuthority' => $casAuthority,
-                'panNo' => $panNo,
-            ],
-            $requestOptions,
+            $params,
+            $requestOptions
         );
 
         // @phpstan-ignore-next-line;