feat(client): use real enums

Author: stainless-app[bot]

src/CasGenerator/CasGeneratorGenerateCasParams.php

@@ -32,7 +32,7 @@
  *   fromDate: string,
  *   password: string,
  *   toDate: string,
- *   casAuthority?: CasAuthority::*,
+ *   casAuthority?: CasAuthority|value-of<CasAuthority>,
  *   panNo?: string,
  * }
  */
@@ -69,7 +69,7 @@ final class CasGeneratorGenerateCasParams implements BaseModel
     /**
      * CAS authority to generate the document from (currently only kfintech is supported).
      *
-     * @var CasAuthority::*|null $casAuthority
+     * @var value-of<CasAuthority>|null $casAuthority
      */
     #[Api('cas_authority', enum: CasAuthority::class, optional: true)]
     public ?string $casAuthority;
@@ -110,14 +110,14 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
-     * @param CasAuthority::* $casAuthority
+     * @param CasAuthority|value-of<CasAuthority> $casAuthority
      */
     public static function with(
         string $email,
         string $fromDate,
         string $password,
         string $toDate,
-        ?string $casAuthority = null,
+        CasAuthority|string|null $casAuthority = null,
         ?string $panNo = null,
     ): self {
         $obj = new self;
@@ -127,7 +127,7 @@ public static function with(
         $obj->password = $password;
         $obj->toDate = $toDate;
 
-        null !== $casAuthority && $obj->casAuthority = $casAuthority;
+        null !== $casAuthority && $obj->casAuthority = $casAuthority instanceof CasAuthority ? $casAuthority->value : $casAuthority;
         null !== $panNo && $obj->panNo = $panNo;
 
         return $obj;
@@ -180,12 +180,12 @@ public function withToDate(string $toDate): self
     /**
      * CAS authority to generate the document from (currently only kfintech is supported).
      *
-     * @param CasAuthority::* $casAuthority
+     * @param CasAuthority|value-of<CasAuthority> $casAuthority
      */
-    public function withCasAuthority(string $casAuthority): self
+    public function withCasAuthority(CasAuthority|string $casAuthority): self
     {
         $obj = clone $this;
-        $obj->casAuthority = $casAuthority;
+        $obj->casAuthority = $casAuthority instanceof CasAuthority ? $casAuthority->value : $casAuthority;
 
         return $obj;
     }

src/CasGenerator/CasGeneratorGenerateCasParams/CasAuthority.php

@@ -4,21 +4,16 @@
 
 namespace CasParser\CasGenerator\CasGeneratorGenerateCasParams;
 
-use CasParser\Core\Concerns\SdkEnum;
-use CasParser\Core\Conversion\Contracts\ConverterSource;
-
 /**
  * CAS authority to generate the document from (currently only kfintech is supported).
  */
-final class CasAuthority implements ConverterSource
+enum CasAuthority: string
 {
-    use SdkEnum;
-
-    public const KFINTECH = 'kfintech';
+    case KFINTECH = 'kfintech';
 
-    public const CAMS = 'cams';
+    case CAMS = 'cams';
 
-    public const CDSL = 'cdsl';
+    case CDSL = 'cdsl';
 
-    public const NSDL = 'nsdl';
+    case NSDL = 'nsdl';
 }

src/CasParser/UnifiedResponse/DematAccount.php

@@ -16,7 +16,7 @@
  *   additionalInfo?: AdditionalInfo|null,
  *   boID?: string|null,
  *   clientID?: string|null,
- *   dematType?: DematType::*|null,
+ *   dematType?: value-of<DematType>|null,
  *   dpID?: string|null,
  *   dpName?: string|null,
  *   holdings?: Holdings|null,
@@ -49,7 +49,7 @@ final class DematAccount implements BaseModel
     /**
      * Type of demat account.
      *
-     * @var DematType::*|null $dematType
+     * @var value-of<DematType>|null $dematType
      */
     #[Api('demat_type', enum: DematType::class, optional: true)]
     public ?string $dematType;
@@ -85,13 +85,13 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
-     * @param DematType::* $dematType
+     * @param DematType|value-of<DematType> $dematType
      */
     public static function with(
         ?AdditionalInfo $additionalInfo = null,
         ?string $boID = null,
         ?string $clientID = null,
-        ?string $dematType = null,
+        DematType|string|null $dematType = null,
         ?string $dpID = null,
         ?string $dpName = null,
         ?Holdings $holdings = null,
@@ -102,7 +102,7 @@ public static function with(
         null !== $additionalInfo && $obj->additionalInfo = $additionalInfo;
         null !== $boID && $obj->boID = $boID;
         null !== $clientID && $obj->clientID = $clientID;
-        null !== $dematType && $obj->dematType = $dematType;
+        null !== $dematType && $obj->dematType = $dematType instanceof DematType ? $dematType->value : $dematType;
         null !== $dpID && $obj->dpID = $dpID;
         null !== $dpName && $obj->dpName = $dpName;
         null !== $holdings && $obj->holdings = $holdings;
@@ -147,12 +147,12 @@ public function withClientID(string $clientID): self
     /**
      * Type of demat account.
      *
-     * @param DematType::* $dematType
+     * @param DematType|value-of<DematType> $dematType
      */
-    public function withDematType(string $dematType): self
+    public function withDematType(DematType|string $dematType): self
     {
         $obj = clone $this;
-        $obj->dematType = $dematType;
+        $obj->dematType = $dematType instanceof DematType ? $dematType->value : $dematType;
 
         return $obj;
     }

src/CasParser/UnifiedResponse/DematAccount/DematType.php

@@ -4,17 +4,12 @@
 
 namespace CasParser\CasParser\UnifiedResponse\DematAccount;
 
-use CasParser\Core\Concerns\SdkEnum;
-use CasParser\Core\Conversion\Contracts\ConverterSource;
-
 /**
  * Type of demat account.
  */
-final class DematType implements ConverterSource
+enum DematType: string
 {
-    use SdkEnum;
-
-    public const NSDL = 'NSDL';
+    case NSDL = 'NSDL';
 
-    public const CDSL = 'CDSL';
+    case CDSL = 'CDSL';
 }

src/CasParser/UnifiedResponse/Meta.php

@@ -12,7 +12,7 @@
 
 /**
  * @phpstan-type meta_alias = array{
- *   casType?: CasType::*|null,
+ *   casType?: value-of<CasType>|null,
  *   generatedAt?: \DateTimeInterface|null,
  *   statementPeriod?: StatementPeriod|null,
  * }
@@ -25,7 +25,7 @@ final class Meta implements BaseModel
     /**
      * Type of CAS detected and processed.
      *
-     * @var CasType::*|null $casType
+     * @var value-of<CasType>|null $casType
      */
     #[Api('cas_type', enum: CasType::class, optional: true)]
     public ?string $casType;
@@ -49,16 +49,16 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
-     * @param CasType::* $casType
+     * @param CasType|value-of<CasType> $casType
      */
     public static function with(
-        ?string $casType = null,
+        CasType|string|null $casType = null,
         ?\DateTimeInterface $generatedAt = null,
         ?StatementPeriod $statementPeriod = null,
     ): self {
         $obj = new self;
 
-        null !== $casType && $obj->casType = $casType;
+        null !== $casType && $obj->casType = $casType instanceof CasType ? $casType->value : $casType;
         null !== $generatedAt && $obj->generatedAt = $generatedAt;
         null !== $statementPeriod && $obj->statementPeriod = $statementPeriod;
 
@@ -68,12 +68,12 @@ public static function with(
     /**
      * Type of CAS detected and processed.
      *
-     * @param CasType::* $casType
+     * @param CasType|value-of<CasType> $casType
      */
-    public function withCasType(string $casType): self
+    public function withCasType(CasType|string $casType): self
     {
         $obj = clone $this;
-        $obj->casType = $casType;
+        $obj->casType = $casType instanceof CasType ? $casType->value : $casType;
 
         return $obj;
     }

src/CasParser/UnifiedResponse/Meta/CasType.php

@@ -4,19 +4,14 @@
 
 namespace CasParser\CasParser\UnifiedResponse\Meta;
 
-use CasParser\Core\Concerns\SdkEnum;
-use CasParser\Core\Conversion\Contracts\ConverterSource;
-
 /**
  * Type of CAS detected and processed.
  */
-final class CasType implements ConverterSource
+enum CasType: string
 {
-    use SdkEnum;
-
-    public const NSDL = 'NSDL';
+    case NSDL = 'NSDL';
 
-    public const CDSL = 'CDSL';
+    case CDSL = 'CDSL';
 
-    public const CAMS_KFINTECH = 'CAMS_KFINTECH';
+    case CAMS_KFINTECH = 'CAMS_KFINTECH';
 }

src/CasParser/UnifiedResponse/MutualFund/Scheme.php

@@ -22,7 +22,7 @@
  *   nav?: float|null,
  *   nominees?: list<string>|null,
  *   transactions?: list<Transaction>|null,
- *   type?: Type::*|null,
+ *   type?: value-of<Type>|null,
  *   units?: float|null,
  *   value?: float|null,
  * }
@@ -80,7 +80,7 @@ final class Scheme implements BaseModel
     /**
      * Type of mutual fund scheme.
      *
-     * @var Type::*|null $type
+     * @var value-of<Type>|null $type
      */
     #[Api(enum: Type::class, optional: true)]
     public ?string $type;
@@ -109,7 +109,7 @@ public function __construct()
      *
      * @param list<string> $nominees
      * @param list<Transaction> $transactions
-     * @param Type::* $type
+     * @param Type|value-of<Type> $type
      */
     public static function with(
         ?AdditionalInfo $additionalInfo = null,
@@ -120,7 +120,7 @@ public static function with(
         ?float $nav = null,
         ?array $nominees = null,
         ?array $transactions = null,
-        ?string $type = null,
+        Type|string|null $type = null,
         ?float $units = null,
         ?float $value = null,
     ): self {
@@ -134,7 +134,7 @@ public static function with(
         null !== $nav && $obj->nav = $nav;
         null !== $nominees && $obj->nominees = $nominees;
         null !== $transactions && $obj->transactions = $transactions;
-        null !== $type && $obj->type = $type;
+        null !== $type && $obj->type = $type instanceof Type ? $type->value : $type;
         null !== $units && $obj->units = $units;
         null !== $value && $obj->value = $value;
 
@@ -231,12 +231,12 @@ public function withTransactions(array $transactions): self
     /**
      * Type of mutual fund scheme.
      *
-     * @param Type::* $type
+     * @param Type|value-of<Type> $type
      */
-    public function withType(string $type): self
+    public function withType(Type|string $type): self
     {
         $obj = clone $this;
-        $obj->type = $type;
+        $obj->type = $type instanceof Type ? $type->value : $type;
 
         return $obj;
     }

src/CasParser/UnifiedResponse/MutualFund/Scheme/Type.php

@@ -4,21 +4,16 @@
 
 namespace CasParser\CasParser\UnifiedResponse\MutualFund\Scheme;
 
-use CasParser\Core\Concerns\SdkEnum;
-use CasParser\Core\Conversion\Contracts\ConverterSource;
-
 /**
  * Type of mutual fund scheme.
  */
-final class Type implements ConverterSource
+enum Type: string
 {
-    use SdkEnum;
-
-    public const EQUITY = 'Equity';
+    case EQUITY = 'Equity';
 
-    public const DEBT = 'Debt';
+    case DEBT = 'Debt';
 
-    public const HYBRID = 'Hybrid';
+    case HYBRID = 'Hybrid';
 
-    public const OTHER = 'Other';
+    case OTHER = 'Other';
 }

src/Core/Attributes/Api.php

@@ -6,6 +6,7 @@
 
 use CasParser\Core\Conversion\Contracts\Converter;
 use CasParser\Core\Conversion\Contracts\ConverterSource;
+use CasParser\Core\Conversion\EnumOf;
 use CasParser\Core\Conversion\ListOf;
 use CasParser\Core\Conversion\MapOf;
 
@@ -15,14 +16,15 @@
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class Api
 {
-    /**
-     * @var class-string<ConverterSource>|Converter|string|null
-     */
+    /** @var class-string<ConverterSource>|Converter|string|null */
     public readonly Converter|string|null $type;
 
+    /** @var array<string,Converter> */
+    private static array $enumConverters = [];
+
     /**
      * @param class-string<ConverterSource>|Converter|string|null $type
-     * @param class-string<ConverterSource>|Converter|null        $enum
+     * @param class-string<\BackedEnum>|Converter|null            $enum
      * @param class-string<ConverterSource>|Converter|null        $union
      * @param class-string<ConverterSource>|Converter|string|null $list
      * @param class-string<ConverterSource>|Converter|string|null $map
@@ -37,6 +39,28 @@ public function __construct(
         public readonly bool $nullable = false,
         public readonly bool $optional = false,
     ) {
-        $this->type = $type ?? $enum ?? $union ?? ($list ? new ListOf($list) : ($map ? new MapOf($map) : null));
+        $type ??= $union;
+        if (null !== $list) {
+            $type ??= new ListOf($list);
+        }
+        if (null !== $map) {
+            $type ??= new MapOf($map);
+        }
+        if (null !== $enum) {
+            $type ??= $enum instanceof Converter ? $enum : $this->getEnumConverter($enum);
+        }
+
+        $this->type = $type;
+    }
+
+    /** @property class-string<\BackedEnum> $enum */
+    private function getEnumConverter(string $enum): Converter
+    {
+        if (!isset(self::$enumConverters[$enum])) {
+            $converter = new EnumOf(array_column($enum::cases(), 'value')); // @phpstan-ignore-line
+            self::$enumConverters[$enum] = $converter;
+        }
+
+        return self::$enumConverters[$enum];
     }
 }

src/ServiceContracts/CasGeneratorContract.php

@@ -19,7 +19,7 @@ interface CasGeneratorContract
      * @param string $fromDate Start date for the CAS period (format YYYY-MM-DD)
      * @param string $password Password to protect the generated CAS PDF
      * @param string $toDate End date for the CAS period (format YYYY-MM-DD)
-     * @param CasAuthority::* $casAuthority CAS authority to generate the document from (currently only kfintech is supported)
+     * @param CasAuthority|value-of<CasAuthority> $casAuthority CAS authority to generate the document from (currently only kfintech is supported)
      * @param string $panNo PAN number (optional for some CAS authorities)
      */
     public function generateCas(