chore: simplify model initialization

stainless-app[bot] · stainless-app[bot] · commit f38ec08395db · 2025-08-30T03:08:59.000Z
diff --git a/src/CasGenerator/CasGeneratorGenerateCasParams.php b/src/CasGenerator/CasGeneratorGenerateCasParams.php
@@ -91,8 +91,7 @@ final class CasGeneratorGenerateCasParams implements BaseModel
      */
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasGenerator/CasGeneratorGenerateCasResponse.php b/src/CasGenerator/CasGeneratorGenerateCasResponse.php
@@ -26,8 +26,7 @@ final class CasGeneratorGenerateCasResponse implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/CasParserCamsKfintechParams.php b/src/CasParser/CasParserCamsKfintechParams.php
@@ -45,8 +45,7 @@ final class CasParserCamsKfintechParams implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/CasParserCdslParams.php b/src/CasParser/CasParserCdslParams.php
@@ -45,8 +45,7 @@ final class CasParserCdslParams implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/CasParserNsdlParams.php b/src/CasParser/CasParserNsdlParams.php
@@ -45,8 +45,7 @@ final class CasParserNsdlParams implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/CasParserSmartParseParams.php b/src/CasParser/CasParserSmartParseParams.php
@@ -45,8 +45,7 @@ final class CasParserSmartParseParams implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse.php b/src/CasParser/UnifiedResponse.php
@@ -51,8 +51,7 @@ final class UnifiedResponse implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount.php b/src/CasParser/UnifiedResponse/DematAccount.php
@@ -77,8 +77,7 @@ final class DematAccount implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/AdditionalInfo.php b/src/CasParser/UnifiedResponse/DematAccount/AdditionalInfo.php
@@ -79,8 +79,7 @@ final class AdditionalInfo implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings.php
@@ -53,8 +53,7 @@ final class Holdings implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/Aif.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/Aif.php
@@ -54,8 +54,7 @@ final class Aif implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/CorporateBond.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/CorporateBond.php
@@ -54,8 +54,7 @@ final class CorporateBond implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/DematMutualFund.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/DematMutualFund.php
@@ -54,8 +54,7 @@ final class DematMutualFund implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/Equity.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/Equity.php
@@ -54,8 +54,7 @@ final class Equity implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/DematAccount/Holdings/GovernmentSecurity.php b/src/CasParser/UnifiedResponse/DematAccount/Holdings/GovernmentSecurity.php
@@ -54,8 +54,7 @@ final class GovernmentSecurity implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Insurance.php b/src/CasParser/UnifiedResponse/Insurance.php
@@ -29,8 +29,7 @@ final class Insurance implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Insurance/LifeInsurancePolicy.php b/src/CasParser/UnifiedResponse/Insurance/LifeInsurancePolicy.php
@@ -82,8 +82,7 @@ final class LifeInsurancePolicy implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Investor.php b/src/CasParser/UnifiedResponse/Investor.php
@@ -68,8 +68,7 @@ final class Investor implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Meta.php b/src/CasParser/UnifiedResponse/Meta.php
@@ -41,8 +41,7 @@ final class Meta implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Meta/StatementPeriod.php b/src/CasParser/UnifiedResponse/Meta/StatementPeriod.php
@@ -32,8 +32,7 @@ final class StatementPeriod implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/MutualFund.php b/src/CasParser/UnifiedResponse/MutualFund.php
@@ -61,8 +61,7 @@ final class MutualFund implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/MutualFund/AdditionalInfo.php b/src/CasParser/UnifiedResponse/MutualFund/AdditionalInfo.php
@@ -40,8 +40,7 @@ final class AdditionalInfo implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme.php
@@ -99,8 +99,7 @@ final class Scheme implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme/AdditionalInfo.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme/AdditionalInfo.php
@@ -56,8 +56,7 @@ final class AdditionalInfo implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme/Gain.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme/Gain.php
@@ -30,8 +30,7 @@ final class Gain implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/MutualFund/Scheme/Transaction.php b/src/CasParser/UnifiedResponse/MutualFund/Scheme/Transaction.php
@@ -75,8 +75,7 @@ final class Transaction implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Summary.php b/src/CasParser/UnifiedResponse/Summary.php
@@ -30,8 +30,7 @@ final class Summary implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts.php b/src/CasParser/UnifiedResponse/Summary/Accounts.php
@@ -32,8 +32,7 @@ final class Accounts implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts/Demat.php b/src/CasParser/UnifiedResponse/Summary/Accounts/Demat.php
@@ -30,8 +30,7 @@ final class Demat implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts/Insurance.php b/src/CasParser/UnifiedResponse/Summary/Accounts/Insurance.php
@@ -30,8 +30,7 @@ final class Insurance implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/CasParser/UnifiedResponse/Summary/Accounts/MutualFunds.php b/src/CasParser/UnifiedResponse/Summary/Accounts/MutualFunds.php
@@ -30,8 +30,7 @@ final class MutualFunds implements BaseModel
 
     public function __construct()
     {
-        self::introspect();
-        $this->unsetOptionalProperties();
+        $this->initialize();
     }
 
     /**
diff --git a/src/Core/Concerns/SdkModel.php b/src/Core/Concerns/SdkModel.php
@@ -50,6 +50,8 @@ public function __unserialize(array $data): void
     }
 
     /**
+     * @internal
+     *
      * @return array<string, mixed>
      */
     public function __debugInfo(): array
