trovesuite 1.0.3__tar.gz → 1.0.5__tar.gz

{trovesuite-1.0.3/src/trovesuite.egg-info → trovesuite-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trovesuite
-Version: 1.0.3
+Version: 1.0.5
 Summary: TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications
 Home-page: https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Author: Bright Debrah Owusu
@@ -34,6 +34,8 @@ Requires-Dist: python-multipart>=0.0.6
 Requires-Dist: python-jose[cryptography]>=3.3.0
 Requires-Dist: passlib[bcrypt]>=1.7.4
 Requires-Dist: passlib[argon2]<2.0.0,>=1.7.4
+Requires-Dist: uvicorn<0.39.0,>=0.38.0
+Requires-Dist: pyjwt<3.0.0,>=2.10.1
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.2; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
@@ -117,10 +119,26 @@ poetry install --with dev
 
 ## Quick Start
 
+### Import Patterns
+
+The package provides clean, simplified import patterns:
+
+```python
+# Import services and DTOs from main package
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto, NotificationSMSServiceWriteDto
+
+# Or import everything you need in one line
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+```
+
 ### Basic Usage
 
 ```python
-from trovesuite import AuthService
+from trovesuite import AuthService, NotificationService
 from trovesuite.configs.settings import db_settings
 
 # Configure your database settings
@@ -135,7 +153,7 @@ db_settings.SECRET_KEY = "your-secret-key"
 auth_service = AuthService()
 
 # Authorize a user
-from trovesuite.auth.auth_write_dto import AuthServiceWriteDto
+from trovesuite.auth import AuthServiceWriteDto
 auth_data = AuthServiceWriteDto(user_id="user123", tenant="tenant456")
 result = AuthService.authorize(auth_data)
 
@@ -147,6 +165,30 @@ else:
     print(f"Authorization failed: {result.detail}")
 ```
 
+### Notification Service Usage
+
+```python
+from trovesuite import NotificationService
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# Send an email notification
+email_data = NotificationEmailServiceWriteDto(
+    sender_email="your-email@gmail.com",
+    receiver_email=["recipient1@example.com", "recipient2@example.com"],
+    password="your-app-password",  # Gmail app password
+    subject="Test Notification",
+    text_message="This is a plain text message",
+    html_message="<h1>This is an HTML message</h1><p>With rich formatting!</p>"
+)
+
+result = NotificationService.send_email(email_data)
+
+if result.success:
+    print(f"Email sent successfully: {result.detail}")
+else:
+    print(f"Email failed: {result.error}")
+```
+
 ### JWT Token Decoding
 
 ```python
@@ -164,7 +206,7 @@ async def protected_route(token: str = Depends(oauth2_scheme)):
     tenant_id = user_data["tenant_id"]
     
     # Authorize user
-    from trovesuite.auth.auth_write_dto import AuthServiceWriteDto
+    from trovesuite.auth import AuthServiceWriteDto
     auth_data = AuthServiceWriteDto(user_id=user_id, tenant=tenant_id)
     auth_result = AuthService.authorize(auth_data)
     return auth_result
@@ -393,8 +435,84 @@ Check if user has all of the required permissions.
 **Returns:**
 - `bool`: True if user has all of the required permissions
 
+### NotificationService
+
+#### `send_email(data: NotificationEmailServiceWriteDto) -> Respons[NotificationEmailServiceReadDto]`
+
+Sends an email notification via Gmail SMTP. Supports both plain text and HTML email bodies.
+
+**Parameters:**
+- `data`: Email notification data including sender, recipients, subject, and message content
+
+**Returns:**
+- `Respons[NotificationEmailServiceReadDto]`: Email sending result with success status and details
+
+**Example:**
+```python
+from trovesuite import NotificationService
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+email_data = NotificationEmailServiceWriteDto(
+    sender_email="sender@gmail.com",
+    receiver_email=["user1@example.com", "user2@example.com"],
+    password="your-gmail-app-password",
+    subject="Welcome to TroveSuite",
+    text_message="Welcome! This is a plain text message.",
+    html_message="<h1>Welcome!</h1><p>This is an <strong>HTML</strong> message.</p>"
+)
+
+result = NotificationService.send_email(email_data)
+if result.success:
+    print("Email sent successfully!")
+else:
+    print(f"Failed to send email: {result.error}")
+```
+
+#### `send_sms(data: NotificationSMSServiceWriteDto) -> Respons[NotificationSMSServiceReadDto]`
+
+Sends an SMS notification (currently not implemented).
+
+**Parameters:**
+- `data`: SMS notification data
+
+**Returns:**
+- `Respons[NotificationSMSServiceReadDto]`: SMS sending result
+
 ### Data Models
 
+#### `NotificationEmailServiceWriteDto`
+
+```python
+class NotificationEmailServiceWriteDto(BaseModel):
+    sender_email: str
+    receiver_email: Union[str, List[str]]  # Single email or list of emails
+    password: str  # Gmail app password
+    subject: str
+    text_message: str
+    html_message: Optional[str] = None  # Optional HTML content
+```
+
+#### `NotificationEmailServiceReadDto`
+
+```python
+class NotificationEmailServiceReadDto(BaseModel):
+    pass  # Empty response model for email service
+```
+
+#### `NotificationSMSServiceWriteDto`
+
+```python
+class NotificationSMSServiceWriteDto(BaseModel):
+    pass  # To be implemented for SMS functionality
+```
+
+#### `NotificationSMSServiceReadDto`
+
+```python
+class NotificationSMSServiceReadDto(BaseModel):
+    pass  # To be implemented for SMS functionality
+```
+
 #### `AuthServiceReadDto`
 
 ```python
@@ -563,7 +681,7 @@ For support, email brightgclt@gmail.com or create a work item in the [Azure DevO
 
 ### 1.0.8
 - Restructured package for direct service imports
-- Added notification services
+- Added comprehensive notification services with email support
 - Excluded controllers from package build
 - Updated import paths for better usability
 - JWT token validation
@@ -572,3 +690,6 @@ For support, email brightgclt@gmail.com or create a work item in the [Azure DevO
 - PostgreSQL database integration
 - Comprehensive logging
 - Azure integration support
+- Email notification service with Gmail SMTP support
+- Support for both plain text and HTML email content
+- Multiple recipient support for email notifications

{trovesuite-1.0.3 → trovesuite-1.0.5}/README.md

@@ -66,10 +66,26 @@ poetry install --with dev
 
 ## Quick Start
 
+### Import Patterns
+
+The package provides clean, simplified import patterns:
+
+```python
+# Import services and DTOs from main package
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto, NotificationSMSServiceWriteDto
+
+# Or import everything you need in one line
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+```
+
 ### Basic Usage
 
 ```python
-from trovesuite import AuthService
+from trovesuite import AuthService, NotificationService
 from trovesuite.configs.settings import db_settings
 
 # Configure your database settings
@@ -84,7 +100,7 @@ db_settings.SECRET_KEY = "your-secret-key"
 auth_service = AuthService()
 
 # Authorize a user
-from trovesuite.auth.auth_write_dto import AuthServiceWriteDto
+from trovesuite.auth import AuthServiceWriteDto
 auth_data = AuthServiceWriteDto(user_id="user123", tenant="tenant456")
 result = AuthService.authorize(auth_data)
 
@@ -96,6 +112,30 @@ else:
     print(f"Authorization failed: {result.detail}")
 ```
 
+### Notification Service Usage
+
+```python
+from trovesuite import NotificationService
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# Send an email notification
+email_data = NotificationEmailServiceWriteDto(
+    sender_email="your-email@gmail.com",
+    receiver_email=["recipient1@example.com", "recipient2@example.com"],
+    password="your-app-password",  # Gmail app password
+    subject="Test Notification",
+    text_message="This is a plain text message",
+    html_message="<h1>This is an HTML message</h1><p>With rich formatting!</p>"
+)
+
+result = NotificationService.send_email(email_data)
+
+if result.success:
+    print(f"Email sent successfully: {result.detail}")
+else:
+    print(f"Email failed: {result.error}")
+```
+
 ### JWT Token Decoding
 
 ```python
@@ -113,7 +153,7 @@ async def protected_route(token: str = Depends(oauth2_scheme)):
     tenant_id = user_data["tenant_id"]
     
     # Authorize user
-    from trovesuite.auth.auth_write_dto import AuthServiceWriteDto
+    from trovesuite.auth import AuthServiceWriteDto
     auth_data = AuthServiceWriteDto(user_id=user_id, tenant=tenant_id)
     auth_result = AuthService.authorize(auth_data)
     return auth_result
@@ -342,8 +382,84 @@ Check if user has all of the required permissions.
 **Returns:**
 - `bool`: True if user has all of the required permissions
 
+### NotificationService
+
+#### `send_email(data: NotificationEmailServiceWriteDto) -> Respons[NotificationEmailServiceReadDto]`
+
+Sends an email notification via Gmail SMTP. Supports both plain text and HTML email bodies.
+
+**Parameters:**
+- `data`: Email notification data including sender, recipients, subject, and message content
+
+**Returns:**
+- `Respons[NotificationEmailServiceReadDto]`: Email sending result with success status and details
+
+**Example:**
+```python
+from trovesuite import NotificationService
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+email_data = NotificationEmailServiceWriteDto(
+    sender_email="sender@gmail.com",
+    receiver_email=["user1@example.com", "user2@example.com"],
+    password="your-gmail-app-password",
+    subject="Welcome to TroveSuite",
+    text_message="Welcome! This is a plain text message.",
+    html_message="<h1>Welcome!</h1><p>This is an <strong>HTML</strong> message.</p>"
+)
+
+result = NotificationService.send_email(email_data)
+if result.success:
+    print("Email sent successfully!")
+else:
+    print(f"Failed to send email: {result.error}")
+```
+
+#### `send_sms(data: NotificationSMSServiceWriteDto) -> Respons[NotificationSMSServiceReadDto]`
+
+Sends an SMS notification (currently not implemented).
+
+**Parameters:**
+- `data`: SMS notification data
+
+**Returns:**
+- `Respons[NotificationSMSServiceReadDto]`: SMS sending result
+
 ### Data Models
 
+#### `NotificationEmailServiceWriteDto`
+
+```python
+class NotificationEmailServiceWriteDto(BaseModel):
+    sender_email: str
+    receiver_email: Union[str, List[str]]  # Single email or list of emails
+    password: str  # Gmail app password
+    subject: str
+    text_message: str
+    html_message: Optional[str] = None  # Optional HTML content
+```
+
+#### `NotificationEmailServiceReadDto`
+
+```python
+class NotificationEmailServiceReadDto(BaseModel):
+    pass  # Empty response model for email service
+```
+
+#### `NotificationSMSServiceWriteDto`
+
+```python
+class NotificationSMSServiceWriteDto(BaseModel):
+    pass  # To be implemented for SMS functionality
+```
+
+#### `NotificationSMSServiceReadDto`
+
+```python
+class NotificationSMSServiceReadDto(BaseModel):
+    pass  # To be implemented for SMS functionality
+```
+
 #### `AuthServiceReadDto`
 
 ```python
@@ -512,7 +628,7 @@ For support, email brightgclt@gmail.com or create a work item in the [Azure DevO
 
 ### 1.0.8
 - Restructured package for direct service imports
-- Added notification services
+- Added comprehensive notification services with email support
 - Excluded controllers from package build
 - Updated import paths for better usability
 - JWT token validation
@@ -521,3 +637,6 @@ For support, email brightgclt@gmail.com or create a work item in the [Azure DevO
 - PostgreSQL database integration
 - Comprehensive logging
 - Azure integration support
+- Email notification service with Gmail SMTP support
+- Support for both plain text and HTML email content
+- Multiple recipient support for email notifications

{trovesuite-1.0.3 → trovesuite-1.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [tool.poetry]
 name = "trovesuite"
-version = "1.0.3"
+version = "1.0.5"
 description = "TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications"
 authors = ["brightgclt <brightgclt@gmail.com>"]
 license = "MIT"
@@ -56,7 +56,7 @@ Documentation = "https://dev.azure.com/brightgclt/trovesuite/_git/packages"
 
 [project]
 name = "trovesuite"
-version = "1.0.3"
+version = "1.0.5"
 description = "TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications"
 readme = "README.md"
 license = {text = "MIT"}
@@ -89,7 +89,9 @@ dependencies = [
     "python-multipart>=0.0.6",
     "python-jose[cryptography]>=3.3.0",
     "passlib[bcrypt]>=1.7.4",
-    "passlib[argon2] (>=1.7.4,<2.0.0)"
+    "passlib[argon2] (>=1.7.4,<2.0.0)",
+    "uvicorn (>=0.38.0,<0.39.0)",
+    "pyjwt (>=2.10.1,<3.0.0)"
 
 ]
 

{trovesuite-1.0.3 → trovesuite-1.0.5}/setup.py

@@ -15,7 +15,7 @@ with open("pyproject.toml", "r", encoding="utf-8") as fh:
 
 setup(
     name="trovesuite",
-    version="1.0.3",
+    version="1.0.5",
     author="Bright Debrah Owusu",
     author_email="owusu.debrah@deladetech.com",
     description="TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications",

trovesuite-1.0.5/src/trovesuite/__init__.py

@@ -0,0 +1,18 @@
+"""
+TroveSuite Package
+
+A comprehensive authentication, authorization, and notification service for ERP systems.
+Provides JWT token validation, user authorization, permission checking, and notification capabilities.
+"""
+
+from .auth import AuthService
+from .notification import NotificationService
+
+__version__ = "1.0.8"
+__author__ = "Bright Debrah Owusu"
+__email__ = "owusu.debrah@deladetech.com"
+
+__all__ = [
+    "AuthService",
+    "NotificationService"
+]

trovesuite-1.0.5/src/trovesuite/auth/__init__.py

@@ -0,0 +1,14 @@
+"""
+TroveSuite Auth Module
+
+Authentication and authorization services for ERP systems.
+"""
+
+from .auth_service import AuthService
+from .auth_write_dto import AuthServiceWriteDto
+
+__all__ = [
+    "AuthService",
+    "AuthServiceWriteDto"
+]
+

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite/auth/auth_controller.py

@@ -2,9 +2,10 @@ from fastapi import APIRouter
 from src.trovesuite.auth.auth_write_dto import AuthControllerWriteDto
 from src.trovesuite.auth.auth_read_dto import AuthControllerReadDto
 from src.trovesuite.auth.auth_service import AuthService
+from src.trovesuite.entities.sh_response import Respons
 
 auth_router = APIRouter()
 
-@auth_router.post("/auth", response_model=AuthControllerReadDto)
+@auth_router.post("/auth", response_model=Respons[AuthControllerReadDto])
 async def authorize(data: AuthControllerWriteDto):
     return AuthService.authorize(data=data)

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite/auth/auth_read_dto.py

@@ -11,7 +11,6 @@ class AuthControllerReadDto(BaseModel):
     role_id: Optional[str] = None
     tenant_id: Optional[str] = None
     permissions: Optional[List[str]] = None
-    shared_resource_id: Optional[str] = None
     resource_id: Optional[str] = None
 
 class AuthServiceReadDto(AuthControllerReadDto):

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite/auth/auth_service.py

@@ -48,7 +48,7 @@ class AuthService:
         
         user_id: str = data.user_id
         tenant_id: str = data.tenant_id
-
+        
         """Check if a user is authorized based on login settings and roles"""
         # Input validation
         if not user_id or not isinstance(user_id, str):
@@ -68,14 +68,14 @@ class AuthService:
                 status_code=400,
                 error="INVALID_TENANT_ID"
             )
-        
+
         try:
 
             is_tenant_verified = DatabaseManager.execute_query(
                 f"SELECT is_verified FROM {db_settings.MAIN_TENANTS_TABLE} WHERE delete_status = 'NOT_DELETED' AND id = %s",
                 (tenant_id,),
             )
-
+            
             if not is_tenant_verified or len(is_tenant_verified) == 0:
                 logger.warning("Login failed - tenant not found: %s", tenant_id)
                 return Respons[AuthServiceReadDto](

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite/auth/auth_write_dto.py

@@ -4,7 +4,7 @@ from pydantic import BaseModel
 
 class AuthControllerWriteDto(BaseModel):
     user_id: Optional[str] = None
-    tenant: Optional[str] = None
+    tenant_id: Optional[str] = None
 
 class AuthServiceWriteDto(AuthControllerWriteDto):
     pass

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite/configs/database.py

@@ -13,7 +13,6 @@ logger = get_logger("database")
 
 # Database connection pool
 _connection_pool: Optional[psycopg2.pool.ThreadedConnectionPool] = None
-_sqlmodel_engine = None
 
 
 class DatabaseConfig:
@@ -21,16 +20,20 @@ class DatabaseConfig:
     
     def __init__(self):
         self.settings = db_settings
+        self.database_url = self.settings.database_url
         self.pool_size = 5
         self.max_overflow = 10
-    
-    @property
-    def database_url(self):
-        """Get database URL (lazy evaluation)"""
-        return self.settings.database_url
         
     def get_connection_params(self) -> dict:
         """Get database connection parameters"""
+        if self.settings.DATABASE_URL:
+            # Use full DATABASE_URL if available
+            return {
+                "dsn": self.settings.DATABASE_URL,
+                "cursor_factory": RealDictCursor
+            }
+
+        # fallback to individual DB_* variables
         return {
             "host": self.settings.DB_HOST,
             "port": self.settings.DB_PORT,
@@ -98,18 +101,19 @@ def get_connection_pool() -> psycopg2.pool.ThreadedConnectionPool:
     """Get the database connection pool"""
     global _connection_pool
     if _connection_pool is None:
-        raise Exception("Database not initialized. Call initialize_database() first.")
+        error_msg = (
+            "Database not initialized. This usually means:\n"
+            "1. Missing or incorrect .env file in app/ directory\n"
+            "2. Database credentials are wrong\n"
+            "3. Database container is not running\n"
+            "4. Database initialization failed during startup\n"
+            "Please check the startup logs for more details."
+        )
+        logger.error(error_msg)
+        raise Exception(error_msg)
     return _connection_pool
 
 
-def get_sqlmodel_engine():
-    """Get the SQLModel engine"""
-    global _sqlmodel_engine
-    if _sqlmodel_engine is None:
-        raise Exception("Database not initialized. Call initialize_database() first.")
-    return _sqlmodel_engine
-
-
 @contextmanager
 def get_db_connection():
     """Get a database connection from the pool (context manager)"""
@@ -217,5 +221,13 @@ class DatabaseManager:
             }
 
 
-# Database initialization is done lazily when needed
-# Call initialize_database() explicitly when you need to use the database
+# Database initialization on module import
+try:
+    initialize_database()
+except Exception as e:
+    logger.error(f"Failed to initialize database on startup: {str(e)}")
+    logger.error("⚠️  CRITICAL: Application started without database connection!")
+    logger.error("⚠️  Please check your .env file and database configuration")
+    logger.error("⚠️  The application will not function properly without a database connection")
+    # Don't raise here to allow the app to start even if DB is unavailable
+    # But log it clearly so it's obvious what's wrong

trovesuite-1.0.5/src/trovesuite/notification/__init__.py

@@ -0,0 +1,14 @@
+"""
+TroveSuite Notification Service
+
+Provides email and SMS notification capabilities for TroveSuite applications.
+"""
+
+from .notification_service import NotificationService
+from .notification_write_dto import NotificationEmailServiceWriteDto, NotificationSMSServiceWriteDto
+
+__all__ = [
+    "NotificationService",
+    "NotificationEmailServiceWriteDto",
+    "NotificationSMSServiceWriteDto"
+]

trovesuite-1.0.5/src/trovesuite/notification/notification_base.py

@@ -0,0 +1,13 @@
+from typing import List, Optional, Union
+from pydantic import BaseModel
+
+class NotificationEmailBase(BaseModel):
+    sender_email: str
+    receiver_email: Union[str, List[str]]
+    password: str
+    subject: str
+    text_message: str
+    html_message: Optional[str] = None
+
+class NotificationSMSBase(BaseModel):
+    pass

trovesuite-1.0.5/src/trovesuite/notification/notification_controller.py

@@ -0,0 +1,21 @@
+from src.trovesuite.notification.notification_write_dto import (
+    NotificationEmailControllerWriteDto,
+    NotificationSMSControllerWriteDto
+)
+from src.trovesuite.notification.notification_read_dto import (
+    NotificationEmailControllerReadDto,
+    NotificationSMSControllerReadDto
+)
+from src.trovesuite.notification.notification_service import NotificationService
+from src.trovesuite.entities.sh_response import Respons
+from fastapi import APIRouter
+
+notification_router = APIRouter()
+
+@notification_router.post("/send_email", response_model=Respons[NotificationEmailControllerReadDto])
+async def send_email(data: NotificationEmailControllerWriteDto):
+    return NotificationService.send_email(data=data)
+
+@notification_router.post("/send_sms", response_model=Respons[NotificationSMSControllerReadDto])
+async def send_sms(data: NotificationSMSControllerWriteDto):
+    return NotificationService.send_sms(data=data)

trovesuite-1.0.5/src/trovesuite/notification/notification_read_dto.py

@@ -0,0 +1,21 @@
+from src.trovesuite.notification.notification_base import (
+    NotificationEmailBase,
+    NotificationSMSBase
+)
+from pydantic import BaseModel
+
+# EMAIL Notification
+
+class NotificationEmailControllerReadDto(NotificationEmailBase):
+    pass
+
+class NotificationEmailServiceReadDto(BaseModel):
+    pass
+
+# SMS Notification
+
+class NotificationSMSControllerReadDto(NotificationSMSBase):
+    pass
+
+class NotificationSMSServiceReadDto(BaseModel):
+    pass

trovesuite-1.0.5/src/trovesuite/notification/notification_service.py

@@ -0,0 +1,73 @@
+import smtplib
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+from src.trovesuite.entities.sh_response import Respons
+from src.trovesuite.notification.notification_read_dto import (
+    NotificationEmailServiceReadDto,
+    NotificationSMSServiceReadDto
+)
+from src.trovesuite.notification.notification_write_dto import (
+    NotificationEmailServiceWriteDto,
+    NotificationSMSServiceWriteDto
+)
+
+class NotificationService:
+
+    @staticmethod
+    def send_email(data: NotificationEmailServiceWriteDto) -> Respons[NotificationEmailServiceReadDto]:
+        """
+        Send an email (single or multiple recipients) via Gmail SMTP.
+        Supports both plain text and HTML email bodies.
+        """
+
+        # Extract input data
+        receiver_email = data.receiver_email
+        text_message = data.text_message
+        html_message = getattr(data, "html_message", None)
+        sender_email = data.sender_email
+        password = data.password
+        subject = data.subject
+
+        # Allow single email or list
+        if isinstance(receiver_email, str):
+            receiver_email = [receiver_email]
+
+        # Create the email container
+        message = MIMEMultipart("alternative")
+        message["From"] = sender_email
+        message["To"] = ", ".join(receiver_email)
+        message["Subject"] = subject
+
+        # Attach plain text
+        message.attach(MIMEText(text_message, "plain"))
+
+        # Attach HTML if provided
+        if html_message:
+            message.attach(MIMEText(html_message, "html"))
+
+        try:
+            with smtplib.SMTP_SSL("smtp.gmail.com", 465) as server:
+                server.login(sender_email, password)
+                server.sendmail(sender_email, receiver_email, message.as_string())
+
+            return Respons[NotificationEmailServiceReadDto](
+                detail=f"Email successfully sent to {len(receiver_email)} recipient(s)",
+                error=None,
+                data=[],
+                status_code=200,
+                success=True,
+            )
+
+        except Exception as e:
+            print(e)
+            return Respons[NotificationEmailServiceReadDto](
+                detail="An error occurred while sending the email",
+                error=str(e),
+                data=[],
+                status_code=500,
+                success=False,
+            )
+
+    @staticmethod
+    def send_sms(data: NotificationSMSServiceWriteDto) -> Respons[NotificationSMSServiceReadDto]:
+        pass

trovesuite-1.0.5/src/trovesuite/notification/notification_write_dto.py

@@ -0,0 +1,21 @@
+from pydantic import BaseModel
+from src.trovesuite.notification.notification_base import (
+    NotificationEmailBase,
+    NotificationSMSBase
+)
+
+# Email Notification
+
+class NotificationEmailControllerWriteDto(NotificationEmailBase):
+    pass
+
+class NotificationEmailServiceWriteDto(NotificationEmailControllerWriteDto):
+    pass
+
+# SMS Notification
+
+class NotificationSMSControllerWriteDto(NotificationSMSBase):
+    pass
+
+class NotificationSMSServiceWriteDto(BaseModel):
+    pass

{trovesuite-1.0.3 → trovesuite-1.0.5/src/trovesuite.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trovesuite
-Version: 1.0.3
+Version: 1.0.5
 Summary: TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications
 Home-page: https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Author: Bright Debrah Owusu
@@ -34,6 +34,8 @@ Requires-Dist: python-multipart>=0.0.6
 Requires-Dist: python-jose[cryptography]>=3.3.0
 Requires-Dist: passlib[bcrypt]>=1.7.4
 Requires-Dist: passlib[argon2]<2.0.0,>=1.7.4
+Requires-Dist: uvicorn<0.39.0,>=0.38.0
+Requires-Dist: pyjwt<3.0.0,>=2.10.1
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.2; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
@@ -117,10 +119,26 @@ poetry install --with dev
 
 ## Quick Start
 
+### Import Patterns
+
+The package provides clean, simplified import patterns:
+
+```python
+# Import services and DTOs from main package
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto, NotificationSMSServiceWriteDto
+
+# Or import everything you need in one line
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+```
+
 ### Basic Usage
 
 ```python
-from trovesuite import AuthService
+from trovesuite import AuthService, NotificationService
 from trovesuite.configs.settings import db_settings
 
 # Configure your database settings
@@ -135,7 +153,7 @@ db_settings.SECRET_KEY = "your-secret-key"
 auth_service = AuthService()
 
 # Authorize a user
-from trovesuite.auth.auth_write_dto import AuthServiceWriteDto
+from trovesuite.auth import AuthServiceWriteDto
 auth_data = AuthServiceWriteDto(user_id="user123", tenant="tenant456")
 result = AuthService.authorize(auth_data)
 
@@ -147,6 +165,30 @@ else:
     print(f"Authorization failed: {result.detail}")
 ```
 
+### Notification Service Usage
+
+```python
+from trovesuite import NotificationService
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# Send an email notification
+email_data = NotificationEmailServiceWriteDto(
+    sender_email="your-email@gmail.com",
+    receiver_email=["recipient1@example.com", "recipient2@example.com"],
+    password="your-app-password",  # Gmail app password
+    subject="Test Notification",
+    text_message="This is a plain text message",
+    html_message="<h1>This is an HTML message</h1><p>With rich formatting!</p>"
+)
+
+result = NotificationService.send_email(email_data)
+
+if result.success:
+    print(f"Email sent successfully: {result.detail}")
+else:
+    print(f"Email failed: {result.error}")
+```
+
 ### JWT Token Decoding
 
 ```python
@@ -164,7 +206,7 @@ async def protected_route(token: str = Depends(oauth2_scheme)):
     tenant_id = user_data["tenant_id"]
     
     # Authorize user
-    from trovesuite.auth.auth_write_dto import AuthServiceWriteDto
+    from trovesuite.auth import AuthServiceWriteDto
     auth_data = AuthServiceWriteDto(user_id=user_id, tenant=tenant_id)
     auth_result = AuthService.authorize(auth_data)
     return auth_result
@@ -393,8 +435,84 @@ Check if user has all of the required permissions.
 **Returns:**
 - `bool`: True if user has all of the required permissions
 
+### NotificationService
+
+#### `send_email(data: NotificationEmailServiceWriteDto) -> Respons[NotificationEmailServiceReadDto]`
+
+Sends an email notification via Gmail SMTP. Supports both plain text and HTML email bodies.
+
+**Parameters:**
+- `data`: Email notification data including sender, recipients, subject, and message content
+
+**Returns:**
+- `Respons[NotificationEmailServiceReadDto]`: Email sending result with success status and details
+
+**Example:**
+```python
+from trovesuite import NotificationService
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+email_data = NotificationEmailServiceWriteDto(
+    sender_email="sender@gmail.com",
+    receiver_email=["user1@example.com", "user2@example.com"],
+    password="your-gmail-app-password",
+    subject="Welcome to TroveSuite",
+    text_message="Welcome! This is a plain text message.",
+    html_message="<h1>Welcome!</h1><p>This is an <strong>HTML</strong> message.</p>"
+)
+
+result = NotificationService.send_email(email_data)
+if result.success:
+    print("Email sent successfully!")
+else:
+    print(f"Failed to send email: {result.error}")
+```
+
+#### `send_sms(data: NotificationSMSServiceWriteDto) -> Respons[NotificationSMSServiceReadDto]`
+
+Sends an SMS notification (currently not implemented).
+
+**Parameters:**
+- `data`: SMS notification data
+
+**Returns:**
+- `Respons[NotificationSMSServiceReadDto]`: SMS sending result
+
 ### Data Models
 
+#### `NotificationEmailServiceWriteDto`
+
+```python
+class NotificationEmailServiceWriteDto(BaseModel):
+    sender_email: str
+    receiver_email: Union[str, List[str]]  # Single email or list of emails
+    password: str  # Gmail app password
+    subject: str
+    text_message: str
+    html_message: Optional[str] = None  # Optional HTML content
+```
+
+#### `NotificationEmailServiceReadDto`
+
+```python
+class NotificationEmailServiceReadDto(BaseModel):
+    pass  # Empty response model for email service
+```
+
+#### `NotificationSMSServiceWriteDto`
+
+```python
+class NotificationSMSServiceWriteDto(BaseModel):
+    pass  # To be implemented for SMS functionality
+```
+
+#### `NotificationSMSServiceReadDto`
+
+```python
+class NotificationSMSServiceReadDto(BaseModel):
+    pass  # To be implemented for SMS functionality
+```
+
 #### `AuthServiceReadDto`
 
 ```python
@@ -563,7 +681,7 @@ For support, email brightgclt@gmail.com or create a work item in the [Azure DevO
 
 ### 1.0.8
 - Restructured package for direct service imports
-- Added notification services
+- Added comprehensive notification services with email support
 - Excluded controllers from package build
 - Updated import paths for better usability
 - JWT token validation
@@ -572,3 +690,6 @@ For support, email brightgclt@gmail.com or create a work item in the [Azure DevO
 - PostgreSQL database integration
 - Comprehensive logging
 - Azure integration support
+- Email notification service with Gmail SMTP support
+- Support for both plain text and HTML email content
+- Multiple recipient support for email notifications

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite.egg-info/SOURCES.txt

@@ -24,5 +24,11 @@ src/trovesuite/configs/settings.py
 src/trovesuite/entities/__init__.py
 src/trovesuite/entities/health.py
 src/trovesuite/entities/sh_response.py
+src/trovesuite/notification/__init__.py
+src/trovesuite/notification/notification_base.py
+src/trovesuite/notification/notification_controller.py
+src/trovesuite/notification/notification_read_dto.py
+src/trovesuite/notification/notification_service.py
+src/trovesuite/notification/notification_write_dto.py
 src/trovesuite/utils/__init__.py
 src/trovesuite/utils/helper.py

{trovesuite-1.0.3 → trovesuite-1.0.5}/src/trovesuite.egg-info/requires.txt

@@ -6,6 +6,8 @@ python-multipart>=0.0.6
 python-jose[cryptography]>=3.3.0
 passlib[bcrypt]>=1.7.4
 passlib[argon2]<2.0.0,>=1.7.4
+uvicorn<0.39.0,>=0.38.0
+pyjwt<3.0.0,>=2.10.1
 
 [dev]
 pytest>=8.4.2

trovesuite-1.0.3/src/trovesuite/__init__.py

@@ -1,16 +0,0 @@
-"""
-TroveSuite Auth Package
-
-A comprehensive authentication and authorization service for ERP systems.
-Provides JWT token validation, user authorization, and permission checking.
-"""
-
-from .auth import AuthService
-
-__version__ = "1.0.8"
-__author__ = "Bright Debrah Owusu"
-__email__ = "owusu.debrah@deladetech.com"
-
-__all__ = [
-    "AuthService"
-]

trovesuite-1.0.3/src/trovesuite/auth/__init__.py

@@ -1,17 +0,0 @@
-"""
-TroveSuite Auth Module
-
-Authentication and authorization services for ERP systems.
-"""
-
-from .auth_service import AuthService
-from .auth_base import AuthBase
-from .auth_read_dto import AuthServiceReadDto, AuthControllerReadDto
-
-__all__ = [
-    "AuthService",
-    "AuthBase", 
-    "AuthServiceReadDto",
-    "AuthControllerReadDto"
-]
-