vortex-python-sdk 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

{vortex_python_sdk-0.0.1.dist-info → vortex_python_sdk-0.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vortex-python-sdk
-Version: 0.0.1
+Version: 0.0.2
 Summary: Vortex Python SDK for invitation management and JWT generation
 Author-email: TeamVortexSoftware <support@vortexsoftware.com>
 License-Expression: MIT
@@ -67,16 +67,33 @@ vortex = Vortex(api_key="your-api-key", base_url="https://custom-api.example.com
 ```python
 # Generate JWT for a user
 jwt = vortex.generate_jwt({
-    "user_id": "user123",
-    "identifiers": {
-        "email": "user@example.com",
-        "username": "johndoe"
-    },
-    "groups": ["admin", "users"],
+    "user_id": "user-123",
+    "identifiers": [
+        {"type": "email", "value": "user@example.com"}
+    ],
+    "groups": [
+        {"type": "team", "id": "team-1", "name": "Engineering"}
+    ],
     "role": "admin"
 })
 
 print(f"JWT: {jwt}")
+
+# Or using type-safe models
+from vortex_sdk import JwtPayload, IdentifierInput, GroupInput
+
+jwt = vortex.generate_jwt(
+    JwtPayload(
+        user_id="user-123",
+        identifiers=[
+            IdentifierInput(type="email", value="user@example.com")
+        ],
+        groups=[
+            GroupInput(type="team", id="team-1", name="Engineering")
+        ],
+        role="admin"
+    )
+)
 ```
 
 ### Invitation Management

vortex_python_sdk-0.0.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+vortex_python_sdk-0.0.2.dist-info/licenses/LICENSE,sha256=VndlWxbL4-w3YDf2yE5gJscj4zVXF0qlSq0LDtay3lo,1074
+vortex_sdk/__init__.py,sha256=BVRNzjJmtAX7QjUSqG1qL_l3jpVp-AOxMhuBdCCPFOg,709
+vortex_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vortex_sdk/types.py,sha256=49M5wb1PjFPeeqzZurd91rIaCTJK2Ll-L28BQhxd4wI,3026
+vortex_sdk/vortex.py,sha256=gtIuLkW4XY6zMClNeMukicEU8Afr6RYA7RHG25YTtmE,13275
+vortex_python_sdk-0.0.2.dist-info/METADATA,sha256=iFMbcUiLIgSOhbijKHdXYQkKJb2rgFjPrCRrxnBu33g,6198
+vortex_python_sdk-0.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+vortex_python_sdk-0.0.2.dist-info/top_level.txt,sha256=xFDlEcXIIi_sBhkse0YfMnSdg2IlaYUd0oP2UCDc_Y0,11
+vortex_python_sdk-0.0.2.dist-info/RECORD,,

vortex_sdk/__init__.py

@@ -8,6 +8,8 @@ from .vortex import Vortex
 from .types import (
     AuthenticatedUser,
     JwtPayload,
+    IdentifierInput,
+    GroupInput,
     InvitationTarget,
     Invitation,
     CreateInvitationRequest,
@@ -16,7 +18,7 @@ from .types import (
     VortexApiError
 )
 
-__version__ = "0.0.1"
+__version__ = "0.0.2"
 __author__ = "TeamVortexSoftware"
 __email__ = "support@vortexsoftware.com"
 
@@ -24,6 +26,8 @@ __all__ = [
     "Vortex",
     "AuthenticatedUser",
     "JwtPayload",
+    "IdentifierInput",
+    "GroupInput",
     "InvitationTarget",
     "Invitation",
     "CreateInvitationRequest",

vortex_sdk/types.py

@@ -1,18 +1,62 @@
 from typing import Dict, List, Optional, Union, Literal
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
+
+
+class IdentifierInput(BaseModel):
+    """Identifier structure for JWT generation"""
+    type: Literal["email", "sms"]
+    value: str
+
+
+class GroupInput(BaseModel):
+    """Group structure for JWT generation (input)"""
+    type: str
+    id: Optional[str] = None  # Legacy field (deprecated, use groupId)
+    groupId: Optional[str] = Field(None, alias="group_id", serialization_alias="groupId")  # Preferred: Customer's group ID
+    name: str
+
+    class Config:
+        populate_by_name = True
+
+
+class InvitationGroup(BaseModel):
+    """
+    Invitation group from API responses
+    This matches the MemberGroups table structure from the API
+    """
+    id: str  # Vortex internal UUID
+    account_id: str  # Vortex account ID (camelCase in JSON: accountId)
+    group_id: str  # Customer's group ID (camelCase in JSON: groupId)
+    type: str  # Group type (e.g., "workspace", "team")
+    name: str  # Group name
+    created_at: str  # ISO 8601 timestamp (camelCase in JSON: createdAt)
+
+    class Config:
+        # Allow both snake_case (Python) and camelCase (JSON) field names
+        populate_by_name = True
+        json_schema_extra = {
+            "example": {
+                "id": "550e8400-e29b-41d4-a716-446655440000",
+                "accountId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
+                "groupId": "workspace-123",
+                "type": "workspace",
+                "name": "My Workspace",
+                "createdAt": "2025-01-27T12:00:00.000Z"
+            }
+        }
 
 
 class AuthenticatedUser(BaseModel):
     user_id: str
-    identifiers: Dict[str, str]
-    groups: Optional[List[str]] = None
+    identifiers: List[IdentifierInput]
+    groups: Optional[List[GroupInput]] = None
     role: Optional[str] = None
 
 
 class JwtPayload(BaseModel):
     user_id: str
-    identifiers: Dict[str, str]
-    groups: Optional[List[str]] = None
+    identifiers: List[IdentifierInput]
+    groups: Optional[List[GroupInput]] = None
     role: Optional[str] = None
 
 
@@ -24,8 +68,7 @@ class InvitationTarget(BaseModel):
 class Invitation(BaseModel):
     id: str
     target: InvitationTarget
-    group_type: Optional[str] = None
-    group_id: Optional[str] = None
+    groups: Optional[List[InvitationGroup]] = None  # Full group information
     status: str
     created_at: str
     updated_at: Optional[str] = None

vortex_sdk/vortex.py

@@ -49,14 +49,18 @@ class Vortex:
             "typ": "JWT"
         }
 
-        # JWT Payload
+        # JWT Payload - serialize identifiers and groups to dicts
         jwt_payload = {
             "userId": payload.user_id,
-            "identifiers": payload.identifiers,
+            "identifiers": [{"type": id.type, "value": id.value} for id in payload.identifiers],
         }
 
         if payload.groups is not None:
-            jwt_payload["groups"] = payload.groups
+            # Serialize groups, using model_dump to handle camelCase conversion
+            jwt_payload["groups"] = [
+                {k: v for k, v in group.model_dump(by_alias=True, exclude_none=True).items()}
+                for group in payload.groups
+            ]
         if payload.role is not None:
             jwt_payload["role"] = payload.role
 

vortex_python_sdk-0.0.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-vortex_python_sdk-0.0.1.dist-info/licenses/LICENSE,sha256=VndlWxbL4-w3YDf2yE5gJscj4zVXF0qlSq0LDtay3lo,1074
-vortex_sdk/__init__.py,sha256=mFLcyV2i5W7xuj25cThFWYBm6S0HpeOGtUIHDenzhBc,631
-vortex_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vortex_sdk/types.py,sha256=whBfV7yVcrmk5K7ex1s4FCs92V9_bj-7KUsCRi5fmgk,1491
-vortex_sdk/vortex.py,sha256=_Ov62rzGdLecbID6LVQLMZgDc96xw7jY5qNqsfUjV3o,12963
-vortex_python_sdk-0.0.1.dist-info/METADATA,sha256=BH1AkI5SMi_mhRtttqLa5w1o2gk8ymwdzX3emM6U5iQ,5765
-vortex_python_sdk-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-vortex_python_sdk-0.0.1.dist-info/top_level.txt,sha256=xFDlEcXIIi_sBhkse0YfMnSdg2IlaYUd0oP2UCDc_Y0,11
-vortex_python_sdk-0.0.1.dist-info/RECORD,,