scalekit-sdk-python 2.15.0__tar.gz → 2.17.0__tar.gz

{scalekit_sdk_python-2.15.0 → scalekit_sdk_python-2.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scalekit-sdk-python
-Version: 2.15.0
+Version: 2.17.0
 Summary: Scalekit official Python SDK
 Home-page: https://github.com/scalekit-inc/scalekit-sdk-python
 Author: Team Scalekit
@@ -17,7 +17,7 @@ Requires-Dist: google>=3.0
 Requires-Dist: requests>=2.34.0
 Requires-Dist: PyJWT>=2.13.0
 Requires-Dist: cffi>=1.15.1
-Requires-Dist: cryptography<49,>=46.0.6
+Requires-Dist: cryptography>=50.0.0
 Requires-Dist: setuptools<83.0,>=82.0.1
 Requires-Dist: grpcio-status<2.0,>=1.81.0
 Requires-Dist: protoc-gen-openapiv2>=0.0.1
@@ -27,6 +27,12 @@ Requires-Dist: python-dotenv<2.0,>=1.2.2
 Requires-Dist: Faker<41.0,>=33.0.0
 Requires-Dist: pydantic>=2.13.4
 Requires-Dist: mcp>=1.27.2
+Provides-Extra: flask
+Requires-Dist: flask>=2.0; extra == "flask"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Provides-Extra: django
+Requires-Dist: django>=4.2; extra == "django"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -35,6 +41,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
 Dynamic: license-file
+Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: summary
 
@@ -178,6 +185,88 @@ Explore fully functional sample applications built with popular Python framework
 |-----------|------------|-------------|
 | **FastAPI** | [scalekit-fastapi-example](https://github.com/scalekit-developers/scalekit-fastapi-example) | Modern async Python API framework |
 
+### Full Stack Auth — encrypted-session middleware for Flask, FastAPI, and Django
+
+The example above is for **Modular SSO**: Scalekit brokers the OAuth exchange with your customer's own IdP via a `connection_id`, and your app owns its own session however it likes.
+
+If instead Scalekit hosts your login UI and you want it to also manage the session lifecycle for you (**Full Stack Auth**), `scalekit-sdk-python` ships optional Flask, FastAPI, and Django extras that handle the encrypted session cookie, transparent token refresh, CSRF-safe login/callback, and full logout for you — no hand-rolled cookies, no manual refresh timing.
+
+Register these under **Dashboard → Authentication → Redirects** before testing:
+- **Redirect URI** — your `redirect_uri` (the `/callback` path). Scalekit rejects the exchange if this doesn't match exactly.
+- **Post Logout Redirect URI** — where users land after full logout. A relative path gets auto-absolutized against the request host, but the resulting absolute URL must still be registered.
+- **Initiate Login URL** — your `/login` path. Scalekit redirects here (not `/callback`) for a bookmarked login page, an IdP portal tile, or an invite/magic link — the login view already handles this correctly, including the `idp_initiated_login` case, with no extra code required.
+
+pip install "scalekit-sdk-python[flask]"  # or "scalekit-sdk-python[fastapi]" or "scalekit-sdk-python[django]"
+
+```python
+# Flask
+import os
+from flask import Flask
+from scalekit.frameworks.flask import ScalekitAuth
+
+app = Flask(__name__)
+auth = ScalekitAuth(
+    app,
+    env_url=os.environ["SCALEKIT_ENV_URL"],
+    client_id=os.environ["SCALEKIT_CLIENT_ID"],
+    client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
+    redirect_uri="https://myapp.com/callback",
+    cookie_encryption_secret=os.environ["COOKIE_ENCRYPTION_SECRET"],  # openssl rand -base64 32
+)  # registers /login, /callback, /logout
+
+@app.route("/account")
+@auth.requires_auth
+def account():
+    return {"email": auth.current_user["email"]}
+```
+
+```python
+# FastAPI -- protect routes with Depends(), FastAPI's idiomatic mechanism
+import os
+from fastapi import Depends, FastAPI
+from scalekit.frameworks.fastapi import ScalekitAuth
+
+app = FastAPI()
+auth = ScalekitAuth(
+    env_url=os.environ["SCALEKIT_ENV_URL"],
+    client_id=os.environ["SCALEKIT_CLIENT_ID"],
+    client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
+    redirect_uri="https://myapp.com/callback",
+    cookie_encryption_secret=os.environ["COOKIE_ENCRYPTION_SECRET"],
+)
+auth.install(app)  # registers /login, /callback, /logout
+
+@app.get("/account")
+async def account(user: dict = Depends(auth.requires_auth)):
+    return {"email": user["email"]}
+```
+
+```python
+# Django -- settings.py
+import os
+
+MIDDLEWARE = [..., "scalekit.frameworks.django.ScalekitAuthMiddleware"]
+SCALEKIT_ENV_URL = os.environ["SCALEKIT_ENV_URL"]
+SCALEKIT_CLIENT_ID = os.environ["SCALEKIT_CLIENT_ID"]
+SCALEKIT_CLIENT_SECRET = os.environ["SCALEKIT_CLIENT_SECRET"]
+SCALEKIT_REDIRECT_URI = "https://myapp.com/callback"
+SCALEKIT_COOKIE_ENCRYPTION_SECRET = os.environ["COOKIE_ENCRYPTION_SECRET"]
+
+# urls.py
+from django.urls import include, path
+urlpatterns = [path("", include("scalekit.frameworks.django")), ...]  # /login, /callback, /logout
+
+# views.py
+from django.http import JsonResponse
+from scalekit.frameworks.django import login_required
+
+@login_required
+def account(request):
+    return JsonResponse(request.scalekit_user)
+```
+
+See [`examples/flask`](./examples/flask), [`examples/fastapi`](./examples/fastapi), and [`examples/django`](./examples/django) for complete, runnable versions. For a fuller production-oriented sample app, see the framework repos above.
+
 ## 🔗 Helpful Links
 
 ### 📖 Quickstart Guides

{scalekit_sdk_python-2.15.0 → scalekit_sdk_python-2.17.0}/README.md

@@ -138,6 +138,88 @@ Explore fully functional sample applications built with popular Python framework
 |-----------|------------|-------------|
 | **FastAPI** | [scalekit-fastapi-example](https://github.com/scalekit-developers/scalekit-fastapi-example) | Modern async Python API framework |
 
+### Full Stack Auth — encrypted-session middleware for Flask, FastAPI, and Django
+
+The example above is for **Modular SSO**: Scalekit brokers the OAuth exchange with your customer's own IdP via a `connection_id`, and your app owns its own session however it likes.
+
+If instead Scalekit hosts your login UI and you want it to also manage the session lifecycle for you (**Full Stack Auth**), `scalekit-sdk-python` ships optional Flask, FastAPI, and Django extras that handle the encrypted session cookie, transparent token refresh, CSRF-safe login/callback, and full logout for you — no hand-rolled cookies, no manual refresh timing.
+
+Register these under **Dashboard → Authentication → Redirects** before testing:
+- **Redirect URI** — your `redirect_uri` (the `/callback` path). Scalekit rejects the exchange if this doesn't match exactly.
+- **Post Logout Redirect URI** — where users land after full logout. A relative path gets auto-absolutized against the request host, but the resulting absolute URL must still be registered.
+- **Initiate Login URL** — your `/login` path. Scalekit redirects here (not `/callback`) for a bookmarked login page, an IdP portal tile, or an invite/magic link — the login view already handles this correctly, including the `idp_initiated_login` case, with no extra code required.
+
+pip install "scalekit-sdk-python[flask]"  # or "scalekit-sdk-python[fastapi]" or "scalekit-sdk-python[django]"
+
+```python
+# Flask
+import os
+from flask import Flask
+from scalekit.frameworks.flask import ScalekitAuth
+
+app = Flask(__name__)
+auth = ScalekitAuth(
+    app,
+    env_url=os.environ["SCALEKIT_ENV_URL"],
+    client_id=os.environ["SCALEKIT_CLIENT_ID"],
+    client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
+    redirect_uri="https://myapp.com/callback",
+    cookie_encryption_secret=os.environ["COOKIE_ENCRYPTION_SECRET"],  # openssl rand -base64 32
+)  # registers /login, /callback, /logout
+
+@app.route("/account")
+@auth.requires_auth
+def account():
+    return {"email": auth.current_user["email"]}
+```
+
+```python
+# FastAPI -- protect routes with Depends(), FastAPI's idiomatic mechanism
+import os
+from fastapi import Depends, FastAPI
+from scalekit.frameworks.fastapi import ScalekitAuth
+
+app = FastAPI()
+auth = ScalekitAuth(
+    env_url=os.environ["SCALEKIT_ENV_URL"],
+    client_id=os.environ["SCALEKIT_CLIENT_ID"],
+    client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
+    redirect_uri="https://myapp.com/callback",
+    cookie_encryption_secret=os.environ["COOKIE_ENCRYPTION_SECRET"],
+)
+auth.install(app)  # registers /login, /callback, /logout
+
+@app.get("/account")
+async def account(user: dict = Depends(auth.requires_auth)):
+    return {"email": user["email"]}
+```
+
+```python
+# Django -- settings.py
+import os
+
+MIDDLEWARE = [..., "scalekit.frameworks.django.ScalekitAuthMiddleware"]
+SCALEKIT_ENV_URL = os.environ["SCALEKIT_ENV_URL"]
+SCALEKIT_CLIENT_ID = os.environ["SCALEKIT_CLIENT_ID"]
+SCALEKIT_CLIENT_SECRET = os.environ["SCALEKIT_CLIENT_SECRET"]
+SCALEKIT_REDIRECT_URI = "https://myapp.com/callback"
+SCALEKIT_COOKIE_ENCRYPTION_SECRET = os.environ["COOKIE_ENCRYPTION_SECRET"]
+
+# urls.py
+from django.urls import include, path
+urlpatterns = [path("", include("scalekit.frameworks.django")), ...]  # /login, /callback, /logout
+
+# views.py
+from django.http import JsonResponse
+from scalekit.frameworks.django import login_required
+
+@login_required
+def account(request):
+    return JsonResponse(request.scalekit_user)
+```
+
+See [`examples/flask`](./examples/flask), [`examples/fastapi`](./examples/fastapi), and [`examples/django`](./examples/django) for complete, runnable versions. For a fuller production-oriented sample app, see the framework repos above.
+
 ## 🔗 Helpful Links
 
 ### 📖 Quickstart Guides

{scalekit_sdk_python-2.15.0 → scalekit_sdk_python-2.17.0}/scalekit/_version.py

@@ -1,3 +1,3 @@
 # Single source of truth for the SDK version.
 # Import this in setup.py and scalekit/core.py — never hardcode the version elsewhere.
-__version__ = "2.15.0"
+__version__ = "2.17.0"

{scalekit_sdk_python-2.15.0 → scalekit_sdk_python-2.17.0}/scalekit/auth.py

@@ -1,6 +1,5 @@
 from typing import Optional, Dict, Any, Mapping
 from google.protobuf.json_format import ParseDict
-from google.protobuf.empty_pb2 import Empty
 
 from scalekit.core import CoreClient
 from scalekit.v1.auth import auth_pb2
@@ -29,7 +28,7 @@ class AuthClient:
         connection_id: str,
         login_request_id: str,
         user: Optional[Mapping[str, Any]] = None,
-    ) -> Empty:
+    ) -> auth_pb2.UpdateLoginUserDetailsResponse:
         """
         Method to update user details for a login request
 
@@ -55,7 +54,7 @@ class AuthClient:
         :type                     : ``` dict ```
 
         :returns:
-            Tuple of (Empty response, grpc.Call metadata)
+            Tuple of (UpdateLoginUserDetailsResponse carrying auth_request_id, grpc.Call metadata)
         """
 
         user_data: Dict[str, Any] = {}

{scalekit_sdk_python-2.15.0 → scalekit_sdk_python-2.17.0}/scalekit/client.py

@@ -26,6 +26,7 @@ from scalekit.passwordless import PasswordlessClient
 from scalekit.mcp import McpClient
 from scalekit.sessions import SessionsClient
 from scalekit.auth import AuthClient
+from scalekit.events import EventsClient
 from scalekit.webauthn import WebAuthnClient
 from scalekit.token import TokenClient
 from scalekit.common.scalekit import (
@@ -83,6 +84,7 @@ class ScalekitClient:
             self.passwordless = PasswordlessClient(self.core_client)
             self.sessions = SessionsClient(self.core_client)
             self.auth = AuthClient(self.core_client)
+            self.events = EventsClient(self.core_client)
             self.webauthn = WebAuthnClient(self.core_client)
             self.tokens = TokenClient(self.core_client)
         except Exception:

{scalekit_sdk_python-2.15.0 → scalekit_sdk_python-2.17.0}/scalekit/core.py

@@ -29,7 +29,7 @@ class CoreClient:
 
     sdk_version = f"Scalekit-Python/{_sdk_version}"
     # YYYYMMDD
-    api_version = "20260717"
+    api_version = "20260727"
     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.17.0/scalekit/events.py

@@ -0,0 +1,58 @@
+from typing import Optional
+
+from scalekit.core import CoreClient
+from scalekit.v1.events.events_pb2 import (
+    EventFilter,
+    ListEventsPaginatedRequest,
+    ListEventsPaginatedResponse,
+)
+from scalekit.v1.events.events_pb2_grpc import EventsServiceStub
+
+
+class EventsClient:
+    """Class definition for Events Client"""
+
+    def __init__(self, core_client: CoreClient):
+        """
+        Initializer for Events Client
+
+        :param core_client    : CoreClient Object
+        :type                 : ``` obj ```
+        :returns
+            None
+        """
+        self.core_client = core_client
+        self.events_service = EventsServiceStub(
+            self.core_client.grpc_secure_channel
+        )
+
+    def list_events_paginated(
+        self,
+        page_size: Optional[int] = None,
+        page_token: Optional[str] = None,
+        filter: Optional[EventFilter] = None,  # noqa: A002
+    ) -> ListEventsPaginatedResponse:
+        """
+        Method to list events with pagination
+
+        :param page_size   : page size for events list fetch (optional, uses server default if not provided)
+        :type              : ``` int ```
+        :param page_token  : page token for events list fetch
+        :type              : ``` str ```
+        :param filter      : EventFilter object to filter events (optional)
+        :type              : ``` obj ```
+
+        :returns:
+            List Events Paginated Response
+        """
+        request = ListEventsPaginatedRequest()
+        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.events_service.ListEventsPaginated.with_call,
+            request,
+        )