Add Permission message to iam/v1/iam.proto (#183)

- Add Permission message to represent a permission in the system, which
has a value and a category.
- Update methods to use this new message instead of using a simple
string to represent the permission value.

Author: Toni Reina

gen/go/qdrant/cloud/iam/v1/iam.pb.go

@@ -644,7 +644,8 @@
             "permissions": {
               "type": "array",
               "items": {
-                "type": "string"
+                "type": "object",
+                "$ref": "#/definitions/v1Permission"
               },
               "description": "The permissions associated with this role."
             },
@@ -690,7 +691,8 @@
             "permissions": {
               "type": "array",
               "items": {
-                "type": "string"
+                "type": "object",
+                "$ref": "#/definitions/v1Permission"
               },
               "description": "The permissions associated with this role."
             },
@@ -834,7 +836,8 @@
         "permissions": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "object",
+            "$ref": "#/definitions/v1Permission"
           },
           "description": "The effective permissions."
         }
@@ -847,9 +850,10 @@
         "permissions": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "object",
+            "$ref": "#/definitions/v1Permission"
           },
-          "description": "The permissions know by the system."
+          "description": "The permissions known by the system."
         }
       },
       "title": "ListPermissionsResponse is the response from the ListPermissions function"
@@ -915,6 +919,20 @@
       "description": "Empty",
       "title": "LogoutUserResponse is the response from the Logout function"
     },
+    "v1Permission": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "The permission value (e.g., \"read:clusters\")."
+        },
+        "category": {
+          "type": "string",
+          "description": "The category of the permission (e.g., \"Cluster\", \"Account\")."
+        }
+      },
+      "description": "A Permission represents a permission in the Qdrant cloud."
+    },
     "v1RecordUserConsentRequest": {
       "type": "object",
       "properties": {
@@ -969,7 +987,8 @@
         "permissions": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "object",
+            "$ref": "#/definitions/v1Permission"
           },
           "description": "The permissions associated with this role."
         },

gen/openapiv2/qdrant/cloud/iam/v1/iam.swagger.json

@@ -134,8 +134,8 @@ class ListPermissionsRequest(_message.Message):
 class ListPermissionsResponse(_message.Message):
     __slots__ = ("permissions",)
     PERMISSIONS_FIELD_NUMBER: _ClassVar[int]
-    permissions: _containers.RepeatedScalarFieldContainer[str]
-    def __init__(self, permissions: _Optional[_Iterable[str]] = ...) -> None: ...
+    permissions: _containers.RepeatedCompositeFieldContainer[Permission]
+    def __init__(self, permissions: _Optional[_Iterable[_Union[Permission, _Mapping]]] = ...) -> None: ...
 
 class ListRolesRequest(_message.Message):
     __slots__ = ("account_id",)
@@ -208,8 +208,8 @@ class ListEffectivePermissionsRequest(_message.Message):
 class ListEffectivePermissionsResponse(_message.Message):
     __slots__ = ("permissions",)
     PERMISSIONS_FIELD_NUMBER: _ClassVar[int]
-    permissions: _containers.RepeatedScalarFieldContainer[str]
-    def __init__(self, permissions: _Optional[_Iterable[str]] = ...) -> None: ...
+    permissions: _containers.RepeatedCompositeFieldContainer[Permission]
+    def __init__(self, permissions: _Optional[_Iterable[_Union[Permission, _Mapping]]] = ...) -> None: ...
 
 class ListUserRolesRequest(_message.Message):
     __slots__ = ("account_id", "user_id")
@@ -271,6 +271,14 @@ class User(_message.Message):
     default_account_id: str
     def __init__(self, id: _Optional[str] = ..., created_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., last_modified_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., email: _Optional[str] = ..., status: _Optional[_Union[UserStatus, str]] = ..., default_account_id: _Optional[str] = ...) -> None: ...
 
+class Permission(_message.Message):
+    __slots__ = ("value", "category")
+    VALUE_FIELD_NUMBER: _ClassVar[int]
+    CATEGORY_FIELD_NUMBER: _ClassVar[int]
+    value: str
+    category: str
+    def __init__(self, value: _Optional[str] = ..., category: _Optional[str] = ...) -> None: ...
+
 class Role(_message.Message):
     __slots__ = ("id", "created_at", "last_modified_at", "account_id", "name", "description", "role_type", "permissions", "sub_type")
     ID_FIELD_NUMBER: _ClassVar[int]
