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

geek_cafe_saas_sdk/lambda_handlers/files/delete/app.py

@@ -0,0 +1,121 @@
+"""
+Lambda handler for deleting files.
+
+Geek Cafe, LLC
+MIT License. See Project Root for the license information.
+"""
+
+import json
+import os
+from typing import Dict, Any
+
+from boto3_assist.dynamodb.dynamodb import DynamoDB
+from boto3_assist.s3.s3_connection import S3Connection
+from boto3_assist.s3.s3_object import S3Object
+from boto3_assist.s3.s3_bucket import S3Bucket
+
+from geek_cafe_saas_sdk.domains.files.services.file_system_service import FileSystemService
+from geek_cafe_saas_sdk.domains.files.services.s3_file_service import S3FileService
+
+
+def lambda_handler(event: Dict[str, Any], context: Any) -> Dict[str, Any]:
+    """
+    Delete file handler.
+    
+    Expected Event:
+    {
+        "pathParameters": {
+            "file_id": "file-123"
+        },
+        "queryStringParameters": {
+            "tenant_id": "tenant-456",
+            "user_id": "user-789",
+            "hard_delete": "false"  # Optional, default false
+        }
+    }
+    
+    Returns:
+    {
+        "statusCode": 200,
+        "body": {
+            "success": true,
+            "message": "File deleted successfully"
+        }
+    }
+    """
+    try:
+        # Extract parameters
+        path_params = event.get('pathParameters', {})
+        query_params = event.get('queryStringParameters', {})
+        
+        file_id = path_params.get('file_id')
+        tenant_id = query_params.get('tenant_id')
+        user_id = query_params.get('user_id')
+        hard_delete = query_params.get('hard_delete', 'false').lower() == 'true'
+        
+        # Validate required fields
+        if not all([file_id, tenant_id, user_id]):
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': 'Missing required parameters: file_id, tenant_id, user_id'
+                })
+            }
+        
+        # Initialize services
+        table_name = os.environ.get('DYNAMODB_TABLE_NAME', 'files-table')
+        bucket_name = os.environ.get('S3_BUCKET_NAME', 'files-bucket')
+        
+        db = DynamoDB()
+        connection = S3Connection()
+        
+        s3_service = S3FileService(
+            s3_object=S3Object(connection=connection),
+            s3_bucket=S3Bucket(connection=connection),
+            default_bucket=bucket_name
+        )
+        
+        file_service = FileSystemService(
+            dynamodb=db,
+            table_name=table_name,
+            s3_service=s3_service,
+            default_bucket=bucket_name
+        )
+        
+        # Delete file
+        result = file_service.delete(
+            resource_id=file_id,
+            tenant_id=tenant_id,
+            user_id=user_id,
+            hard_delete=hard_delete
+        )
+        
+        if result.success:
+            delete_type = "permanently" if hard_delete else "soft"
+            return {
+                'statusCode': 200,
+                'body': json.dumps({
+                    'success': True,
+                    'message': f'File {delete_type} deleted successfully'
+                })
+            }
+        else:
+            status_code = 404 if result.error_code == 'NOT_FOUND' else 403
+            return {
+                'statusCode': status_code,
+                'body': json.dumps({
+                    'success': False,
+                    'message': result.message,
+                    'error_code': result.error_code
+                })
+            }
+    
+    except Exception as e:
+        return {
+            'statusCode': 500,
+            'body': json.dumps({
+                'success': False,
+                'message': f'Internal server error: {str(e)}'
+            })
+        }

geek_cafe_saas_sdk/lambda_handlers/files/download/app.py

