feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 12
+configured_endpoints: 21
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser%2Fcas-parser-d9763d006969b49a1473851069fdfa429eb13133b64103a62963bb70ddb22305.yml
 openapi_spec_hash: 6aee689b7a759b12c85c088c15e29bc0
-config_hash: 41c337f5cda03b13880617490f82bad0
+config_hash: d54f39abb185904495bef7c5f8702746

README.md

@@ -45,9 +45,9 @@ $client = new Client(
   environment: 'environment_1',
 );
 
-$unifiedResponse = $client->camsKfintech->parse();
+$response = $client->credits->check();
 
-var_dump($unifiedResponse->demat_accounts);
+var_dump($response->enabled_features);
 ```
 
 ### Value Objects
@@ -69,7 +69,7 @@ use CasParser\Core\Exceptions\RateLimitException;
 use CasParser\Core\Exceptions\APIStatusException;
 
 try {
-  $unifiedResponse = $client->camsKfintech->parse();
+  $response = $client->credits->check();
 } catch (APIConnectionException $e) {
   echo "The server could not be reached", PHP_EOL;
   var_dump($e->getPrevious());
@@ -114,7 +114,7 @@ use CasParser\Client;
 $client = new Client(requestOptions: ['maxRetries' => 0]);
 
 // Or, configure per-request:
-$result = $client->camsKfintech->parse(requestOptions: ['maxRetries' => 5]);
+$result = $client->credits->check(requestOptions: ['maxRetries' => 5]);
 ```
 
 ## Advanced concepts
@@ -130,7 +130,7 @@ Note: the `extra*` parameters of the same name overrides the documented paramete
 ```php
 <?php
 
-$unifiedResponse = $client->camsKfintech->parse(
+$response = $client->credits->check(
   requestOptions: [
     'extraQueryParams' => ['my_query_parameter' => 'value'],
     'extraBodyParams' => ['my_body_parameter' => 'value'],

src/AccessToken/AccessTokenCreateParams.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CasParser\AccessToken;
+
+use CasParser\Core\Attributes\Optional;
+use CasParser\Core\Concerns\SdkModel;
+use CasParser\Core\Concerns\SdkParams;
+use CasParser\Core\Contracts\BaseModel;
+
+/**
+ * Generate a short-lived access token from your API key.
+ *
+ * **Use this endpoint from your backend** to create tokens that can be safely passed to frontend/SDK.
+ *
+ * **Legacy path:** `/v1/access-token` (still supported)
+ *
+ * Access tokens:
+ * - Are prefixed with `at_` for easy identification
+ * - Valid for up to 60 minutes
+ * - Can be used in place of API keys on all v4 endpoints
+ * - Cannot be used to generate other access tokens
+ *
+ * @see CasParser\Services\AccessTokenService::create()
+ *
+ * @phpstan-type AccessTokenCreateParamsShape = array{expiryMinutes?: int|null}
+ */
+final class AccessTokenCreateParams implements BaseModel
+{
+    /** @use SdkModel<AccessTokenCreateParamsShape> */
+    use SdkModel;
+    use SdkParams;
+
+    /**
+     * Token validity in minutes (max 60).
+     */
+    #[Optional('expiry_minutes')]
+    public ?int $expiryMinutes;
+
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     */
+    public static function with(?int $expiryMinutes = null): self
+    {
+        $self = new self;
+
+        null !== $expiryMinutes && $self['expiryMinutes'] = $expiryMinutes;
+
+        return $self;
+    }
+
+    /**
+     * Token validity in minutes (max 60).
+     */
+    public function withExpiryMinutes(int $expiryMinutes): self
+    {
+        $self = clone $this;
+        $self['expiryMinutes'] = $expiryMinutes;
+
+        return $self;
+    }
+}

src/AccessToken/AccessTokenNewResponse.php

@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CasParser\AccessToken;
+
+use CasParser\Core\Attributes\Optional;
+use CasParser\Core\Concerns\SdkModel;
+use CasParser\Core\Contracts\BaseModel;
+
+/**
+ * @phpstan-type AccessTokenNewResponseShape = array{
+ *   accessToken?: string|null, expiresIn?: int|null, tokenType?: string|null
+ * }
+ */
+final class AccessTokenNewResponse implements BaseModel
+{
+    /** @use SdkModel<AccessTokenNewResponseShape> */
+    use SdkModel;
+
+    /**
+     * The at_ prefixed access token.
+     */
+    #[Optional('access_token')]
+    public ?string $accessToken;
+
+    /**
+     * Token validity in seconds.
+     */
+    #[Optional('expires_in')]
+    public ?int $expiresIn;
+
+    /**
+     * Always "api_key" - token is a drop-in replacement for x-api-key header.
+     */
+    #[Optional('token_type')]
+    public ?string $tokenType;
+
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     */
+    public static function with(
+        ?string $accessToken = null,
+        ?int $expiresIn = null,
+        ?string $tokenType = null
+    ): self {
+        $self = new self;
+
+        null !== $accessToken && $self['accessToken'] = $accessToken;
+        null !== $expiresIn && $self['expiresIn'] = $expiresIn;
+        null !== $tokenType && $self['tokenType'] = $tokenType;
+
+        return $self;
+    }
+
+    /**
+     * The at_ prefixed access token.
+     */
+    public function withAccessToken(string $accessToken): self
+    {
+        $self = clone $this;
+        $self['accessToken'] = $accessToken;
+
+        return $self;
+    }
+
+    /**
+     * Token validity in seconds.
+     */
+    public function withExpiresIn(int $expiresIn): self
+    {
+        $self = clone $this;
+        $self['expiresIn'] = $expiresIn;
+
+        return $self;
+    }
+
+    /**
+     * Always "api_key" - token is a drop-in replacement for x-api-key header.
+     */
+    public function withTokenType(string $tokenType): self
+    {
+        $self = clone $this;
+        $self['tokenType'] = $tokenType;
+
+        return $self;
+    }
+}

src/Client.php

@@ -11,6 +11,7 @@
 use CasParser\Services\CdslService;
 use CasParser\Services\ContractNoteService;
 use CasParser\Services\CreditsService;
+use CasParser\Services\InboundEmailService;
 use CasParser\Services\InboxService;
 use CasParser\Services\KfintechService;
 use CasParser\Services\LogsService;
@@ -83,6 +84,11 @@ class Client extends BaseClient
      */
     public SmartService $smart;
 
+    /**
+     * @api
+     */
+    public InboundEmailService $inboundEmail;
+
     /**
      * @param RequestOpts|null $requestOptions
      */
@@ -134,6 +140,7 @@ public function __construct(
         $this->kfintech = new KfintechService($this);
         $this->nsdl = new NsdlService($this);
         $this->smart = new SmartService($this);
+        $this->inboundEmail = new InboundEmailService($this);
     }
 
     /** @return array<string,string> */