Feat whitelist enums

example.php

@@ -37,8 +37,8 @@ function getSSLPage($url) {
     }
 
     // Leave the platform you want uncommented
-    $platform = 'client';
-    // $platform = 'console';
+//    $platform = 'client';
+     $platform = 'console';
     // $platform = 'server';
 
     $spec = getSSLPage("https://raw.githubusercontent.com/appwrite/appwrite/master/app/config/specs/swagger2-latest-{$platform}.json");

src/SDK/Language.php

@@ -41,7 +41,7 @@ abstract public function getFiles(): array;
      * @param array $parameter
      * @return string
      */
-    abstract public function getTypeName(array $parameter): string;
+    abstract public function getTypeName(array $parameter, array $spec = []): string;
 
     /**
      * @param array $param
@@ -84,7 +84,7 @@ public function getFilters(): array
         return [];
     }
 
-    protected function toUpperCaseWords(string $value): string
+    protected function toPascalCase(string $value): string
     {
         return ucfirst($this->toCamelCase($value));
     }
@@ -97,4 +97,17 @@ protected function toCamelCase($str): string
         $str = str_replace(" ", "", $str);
         return lcfirst($str);
     }
+
+    protected function toSnakeCase($str): string
+    {
+        $str = \preg_replace('/([a-z])([A-Z])/', '$1 $2', $str);
+        $str = \explode(' ', $str);
+        $str = \implode('_', $str);
+        return \strtolower($str);
+    }
+
+    protected function toUpperSnakeCase($str): string
+    {
+        return \strtoupper($this->toSnakeCase($str));
+    }
 }

src/SDK/Language/Android.php

@@ -387,6 +387,11 @@ public function getFiles(): array
                 'destination'   => 'library/src/main/java/io/appwrite/models/{{ definition.name | caseUcfirst }}.kt',
                 'template'      => '/android/library/src/main/java/io/appwrite/models/Model.kt.twig',
             ],
+            [
+                'scope'         => 'enum',
+                'destination'   => 'library/src/main/java/io/appwrite/enums/{{ enum.name | caseUcfirst }}.kt',
+                'template'      => '/android/library/src/main/java/io/appwrite/enums/Enum.kt.twig',
+            ],
         ];
     }
 }

src/SDK/Language/Dart.php

@@ -112,16 +112,28 @@ public function getKeywords(): array
      */
     public function getIdentifierOverrides(): array
     {
-        return ['Function' => 'Func', 'default' => 'xdefault', 'required' => 'xrequired', 'async' => 'xasync'];
+        return [
+            'Function' => 'Func',
+            'default' => 'xdefault',
+            'required' => 'xrequired',
+            'async' => 'xasync',
+            'enum' => 'xenum',
+        ];
     }
 
     /**
      * @param array $parameter
      * @return string
      */