@@ -0,0 +1,187 @@
+"""
+Lambda handler for file download.
+
+Geek Cafe, LLC
+MIT License. See Project Root for the license information.
+"""
+
+import json
+import base64
+import os
+from typing import Dict, Any
+
+from boto3_assist.dynamodb.dynamodb import DynamoDB
+from boto3_assist.s3.s3_connection import S3Connection
+from boto3_assist.s3.s3_object import S3Object
+from boto3_assist.s3.s3_bucket import S3Bucket
+
+from geek_cafe_saas_sdk.domains.files.services.file_system_service import FileSystemService
+from geek_cafe_saas_sdk.domains.files.services.s3_file_service import S3FileService
+
+
+def lambda_handler(event: Dict[str, Any], context: Any) -> Dict[str, Any]:
+    """
+    Download file handler.
+    
+    Expected Event:
+    {
+        "pathParameters": {
+            "file_id": "file-123"
+        },
+        "queryStringParameters": {
+            "tenant_id": "tenant-456",
+            "user_id": "user-789",
+            "presigned": "true"  # Optional, return presigned URL instead
+        }
+    }
+    
+    Returns (Direct Download):
+    {
+        "statusCode": 200,
+        "isBase64Encoded": true,
+        "headers": {
+            "Content-Type": "application/pdf",
+            "Content-Disposition": "attachment; filename=document.pdf"
+        },
+        "body": "base64_encoded_file_content"
+    }
+    
+    Returns (Presigned URL):
+    {
+        "statusCode": 200,
+        "body": {
+            "success": true,
+            "data": {
+                "download_url": "https://s3.amazonaws.com/..."
+            }
+        }
+    }
+    """
+    try:
+        # Extract parameters
+        path_params = event.get('pathParameters', {})
+        query_params = event.get('queryStringParameters', {})
+        
+        file_id = path_params.get('file_id')
+        tenant_id = query_params.get('tenant_id')
+        user_id = query_params.get('user_id')
+        presigned = query_params.get('presigned', 'false').lower() == 'true'
+        expires_in = int(query_params.get('expires_in', '300'))
+        
+        # Validate required fields
+        if not all([file_id, tenant_id, user_id]):
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': 'Missing required parameters: file_id, tenant_id, user_id'
+                })
+            }
+        
+        # Initialize services
+        table_name = os.environ.get('DYNAMODB_TABLE_NAME', 'files-table')
+        bucket_name = os.environ.get('S3_BUCKET_NAME', 'files-bucket')
+        
+        db = DynamoDB()
+        connection = S3Connection()
+        
+        s3_service = S3FileService(
+            s3_object=S3Object(connection=connection),
+            s3_bucket=S3Bucket(connection=connection),
+            default_bucket=bucket_name
+        )
+        
+        file_service = FileSystemService(
+            dynamodb=db,
+            table_name=table_name,
+            s3_service=s3_service,
+            default_bucket=bucket_name
+        )
+        
+        # Return presigned URL if requested
+        if presigned:
+            url_result = file_service.generate_download_url(
+                tenant_id=tenant_id,
+                file_id=file_id,
+                user_id=user_id,
+                expires_in=expires_in
+            )
+            
+            if url_result.success:
+                return {
+                    'statusCode': 200,
+                    'body': json.dumps({
+                        'success': True,
+                        'data': {
+                            'download_url': url_result.data,
+                            'expires_in': expires_in
+                        }
+                    })
+                }
+            else:
+                return {
+                    'statusCode': 404 if url_result.error_code == 'NOT_FOUND' else 403,
+                    'body': json.dumps({
+                        'success': False,
+                        'message': url_result.message,
+                        'error_code': url_result.error_code
+                    })
+                }
+        
+        # Get file metadata
+        file_result = file_service.get_by_id(
+            resource_id=file_id,
+            tenant_id=tenant_id,
+            user_id=user_id
+        )
+        
+        if not file_result.success:
+            return {
+                'statusCode': 404 if file_result.error_code == 'NOT_FOUND' else 403,
+                'body': json.dumps({
+                    'success': False,
+                    'message': file_result.message,
+                    'error_code': file_result.error_code
+                })
+            }
+        
+        file = file_result.data
+        
+        # Download file content
+        download_result = file_service.download_file(
+            tenant_id=tenant_id,
+            file_id=file_id,
+            user_id=user_id
+        )
+        
+        if download_result.success:
+            file_data = download_result.data
+            
+            # Return file as base64-encoded response
+            return {
+                'statusCode': 200,
+                'isBase64Encoded': True,
+                'headers': {
+                    'Content-Type': file.mime_type,
+                    'Content-Disposition': f'attachment; filename="{file.file_name}"'
+                },
+                'body': base64.b64encode(file_data).decode('utf-8')
+            }
+        else:
+            return {
+                'statusCode': 500,
+                'body': json.dumps({
+                    'success': False,
+                    'message': download_result.message,
+                    'error_code': download_result.error_code
+                })
+            }
+    
+    except Exception as e:
+        return {
+            'statusCode': 500,
+            'body': json.dumps({
+                'success': False,
+                'message': f'Internal server error: {str(e)}'
+            })
+        }

