[IMP] Add clerk organizations types and CRUD endpoints.

Update Organization object.

Author: Cyril De Faria

.gitignore

@@ -137,3 +137,4 @@ dmypy.json
 # Cython debug symbols
 cython_debug/
 
+*.idea

clerk/client.py

@@ -51,6 +51,12 @@ def users(self):
 
         return UsersService(self)
 
+    @property
+    def organizations(self):
+        from clerk.organizations import OrganizationsService
+
+        return OrganizationsService(self)
+
     @asynccontextmanager
     async def get(
         self, endpoint: str, params: Optional[Mapping[str, str]] = None

clerk/organizations.py

@@ -0,0 +1,31 @@
+from typing import List
+
+from clerk import types
+from clerk.client import Service
+
+
+class OrganizationsService(Service):
+    endpoint = "organizations"
+
+    async def list(self) -> List[types.Organization]:
+        """Retrieve a list of all organizations"""
+        async with self._client.get(self.endpoint) as r:
+            s = await r.json()
+            return [types.Organization.parse_obj(s) for s in s.get("data")]
+
+    async def get(self, organization_id: str) -> types.Organization:
+        """Retrieve an organization by their id"""
+        async with self._client.get(f"{self.endpoint}/{organization_id}") as r:
+            return types.Organization.parse_obj(await r.json())
+
+    async def delete(self, organization_id: str) -> types.DeleteOrganizationResponse:
+        """Delete an organization by their id"""
+        async with self._client.delete(f"{self.endpoint}/{organization_id}") as r:
+            return types.DeleteOrganizationResponse.parse_obj(await r.json())
+
+    async def update(self, organization_id: str, request: types.UpdateOrganizationRequest) -> types.Organization:
+        """Update an organization by their id"""
+        async with self._client.patch(
+            f"{self.endpoint}/{organization_id}", data=request.json(exclude_unset=True)
+        ) as r:
+            return types.Organization.parse_obj(await r.json())

clerk/types.py

@@ -83,16 +83,43 @@ class VerifyRequest(BaseModel):
     token: str
 
 
-class DeleteUserResponse(BaseModel):
+class DeleteResponse(BaseModel):
     object: str
     id: str
     deleted: bool
 
 
+class DeleteUserResponse(DeleteResponse):
+    pass
+
+
 class UpdateUserRequest(BaseModel):
     first_name: Optional[str] = None
     last_name: Optional[str] = None
     primary_email_address_id: Optional[str] = None
     primary_phone_number_id: Optional[str] = None
     profile_image: Optional[str] = None
     password: Optional[str] = None
+
+
+class Organization(BaseModel):
+    object: str
+    id: str
+    name: str
+    slug: str
+    max_allowed_memberships: int
+    admin_delete_enabled: bool | None = None
+    public_metadata: dict
+    private_metadata: dict
+    created_by: str | None = None
+
+
+class DeleteOrganizationResponse(DeleteResponse):
+    pass
+
+
+class UpdateOrganizationRequest(BaseModel):
+    name: str | None = None
+    slug: str | None = None
+    max_allowed_memberships: int | None = None
+    admin_delete_enabled: bool | None = None