geek-cafe-saas-sdk 0.6.0__py3-none-any.whl

geek_cafe_saas_sdk/domains/tenancy/handlers/subscriptions/list/app.py

@@ -0,0 +1,44 @@
+# src/geek_cafe_saas_sdk/lambda_handlers/subscriptions/list/app.py
+
+from typing import Dict, Any
+
+from geek_cafe_saas_sdk.services import SubscriptionService
+from geek_cafe_saas_sdk.lambda_handlers import ServicePool
+from geek_cafe_saas_sdk.utilities.response import service_result_to_response, error_response
+from geek_cafe_saas_sdk.utilities.lambda_event_utility import LambdaEventUtility
+
+subscription_service_pool = ServicePool(SubscriptionService)
+
+def handler(event: Dict[str, Any], context: object, injected_service=None) -> Dict[str, Any]:
+    """
+    Lambda handler for listing subscription history for a tenant.
+    
+    Returns all subscriptions (current and past) sorted by date descending.
+    
+    Query parameters:
+    - limit: Maximum number of results (default: 50)
+    
+    Args:
+        event: API Gateway event
+        context: Lambda context
+        injected_service: Optional SubscriptionService for testing
+    """
+    try:
+        subscription_service = injected_service if injected_service else subscription_service_pool.get()
+        user_id = LambdaEventUtility.get_authenticated_user_id(event)
+        tenant_id = LambdaEventUtility.get_authenticated_user_tenant_id(event)
+        query_params = event.get('queryStringParameters', {}) or {}
+        
+        # Get limit from query params (default 50)
+        limit = int(query_params.get('limit', 50))
+        
+        result = subscription_service.list_subscription_history(
+            tenant_id=tenant_id,
+            user_id=user_id,
+            limit=limit
+        )
+        
+        return service_result_to_response(result)
+    
+    except Exception as e:
+        return error_response(f"An unexpected error occurred: {str(e)}", "INTERNAL_ERROR", 500)

geek_cafe_saas_sdk/domains/tenancy/handlers/subscriptions/record_payment/app.py

@@ -0,0 +1,56 @@
+# src/geek_cafe_saas_sdk/lambda_handlers/subscriptions/record_payment/app.py
+
+import json
+from typing import Dict, Any
+
+from geek_cafe_saas_sdk.services import SubscriptionService
+from geek_cafe_saas_sdk.lambda_handlers import ServicePool
+from geek_cafe_saas_sdk.utilities.response import service_result_to_response, error_response
+from geek_cafe_saas_sdk.utilities.lambda_event_utility import LambdaEventUtility
+
+subscription_service_pool = ServicePool(SubscriptionService)
+
+def handler(event: Dict[str, Any], context: object, injected_service=None) -> Dict[str, Any]:
+    """
+    Lambda handler for recording a payment on a subscription.
+    
+    This updates the subscription with payment details and can change status from past_due to active.
+    
+    Expected body:
+    {
+        "amount_cents": 2999
+    }
+    
+    Args:
+        event: API Gateway event
+        context: Lambda context
+        injected_service: Optional SubscriptionService for testing
+    """
+    try:
+        subscription_service = injected_service if injected_service else subscription_service_pool.get()
+        body = LambdaEventUtility.get_body_from_event(event)
+        user_id = LambdaEventUtility.get_authenticated_user_id(event)
+        tenant_id = LambdaEventUtility.get_authenticated_user_tenant_id(event)
+        resource_id = LambdaEventUtility.get_value_from_path_parameters(event, 'id')
+        
+        if not resource_id:
+            return error_response("Subscription ID is required in the path.", "VALIDATION_ERROR", 400)
+        
+        # Get payment amount
+        amount_cents = body.get('amount_cents')
+        if amount_cents is None:
+            return error_response("Payment amount_cents is required.", "VALIDATION_ERROR", 400)
+        
+        result = subscription_service.record_payment(
+            subscription_id=resource_id,
+            tenant_id=tenant_id,
+            user_id=user_id,
+            amount_cents=amount_cents
+        )
+        
+        return service_result_to_response(result)
+    
+    except json.JSONDecodeError:
+        return error_response("Invalid JSON in request body.", "VALIDATION_ERROR", 400)
+    except Exception as e:
+        return error_response(f"An unexpected error occurred: {str(e)}", "INTERNAL_ERROR", 500)

