feat: ensure ->toArray() benefits from structural typing

Author: stainless-app[bot]

src/CasGenerator/CasGeneratorGenerateCasParams.php

@@ -13,9 +13,19 @@
 /**
  * This endpoint generates CAS (Consolidated Account Statement) documents by submitting a mailback request to the specified CAS authority.
  * Currently only supports KFintech, with plans to support CAMS, CDSL, and NSDL in the future.
+ *
+ * @phpstan-type cas_generator_generate_cas_params = array{
+ *   email: string,
+ *   fromDate: string,
+ *   password: string,
+ *   toDate: string,
+ *   casAuthority?: CasAuthority::*,
+ *   panNo?: string,
+ * }
  */
 final class CasGeneratorGenerateCasParams implements BaseModel
 {
+    /** @use SdkModel<cas_generator_generate_cas_params> */
     use SdkModel;
     use SdkParams;
 

src/CasGenerator/CasGeneratorGenerateCasResponse.php

@@ -8,8 +8,14 @@
 use CasParser\Core\Concerns\SdkModel;
 use CasParser\Core\Contracts\BaseModel;
 
+/**
+ * @phpstan-type cas_generator_generate_cas_response = array{
+ *   msg?: string|null, status?: string|null
+ * }
+ */
 final class CasGeneratorGenerateCasResponse implements BaseModel
 {
+    /** @use SdkModel<cas_generator_generate_cas_response> */
     use SdkModel;
 
     #[Api(optional: true)]

src/CasParser/CasParserCamsKfintechParams.php

@@ -12,9 +12,14 @@
 /**
  * This endpoint specifically parses CAMS/KFintech CAS (Consolidated Account Statement) PDF files and returns data in a unified format.
  * Use this endpoint when you know the PDF is from CAMS or KFintech.
+ *
+ * @phpstan-type cas_parser_cams_kfintech_params = array{
+ *   password?: string, pdfFile?: string, pdfURL?: string
+ * }
  */
 final class CasParserCamsKfintechParams implements BaseModel
 {
+    /** @use SdkModel<cas_parser_cams_kfintech_params> */
     use SdkModel;
     use SdkParams;
 

src/CasParser/CasParserCdslParams.php

@@ -12,9 +12,14 @@
 /**
  * This endpoint specifically parses CDSL CAS (Consolidated Account Statement) PDF files and returns data in a unified format.
  * Use this endpoint when you know the PDF is from CDSL.
+ *
+ * @phpstan-type cas_parser_cdsl_params = array{
+ *   password?: string, pdfFile?: string, pdfURL?: string
+ * }
  */
 final class CasParserCdslParams implements BaseModel
 {
+    /** @use SdkModel<cas_parser_cdsl_params> */
     use SdkModel;
     use SdkParams;
 

src/CasParser/CasParserNsdlParams.php

@@ -12,9 +12,14 @@
 /**
  * This endpoint specifically parses NSDL CAS (Consolidated Account Statement) PDF files and returns data in a unified format.
  * Use this endpoint when you know the PDF is from NSDL.
+ *
+ * @phpstan-type cas_parser_nsdl_params = array{
+ *   password?: string, pdfFile?: string, pdfURL?: string
+ * }
  */
 final class CasParserNsdlParams implements BaseModel
 {
+    /** @use SdkModel<cas_parser_nsdl_params> */
     use SdkModel;
     use SdkParams;
 

src/CasParser/CasParserSmartParseParams.php

@@ -12,9 +12,14 @@
 /**
  * This endpoint parses CAS (Consolidated Account Statement) PDF files from NSDL, CDSL, or CAMS/KFintech and returns data in a unified format.
  * It auto-detects the CAS type and transforms the data into a consistent structure regardless of the source.
+ *
+ * @phpstan-type cas_parser_smart_parse_params = array{
+ *   password?: string, pdfFile?: string, pdfURL?: string
+ * }
  */
 final class CasParserSmartParseParams implements BaseModel
 {
+    /** @use SdkModel<cas_parser_smart_parse_params> */
     use SdkModel;
     use SdkParams;
 

src/CasParser/UnifiedResponse.php

@@ -14,8 +14,19 @@
 use CasParser\Core\Concerns\SdkModel;
 use CasParser\Core\Contracts\BaseModel;
 
+/**
+ * @phpstan-type unified_response = array{
+ *   dematAccounts?: list<DematAccount>|null,
+ *   insurance?: Insurance|null,
+ *   investor?: Investor|null,
+ *   meta?: Meta|null,
+ *   mutualFunds?: list<MutualFund>|null,
+ *   summary?: Summary|null,
+ * }
+ */
 final class UnifiedResponse implements BaseModel
 {
+    /** @use SdkModel<unified_response> */
     use SdkModel;
 
     /** @var list<DematAccount>|null $dematAccounts */

src/CasParser/UnifiedResponse/DematAccount.php

@@ -11,8 +11,21 @@
 use CasParser\Core\Concerns\SdkModel;
 use CasParser\Core\Contracts\BaseModel;
 
+/**
+ * @phpstan-type demat_account = array{
+ *   additionalInfo?: AdditionalInfo|null,
+ *   boID?: string|null,
+ *   clientID?: string|null,
+ *   dematType?: DematType::*|null,
+ *   dpID?: string|null,
+ *   dpName?: string|null,
+ *   holdings?: Holdings|null,
+ *   value?: float|null,
+ * }
+ */
 final class DematAccount implements BaseModel
 {
+    /** @use SdkModel<demat_account> */
     use SdkModel;
 
     /**

src/CasParser/UnifiedResponse/DematAccount/AdditionalInfo.php

@@ -10,9 +10,21 @@
 
 /**
  * Additional information specific to the demat account type.
+ *
+ * @phpstan-type additional_info = array{
+ *   boStatus?: string|null,
+ *   boSubStatus?: string|null,
+ *   boType?: string|null,
+ *   bsda?: string|null,
+ *   email?: string|null,
+ *   linkedPans?: list<string>|null,
+ *   nominee?: string|null,
+ *   status?: string|null,
+ * }
  */
 final class AdditionalInfo implements BaseModel
 {
+    /** @use SdkModel<additional_info> */
     use SdkModel;
 
     /**

src/CasParser/UnifiedResponse/DematAccount/Holdings.php

@@ -13,8 +13,18 @@
 use CasParser\Core\Concerns\SdkModel;
 use CasParser\Core\Contracts\BaseModel;
 
+/**
+ * @phpstan-type holdings_alias = array{
+ *   aifs?: list<Aif>|null,
+ *   corporateBonds?: list<CorporateBond>|null,
+ *   dematMutualFunds?: list<DematMutualFund>|null,
+ *   equities?: list<Equity>|null,
+ *   governmentSecurities?: list<GovernmentSecurity>|null,
+ * }
+ */
 final class Holdings implements BaseModel
 {
+    /** @use SdkModel<holdings_alias> */
     use SdkModel;
 
     /** @var list<Aif>|null $aifs */