scalekit-sdk-python 2.4.7__tar.gz → 2.4.8__tar.gz

{scalekit_sdk_python-2.4.7 → scalekit_sdk_python-2.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scalekit-sdk-python
-Version: 2.4.7
+Version: 2.4.8
 Summary: Scalekit official Python SDK
 Home-page: https://github.com/scalekit-inc/scalekit-sdk-python
 Author: Team Scalekit

{scalekit_sdk_python-2.4.7 → scalekit_sdk_python-2.4.8}/scalekit/client.py

@@ -360,25 +360,24 @@ class ScalekitClient:
         scopes = payload.get("scopes", [])
         return [scope for scope in scopes if scope and scope.strip()]
 
-    def verify_webhook_payload(self, secret: str, headers: Dict[str, str], payload: [str | bytes]) -> bool:
+    def __verify_payload_signature(self, secret: str, webhook_id: str, webhook_timestamp: str, webhook_signature: str, payload: str) -> bool:
         """
-        Method to verify webhook payload
-
-        :param secret      :     Secret for webhook verification
-        :type              :     ``` str ```
-        :param headers     :     Webhook request headers
-        :type              :     ``` dict[str, str] ```
-        :param payload     :     Webhook payload in str or bytes
-        :type              :     ``` str | bytes ```
+        Private method to verify payload signature (common logic for both webhook and interceptor verification)
+
+        :param secret            :     Secret for verification
+        :type                    :     ``` str ```
+        :param webhook_id        :     Webhook/Interceptor ID
+        :type                    :     ``` str ```
+        :param webhook_timestamp :     Webhook/Interceptor timestamp
+        :type                    :     ``` str ```
+        :param webhook_signature :     Webhook/Interceptor signature
+        :type                    :     ``` str ```
+        :param payload           :     Payload string
+        :type                    :     ``` str ```
 
         :returns:
             bool
         """
-        payload = payload if isinstance(payload, str) else payload.decode()
-        webhook_id = headers.get("webhook-id")
-        webhook_timestamp = headers.get("webhook-timestamp")
-        webhook_signature = headers.get("webhook-signature")
-
         if not all([webhook_id, webhook_timestamp, webhook_signature]):
             raise WebhookVerificationError("Missing required headers")
 
@@ -417,6 +416,49 @@ class ScalekitClient:
 
         raise WebhookVerificationError("Invalid signature")
 
+    def verify_webhook_payload(self, secret: str, headers: Dict[str, str], payload: str | bytes) -> bool:
+        """
+        Method to verify webhook payload
+
+        :param secret      :     Secret for webhook verification
+        :type              :     ``` str ```
+        :param headers     :     Webhook request headers
+        :type              :     ``` dict[str, str] ```
+        :param payload     :     Webhook payload in str or bytes
+        :type              :     ``` str | bytes ```
+
+        :returns:
+            bool
+        """
+        payload_str = payload if isinstance(payload, str) else payload.decode()
+        webhook_id = headers.get("webhook-id")
+        webhook_timestamp = headers.get("webhook-timestamp")
+        webhook_signature = headers.get("webhook-signature")
+
+        return self.__verify_payload_signature(secret, webhook_id, webhook_timestamp, webhook_signature, payload_str)
+
+    def verify_interceptor_payload(self, secret: str, headers: Dict[str, str], payload: str | bytes) -> bool:
+        """
+        Method to verify interceptor payload using common verification logic
+
+        :param secret      :     Secret for interceptor verification
+        :type              :     ``` str ```
+        :param headers     :     Interceptor request headers (with interceptor-id, interceptor-timestamp, interceptor-signature)
+        :type              :     ``` dict[str, str] ```
+        :param payload     :     Interceptor payload in str or bytes
+        :type              :     ``` str | bytes ```
+
+        :returns:
+            bool
+        """
+        payload_str = payload if isinstance(payload, str) else payload.decode()
+        
+        interceptor_id = headers.get("interceptor-id") or headers.get("webhook-id")
+        interceptor_timestamp = headers.get("interceptor-timestamp") or headers.get("webhook-timestamp")
+        interceptor_signature = headers.get("interceptor-signature") or headers.get("webhook-signature")
+
+        return self.__verify_payload_signature(secret, interceptor_id, interceptor_timestamp, interceptor_signature, payload_str)
+
     @staticmethod
     def __verify_timestamp(timestamp_str: str):
         """

{scalekit_sdk_python-2.4.7 → scalekit_sdk_python-2.4.8}/scalekit/core.py

@@ -26,8 +26,8 @@ class WithCall(Protocol):
 class CoreClient:
     """Class definition for Core Client"""
 
-    sdk_version = "Scalekit-Python/2.4.7"
-    api_version = "20250917"
+    sdk_version = "Scalekit-Python/2.4.8"
+    api_version = "20250104"
     user_agent = f"{sdk_version} Python/{platform.python_version()} ({platform.system()}; {platform.architecture()}"
 
     def __init__(self, env_url, client_id, client_secret):

scalekit_sdk_python-2.4.8/scalekit/sessions.py

@@ -0,0 +1,134 @@
+from scalekit.core import CoreClient
+from scalekit.v1.sessions.sessions_pb2 import *
+from scalekit.v1.sessions.sessions_pb2_grpc import SessionServiceStub
+from google.protobuf.timestamp_pb2 import Timestamp
+from typing import List, Optional
+
+
+class SessionsClient:
+    """Class definition for Sessions Client"""
+
+    def __init__(self, core_client: CoreClient):
+        """
+        Initializer for Sessions Client
+
+        :param core_client    : CoreClient Object
+        :type                 : ``` obj ```
+        :returns
+            None
+        """
+        self.core_client = core_client
+        self.session_service = SessionServiceStub(
+            self.core_client.grpc_secure_channel
+        )
+
+    def get_session(self, session_id: str) -> SessionDetails:
+        """
+        Method to get session details by session ID
+
+        :param session_id     : Session ID to get session details
+        :type                 : ``` str ```
+
+        :returns:
+            Session Details
+        """
+        return self.core_client.grpc_exec(
+            self.session_service.GetSession.with_call,
+            SessionDetailsRequest(session_id=session_id),
+        )
+
+    def get_user_sessions(
+        self, 
+        user_id: str, 
+        page_size: int = None, 
+        page_token: str = None, 
+        filter: UserSessionFilter = None
+    ) -> UserSessionDetails:
+        """
+        Method to get all session details for a user with pagination and filtering support
+
+        :param user_id        : User ID to get all session details for
+        :type                 : ``` str ```
+        :param page_size      : Number of sessions to return per page
+        :type                 : ``` int ```
+        :param page_token     : Token for pagination to get next/previous page
+        :type                 : ``` str ```
+        :param filter         : Filter to apply to sessions (status, time range)
+        :type                 : ``` UserSessionFilter ```
+
+        :returns:
+            User Session Details with pagination info
+        """
+        request = UserSessionDetailsRequest(user_id=user_id)
+        
+        if page_size is not None:
+            request.page_size = page_size
+        if page_token is not None:
+            request.page_token = page_token
+        if filter is not None:
+            request.filter.CopyFrom(filter)
+            
+        return self.core_client.grpc_exec(
+            self.session_service.GetUserSessions.with_call,
+            request,
+        )
+
+    def revoke_session(self, session_id: str) -> RevokeSessionResponse:
+        """
+        Method to revoke a session for a user
+
+        :param session_id     : Session ID to revoke
+        :type                 : ``` str ```
+
+        :returns:
+            Revoke Session Response
+        """
+        return self.core_client.grpc_exec(
+            self.session_service.RevokeSession.with_call,
+            RevokeSessionRequest(session_id=session_id),
+        )
+
+    def revoke_all_user_sessions(self, user_id: str) -> RevokeAllUserSessionsResponse:
+        """
+        Method to revoke all sessions for a user
+
+        :param user_id        : User ID to revoke all sessions for
+        :type                 : ``` str ```
+
+        :returns:
+            Revoke All User Sessions Response
+        """
+        return self.core_client.grpc_exec(
+            self.session_service.RevokeAllUserSessions.with_call,
+            RevokeAllUserSessionsRequest(user_id=user_id),
+        )
+
+    @staticmethod
+    def create_session_filter(
+        status: Optional[List[str]] = None,
+        start_time: Optional[Timestamp] = None,
+        end_time: Optional[Timestamp] = None
+    ) -> UserSessionFilter:
+        """
+        Helper method to create a UserSessionFilter for filtering sessions
+
+        :param status         : List of session statuses to filter by
+        :type                 : ``` List[str] ```
+        :param start_time     : Filter sessions from this timestamp
+        :type                 : ``` Timestamp ```
+        :param end_time       : Filter sessions until this timestamp
+        :type                 : ``` Timestamp ```
+
+        :returns:
+            UserSessionFilter object
+        """
+        filter_obj = UserSessionFilter()
+        
+        if status is not None:
+            filter_obj.status.extend(status)
+        if start_time is not None:
+            filter_obj.start_time.CopyFrom(start_time)
+        if end_time is not None:
+            filter_obj.end_time.CopyFrom(end_time)
+            
+        return filter_obj

{scalekit_sdk_python-2.4.7 → scalekit_sdk_python-2.4.8}/scalekit/v1/auditlogs/auditlogs_pb2.py

@@ -18,7 +18,7 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from scalekit.v1.options import options_pb2 as scalekit_dot_v1_dot_options_dot_options__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n%scalekit/v1/auditlogs/auditlogs.proto\x12\x15scalekit.v1.auditlogs\x1a\x1b\x62uf/validate/validate.proto\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a!scalekit/v1/options/options.proto\"\xf0\x01\n\x12ListAuthLogRequest\x12\x1b\n\tpage_size\x18\x01 \x01(\rR\x08pageSize\x12\x1d\n\npage_token\x18\x02 \x01(\tR\tpageToken\x12\x14\n\x05\x65mail\x18\x03 \x01(\tR\x05\x65mail\x12\x16\n\x06status\x18\x04 \x01(\tR\x06status\x12\x39\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\tstartTime\x12\x35\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x07\x65ndTime\"\xcf\x01\n\x13ListAuthLogResponse\x12&\n\x0fnext_page_token\x18\x01 \x01(\tR\rnextPageToken\x12&\n\x0fprev_page_token\x18\x02 \x01(\tR\rprevPageToken\x12\x1d\n\ntotal_size\x18\x03 \x01(\rR\ttotalSize\x12I\n\x0c\x61uthRequests\x18\x04 \x03(\x0b\x32%.scalekit.v1.auditlogs.AuthLogRequestR\x0c\x61uthRequests\"\xe4\x03\n\x0e\x41uthLogRequest\x12\'\n\x0forganization_id\x18\x01 \x01(\tR\x0eorganizationId\x12%\n\x0e\x65nvironment_id\x18\x02 \x01(\tR\renvironmentId\x12#\n\rconnection_id\x18\x03 \x01(\tR\x0c\x63onnectionId\x12&\n\x0f\x61uth_request_id\x18\x04 \x01(\tR\rauthRequestId\x12\x14\n\x05\x65mail\x18\x05 \x01(\tR\x05\x65mail\x12\'\n\x0f\x63onnection_type\x18\x06 \x01(\tR\x0e\x63onnectionType\x12/\n\x13\x63onnection_provider\x18\x07 \x01(\tR\x12\x63onnectionProvider\x12\x16\n\x06status\x18\x08 \x01(\tR\x06status\x12\x38\n\ttimestamp\x18\t \x01(\x0b\x32\x1a.google.protobuf.TimestampR\ttimestamp\x12W\n\x12\x63onnection_details\x18\n \x03(\x0b\x32(.scalekit.v1.auditlogs.ConnectionDetailsR\x11\x63onnectionDetails\x12\x1a\n\x08workflow\x18\x0b \x01(\tR\x08workflow\"\xbb\x01\n\x11\x43onnectionDetails\x12#\n\rconnection_id\x18\x01 \x01(\tR\x0c\x63onnectionId\x12\'\n\x0forganization_id\x18\x02 \x01(\tR\x0eorganizationId\x12\'\n\x0f\x63onnection_type\x18\x03 \x01(\tR\x0e\x63onnectionType\x12/\n\x13\x63onnection_provider\x18\x04 \x01(\tR\x12\x63onnectionProvider2\xb2\x01\n\x10\x41uditLogsService\x12\x9d\x01\n\x10ListAuthRequests\x12).scalekit.v1.auditlogs.ListAuthLogRequest\x1a*.scalekit.v1.auditlogs.ListAuthLogResponse\"2\x82\xb5\x18\x02\x18T\x82\xd3\xe4\x93\x02&\x12$/api/v1/logs/authentication/requestsB5Z3github.com/scalekit-inc/scalekit/pkg/grpc/auditlogsb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n%scalekit/v1/auditlogs/auditlogs.proto\x12\x15scalekit.v1.auditlogs\x1a\x1b\x62uf/validate/validate.proto\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a!scalekit/v1/options/options.proto\"\xf0\x01\n\x12ListAuthLogRequest\x12\x1b\n\tpage_size\x18\x01 \x01(\rR\x08pageSize\x12\x1d\n\npage_token\x18\x02 \x01(\tR\tpageToken\x12\x14\n\x05\x65mail\x18\x03 \x01(\tR\x05\x65mail\x12\x16\n\x06status\x18\x04 \x03(\tR\x06status\x12\x39\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\tstartTime\x12\x35\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x07\x65ndTime\"\xcf\x01\n\x13ListAuthLogResponse\x12&\n\x0fnext_page_token\x18\x01 \x01(\tR\rnextPageToken\x12&\n\x0fprev_page_token\x18\x02 \x01(\tR\rprevPageToken\x12\x1d\n\ntotal_size\x18\x03 \x01(\rR\ttotalSize\x12I\n\x0c\x61uthRequests\x18\x04 \x03(\x0b\x32%.scalekit.v1.auditlogs.AuthLogRequestR\x0c\x61uthRequests\"\xe4\x03\n\x0e\x41uthLogRequest\x12\'\n\x0forganization_id\x18\x01 \x01(\tR\x0eorganizationId\x12%\n\x0e\x65nvironment_id\x18\x02 \x01(\tR\renvironmentId\x12#\n\rconnection_id\x18\x03 \x01(\tR\x0c\x63onnectionId\x12&\n\x0f\x61uth_request_id\x18\x04 \x01(\tR\rauthRequestId\x12\x14\n\x05\x65mail\x18\x05 \x01(\tR\x05\x65mail\x12\'\n\x0f\x63onnection_type\x18\x06 \x01(\tR\x0e\x63onnectionType\x12/\n\x13\x63onnection_provider\x18\x07 \x01(\tR\x12\x63onnectionProvider\x12\x16\n\x06status\x18\x08 \x01(\tR\x06status\x12\x38\n\ttimestamp\x18\t \x01(\x0b\x32\x1a.google.protobuf.TimestampR\ttimestamp\x12W\n\x12\x63onnection_details\x18\n \x03(\x0b\x32(.scalekit.v1.auditlogs.ConnectionDetailsR\x11\x63onnectionDetails\x12\x1a\n\x08workflow\x18\x0b \x01(\tR\x08workflow\"\xbb\x01\n\x11\x43onnectionDetails\x12#\n\rconnection_id\x18\x01 \x01(\tR\x0c\x63onnectionId\x12\'\n\x0forganization_id\x18\x02 \x01(\tR\x0eorganizationId\x12\'\n\x0f\x63onnection_type\x18\x03 \x01(\tR\x0e\x63onnectionType\x12/\n\x13\x63onnection_provider\x18\x04 \x01(\tR\x12\x63onnectionProvider2\xb2\x01\n\x10\x41uditLogsService\x12\x9d\x01\n\x10ListAuthRequests\x12).scalekit.v1.auditlogs.ListAuthLogRequest\x1a*.scalekit.v1.auditlogs.ListAuthLogResponse\"2\x82\xb5\x18\x02\x18T\x82\xd3\xe4\x93\x02&\x12$/api/v1/logs/authentication/requestsB5Z3github.com/scalekit-inc/scalekit/pkg/grpc/auditlogsb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)

{scalekit_sdk_python-2.4.7 → scalekit_sdk_python-2.4.8}/scalekit/v1/auditlogs/auditlogs_pb2.pyi

@@ -20,10 +20,10 @@ class ListAuthLogRequest(_message.Message):
     page_size: int
     page_token: str
     email: str
-    status: str
+    status: _containers.RepeatedScalarFieldContainer[str]
     start_time: _timestamp_pb2.Timestamp
     end_time: _timestamp_pb2.Timestamp
-    def __init__(self, page_size: _Optional[int] = ..., page_token: _Optional[str] = ..., email: _Optional[str] = ..., status: _Optional[str] = ..., start_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., end_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ...) -> None: ...
+    def __init__(self, page_size: _Optional[int] = ..., page_token: _Optional[str] = ..., email: _Optional[str] = ..., status: _Optional[_Iterable[str]] = ..., start_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., end_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ...) -> None: ...
 
 class ListAuthLogResponse(_message.Message):
     __slots__ = ("next_page_token", "prev_page_token", "total_size", "authRequests")