Add permissions attribute to Role (#287)

* Add permissions to Role resource
* Add phpdocs to Role resource
* Add permissions to OrganizationTest role fixtures

Author: MrCrayfish

lib/Resource/Role.php

@@ -4,6 +4,15 @@
 
 /**
  * Class Role.
+ *
+ * @property string $id
+ * @property string $name
+ * @property string $slug
+ * @property string $description
+ * @property array<string> $permissions
+ * @property string $type
+ * @property string $created_at
+ * @property string $updated_at
  */
 
 class Role extends BaseWorkOSResource
@@ -15,6 +24,7 @@ class Role extends BaseWorkOSResource
         "name",
         "slug",
         "description",
+        "permissions",
         "type",
         "created_at",
         "updated_at"
@@ -25,6 +35,7 @@ class Role extends BaseWorkOSResource
         "name" => "name",
         "slug" => "slug",
         "description" => "description",
+        "permissions" => "permissions",
         "type" => "type",
         "created_at" => "created_at",
         "updated_at" => "updated_at"

tests/WorkOS/OrganizationsTest.php

@@ -298,6 +298,7 @@ private function organizationRolesResponseFixture()
                     "name" => "Admin",
                     "slug" => "admin",
                     "description" => "Admin role",
+                    "permissions" => ["posts:read", "posts:write"],
                     "type" => "EnvironmentRole",
                     "created_at" => "2024-01-01T00:00:00.000Z",
                     "updated_at" => "2024-01-01T00:00:00.000Z"
@@ -308,6 +309,7 @@ private function organizationRolesResponseFixture()
                     "name" => "Member",
                     "slug" => "member",
                     "description" => "Member role",
+                    "permissions" => [],
                     "type" => "EnvironmentRole",
                     "created_at" => "2024-01-01T00:00:00.000Z",
                     "updated_at" => "2024-01-01T00:00:00.000Z"
@@ -318,6 +320,7 @@ private function organizationRolesResponseFixture()
                     "name" => "Org. Member",
                     "slug" => "org-member",
                     "description" => "Organization member role",
+                    "permissions" => ["posts:read"],
                     "type" => "OrganizationRole",
                     "created_at" => "2024-01-01T00:00:00.000Z",
                     "updated_at" => "2024-01-01T00:00:00.000Z"
@@ -333,6 +336,7 @@ private function roleFixture()
             "name" => "Admin",
             "slug" => "admin",
             "description" => "Admin role",
+            "permissions" => ["posts:read", "posts:write"],
             "type" => "EnvironmentRole",
             "created_at" => "2024-01-01T00:00:00.000Z",
             "updated_at" => "2024-01-01T00:00:00.000Z"