fix: add permission and role helper class to node

src/SDK/Language.php

@@ -32,6 +32,25 @@ abstract public function getKeywords(): array;
      */
     abstract public function getIdentifierOverrides(): array;
 
+    /**
+     * Get the static access operator for the language (e.g. '::' for PHP, '.' for JS)
+     * @return string
+     */
+    abstract public function getStaticAccessOperator(): string;
+
+    /**
+     * Get the string quote character for the language (e.g. '"' for PHP, "'" for JS)
+     * @return string
+     */
+    abstract public function getStringQuote(): string;
+
+    /**
+     * Wrap elements in an array syntax for the language
+     * @param string $elements Comma-separated elements
+     * @return string
+     */
+    abstract public function getArrayOf(string $elements): string;
+
     /**
      * @return array<array>
      */
@@ -193,4 +212,68 @@ public function hasPermissionParam(array $parameters): bool
         }
         return false;
     }
+
+    /**
+     * Get the prefix for Permission and Role classes (e.g., 'sdk.' for Node)
+     * @return string
+     */
+    protected function getPermissionPrefix(): string
+    {
+        return '';
+    }
+
+    /**
+     * Transform permission action name for language-specific casing
+     * Override in child classes if needed (e.g., DotNet uses ucfirst)
+     * @param string $action
+     * @return string
+     */
+    protected function transformPermissionAction(string $action): string
+    {
+        return $action;
+    }
+
+    /**
+     * Transform permission role name for language-specific casing
+     * Override in child classes if needed (e.g., DotNet uses ucfirst)
+     * @param string $role
+     * @return string
+     */
+    protected function transformPermissionRole(string $role): string
+    {
+        return $role;
+    }
+
+    /**
+     * Generate permission example code for the language
+     * @param string $example Permission string example
+     * @return string
+     */
+    public function getPermissionExample(string $example): string
+    {
+        $permissions = [];
+        $staticOp = $this->getStaticAccessOperator();
+        $quote = $this->getStringQuote();
+        $prefix = $this->getPermissionPrefix();
+
+        foreach ($this->extractPermissionParts($example) as $permission) {
+            $args = [];
+            if ($permission['id'] !== null) {
+                $args[] = $quote . $permission['id'] . $quote;
+            }
+            if ($permission['innerRole'] !== null) {
+                $args[] = $quote . $permission['innerRole'] . $quote;
+            }
+            $argsString = implode(', ', $args);
+
+            $action = $permission['action'];
+            $role = $permission['role'];
+            $action = $this->transformPermissionAction($action);
+            $role = $this->transformPermissionRole($role);
+
+            $permissions[] = $prefix . 'Permission' . $staticOp . $action . '(' . $prefix . 'Role' . $staticOp . $role . '(' . $argsString . '))';
+        }
+
+        return $this->getArrayOf(implode(', ', $permissions));
+    }
 }

src/SDK/Language/Dart.php

@@ -121,6 +121,21 @@ public function getIdentifierOverrides(): array
         ];
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return "'";
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return '[' . $elements . ']';
+    }
+
     /**
      * @param array $parameter
      * @return string
@@ -252,23 +267,6 @@ public function getParamExample(array $param): string
         };
     }
 
-    public function getPermissionExample(string $example): string
-    {
-        $permissions = [];
-        foreach ($this->extractPermissionParts($example) as $permission) {
-            $args = [];
-            if ($permission['id'] !== null) {
-                $args[] = "'" . $permission['id'] . "'";
-            }
-            if ($permission['innerRole'] !== null) {
-                $args[] = "'" . $permission['innerRole'] . "'";
-            }
-            $argsString = implode(', ', $args);
-            $permissions[] = 'Permission.' . $permission['action'] . '(Role.' . $permission['role'] . '(' . $argsString . '))';
-        }
-        return '[' . implode(', ', $permissions) . ']';
-    }
-
     /**
      * @return array
      */

src/SDK/Language/Deno.php

@@ -12,6 +12,21 @@ public function getName(): string
         return 'Deno';
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return "'";
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return '[' . $elements . ']';
+    }
+
     /**
      * @return array
      */
@@ -188,21 +203,4 @@ public function getParamExample(array $param): string
             self::TYPE_STRING => "'{$example}'",
         };
     }
