feat(client): support raw responses

stainless-app[bot] · stainless-app[bot] · commit db0fac37cc5a · 2025-09-13T02:34:49.000Z
diff --git a/src/CasGenerator/CasGeneratorGenerateCasResponse.php b/src/CasGenerator/CasGeneratorGenerateCasResponse.php
@@ -10,8 +10,12 @@
 
 /**
  * @phpstan-type cas_generator_generate_cas_response = array{
- *   msg?: string|null, status?: string|null
+ *   msg?: string, status?: string
  * }
+ * When used in a response, this type parameter can be used to define a $rawResponse property.
+ * @template TRawResponse of object = object{}
+ *
+ * @mixin TRawResponse
  */
 final class CasGeneratorGenerateCasResponse implements BaseModel
 {
diff --git a/src/CasParser/UnifiedResponse.php b/src/CasParser/UnifiedResponse.php
@@ -16,13 +16,17 @@
 
 /**
  * @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,
+ *   dematAccounts?: list<DematAccount>,
+ *   insurance?: Insurance,
+ *   investor?: Investor,
+ *   meta?: Meta,
+ *   mutualFunds?: list<MutualFund>,
+ *   summary?: Summary,
  * }
+ * When used in a response, this type parameter can be used to define a $rawResponse property.
+ * @template TRawResponse of object = object{}
+ *
+ * @mixin TRawResponse
  */
 final class UnifiedResponse implements BaseModel
 {
diff --git a/src/CasParser/UnifiedResponse/DematAccount.php b/src/CasParser/UnifiedResponse/DematAccount.php
@@ -13,14 +13,14 @@
 
 /**
  * @phpstan-type demat_account = array{
- *   additionalInfo?: AdditionalInfo|null,
- *   boID?: string|null,
- *   clientID?: string|null,
- *   dematType?: value-of<DematType>|null,
- *   dpID?: string|null,
- *   dpName?: string|null,
- *   holdings?: Holdings|null,
- *   value?: float|null,
+ *   additionalInfo?: AdditionalInfo,
+ *   boID?: string,
+ *   clientID?: string,
+ *   dematType?: value-of<DematType>,
+ *   dpID?: string,
+ *   dpName?: string,
+ *   holdings?: Holdings,
+ *   value?: float,
  * }
  */
 final class DematAccount implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/AdditionalInfo.php b/src/CasParser/UnifiedResponse/DematAccount/AdditionalInfo.php
@@ -12,14 +12,14 @@
  * 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,
+ *   boStatus?: string,
+ *   boSubStatus?: string,
+ *   boType?: string,
+ *   bsda?: string,
+ *   email?: string,
+ *   linkedPans?: list<string>,
+ *   nominee?: string,
+ *   status?: string,
  * }
  */
 final class AdditionalInfo implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings.php
@@ -15,11 +15,11 @@
 
 /**
  * @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,
+ *   aifs?: list<Aif>,
+ *   corporateBonds?: list<CorporateBond>,
+ *   dematMutualFunds?: list<DematMutualFund>,
+ *   equities?: list<Equity>,
+ *   governmentSecurities?: list<GovernmentSecurity>,
  * }
  */
 final class Holdings implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/Aif.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/Aif.php
@@ -11,10 +11,10 @@
 /**
  * @phpstan-type aif_alias = array{
  *   additionalInfo?: mixed,
- *   isin?: string|null,
- *   name?: string|null,
- *   units?: float|null,
- *   value?: float|null,
+ *   isin?: string,
+ *   name?: string,
+ *   units?: float,
+ *   value?: float,
  * }
  */
 final class Aif implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/CorporateBond.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/CorporateBond.php
@@ -11,10 +11,10 @@
 /**
  * @phpstan-type corporate_bond = array{
  *   additionalInfo?: mixed,
- *   isin?: string|null,
- *   name?: string|null,
- *   units?: float|null,
- *   value?: float|null,
+ *   isin?: string,
+ *   name?: string,
+ *   units?: float,
+ *   value?: float,
  * }
  */
 final class CorporateBond implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/DematMutualFund.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/DematMutualFund.php
@@ -11,10 +11,10 @@
 /**
  * @phpstan-type demat_mutual_fund = array{
  *   additionalInfo?: mixed,
- *   isin?: string|null,
- *   name?: string|null,
- *   units?: float|null,
- *   value?: float|null,
+ *   isin?: string,
+ *   name?: string,
+ *   units?: float,
+ *   value?: float,
  * }
  */
 final class DematMutualFund implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/Equity.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/Equity.php
@@ -11,10 +11,10 @@
 /**
  * @phpstan-type equity_alias = array{
  *   additionalInfo?: mixed,
- *   isin?: string|null,
- *   name?: string|null,
- *   units?: float|null,
- *   value?: float|null,
+ *   isin?: string,
+ *   name?: string,
+ *   units?: float,
+ *   value?: float,
  * }
  */
 final class Equity implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/GovernmentSecurity.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/GovernmentSecurity.php
@@ -11,10 +11,10 @@
 /**
  * @phpstan-type government_security = array{
  *   additionalInfo?: mixed,
- *   isin?: string|null,
- *   name?: string|null,
- *   units?: float|null,
- *   value?: float|null,
+ *   isin?: string,
+ *   name?: string,
+ *   units?: float,
+ *   value?: float,
  * }
  */
 final class GovernmentSecurity implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Insurance.php b/src/CasParser/UnifiedResponse/Insurance.php
@@ -11,7 +11,7 @@
 
 /**
  * @phpstan-type insurance_alias = array{
- *   lifeInsurancePolicies?: list<LifeInsurancePolicy>|null
+ *   lifeInsurancePolicies?: list<LifeInsurancePolicy>
  * }
  */
 final class Insurance implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Insurance/LifeInsurancePolicy.php b/src/CasParser/UnifiedResponse/Insurance/LifeInsurancePolicy.php
@@ -11,14 +11,14 @@
 /**
  * @phpstan-type life_insurance_policy = array{
  *   additionalInfo?: mixed,
- *   lifeAssured?: string|null,
- *   policyName?: string|null,
- *   policyNumber?: string|null,
- *   premiumAmount?: float|null,
- *   premiumFrequency?: string|null,
- *   provider?: string|null,
- *   status?: string|null,
- *   sumAssured?: float|null,
+ *   lifeAssured?: string,
+ *   policyName?: string,
+ *   policyNumber?: string,
+ *   premiumAmount?: float,
+ *   premiumFrequency?: string,
+ *   provider?: string,
+ *   status?: string,
+ *   sumAssured?: float,
  * }
  */
 final class LifeInsurancePolicy implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Investor.php b/src/CasParser/UnifiedResponse/Investor.php
@@ -10,13 +10,13 @@
 
 /**
  * @phpstan-type investor_alias = array{
- *   address?: string|null,
- *   casID?: string|null,
- *   email?: string|null,
- *   mobile?: string|null,
- *   name?: string|null,
- *   pan?: string|null,
- *   pincode?: string|null,
+ *   address?: string,
+ *   casID?: string,
+ *   email?: string,
+ *   mobile?: string,
+ *   name?: string,
+ *   pan?: string,
+ *   pincode?: string,
  * }
  */
 final class Investor implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Meta.php b/src/CasParser/UnifiedResponse/Meta.php
@@ -12,9 +12,9 @@
 
 /**
  * @phpstan-type meta_alias = array{
- *   casType?: value-of<CasType>|null,
- *   generatedAt?: \DateTimeInterface|null,
- *   statementPeriod?: StatementPeriod|null,
+ *   casType?: value-of<CasType>,
+ *   generatedAt?: \DateTimeInterface,
+ *   statementPeriod?: StatementPeriod,
  * }
  */
 final class Meta implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Meta/StatementPeriod.php b/src/CasParser/UnifiedResponse/Meta/StatementPeriod.php
@@ -10,7 +10,7 @@
 
 /**
  * @phpstan-type statement_period = array{
- *   from?: \DateTimeInterface|null, to?: \DateTimeInterface|null
+ *   from?: \DateTimeInterface, to?: \DateTimeInterface
  * }
  */
 final class StatementPeriod implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/MutualFund.php b/src/CasParser/UnifiedResponse/MutualFund.php
@@ -12,12 +12,12 @@
 
 /**
  * @phpstan-type mutual_fund = array{
- *   additionalInfo?: AdditionalInfo|null,
- *   amc?: string|null,
- *   folioNumber?: string|null,
- *   registrar?: string|null,
- *   schemes?: list<Scheme>|null,
- *   value?: float|null,
+ *   additionalInfo?: AdditionalInfo,
+ *   amc?: string,
+ *   folioNumber?: string,
+ *   registrar?: string,
+ *   schemes?: list<Scheme>,
+ *   value?: float,
  * }
  */
 final class MutualFund implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/MutualFund/AdditionalInfo.php b/src/CasParser/UnifiedResponse/MutualFund/AdditionalInfo.php
@@ -12,7 +12,7 @@
  * Additional folio information.
  *
  * @phpstan-type additional_info = array{
- *   kyc?: string|null, pan?: string|null, pankyc?: string|null
+ *   kyc?: string, pan?: string, pankyc?: string
  * }
  */
 final class AdditionalInfo implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme.php
@@ -14,17 +14,17 @@
 
 /**
  * @phpstan-type scheme_alias = array{
- *   additionalInfo?: AdditionalInfo|null,
- *   cost?: float|null,
- *   gain?: Gain|null,
- *   isin?: string|null,
- *   name?: string|null,
- *   nav?: float|null,
- *   nominees?: list<string>|null,
- *   transactions?: list<Transaction>|null,
- *   type?: value-of<Type>|null,
- *   units?: float|null,
- *   value?: float|null,
+ *   additionalInfo?: AdditionalInfo,
+ *   cost?: float,
+ *   gain?: Gain,
+ *   isin?: string,
+ *   name?: string,
+ *   nav?: float,
+ *   nominees?: list<string>,
+ *   transactions?: list<Transaction>,
+ *   type?: value-of<Type>,
+ *   units?: float,
+ *   value?: float,
  * }
  */
 final class Scheme implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme/AdditionalInfo.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme/AdditionalInfo.php
@@ -12,11 +12,11 @@
  * Additional information specific to the scheme.
  *
  * @phpstan-type additional_info = array{
- *   advisor?: string|null,
- *   amfi?: string|null,
- *   closeUnits?: float|null,
- *   openUnits?: float|null,
- *   rtaCode?: string|null,
+ *   advisor?: string,
+ *   amfi?: string,
+ *   closeUnits?: float,
+ *   openUnits?: float,
+ *   rtaCode?: string,
  * }
  */
 final class AdditionalInfo implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme/Gain.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme/Gain.php
@@ -9,7 +9,7 @@
 use CasParser\Core\Contracts\BaseModel;
 
 /**
- * @phpstan-type gain_alias = array{absolute?: float|null, percentage?: float|null}
+ * @phpstan-type gain_alias = array{absolute?: float, percentage?: float}
  */
 final class Gain implements BaseModel
 {
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme/Transaction.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme/Transaction.php
@@ -10,14 +10,14 @@
 
 /**
  * @phpstan-type transaction_alias = array{
- *   amount?: float|null,
- *   balance?: float|null,
- *   date?: \DateTimeInterface|null,
- *   description?: string|null,
- *   dividendRate?: float|null,
- *   nav?: float|null,
- *   type?: string|null,
- *   units?: float|null,
+ *   amount?: float,
+ *   balance?: float,
+ *   date?: \DateTimeInterface,
+ *   description?: string,
+ *   dividendRate?: float,
+ *   nav?: float,
+ *   type?: string,
+ *   units?: float,
  * }
  */
 final class Transaction implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Summary.php b/src/CasParser/UnifiedResponse/Summary.php
@@ -10,9 +10,7 @@
 use CasParser\Core\Contracts\BaseModel;
 
 /**
- * @phpstan-type summary_alias = array{
- *   accounts?: Accounts|null, totalValue?: float|null
- * }
+ * @phpstan-type summary_alias = array{accounts?: Accounts, totalValue?: float}
  */
 final class Summary implements BaseModel
 {
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts.php b/src/CasParser/UnifiedResponse/Summary/Accounts.php
@@ -13,7 +13,7 @@
 
 /**
  * @phpstan-type accounts_alias = array{
- *   demat?: Demat|null, insurance?: Insurance|null, mutualFunds?: MutualFunds|null
+ *   demat?: Demat, insurance?: Insurance, mutualFunds?: MutualFunds
  * }
  */
 final class Accounts implements BaseModel
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts/Demat.php b/src/CasParser/UnifiedResponse/Summary/Accounts/Demat.php
@@ -9,7 +9,7 @@
 use CasParser\Core\Contracts\BaseModel;
 
 /**
- * @phpstan-type demat_alias = array{count?: int|null, totalValue?: float|null}
+ * @phpstan-type demat_alias = array{count?: int, totalValue?: float}
  */
 final class Demat implements BaseModel
 {
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts/Insurance.php b/src/CasParser/UnifiedResponse/Summary/Accounts/Insurance.php
@@ -9,7 +9,7 @@
 use CasParser\Core\Contracts\BaseModel;
 
 /**
- * @phpstan-type insurance_alias = array{count?: int|null, totalValue?: float|null}
+ * @phpstan-type insurance_alias = array{count?: int, totalValue?: float}
  */
 final class Insurance implements BaseModel
 {
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts/MutualFunds.php b/src/CasParser/UnifiedResponse/Summary/Accounts/MutualFunds.php
diff --git a/src/Core/Implementation/HasRawResponse.php b/src/Core/Implementation/HasRawResponse.php
diff --git a/src/ServiceContracts/CasGeneratorContract.php b/src/ServiceContracts/CasGeneratorContract.php
diff --git a/src/ServiceContracts/CasParserContract.php b/src/ServiceContracts/CasParserContract.php
diff --git a/src/Services/CasGeneratorService.php b/src/Services/CasGeneratorService.php
diff --git a/src/Services/CasParserService.php b/src/Services/CasParserService.php