geek_cafe_saas_sdk/domains/tenancy/handlers/tenants/get/app.py

@@ -0,0 +1,39 @@
+# src/geek_cafe_saas_sdk/lambda_handlers/tenants/get/app.py
+
+from typing import Dict, Any
+
+from geek_cafe_saas_sdk.services import TenantService
+from geek_cafe_saas_sdk.lambda_handlers import ServicePool
+from geek_cafe_saas_sdk.utilities.response import service_result_to_response, error_response
+from geek_cafe_saas_sdk.utilities.lambda_event_utility import LambdaEventUtility
+
+tenant_service_pool = ServicePool(TenantService)
+
+def handler(event: Dict[str, Any], context: object, injected_service=None) -> Dict[str, Any]:
+    """
+    Lambda handler for retrieving a tenant by ID.
+    
+    Args:
+        event: API Gateway event
+        context: Lambda context
+        injected_service: Optional TenantService for testing
+    """
+    try:
+        tenant_service = injected_service if injected_service else tenant_service_pool.get()
+        user_id = LambdaEventUtility.get_authenticated_user_id(event)
+        tenant_id = LambdaEventUtility.get_authenticated_user_tenant_id(event)
+        resource_id = LambdaEventUtility.get_value_from_path_parameters(event, 'id')
+        
+        if not resource_id:
+            return error_response("Tenant ID is required in the path.", "VALIDATION_ERROR", 400)
+        
+        result = tenant_service.get_by_id(
+            resource_id=resource_id,
+            tenant_id=tenant_id,
+            user_id=user_id
+        )
+        
+        return service_result_to_response(result)
+    
+    except Exception as e:
+        return error_response(f"An unexpected error occurred: {str(e)}", "INTERNAL_ERROR", 500)

geek_cafe_saas_sdk/domains/tenancy/handlers/tenants/me/app.py

@@ -0,0 +1,37 @@
+# src/geek_cafe_saas_sdk/lambda_handlers/tenants/me/app.py
+
+from typing import Dict, Any
+
+from geek_cafe_saas_sdk.services import TenantService
+from geek_cafe_saas_sdk.lambda_handlers import ServicePool
+from geek_cafe_saas_sdk.utilities.response import service_result_to_response, error_response
+from geek_cafe_saas_sdk.utilities.lambda_event_utility import LambdaEventUtility
+
+tenant_service_pool = ServicePool(TenantService)
+
+def handler(event: Dict[str, Any], context: object, injected_service=None) -> Dict[str, Any]:
+    """
+    Lambda handler for retrieving the authenticated user's tenant.
+    
+    This is a convenience endpoint for /tenants/me to get the current user's tenant.
+    
+    Args:
+        event: API Gateway event
+        context: Lambda context
+        injected_service: Optional TenantService for testing
+    """
+    try:
+        tenant_service = injected_service if injected_service else tenant_service_pool.get()
+        user_id = LambdaEventUtility.get_authenticated_user_id(event)
+        tenant_id = LambdaEventUtility.get_authenticated_user_tenant_id(event)
+        
+        result = tenant_service.get_by_id(
+            resource_id=tenant_id,
+            tenant_id=tenant_id,
+            user_id=user_id
+        )
+        
+        return service_result_to_response(result)
+    
+    except Exception as e:
+        return error_response(f"An unexpected error occurred: {str(e)}", "INTERNAL_ERROR", 500)

geek_cafe_saas_sdk/domains/tenancy/handlers/tenants/signup/app.py