geek_cafe_saas_sdk/lambda_handlers/files/get/app.py

@@ -0,0 +1,127 @@
+"""
+Lambda handler for getting file metadata.
+
+Geek Cafe, LLC
+MIT License. See Project Root for the license information.
+"""
+
+import json
+import os
+from typing import Dict, Any
+
+from boto3_assist.dynamodb.dynamodb import DynamoDB
+from boto3_assist.s3.s3_connection import S3Connection
+from boto3_assist.s3.s3_object import S3Object
+from boto3_assist.s3.s3_bucket import S3Bucket
+
+from geek_cafe_saas_sdk.domains.files.services.file_system_service import FileSystemService
+from geek_cafe_saas_sdk.domains.files.services.s3_file_service import S3FileService
+
+
+def lambda_handler(event: Dict[str, Any], context: Any) -> Dict[str, Any]:
+    """
+    Get file metadata handler.
+    
+    Expected Event:
+    {
+        "pathParameters": {
+            "file_id": "file-123"
+        },
+        "queryStringParameters": {
+            "tenant_id": "tenant-456",
+            "user_id": "user-789"
+        }
+    }
+    
+    Returns:
+    {
+        "statusCode": 200,
+        "body": {
+            "success": true,
+            "data": {
+                "file_id": "file-123",
+                "file_name": "document.pdf",
+                "file_size": 12345,
+                "mime_type": "application/pdf",
+                "directory_id": "dir-789",
+                "owner_id": "user-456",
+                "created_utc_ts": 1234567890.0,
+                "tags": ["report", "monthly"]
+            }
+        }
+    }
+    """
+    try:
+        # Extract parameters
+        path_params = event.get('pathParameters', {})
+        query_params = event.get('queryStringParameters', {})
+        
+        file_id = path_params.get('file_id')
+        tenant_id = query_params.get('tenant_id')
+        user_id = query_params.get('user_id')
+        
+        # Validate required fields
+        if not all([file_id, tenant_id, user_id]):
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': 'Missing required parameters: file_id, tenant_id, user_id'
+                })
+            }
+        
+        # Initialize services
+        table_name = os.environ.get('DYNAMODB_TABLE_NAME', 'files-table')
+        bucket_name = os.environ.get('S3_BUCKET_NAME', 'files-bucket')
+        
+        db = DynamoDB()
+        connection = S3Connection()
+        
+        s3_service = S3FileService(
+            s3_object=S3Object(connection=connection),
+            s3_bucket=S3Bucket(connection=connection),
+            default_bucket=bucket_name
+        )
+        
+        file_service = FileSystemService(
+            dynamodb=db,
+            table_name=table_name,
+            s3_service=s3_service,
+            default_bucket=bucket_name
+        )
+        
+        # Get file
+        result = file_service.get_by_id(
+            resource_id=file_id,
+            tenant_id=tenant_id,
+            user_id=user_id
+        )
+        
+        if result.success:
+            file = result.data
+            return {
+                'statusCode': 200,
+                'body': json.dumps({
+                    'success': True,
+                    'data': file.to_dictionary()
+                })
+            }
+        else:
+            status_code = 404 if result.error_code == 'NOT_FOUND' else 403
+            return {
+                'statusCode': status_code,
+                'body': json.dumps({
+                    'success': False,
+                    'message': result.message,
+                    'error_code': result.error_code
+                })
+            }
+    
+    except Exception as e:
+        return {
+            'statusCode': 500,
+            'body': json.dumps({
+                'success': False,
+                'message': f'Internal server error: {str(e)}'
+            })
+        }

geek_cafe_saas_sdk/lambda_handlers/files/list/app.py