@@ -289,9 +297,9 @@ class Role(_message.Message):
     name: str
     description: str
     role_type: RoleType
-    permissions: _containers.RepeatedScalarFieldContainer[str]
+    permissions: _containers.RepeatedCompositeFieldContainer[Permission]
     sub_type: SystemRoleSubType
-    def __init__(self, id: _Optional[str] = ..., created_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., last_modified_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., account_id: _Optional[str] = ..., name: _Optional[str] = ..., description: _Optional[str] = ..., role_type: _Optional[_Union[RoleType, str]] = ..., permissions: _Optional[_Iterable[str]] = ..., sub_type: _Optional[_Union[SystemRoleSubType, str]] = ...) -> None: ...
+    def __init__(self, id: _Optional[str] = ..., created_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., last_modified_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., account_id: _Optional[str] = ..., name: _Optional[str] = ..., description: _Optional[str] = ..., role_type: _Optional[_Union[RoleType, str]] = ..., permissions: _Optional[_Iterable[_Union[Permission, _Mapping]]] = ..., sub_type: _Optional[_Union[SystemRoleSubType, str]] = ...) -> None: ...
 
 class LogoutUserRequest(_message.Message):
     __slots__ = ()

gen/python/qdrant/cloud/iam/v1/iam_pb2.py

@@ -312,11 +312,11 @@ export declare const ListPermissionsRequestSchema: GenMessage<ListPermissionsReq
  */
 export declare type ListPermissionsResponse = Message<"qdrant.cloud.iam.v1.ListPermissionsResponse"> & {
   /**
-   * The permissions know by the system.
+   * The permissions known by the system.
    *
-   * @generated from field: repeated string permissions = 1;
+   * @generated from field: repeated qdrant.cloud.iam.v1.Permission permissions = 1;
    */
-  permissions: string[];
+  permissions: Permission[];
 };
 
 export declare type ListPermissionsResponseValid = ListPermissionsResponse;
@@ -654,9 +654,9 @@ export declare type ListEffectivePermissionsResponse = Message<"qdrant.cloud.iam
   /**
    * The effective permissions.
    *
-   * @generated from field: repeated string permissions = 1;
+   * @generated from field: repeated qdrant.cloud.iam.v1.Permission permissions = 1;
    */
-  permissions: string[];
+  permissions: Permission[];
 };
 
 export declare type ListEffectivePermissionsResponseValid = ListEffectivePermissionsResponse;
@@ -905,6 +905,35 @@ export declare type UserValid = User;
  */
 export declare const UserSchema: GenMessage<User, {validType: UserValid}>;
 
+/**
+ * A Permission represents a permission in the Qdrant cloud.
+ *
+ * @generated from message qdrant.cloud.iam.v1.Permission
+ */
+export declare type Permission = Message<"qdrant.cloud.iam.v1.Permission"> & {
+  /**
+   * The permission value (e.g., "read:clusters").
+   *
+   * @generated from field: string value = 1;
+   */
+  value: string;
+
+  /**
+   * The category of the permission (e.g., "Cluster", "Account").
+   *
+   * @generated from field: string category = 2;
+   */
+  category: string;
+};
+
+export declare type PermissionValid = Permission;
+
+/**
+ * Describes the message qdrant.cloud.iam.v1.Permission.
+ * Use `create(PermissionSchema)` to create a new message.
+ */
+export declare const PermissionSchema: GenMessage<Permission, {validType: PermissionValid}>;
+
 /**
  * A Role represents a role in the Qdrant cloud.
  *
@@ -968,9 +997,9 @@ export declare type Role = Message<"qdrant.cloud.iam.v1.Role"> & {
   /**
    * The permissions associated with this role.
    *
-   * @generated from field: repeated string permissions = 8;
+   * @generated from field: repeated qdrant.cloud.iam.v1.Permission permissions = 8;
    */
-  permissions: string[];
+  permissions: Permission[];
 
   /**
    * The sub-type of the system role.