quantumapi 0.1.0b0__tar.gz → 0.2.0b1__tar.gz

{quantumapi-0.1.0b0/quantumapi.egg-info → quantumapi-0.2.0b1}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: quantumapi
-Version: 0.1.0b0
+Version: 0.2.0b1
 Summary: Official Python SDK for QuantumAPI - Quantum-safe encryption and identity platform
 Author-email: QuantumAPI Team <developers@quantumapi.eu>
 License-Expression: MIT
 Project-URL: Homepage, https://quantumapi.eu
 Project-URL: Documentation, https://docs.quantumapi.eu/sdk/python
-Project-URL: Repository, https://github.com/victorZKov/mislata
-Project-URL: Bug Tracker, https://github.com/victorZKov/mislata/issues
-Project-URL: Changelog, https://github.com/victorZKov/mislata/blob/main/src/sdk/python-quantumapi/CHANGELOG.md
+Project-URL: Repository, https://github.com/victorZKov/quantumapi
+Project-URL: Bug Tracker, https://github.com/victorZKov/quantumapi/issues
+Project-URL: Changelog, https://github.com/victorZKov/quantumapi/blob/main/src/sdk/python-quantumapi/CHANGELOG.md
 Keywords: quantum,encryption,post-quantum,cryptography,security,api,sdk,ml-kem,ml-dsa,pqc
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -424,13 +424,25 @@ client = QuantumAPIClient(
 
 Check out the [examples/](./examples/) directory for more comprehensive examples:
 
-- [Basic encryption and decryption](./examples/01_encryption_basics.py)
-- [Secret management](./examples/02_secret_management.py)
-- [Key generation and rotation](./examples/03_key_management.py)
-- [User management](./examples/04_user_management.py)
-- [Audit log queries](./examples/05_audit_logs.py)
-- [Django integration](./examples/frameworks/django_integration.py)
-- [Flask integration](./examples/frameworks/flask_integration.py)
+**Basic Examples:**
+- [01_encryption_basics.py](./examples/01_encryption_basics.py) - Basic encryption and decryption
+- [02_secret_management.py](./examples/02_secret_management.py) - Secret CRUD operations
+- [03_key_management.py](./examples/03_key_management.py) - Key generation and rotation
+- [04_error_handling.py](./examples/04_error_handling.py) - Error handling patterns
+- [05_health_monitoring.py](./examples/05_health_monitoring.py) - Health checks and monitoring
+- [06_configuration.py](./examples/06_configuration.py) - Configuration options
+
+**Advanced Secret Management:**
+- [07_versioning.py](./examples/07_versioning.py) - Secret versioning and rotation
+- [08_sharing.py](./examples/08_sharing.py) - Secure secret sharing with access controls
+- [09_batch_operations.py](./examples/09_batch_operations.py) - Batch operations at scale
+
+Run any example with:
+
+```bash
+export QUANTUMAPI_API_KEY="qapi_your_key_here"
+python examples/01_encryption_basics.py
+```
 
 ## Framework Integrations
 
@@ -543,7 +555,7 @@ See [CHANGELOG.md](CHANGELOG.md) for a history of changes to this SDK.
 
 ## Security
 
-For security concerns, please email security@quantumapi.eu. Do not create public issues for security vulnerabilities.
+For security concerns, please email it@kovimatic.ie. Do not create public issues for security vulnerabilities.
 
 ## Links
 

{quantumapi-0.1.0b0 → quantumapi-0.2.0b1}/README.md

@@ -383,13 +383,25 @@ client = QuantumAPIClient(
 
 Check out the [examples/](./examples/) directory for more comprehensive examples:
 
-- [Basic encryption and decryption](./examples/01_encryption_basics.py)
-- [Secret management](./examples/02_secret_management.py)
-- [Key generation and rotation](./examples/03_key_management.py)
-- [User management](./examples/04_user_management.py)
-- [Audit log queries](./examples/05_audit_logs.py)
-- [Django integration](./examples/frameworks/django_integration.py)
-- [Flask integration](./examples/frameworks/flask_integration.py)
+**Basic Examples:**
+- [01_encryption_basics.py](./examples/01_encryption_basics.py) - Basic encryption and decryption
+- [02_secret_management.py](./examples/02_secret_management.py) - Secret CRUD operations
+- [03_key_management.py](./examples/03_key_management.py) - Key generation and rotation
+- [04_error_handling.py](./examples/04_error_handling.py) - Error handling patterns
+- [05_health_monitoring.py](./examples/05_health_monitoring.py) - Health checks and monitoring
+- [06_configuration.py](./examples/06_configuration.py) - Configuration options
+
+**Advanced Secret Management:**
+- [07_versioning.py](./examples/07_versioning.py) - Secret versioning and rotation
+- [08_sharing.py](./examples/08_sharing.py) - Secure secret sharing with access controls
+- [09_batch_operations.py](./examples/09_batch_operations.py) - Batch operations at scale
+
+Run any example with:
+
+```bash
+export QUANTUMAPI_API_KEY="qapi_your_key_here"
+python examples/01_encryption_basics.py
+```
 
 ## Framework Integrations
 
@@ -502,7 +514,7 @@ See [CHANGELOG.md](CHANGELOG.md) for a history of changes to this SDK.
 
 ## Security
 
-For security concerns, please email security@quantumapi.eu. Do not create public issues for security vulnerabilities.
+For security concerns, please email it@kovimatic.ie. Do not create public issues for security vulnerabilities.
 
 ## Links
 

{quantumapi-0.1.0b0 → quantumapi-0.2.0b1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantumapi"
-version = "0.1.0b0"
+version = "0.2.0b1"
 description = "Official Python SDK for QuantumAPI - Quantum-safe encryption and identity platform"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -60,9 +60,9 @@ dev = [
 [project.urls]
 Homepage = "https://quantumapi.eu"
 Documentation = "https://docs.quantumapi.eu/sdk/python"
-Repository = "https://github.com/victorZKov/mislata"
-"Bug Tracker" = "https://github.com/victorZKov/mislata/issues"
-Changelog = "https://github.com/victorZKov/mislata/blob/main/src/sdk/python-quantumapi/CHANGELOG.md"
+Repository = "https://github.com/victorZKov/quantumapi"
+"Bug Tracker" = "https://github.com/victorZKov/quantumapi/issues"
+Changelog = "https://github.com/victorZKov/quantumapi/blob/main/src/sdk/python-quantumapi/CHANGELOG.md"
 
 [tool.setuptools.packages.find]
 include = ["quantumapi*"]

{quantumapi-0.1.0b0 → quantumapi-0.2.0b1}/quantumapi/client/__init__.py

@@ -1,7 +1,9 @@
 """Client package for QuantumAPI SDK."""
 
+from quantumapi.client.applications import ApplicationsClient
 from quantumapi.client.async_client import QuantumAPIClient
 from quantumapi.client.encryption import EncryptionClient
+from quantumapi.client.end_users import EndUsersClient
 from quantumapi.client.health import HealthClient
 from quantumapi.client.keys import KeysClient
 from quantumapi.client.secrets import SecretsClient
@@ -10,6 +12,8 @@ from quantumapi.client.sync_client import QuantumAPISyncClient
 __all__ = [
     "QuantumAPIClient",
     "QuantumAPISyncClient",
+    "ApplicationsClient",
+    "EndUsersClient",
     "EncryptionClient",
     "KeysClient",
     "SecretsClient",

quantumapi-0.2.0b1/quantumapi/client/applications.py

@@ -0,0 +1,180 @@
+"""Applications client for QuantumAPI SDK."""
+
+from typing import List, Optional
+from uuid import UUID
+
+from quantumapi.client.base import BaseClient
+from quantumapi.models.applications import (
+    Application,
+    ApplicationEnvironment,
+    ApplicationType,
+    CreateApplicationRequest,
+    CreateApplicationResponse,
+    RotateSecretResponse,
+    UpdateApplicationRequest,
+)
+
+
+class ApplicationsClient:
+    """Client for OIDC application management operations."""
+
+    def __init__(self, base_client: BaseClient) -> None:
+        self._client = base_client
+
+    async def create(
+        self,
+        name: str,
+        application_type: ApplicationType,
+        redirect_uris: Optional[List[str]] = None,
+        description: Optional[str] = None,
+        environment: ApplicationEnvironment = ApplicationEnvironment.DEVELOPMENT,
+        post_logout_redirect_uris: Optional[List[str]] = None,
+        allowed_scopes: Optional[List[str]] = None,
+    ) -> CreateApplicationResponse:
+        """
+        Create a new OIDC application.
+
+        Args:
+            name: Application name
+            application_type: Type (SPA, WebApp, NativeApp, MachineToMachine, Agent)
+            redirect_uris: Allowed redirect URIs for the OIDC flow
+            description: Optional description
+            environment: Target environment (Development, Staging, Production)
+            post_logout_redirect_uris: Allowed post-logout redirect URIs
+            allowed_scopes: Allowed OAuth2 scopes
+
+        Returns:
+            Created application with client secret (shown once for confidential apps)
+
+        Example:
+            >>> result = await client.applications.create(
+            ...     name="My SPA",
+            ...     application_type=ApplicationType.SPA,
+            ...     redirect_uris=["http://localhost:3000/callback"],
+            ... )
+            >>> print(result.application.client_id)
+        """
+        request = CreateApplicationRequest(
+            name=name,
+            application_type=application_type,
+            redirect_uris=redirect_uris or [],
+            description=description,
+            environment=environment,
+            post_logout_redirect_uris=post_logout_redirect_uris,
+            allowed_scopes=allowed_scopes,
+        )
+        response = await self._client.post(
+            "/api/v1/applications",
+            json_data=request.model_dump(by_alias=True, exclude_none=True),
+        )
+        return CreateApplicationResponse(**response)
+
+    async def list(self) -> List[Application]:
+        """
+        List all applications for the current tenant.
+
+        Returns:
+            List of applications
+
+        Example:
+            >>> apps = await client.applications.list()
+            >>> for app in apps:
+            ...     print(app.display_name)
+        """
+        response = await self._client.get("/api/v1/applications")
+        return [Application(**item) for item in response]
+
+    async def get(self, application_id: UUID) -> Application:
+        """
+        Get application details by ID.
+
+        Args:
+            application_id: Application ID
+
+        Returns:
+            Application details
+
+        Example:
+            >>> app = await client.applications.get(app_id)
+            >>> print(app.display_name)
+        """
+        response = await self._client.get(f"/api/v1/applications/{application_id}")
+        return Application(**response)
+
+    async def update(
+        self,
+        application_id: UUID,
+        display_name: str,
+        environment: ApplicationEnvironment,
+        redirect_uris: List[str],
+        description: Optional[str] = None,
+        post_logout_redirect_uris: Optional[List[str]] = None,
+        allowed_scopes: Optional[List[str]] = None,
+    ) -> Application:
+        """
+        Update an application.
+
+        Args:
+            application_id: Application ID
+            display_name: Updated display name
+            environment: Updated environment
+            redirect_uris: Updated redirect URIs
+            description: Updated description
+            post_logout_redirect_uris: Updated post-logout redirect URIs
+            allowed_scopes: Updated allowed scopes
+
+        Returns:
+            Updated application
+
+        Example:
+            >>> app = await client.applications.update(
+            ...     app_id,
+            ...     display_name="Updated Name",
+            ...     environment=ApplicationEnvironment.PRODUCTION,
+            ...     redirect_uris=["https://myapp.com/callback"],
+            ... )
+        """
+        request = UpdateApplicationRequest(
+            display_name=display_name,
+            description=description,
+            environment=environment,
+            redirect_uris=redirect_uris,
+            post_logout_redirect_uris=post_logout_redirect_uris,
+            allowed_scopes=allowed_scopes,
+        )
+        response = await self._client.put(
+            f"/api/v1/applications/{application_id}",
+            json_data=request.model_dump(by_alias=True, exclude_none=True),
+        )
+        return Application(**response)
+
+    async def delete(self, application_id: UUID) -> None:
+        """
+        Delete an application.
+
+        Args:
+            application_id: Application ID
+
+        Example:
+            >>> await client.applications.delete(app_id)
+        """
+        await self._client.delete(f"/api/v1/applications/{application_id}")
+
+    async def rotate_secret(self, application_id: UUID) -> RotateSecretResponse:
+        """
+        Rotate the client secret for a confidential application.
+
+        Args:
+            application_id: Application ID
+
+        Returns:
+            New client credentials
+
+        Example:
+            >>> creds = await client.applications.rotate_secret(app_id)
+            >>> print(creds.client_secret)
+        """
+        response = await self._client.post(
+            f"/api/v1/applications/{application_id}/rotate-secret"
+        )
+        return RotateSecretResponse(**response)

{quantumapi-0.1.0b0 → quantumapi-0.2.0b1}/quantumapi/client/async_client.py

@@ -3,10 +3,14 @@
 import os
 from typing import Optional
 
+from quantumapi.client.applications import ApplicationsClient
 from quantumapi.client.base import BaseClient
 from quantumapi.client.encryption import EncryptionClient
+from quantumapi.client.end_users import EndUsersClient
 from quantumapi.client.health import HealthClient
 from quantumapi.client.keys import KeysClient
+from quantumapi.client.resource_groups import ResourceGroupsClient
+from quantumapi.client.roles import RolesClient
 from quantumapi.client.secrets import SecretsClient
 
 
@@ -78,6 +82,10 @@ class QuantumAPIClient:
         self.encryption = EncryptionClient(self._base_client)
         self.keys = KeysClient(self._base_client)
         self.secrets = SecretsClient(self._base_client)
+        self.resource_groups = ResourceGroupsClient(self._base_client)
+        self.applications = ApplicationsClient(self._base_client)
+        self.end_users = EndUsersClient(self._base_client)
+        self.roles = RolesClient(self._base_client)
         self.health = HealthClient(self._base_client)
 
     async def close(self) -> None:

{quantumapi-0.1.0b0 → quantumapi-0.2.0b1}/quantumapi/client/base.py

@@ -62,7 +62,7 @@ class BaseClient:
     def _get_default_headers(self) -> Dict[str, str]:
         """Get default headers for all requests."""
         return {
-            "Authorization": f"Bearer {self.api_key}",
+            "X-Api-Key": self.api_key,
             "Content-Type": "application/json",
             "Accept": "application/json",
             "User-Agent": "quantumapi-python/0.1.0-beta",

quantumapi-0.2.0b1/quantumapi/client/end_users.py

@@ -0,0 +1,274 @@
+"""End-users client for QuantumAPI SDK."""
+
+from typing import List, Optional
+from uuid import UUID
+
+from quantumapi.client.base import BaseClient
+from quantumapi.models.end_users import (
+    CreateEndUserRequest,
+    EndUser,
+    EndUserListResponse,
+    EndUserRole,
+    UpdateEndUserRequest,
+)
+
+
+class EndUsersClient:
+    """Client for end-user management operations scoped to an application."""
+
+    def __init__(self, base_client: BaseClient) -> None:
+        self._client = base_client
+
+    def _base_url(self, app_id: UUID) -> str:
+        return f"/api/v1/applications/{app_id}/end-users"
+
+    async def create(
+        self,
+        app_id: UUID,
+        email: str,
+        display_name: str,
+        first_name: Optional[str] = None,
+        last_name: Optional[str] = None,
+        phone_number: Optional[str] = None,
+        password: Optional[str] = None,
+        email_verified: bool = False,
+        metadata: Optional[str] = None,
+        role_ids: Optional[List[UUID]] = None,
+    ) -> EndUser:
+        """
+        Create a new end-user for an application.
+
+        Args:
+            app_id: Application ID
+            email: User's email address
+            display_name: Display name
+            first_name: First name
+            last_name: Last name
+            phone_number: Phone number
+            password: Initial password (if None, user must reset via email)
+            email_verified: Mark email as already verified
+            metadata: Custom metadata (JSON string)
+            role_ids: Role IDs to assign
+
+        Returns:
+            Created end-user
+
+        Example:
+            >>> user = await client.end_users.create(
+            ...     app_id=app_id,
+            ...     email="john@example.com",
+            ...     display_name="John Doe",
+            ...     email_verified=True,
+            ... )
+        """
+        request = CreateEndUserRequest(
+            email=email,
+            display_name=display_name,
+            first_name=first_name,
+            last_name=last_name,
+            phone_number=phone_number,
+            password=password,
+            email_verified=email_verified,
+            metadata=metadata,
+            role_ids=role_ids,
+        )
+        response = await self._client.post(
+            self._base_url(app_id),
+            json_data=request.model_dump(by_alias=True, exclude_none=True),
+        )
+        return EndUser(**response)
+
+    async def list(
+        self,
+        app_id: UUID,
+        page: int = 1,
+        page_size: int = 20,
+        search: Optional[str] = None,
+        blocked: Optional[bool] = None,
+        email_verified: Optional[bool] = None,
+        role_id: Optional[UUID] = None,
+    ) -> EndUserListResponse:
+        """
+        List end-users for an application (paginated).
+
+        Args:
+            app_id: Application ID
+            page: Page number (default 1)
+            page_size: Items per page (default 20, max 100)
+            search: Search by email or name
+            blocked: Filter by blocked status
+            email_verified: Filter by email verification status
+            role_id: Filter by role ID
+
+        Returns:
+            Paginated list of end-users
+
+        Example:
+            >>> result = await client.end_users.list(app_id, search="john")
+            >>> for user in result.items:
+            ...     print(user.email)
+        """
+        params: dict = {"page": page, "pageSize": page_size}
+        if search is not None:
+            params["search"] = search
+        if blocked is not None:
+            params["blocked"] = str(blocked).lower()
+        if email_verified is not None:
+            params["emailVerified"] = str(email_verified).lower()
+        if role_id is not None:
+            params["roleId"] = str(role_id)
+
+        response = await self._client.get(self._base_url(app_id), params=params)
+        return EndUserListResponse(**response)
+
+    async def get(self, app_id: UUID, user_id: UUID) -> EndUser:
+        """
+        Get end-user details.
+
+        Args:
+            app_id: Application ID
+            user_id: End-user ID
+
+        Returns:
+            End-user details
+
+        Example:
+            >>> user = await client.end_users.get(app_id, user_id)
+            >>> print(user.display_name)
+        """
+        response = await self._client.get(f"{self._base_url(app_id)}/{user_id}")
+        return EndUser(**response)
+
+    async def update(
+        self,
+        app_id: UUID,
+        user_id: UUID,
+        display_name: Optional[str] = None,
+        first_name: Optional[str] = None,
+        last_name: Optional[str] = None,
+        phone_number: Optional[str] = None,
+        profile_picture_url: Optional[str] = None,
+        metadata: Optional[str] = None,
+    ) -> EndUser:
+        """
+        Update an end-user.
+
+        Args:
+            app_id: Application ID
+            user_id: End-user ID
+            display_name: Updated display name
+            first_name: Updated first name
+            last_name: Updated last name
+            phone_number: Updated phone number
+            profile_picture_url: Updated profile picture URL
+            metadata: Updated custom metadata (JSON string)
+
+        Returns:
+            Updated end-user
+
+        Example:
+            >>> user = await client.end_users.update(
+            ...     app_id, user_id, display_name="Jane Doe"
+            ... )
+        """
+        request = UpdateEndUserRequest(
+            display_name=display_name,
+            first_name=first_name,
+            last_name=last_name,
+            phone_number=phone_number,
+            profile_picture_url=profile_picture_url,
+            metadata=metadata,
+        )
+        response = await self._client.put(
+            f"{self._base_url(app_id)}/{user_id}",
+            json_data=request.model_dump(by_alias=True, exclude_none=True),
+        )
+        return EndUser(**response)
+
+    async def block(
+        self, app_id: UUID, user_id: UUID, reason: Optional[str] = None
+    ) -> None:
+        """
+        Block an end-user.
+
+        Args:
+            app_id: Application ID
+            user_id: End-user ID
+            reason: Optional reason for blocking
+
+        Example:
+            >>> await client.end_users.block(app_id, user_id, reason="Suspicious activity")
+        """
+        json_data = {"reason": reason} if reason else {}
+        await self._client.post(
+            f"{self._base_url(app_id)}/{user_id}/block",
+            json_data=json_data if json_data else None,
+        )
+
+    async def unblock(self, app_id: UUID, user_id: UUID) -> None:
+        """
+        Unblock an end-user.
+
+        Args:
+            app_id: Application ID
+            user_id: End-user ID
+
+        Example:
+            >>> await client.end_users.unblock(app_id, user_id)
+        """
+        await self._client.post(f"{self._base_url(app_id)}/{user_id}/unblock")
+
+    async def delete(self, app_id: UUID, user_id: UUID) -> None:
+        """
+        Delete an end-user permanently.
+
+        Args:
+            app_id: Application ID
+            user_id: End-user ID
+
+        Example:
+            >>> await client.end_users.delete(app_id, user_id)
+        """
+        await self._client.delete(f"{self._base_url(app_id)}/{user_id}")
+
+    async def list_roles(self, app_id: UUID, user_id: UUID) -> List[EndUserRole]:
+        """
+        List the roles currently assigned to an end-user.
+
+        Example:
+            >>> roles = await client.end_users.list_roles(app_id, user_id)
+            >>> for r in roles:
+            ...     print(r.role_name)
+        """
+        response = await self._client.get(f"{self._base_url(app_id)}/{user_id}/roles")
+        return [EndUserRole(**r) for r in response]
+
+    async def assign_role(
+        self, app_id: UUID, user_id: UUID, role_id: UUID
+    ) -> EndUserRole:
+        """
+        Assign a role to an end-user.
+
+        Example:
+            >>> assignment = await client.end_users.assign_role(
+            ...     app_id, user_id, role_id
+            ... )
+        """
+        response = await self._client.post(
+            f"{self._base_url(app_id)}/{user_id}/roles",
+            json_data={"roleId": str(role_id)},
+        )
+        return EndUserRole(**response)
+
+    async def remove_role(
+        self, app_id: UUID, user_id: UUID, role_id: UUID
+    ) -> None:
+        """
+        Remove a role from an end-user.
+
+        Example:
+            >>> await client.end_users.remove_role(app_id, user_id, role_id)
+        """
+        await self._client.delete(
+            f"{self._base_url(app_id)}/{user_id}/roles/{role_id}"
+        )