-    public function getTypeName(array $parameter): string
+    public function getTypeName(array $parameter, array $spec = []): string
     {
-        switch ($parameter['type']) {
+        if (isset($parameter['enumName'])) {
+            return 'enums.' . \ucfirst($parameter['enumName']);
+        }
+        if (!empty($parameter['enumValues'])) {
+            return 'enums.' . \ucfirst($parameter['name']);
+        }
+        switch ($parameter['type'] ?? '') {
             case self::TYPE_INTEGER:
                 return 'int';
             case self::TYPE_STRING:
@@ -131,17 +143,17 @@ public function getTypeName(array $parameter): string
             case self::TYPE_BOOLEAN:
                 return 'bool';
             case self::TYPE_ARRAY:
-                if (!empty($parameter['array']['type'])) {
+                if (!empty(($parameter['array'] ?? [])['type']) && !\is_array($parameter['array']['type'])) {
                     return 'List<' . $this->getTypeName($parameter['array']) . '>';
                 }
                 return 'List';
             case self::TYPE_OBJECT:
                 return 'Map';
             case self::TYPE_NUMBER:
                 return 'double';
+            default:
+                return $parameter['type'];
         }
-
-        return $parameter['type'];
     }
 
     /**
@@ -386,6 +398,11 @@ public function getFiles(): array
                 'destination'   => '/lib/models.dart',
                 'template'      => 'dart/lib/models.dart.twig',
             ],
+            [
+                'scope'         => 'default',
+                'destination'   => '/lib/enums.dart',
+                'template'      => 'dart/lib/enums.dart.twig',
+            ],
             [
                 'scope'         => 'service',
                 'destination'   => '/lib/services/{{service.name | caseDash}}.dart',
@@ -466,6 +483,11 @@ public function getFiles(): array
                 'destination'   => 'lib/src/input_file.dart',
                 'template'      => 'dart/lib/src/input_file.dart.twig',
             ],
+            [
+                'scope'         => 'enum',
+                'destination'   => 'lib/src/enums/{{ enum.name | caseSnake }}.dart',
+                'template'      => 'dart/lib/src/enums/enum.dart.twig',
+            ],
         ];
     }
 
@@ -479,6 +501,9 @@ public function getFilters(): array
                 }
                 return implode("\n", $value);
             }, ['is_safe' => ['html']]),
+            new TwigFilter('caseEnumKey', function (string $value) {
+                return $this->toCamelCase($value);
+            }),
         ];
     }
 }

src/SDK/Language/Deno.php

@@ -2,6 +2,8 @@
 
 namespace Appwrite\SDK\Language;
 
+use Twig\TwigFilter;
+
 class Deno extends JS
 {
     /**
@@ -93,34 +95,37 @@ public function getFiles(): array
                 'destination'   => 'docs/examples/{{service.name | caseLower}}/{{method.name | caseDash}}.md',
                 'template'      => 'deno/docs/example.md.twig',
             ],
+            [
+                'scope'         => 'enum',
+                'destination'   => 'src/enums/{{ enum.name | caseDash }}.ts',
+                'template'      => 'deno/src/enums/enum.ts.twig',
+            ],
         ];
     }
 
     /**
      * @param array $parameter
      * @return string
      */
-    public function getTypeName(array $parameter): string
+    public function getTypeName(array $parameter, array $spec = []): string
     {
-        switch ($parameter['type']) {
-            case self::TYPE_INTEGER:
-                return 'number';
-            case self::TYPE_STRING:
-                return 'string';
-            case self::TYPE_FILE:
-                return 'InputFile';
-            case self::TYPE_BOOLEAN:
-                return 'boolean';
-            case self::TYPE_ARRAY:
-                if (!empty($parameter['array']['type'])) {
-                    return $this->getTypeName($parameter['array']) . '[]';
-                }
-                return 'string[]';
-            case self::TYPE_OBJECT:
-                return 'object';
+        if (isset($parameter['enumName'])) {
+            return \ucfirst($parameter['enumName']);
         }
-
-        return $parameter['type'];
+        if (!empty($parameter['enumValues'])) {
+            return \ucfirst($parameter['name']);
+        }
+        return match ($parameter['type']) {
+            self::TYPE_INTEGER => 'number',
+            self::TYPE_STRING => 'string',
+            self::TYPE_FILE => 'InputFile',
+            self::TYPE_BOOLEAN => 'boolean',
+            self::TYPE_ARRAY => (!empty(($parameter['array'] ?? [])['type']) && !\is_array($parameter['array']['type']))
+                ? $this->getTypeName($parameter['array']) . '[]'
+                : 'string[]',
+            self::TYPE_OBJECT => 'object',
+            default => $parameter['type']
+        };
     }
 
     /**
@@ -176,4 +181,13 @@ public function getParamExample(array $param): string
 
         return $output;
     }
+
+    public function getFilters(): array
+    {
+        return [
+            new TwigFilter('caseEnumKey', function (string $value) {
+                return $this->toPascalCase($value);
+            }),
+        ];
+    }
 }

src/SDK/Language/DotNet.php

@@ -149,29 +149,26 @@ public function getIdentifierOverrides(): array
      * @param array $parameter
      * @return string
      */
-    public function getTypeName(array $parameter): string
+    public function getTypeName(array $parameter, array $spec = []): string
     {
-        switch ($parameter['type']) {
-            case self::TYPE_INTEGER:
-                return 'long';
-            case self::TYPE_NUMBER:
-                return 'double';
-            case self::TYPE_STRING:
-                return 'string';
-            case self::TYPE_FILE:
-                return 'InputFile';
-            case self::TYPE_BOOLEAN:
-                return 'bool';
-            case self::TYPE_ARRAY:
-                if (!empty($parameter['array']['type'])) {
-                    return 'List<' . $this->getTypeName($parameter['array']) . '>';
-                }
-                return 'List<object>';
-            case self::TYPE_OBJECT:
-                return 'object';
+        if (isset($parameter['enumName'])) {
+            return \ucfirst($parameter['enumName']);
         }
-
-        return $parameter['type'];
+        if (!empty($parameter['enumValues'])) {
+            return \ucfirst($parameter['name']);
+        }
+        return match ($parameter['type']) {
+            self::TYPE_INTEGER => 'long',
+            self::TYPE_NUMBER => 'double',
+            self::TYPE_STRING => 'string',
+            self::TYPE_BOOLEAN => 'bool',
+            self::TYPE_FILE => 'InputFile',
+            self::TYPE_ARRAY => (!empty(($parameter['array'] ?? [])['type']) && !\is_array($parameter['array']['type']))
+                ? 'List<' . $this->getTypeName($parameter['array']) . '>'
+                : 'List<object>',
+            self::TYPE_OBJECT => 'object',
+            default => $parameter['type']
+        };
     }
 
     /**
@@ -361,6 +358,11 @@ public function getFiles(): array
                 'destination'   => '/src/{{ spec.title | caseUcfirst }}/Role.cs',
                 'template'      => 'dotnet/src/Appwrite/Role.cs.twig',
             ],
+            [
+                'scope'         => 'default',
+                'destination'   => '/src/{{ spec.title | caseUcfirst }}/Converters/ValueClassConverter.cs',
+                'template'      => 'dotnet/src/Appwrite/Converters/ValueClassConverter.cs.twig',
+            ],
             [
                 'scope'         => 'default',
                 'destination'   => '/src/{{ spec.title | caseUcfirst }}/Extensions/Extensions.cs',
@@ -395,6 +397,16 @@ public function getFiles(): array
                 'scope'         => 'definition',
                 'destination'   => '/src/{{ spec.title | caseUcfirst }}/Models/{{ definition.name | caseUcfirst | overrideIdentifier }}.cs',
                 'template'      => 'dotnet/src/Appwrite/Models/Model.cs.twig',
+            ],
+            [
+                'scope'         => 'enum',
+                'destination'   => '/src/{{ spec.title | caseUcfirst }}/Enums/{{ enum.name | caseUcfirst | overrideIdentifier }}.cs',
+                'template'      => 'dotnet/src/Appwrite/Enums/Enum.cs.twig',
+            ],
+            [
+                'scope'         => 'default',
+                'destination'   => '/src/{{ spec.title | caseUcfirst }}/Enums/IEnum.cs',
+                'template'      => 'dotnet/src/Appwrite/Enums/IEnum.cs.twig',
             ]
         ];
     }
@@ -408,7 +420,10 @@ public function getFilters(): array
                     $value[$key] = "        /// " . wordwrap($line, 75, "\n        /// ");
                 }
                 return implode("\n", $value);
-            }, ['is_safe' => ['html']])
+            }, ['is_safe' => ['html']]),
+            new TwigFilter('caseEnumKey', function (string $value) {
+                return $this->toPascalCase($value);
+            }),
         ];
     }
 }

src/SDK/Language/Flutter.php

@@ -60,6 +60,11 @@ public function getFiles(): array
                 'destination'   => '/lib/models.dart',
                 'template'      => 'dart/lib/models.dart.twig',
             ],
+            [
+                'scope'         => 'default',
+                'destination'   => '/lib/enums.dart',
+                'template'      => 'dart/lib/enums.dart.twig',
+            ],
             [
                 'scope'         => 'default',
                 'destination'   => '/lib/permission.dart',
@@ -330,6 +335,11 @@ public function getFiles(): array
                 'destination'   => '.travis.yml',
                 'template'      => 'flutter/.travis.yml.twig',
             ],
+            [
+                'scope'         => 'enum',
+                'destination'   => 'lib/src/enums/{{ enum.name | caseSnake }}.dart',
+                'template'      => 'dart/lib/src/enums/enum.dart.twig',
+            ],
         ];
     }
 }

src/SDK/Language/Go.php

@@ -106,25 +106,17 @@ public function getFiles(): array
      * @param array $nestedTypes
      * @return string
      */
-    public function getTypeName(array $parameter): string
+    public function getTypeName(array $parameter, array $spec = []): string
     {
-        switch ($parameter['type']) {
-            case self::TYPE_INTEGER:
-                return 'int';
-            case self::TYPE_NUMBER:
-                return 'float64';
-            case self::TYPE_FILE:
-            case self::TYPE_STRING:
-                return 'string';
-            case self::TYPE_BOOLEAN:
-                return 'bool';
-            case self::TYPE_OBJECT:
-                return 'interface{}';
-            case self::TYPE_ARRAY:
-                return '[]interface{}';
-        }
-
-        return $parameter['type'];
+        return match ($parameter['type']) {
+            self::TYPE_INTEGER => 'int',
+            self::TYPE_NUMBER => 'float64',
+            self::TYPE_FILE, self::TYPE_STRING => 'string',
+            self::TYPE_BOOLEAN => 'bool',
+            self::TYPE_OBJECT => 'interface{}',
+            self::TYPE_ARRAY => '[]interface{}',
+            default => $parameter['type'],
+        };
     }
 
     /**
@@ -247,7 +239,10 @@ public function getFilters(): array
                     $value[$key] = "// " . wordwrap($line, 75, "\n// ");
                 }
                 return implode("\n", $value);
-            }, ['is_safe' => ['html']])
+            }, ['is_safe' => ['html']]),
+            new TwigFilter('caseEnumKey', function (string $value) {
+                return $this->toUpperSnakeCase($value);
+            }),
         ];
     }
 }