@@ -135,8 +137,6 @@ public function offsetExists(mixed $offset): bool
      * @internal
      *
      * @param key-of<Shape> $offset
-     *
-     * @return value-of<Shape>
      */
     public function &offsetGet(mixed $offset): mixed
     {
@@ -205,6 +205,8 @@ public function offsetUnset(mixed $offset): void
     }
 
     /**
+     * @internal
+     *
      * @return array<string, mixed>
      */
     public function jsonSerialize(): array
@@ -238,16 +240,10 @@ public static function converter(): Converter
     /**
      * @internal
      */
-    public static function introspect(): void
+    private function initialize(): void
     {
         static::converter();
-    }
 
-    /**
-     * @internal
-     */
-    private function unsetOptionalProperties(): void
-    {
         foreach (self::$converter->properties as $name => $info) {
             if ($info->optional) {
                 unset($this->{$name});
diff --git a/src/Core/Concerns/SdkPage.php b/src/Core/Concerns/SdkPage.php
@@ -70,7 +70,7 @@ public function getNextPage(): static
     }
 
     /**
-     * Generator yielding each page (instance of static).
+     * Iterator yielding each page (instance of static).
      *
      * @return \Generator<static>
      */
@@ -87,7 +87,7 @@ public function getIterator(): \Generator
     }
 
     /**
-     * Generator yielding each item across all pages.
+     * Iterator yielding each item across all pages.
      *
      * @return \Generator<Item>
      */
@@ -101,13 +101,17 @@ public function pagingEachItem(): \Generator
     }
 
     /**
+     * @internal
+     *
      * @param array<string, mixed> $data
      *
      * @return static<Item>
      */
     abstract public static function fromArray(array $data): static;
 
     /**
+     * @internal
+     *
      * @return array{normalized_request, RequestOptions}
      */
     abstract protected function nextRequest(): ?array;
diff --git a/src/Core/Services/CasGeneratorService.php b/src/Core/Services/CasGeneratorService.php
diff --git a/src/Core/Services/CasParserService.php b/src/Core/Services/CasParserService.php
diff --git a/src/RequestOptions.php b/src/RequestOptions.php
diff --git a/tests/Core/TestModel.php b/tests/Core/TestModel.php

Original file line number	Diff line number	Diff line change
`@@ -91,8 +91,7 @@ final class CasGeneratorGenerateCasParams implements BaseModel`
`91`	`91`	`*/`
`92`	`92`	`public function __construct()`
`93`	`93`	`{`
`94`		`- self::introspect();`
`95`		`- $this->unsetOptionalProperties();`
	`94`	`+ $this->initialize();`
`96`	`95`	`}`
`97`	`96`
`98`	`97`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -26,8 +26,7 @@ final class CasGeneratorGenerateCasResponse implements BaseModel`
`26`	`26`
`27`	`27`	`public function __construct()`
`28`	`28`	`{`
`29`		`- self::introspect();`
`30`		`- $this->unsetOptionalProperties();`
	`29`	`+ $this->initialize();`
`31`	`30`	`}`
`32`	`31`
`33`	`32`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -45,8 +45,7 @@ final class CasParserCamsKfintechParams implements BaseModel`
`45`	`45`
`46`	`46`	`public function __construct()`
`47`	`47`	`{`
`48`		`- self::introspect();`
`49`		`- $this->unsetOptionalProperties();`
	`48`	`+ $this->initialize();`
`50`	`49`	`}`
`51`	`50`
`52`	`51`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -51,8 +51,7 @@ final class UnifiedResponse implements BaseModel`
`51`	`51`
`52`	`52`	`public function __construct()`
`53`	`53`	`{`
`54`		`- self::introspect();`
`55`		`- $this->unsetOptionalProperties();`
	`54`	`+ $this->initialize();`
`56`	`55`	`}`
`57`	`56`
`58`	`57`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -77,8 +77,7 @@ final class DematAccount implements BaseModel`
`77`	`77`
`78`	`78`	`public function __construct()`
`79`	`79`	`{`
`80`		`- self::introspect();`
`81`		`- $this->unsetOptionalProperties();`
	`80`	`+ $this->initialize();`
`82`	`81`	`}`
`83`	`82`
`84`	`83`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -79,8 +79,7 @@ final class AdditionalInfo implements BaseModel`
`79`	`79`
`80`	`80`	`public function __construct()`
`81`	`81`	`{`
`82`		`- self::introspect();`
`83`		`- $this->unsetOptionalProperties();`
	`82`	`+ $this->initialize();`
`84`	`83`	`}`
`85`	`84`
`86`	`85`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -53,8 +53,7 @@ final class Holdings implements BaseModel`
`53`	`53`
`54`	`54`	`public function __construct()`
`55`	`55`	`{`
`56`		`- self::introspect();`
`57`		`- $this->unsetOptionalProperties();`
	`56`	`+ $this->initialize();`
`58`	`57`	`}`
`59`	`58`
`60`	`59`	`/**`