@@ -0,0 +1,108 @@
+"""
+Lambda handler for listing files.
+
+Geek Cafe, LLC
+MIT License. See Project Root for the license information.
+"""
+
+import json
+import os
+from typing import Dict, Any
+
+from boto3_assist.dynamodb.dynamodb import DynamoDB
+from boto3_assist.s3.s3_connection import S3Connection
+from boto3_assist.s3.s3_object import S3Object
+from boto3_assist.s3.s3_bucket import S3Bucket
+
+from geek_cafe_saas_sdk.domains.files.services.file_system_service import FileSystemService
+from geek_cafe_saas_sdk.domains.files.services.s3_file_service import S3FileService
+
+
+def lambda_handler(event: Dict[str, Any], context: Any) -> Dict[str, Any]:
+    """List files handler."""
+    try:
+        query_params = event.get('queryStringParameters', {})
+        
+        tenant_id = query_params.get('tenant_id')
+        user_id = query_params.get('user_id')
+        directory_id = query_params.get('directory_id')
+        owner_id = query_params.get('owner_id')
+        limit = int(query_params.get('limit', '100'))
+        
+        if not all([tenant_id, user_id]):
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': 'Missing required parameters'
+                })
+            }
+        
+        table_name = os.environ.get('DYNAMODB_TABLE_NAME', 'files-table')
+        bucket_name = os.environ.get('S3_BUCKET_NAME', 'files-bucket')
+        
+        db = DynamoDB()
+        connection = S3Connection()
+        
+        s3_service = S3FileService(
+            s3_object=S3Object(connection=connection),
+            s3_bucket=S3Bucket(connection=connection),
+            default_bucket=bucket_name
+        )
+        
+        file_service = FileSystemService(
+            dynamodb=db,
+            table_name=table_name,
+            s3_service=s3_service,
+            default_bucket=bucket_name
+        )
+        
+        if directory_id:
+            result = file_service.list_files_by_directory(
+                tenant_id=tenant_id,
+                directory_id=directory_id,
+                user_id=user_id,
+                limit=limit
+            )
+        elif owner_id:
+            result = file_service.list_files_by_owner(
+                tenant_id=tenant_id,
+                owner_id=owner_id,
+                user_id=user_id,
+                limit=limit
+            )
+        else:
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': 'Must provide directory_id or owner_id'
+                })
+            }
+        
+        if result.success:
+            return {
+                'statusCode': 200,
+                'body': json.dumps({
+                    'success': True,
+                    'data': [f.to_dictionary() for f in result.data],
+                    'count': len(result.data)
+                })
+            }
+        else:
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': result.message
+                })
+            }
+    
+    except Exception as e:
+        return {
+            'statusCode': 500,
+            'body': json.dumps({
+                'success': False,
+                'message': str(e)
+            })
+        }

geek_cafe_saas_sdk/lambda_handlers/files/share/app.py

@@ -0,0 +1,83 @@
+"""
+Lambda handler for sharing files.
+
+Geek Cafe, LLC
+MIT License. See Project Root for the license information.
+"""
+
+import json
+import os
+from typing import Dict, Any
+
+from boto3_assist.dynamodb.dynamodb import DynamoDB
+from geek_cafe_saas_sdk.domains.files.services.file_share_service import FileShareService
+
+
+def lambda_handler(event: Dict[str, Any], context: Any) -> Dict[str, Any]:
+    """Share file handler."""
+    try:
+        if isinstance(event.get('body'), str):
+            body = json.loads(event['body'])
+        else:
+            body = event.get('body', {})
+        
+        tenant_id = body.get('tenant_id')
+        user_id = body.get('user_id')
+        file_id = body.get('file_id')
+        shared_with_user_id = body.get('shared_with_user_id')
+        permission = body.get('permission', 'view')
+        expires_at = body.get('expires_at')
+        message = body.get('message')
+        
+        if not all([tenant_id, user_id, file_id, shared_with_user_id]):
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': 'Missing required fields'
+                })
+            }
+        
+        table_name = os.environ.get('DYNAMODB_TABLE_NAME', 'files-table')
+        db = DynamoDB()
+        
+        share_service = FileShareService(
+            dynamodb=db,
+            table_name=table_name
+        )
+        
+        result = share_service.create(
+            tenant_id=tenant_id,
+            user_id=user_id,
+            file_id=file_id,
+            shared_with_user_id=shared_with_user_id,
+            permission=permission,
+            expires_at=expires_at,
+            message=message
+        )
+        
+        if result.success:
+            return {
+                'statusCode': 201,
+                'body': json.dumps({
+                    'success': True,
+                    'data': result.data.to_dictionary()
+                })
+            }
+        else:
+            return {
+                'statusCode': 400,
+                'body': json.dumps({
+                    'success': False,
+                    'message': result.message
+                })
+            }
+    
+    except Exception as e:
+        return {
+            'statusCode': 500,
+            'body': json.dumps({
+                'success': False,
+                'message': str(e)
+            })
+        }