-
-    public function getPermissionExample(string $example): string
-    {
-        $permissions = [];
-        foreach ($this->extractPermissionParts($example) as $permission) {
-            $args = [];
-            if ($permission['id'] !== null) {
-                $args[] = "'" . $permission['id'] . "'";
-            }
-            if ($permission['innerRole'] !== null) {
-                $args[] = "'" . $permission['innerRole'] . "'";
-            }
-            $argsString = implode(', ', $args);
-            $permissions[] = 'Permission.' . $permission['action'] . '(Role.' . $permission['role'] . '(' . $argsString . '))';
-        }
-        return '[' . implode(', ', $permissions) . ']';
-    }
 }

src/SDK/Language/DotNet.php

@@ -146,6 +146,31 @@ public function getIdentifierOverrides(): array
         ];
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return '"';
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return 'new List<string> { ' . $elements . ' }';
+    }
+
+    protected function transformPermissionAction(string $action): string
+    {
+        return ucfirst($action);
+    }
+
+    protected function transformPermissionRole(string $role): string
+    {
+        return ucfirst($role);
+    }
+
     public function getPropertyOverrides(): array
     {
         return [
@@ -312,23 +337,6 @@ public function getParamExample(array $param): string
         return $output;
     }
 
-    public function getPermissionExample(string $example): string
-    {
-        $permissions = [];
-        foreach ($this->extractPermissionParts($example) as $permission) {
-            $args = [];
-            if ($permission['id'] !== null) {
-                $args[] = '"' . $permission['id'] . '"';
-            }
-            if ($permission['innerRole'] !== null) {
-                $args[] = '"' . $permission['innerRole'] . '"';
-            }
-            $argsString = implode(', ', $args);
-            $permissions[] = 'Permission.' . ucfirst($permission['action']) . '(Role.' . ucfirst($permission['role']) . '(' . $argsString . '))';
-        }
-        return 'new List<string> { ' . implode(', ', $permissions) . ' }';
-    }
-
     /**
      * @return array
      */

src/SDK/Language/Go.php

@@ -44,6 +44,21 @@ public function getKeywords(): array
         ];
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return '"';
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return '[' . $elements . ']';
+    }
+
     /**
      * @return array
      */

src/SDK/Language/GraphQL.php

@@ -12,6 +12,21 @@ public function getName(): string
         return 'GraphQL';
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return '"';
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return '[' . $elements . ']';
+    }
+
     /**
      * @param $type
      * @return string

src/SDK/Language/Kotlin.php

@@ -99,6 +99,21 @@ public function getIdentifierOverrides(): array
         return [];
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return '"';
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return 'listOf(' . $elements . ')';
+    }
+
     /**
      * @param array $parameter
      * @param array $spec
@@ -281,23 +296,6 @@ public function getParamExample(array $param): string
         return $output;
     }
 
-    public function getPermissionExample(string $example): string
-    {
-        $permissions = [];
-        foreach ($this->extractPermissionParts($example) as $permission) {
-            $args = [];
-            if ($permission['id'] !== null) {
-                $args[] = '"' . $permission['id'] . '"';
-            }
-            if ($permission['innerRole'] !== null) {
-                $args[] = '"' . $permission['innerRole'] . '"';
-            }
-            $argsString = implode(', ', $args);
-            $permissions[] = 'Permission.' . $permission['action'] . '(Role.' . $permission['role'] . '(' . $argsString . '))';
-        }
-        return 'listOf(' . implode(', ', $permissions) . ')';
-    }
-
     /**
      * @return array
      */

src/SDK/Language/Node.php

@@ -12,6 +12,26 @@ public function getName(): string
         return 'NodeJS';
     }
 
+    public function getStaticAccessOperator(): string
+    {
+        return '.';
+    }
+
+    public function getStringQuote(): string
+    {
+        return "'";
+    }
+
+    public function getArrayOf(string $elements): string
+    {
+        return '[' . $elements . ']';
+    }
+
+    protected function getPermissionPrefix(): string
+    {
+        return 'sdk.';
+    }
+
     public function getTypeName(array $parameter, array $method = []): string
     {
         if (isset($parameter['enumName'])) {
@@ -140,7 +160,8 @@ public function getParamExample(array $param): string
         }
 
         return match ($type) {
-            self::TYPE_ARRAY, self::TYPE_FILE, self::TYPE_INTEGER, self::TYPE_NUMBER => $example,
+            self::TYPE_ARRAY => $this->isPermissionString($example) ? $this->getPermissionExample($example) : $example,
+            self::TYPE_FILE, self::TYPE_INTEGER, self::TYPE_NUMBER => $example,
             self::TYPE_BOOLEAN => ($example) ? 'true' : 'false',
             self::TYPE_OBJECT => ($example === '{}')
             ? '{}'