feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser%2Fcas-parser-9eaed98ce5934f11e901cef376a28257d2c196bd3dba7c690babc6741a730ded.yml
-openapi_spec_hash: b76e4e830c4d03ba4cf9429bb9fb9c8a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser%2Fcas-parser-38618cc5c938e87eeacf4893d6a6ba4e6ef7da390e6283dc7b50b484a7b97165.yml
+openapi_spec_hash: b9e439ecee904ded01aa34efdee88856
 config_hash: cb5d75abef6264b5d86448caf7295afa

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Cas Parser
+   Copyright 2026 Cas Parser
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -47,9 +47,11 @@ Parameters with a default value must be set by name.
 
 use CasParser\Client;
 
-$client = new Client(apiKey: getenv("CAS_PARSER_API_KEY") ?: "My API Key");
+$client = new Client(apiKey: getenv('CAS_PARSER_API_KEY') ?: 'My API Key');
 
-$unifiedResponse = $client->casParser->smartParse([]);
+$unifiedResponse = $client->casParser->smartParse(
+  password: 'ABCDF', pdfURL: 'https://your-cas-pdf-url-here.com'
+);
 
 var_dump($unifiedResponse->demat_accounts);
 ```
@@ -71,11 +73,11 @@ When the library is unable to connect to the API, or if the API returns a non-su
 use CasParser\Core\Exceptions\APIConnectionException;
 
 try {
-  $unifiedResponse = $client->casParser->smartParse([]);
+  $unifiedResponse = $client->casParser->smartParse();
 } catch (APIConnectionException $e) {
   echo "The server could not be reached", PHP_EOL;
   var_dump($e->getPrevious());
-} catch (RateLimitError $_) {
+} catch (RateLimitError $e) {
   echo "A 429 status code was received; we should back off a bit.", PHP_EOL;
 } catch (APIStatusError $e) {
   echo "Another non-200-range status code was received", PHP_EOL;
@@ -118,7 +120,9 @@ $client = new Client(maxRetries: 0);
 
 // Or, configure per-request:
 $result = $client->casParser->smartParse(
-  [], RequestOptions::with(maxRetries: 5)
+  password: 'ABCDF',
+  pdfURL: 'https://you-cas-pdf-url-here.com',
+  requestOptions: RequestOptions::with(maxRetries: 5),
 );
 ```
 