@@ -0,0 +1,61 @@
+# src/geek_cafe_saas_sdk/lambda_handlers/tenants/signup/app.py
+
+import json
+from typing import Dict, Any
+
+from geek_cafe_saas_sdk.services import TenantService
+from geek_cafe_saas_sdk.lambda_handlers import ServicePool
+from geek_cafe_saas_sdk.utilities.response import service_result_to_response, error_response
+from geek_cafe_saas_sdk.utilities.lambda_event_utility import LambdaEventUtility
+
+tenant_service_pool = ServicePool(TenantService)
+
+def handler(event: Dict[str, Any], context: object, injected_service=None) -> Dict[str, Any]:
+    """
+    Lambda handler for tenant signup (creates tenant + primary admin user).
+    
+    This is the initial signup endpoint that creates both a tenant and its first admin user.
+    
+    Expected body:
+    {
+        "user": {
+            "email": "admin@company.com",
+            "first_name": "John",
+            "last_name": "Doe"
+        },
+        "tenant": {
+            "name": "Company Name"
+        }
+    }
+    
+    Args:
+        event: API Gateway event
+        context: Lambda context
+        injected_service: Optional TenantService for testing
+    """
+    try:
+        tenant_service = injected_service if injected_service else tenant_service_pool.get()
+        body = LambdaEventUtility.get_body_from_event(event)
+        
+        # Extract user and tenant payloads
+        user_payload = body.get('user', {})
+        tenant_payload = body.get('tenant', {})
+        
+        if not user_payload:
+            return error_response("User information is required.", "VALIDATION_ERROR", 400)
+        
+        if not tenant_payload:
+            return error_response("Tenant information is required.", "VALIDATION_ERROR", 400)
+        
+        # Create tenant with user (signup flow)
+        result = tenant_service.create_with_user(
+            user_payload=user_payload,
+            tenant_payload=tenant_payload
+        )
+        
+        return service_result_to_response(result, success_status=201)
+    
+    except json.JSONDecodeError:
+        return error_response("Invalid JSON in request body.", "VALIDATION_ERROR", 400)
+    except Exception as e:
+        return error_response(f"An unexpected error occurred: {str(e)}", "INTERNAL_ERROR", 500)

geek_cafe_saas_sdk/domains/tenancy/handlers/tenants/update/app.py

@@ -0,0 +1,44 @@
+# src/geek_cafe_saas_sdk/lambda_handlers/tenants/update/app.py
+
+import json
+from typing import Dict, Any
+
+from geek_cafe_saas_sdk.services import TenantService
+from geek_cafe_saas_sdk.lambda_handlers import ServicePool
+from geek_cafe_saas_sdk.utilities.response import service_result_to_response, error_response
+from geek_cafe_saas_sdk.utilities.lambda_event_utility import LambdaEventUtility
+
+tenant_service_pool = ServicePool(TenantService)
+
+def handler(event: Dict[str, Any], context: object, injected_service=None) -> Dict[str, Any]:
+    """
+    Lambda handler for updating a tenant.
+    
+    Args:
+        event: API Gateway event
+        context: Lambda context
+        injected_service: Optional TenantService for testing
+    """
+    try:
+        tenant_service = injected_service if injected_service else tenant_service_pool.get()
+        body = LambdaEventUtility.get_body_from_event(event)
+        user_id = LambdaEventUtility.get_authenticated_user_id(event)
+        tenant_id = LambdaEventUtility.get_authenticated_user_tenant_id(event)
+        resource_id = LambdaEventUtility.get_value_from_path_parameters(event, 'id')
+        
+        if not resource_id:
+            return error_response("Tenant ID is required in the path.", "VALIDATION_ERROR", 400)
+        
+        result = tenant_service.update(
+            resource_id=resource_id,
+            tenant_id=tenant_id,
+            user_id=user_id,
+            updates=body
+        )
+        
+        return service_result_to_response(result)
+    
+    except json.JSONDecodeError:
+        return error_response("Invalid JSON in request body.", "VALIDATION_ERROR", 400)
+    except Exception as e:
+        return error_response(f"An unexpected error occurred: {str(e)}", "INTERNAL_ERROR", 500)

geek_cafe_saas_sdk/domains/tenancy/models/__init__.py

@@ -0,0 +1,6 @@
+# Tenancy Domain Models
+
+from .tenant import Tenant
+from .subscription import Subscription
+
+__all__ = ["Tenant", "Subscription"]