@@ -138,11 +142,12 @@ Note: the `extra*` parameters of the same name overrides the documented paramete
 use CasParser\RequestOptions;
 
 $unifiedResponse = $client->casParser->smartParse(
-  [],
-  RequestOptions::with(
-    extraQueryParams: ["my_query_parameter" => "value"],
-    extraBodyParams: ["my_body_parameter" => "value"],
-    extraHeaders: ["my-header" => "value"],
+  password: 'ABCDF',
+  pdfURL: 'https://you-cas-pdf-url-here.com',
+  requestOptions: RequestOptions::with(
+    extraQueryParams: ['my_query_parameter' => 'value'],
+    extraBodyParams: ['my_body_parameter' => 'value'],
+    extraHeaders: ['my-header' => 'value'],
   ),
 );
 ```

composer.json

@@ -4,6 +4,7 @@
   "autoload": {
     "files": [
       "src/Core.php",
+      "src/Version.php",
       "src/Client.php"
     ],
     "psr-4": {

release-please-config.json

@@ -62,6 +62,6 @@
   "release-type": "php",
   "extra-files": [
     "README.md",
-    "src/Client.php"
+    "src/Version.php"
   ]
 }

scripts/lint

@@ -5,4 +5,4 @@ set -e
 cd -- "$(dirname -- "$0")/.."
 
 echo "==> Running PHPStan"
-exec -- ./vendor/bin/phpstan analyse --memory-limit=2G
+exec -- ./vendor/bin/phpstan analyse --memory-limit=12G

src/CasGenerator/CasGeneratorGenerateCasParams.php

@@ -5,7 +5,8 @@
 namespace CasParser\CasGenerator;
 
 use CasParser\CasGenerator\CasGeneratorGenerateCasParams\CasAuthority;
-use CasParser\Core\Attributes\Api;
+use CasParser\Core\Attributes\Optional;
+use CasParser\Core\Attributes\Required;
 use CasParser\Core\Concerns\SdkModel;
 use CasParser\Core\Concerns\SdkParams;
 use CasParser\Core\Contracts\BaseModel;
@@ -18,11 +19,11 @@
  *
  * @phpstan-type CasGeneratorGenerateCasParamsShape = array{
  *   email: string,
- *   from_date: string,
+ *   fromDate: string,
  *   password: string,
- *   to_date: string,
- *   cas_authority?: CasAuthority|value-of<CasAuthority>,
- *   pan_no?: string,
+ *   toDate: string,
+ *   casAuthority?: null|CasAuthority|value-of<CasAuthority>,
+ *   panNo?: string|null,
  * }
  */
 final class CasGeneratorGenerateCasParams implements BaseModel
@@ -34,48 +35,48 @@ final class CasGeneratorGenerateCasParams implements BaseModel
     /**
      * Email address to receive the CAS document.
      */
-    #[Api]
+    #[Required]
     public string $email;
 
     /**
      * Start date for the CAS period (format YYYY-MM-DD).
      */
-    #[Api]
-    public string $from_date;
+    #[Required('from_date')]
+    public string $fromDate;
 
     /**
      * Password to protect the generated CAS PDF.
      */
-    #[Api]
+    #[Required]
     public string $password;
 
     /**
      * End date for the CAS period (format YYYY-MM-DD).
      */
-    #[Api]
-    public string $to_date;
+    #[Required('to_date')]
+    public string $toDate;
 
     /**
      * CAS authority to generate the document from (currently only kfintech is supported).
      *
-     * @var value-of<CasAuthority>|null $cas_authority
+     * @var value-of<CasAuthority>|null $casAuthority
      */
-    #[Api(enum: CasAuthority::class, optional: true)]
-    public ?string $cas_authority;
+    #[Optional('cas_authority', enum: CasAuthority::class)]
+    public ?string $casAuthority;
 
     /**
      * PAN number (optional for some CAS authorities).
      */
-    #[Api(optional: true)]
-    public ?string $pan_no;
+    #[Optional('pan_no')]
+    public ?string $panNo;
 
     /**
      * `new CasGeneratorGenerateCasParams()` is missing required properties by the API.
      *
      * To enforce required parameters use
      * ```
      * CasGeneratorGenerateCasParams::with(
-     *   email: ..., from_date: ..., password: ..., to_date: ...
+     *   email: ..., fromDate: ..., password: ..., toDate: ...
      * )
      * ```
      *
@@ -99,71 +100,71 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
-     * @param CasAuthority|value-of<CasAuthority> $cas_authority
+     * @param CasAuthority|value-of<CasAuthority>|null $casAuthority
      */
     public static function with(
         string $email,
-        string $from_date,
+        string $fromDate,
         string $password,
-        string $to_date,
-        CasAuthority|string|null $cas_authority = null,
-        ?string $pan_no = null,
+        string $toDate,
+        CasAuthority|string|null $casAuthority = null,
+        ?string $panNo = null,
     ): self {
-        $obj = new self;
+        $self = new self;
 
-        $obj->email = $email;
-        $obj->from_date = $from_date;
-        $obj->password = $password;
-        $obj->to_date = $to_date;
+        $self['email'] = $email;
+        $self['fromDate'] = $fromDate;
+        $self['password'] = $password;
+        $self['toDate'] = $toDate;
 
-        null !== $cas_authority && $obj['cas_authority'] = $cas_authority;
-        null !== $pan_no && $obj->pan_no = $pan_no;
+        null !== $casAuthority && $self['casAuthority'] = $casAuthority;
+        null !== $panNo && $self['panNo'] = $panNo;
 
-        return $obj;
+        return $self;
     }
 
     /**
      * Email address to receive the CAS document.
      */
     public function withEmail(string $email): self
     {
-        $obj = clone $this;
-        $obj->email = $email;
+        $self = clone $this;
+        $self['email'] = $email;
 
-        return $obj;
+        return $self;
     }
 
     /**
      * Start date for the CAS period (format YYYY-MM-DD).
      */
     public function withFromDate(string $fromDate): self
     {
-        $obj = clone $this;
-        $obj->from_date = $fromDate;
+        $self = clone $this;
+        $self['fromDate'] = $fromDate;
 
-        return $obj;
+        return $self;
     }
 
     /**
      * Password to protect the generated CAS PDF.
      */
     public function withPassword(string $password): self
     {
-        $obj = clone $this;
-        $obj->password = $password;
+        $self = clone $this;
+        $self['password'] = $password;
 
-        return $obj;
+        return $self;
     }
 
     /**
      * End date for the CAS period (format YYYY-MM-DD).
      */
     public function withToDate(string $toDate): self
     {
-        $obj = clone $this;
-        $obj->to_date = $toDate;
+        $self = clone $this;
+        $self['toDate'] = $toDate;
 
-        return $obj;
+        return $self;
     }
 
     /**
@@ -173,20 +174,20 @@ public function withToDate(string $toDate): self
      */
     public function withCasAuthority(CasAuthority|string $casAuthority): self
     {
-        $obj = clone $this;
-        $obj['cas_authority'] = $casAuthority;
+        $self = clone $this;
+        $self['casAuthority'] = $casAuthority;
 
-        return $obj;
+        return $self;
     }
 
     /**
      * PAN number (optional for some CAS authorities).
      */
     public function withPanNo(string $panNo): self
     {
-        $obj = clone $this;
-        $obj->pan_no = $panNo;
+        $self = clone $this;
+        $self['panNo'] = $panNo;
 
-        return $obj;
+        return $self;
     }
 }

src/CasGenerator/CasGeneratorGenerateCasResponse.php

@@ -4,28 +4,24 @@
 
 namespace CasParser\CasGenerator;
 
-use CasParser\Core\Attributes\Api;
+use CasParser\Core\Attributes\Optional;
 use CasParser\Core\Concerns\SdkModel;
-use CasParser\Core\Concerns\SdkResponse;
 use CasParser\Core\Contracts\BaseModel;
-use CasParser\Core\Conversion\Contracts\ResponseConverter;
 
 /**
  * @phpstan-type CasGeneratorGenerateCasResponseShape = array{
  *   msg?: string|null, status?: string|null
  * }
  */
-final class CasGeneratorGenerateCasResponse implements BaseModel, ResponseConverter
+final class CasGeneratorGenerateCasResponse implements BaseModel
 {
     /** @use SdkModel<CasGeneratorGenerateCasResponseShape> */
     use SdkModel;
 
-    use SdkResponse;
-
-    #[Api(optional: true)]
+    #[Optional]
     public ?string $msg;
 
-    #[Api(optional: true)]
+    #[Optional]
     public ?string $status;
 
     public function __construct()
@@ -40,27 +36,27 @@ public function __construct()
      */
     public static function with(?string $msg = null, ?string $status = null): self
     {
-        $obj = new self;
+        $self = new self;
 
-        null !== $msg && $obj->msg = $msg;
-        null !== $status && $obj->status = $status;
+        null !== $msg && $self['msg'] = $msg;
+        null !== $status && $self['status'] = $status;
 
-        return $obj;
+        return $self;
     }
 
     public function withMsg(string $msg): self
     {
-        $obj = clone $this;
-        $obj->msg = $msg;
+        $self = clone $this;
+        $self['msg'] = $msg;
 
-        return $obj;
+        return $self;
     }
 
     public function withStatus(string $status): self
     {
-        $obj = clone $this;
-        $obj->status = $status;
+        $self = clone $this;
+        $self['status'] = $status;
 
-        return $obj;
+        return $self;
     }
 }