trovesuite 1.0.4__tar.gz → 1.0.6__tar.gz

{trovesuite-1.0.4/src/trovesuite.egg-info → trovesuite-1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trovesuite
-Version: 1.0.4
+Version: 1.0.6
 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
@@ -119,10 +119,28 @@ poetry install --with dev
 
 ## Quick Start
 
+> **✅ Package Status**: All import issues have been resolved in version 1.0.5. The package now works correctly when installed from PyPI or wheel files.
+
+### 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
@@ -137,7 +155,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)
 
@@ -149,6 +167,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
@@ -166,7 +208,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
@@ -395,8 +437,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
@@ -557,15 +675,65 @@ poetry install
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Troubleshooting
+
+### Import Issues
+
+If you encounter import errors, make sure you're using the correct import patterns:
+
+```python
+# ✅ Correct imports
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# ❌ Incorrect imports (will fail)
+from trovesuite.auth.auth_write_dto import AuthServiceWriteDto  # Too specific
+from trovesuite.notification.notification_write_dto import NotificationEmailServiceWriteDto  # Too specific
+```
+
+### Package Installation
+
+If you're having issues with the package installation:
+
+1. **Make sure you have the latest version**:
+   ```bash
+   pip install --upgrade trovesuite
+   ```
+
+2. **Force reinstall if needed**:
+   ```bash
+   pip install --force-reinstall trovesuite
+   ```
+
+3. **Check your Python environment**:
+   ```bash
+   python -c "import trovesuite; print('Package installed successfully')"
+   ```
+
+### Common Issues
+
+- **ImportError: No module named 'src'**: This was fixed in version 1.0.5. Update to the latest version.
+- **AttributeError: module has no attribute 'AuthServiceWriteDto'**: Use `from trovesuite.auth import AuthServiceWriteDto` instead of importing from the main package.
+
 ## Support
 
 For support, email brightgclt@gmail.com or create a work item in the [Azure DevOps repository](https://dev.azure.com/brightgclt/trovesuite/_workitems/create).
 
 ## Changelog
 
+### 1.0.5
+- Fixed all import issues across auth, notification, and entities modules
+- Changed absolute imports (`from src.trovesuite.`) to relative imports (`from .` and `from ..`)
+- Ensured package works correctly when installed from PyPI or wheel
+- Added service write DTOs to module exports for easier usage
+- Updated documentation with simplified import patterns
+- All services and DTOs now import correctly in clean environments
+- Package builds and installs without import errors
+
 ### 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
@@ -574,3 +742,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.4 → trovesuite-1.0.6}/README.md

@@ -66,10 +66,28 @@ poetry install --with dev
 
 ## Quick Start
 
+> **✅ Package Status**: All import issues have been resolved in version 1.0.5. The package now works correctly when installed from PyPI or wheel files.
+
+### 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 +102,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 +114,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 +155,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 +384,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
@@ -504,15 +622,65 @@ poetry install
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Troubleshooting
+
+### Import Issues
+
+If you encounter import errors, make sure you're using the correct import patterns:
+
+```python
+# ✅ Correct imports
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# ❌ Incorrect imports (will fail)
+from trovesuite.auth.auth_write_dto import AuthServiceWriteDto  # Too specific
+from trovesuite.notification.notification_write_dto import NotificationEmailServiceWriteDto  # Too specific
+```
+
+### Package Installation
+
+If you're having issues with the package installation:
+
+1. **Make sure you have the latest version**:
+   ```bash
+   pip install --upgrade trovesuite
+   ```
+
+2. **Force reinstall if needed**:
+   ```bash
+   pip install --force-reinstall trovesuite
+   ```
+
+3. **Check your Python environment**:
+   ```bash
+   python -c "import trovesuite; print('Package installed successfully')"
+   ```
+
+### Common Issues
+
+- **ImportError: No module named 'src'**: This was fixed in version 1.0.5. Update to the latest version.
+- **AttributeError: module has no attribute 'AuthServiceWriteDto'**: Use `from trovesuite.auth import AuthServiceWriteDto` instead of importing from the main package.
+
 ## Support
 
 For support, email brightgclt@gmail.com or create a work item in the [Azure DevOps repository](https://dev.azure.com/brightgclt/trovesuite/_workitems/create).
 
 ## Changelog
 
+### 1.0.5
+- Fixed all import issues across auth, notification, and entities modules
+- Changed absolute imports (`from src.trovesuite.`) to relative imports (`from .` and `from ..`)
+- Ensured package works correctly when installed from PyPI or wheel
+- Added service write DTOs to module exports for easier usage
+- Updated documentation with simplified import patterns
+- All services and DTOs now import correctly in clean environments
+- Package builds and installs without import errors
+
 ### 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 +689,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.4 → trovesuite-1.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [tool.poetry]
 name = "trovesuite"
-version = "1.0.4"
+version = "1.0.6"
 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.4"
+version = "1.0.6"
 description = "TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications"
 readme = "README.md"
 license = {text = "MIT"}

{trovesuite-1.0.4 → trovesuite-1.0.6}/setup.py

@@ -15,7 +15,7 @@ with open("pyproject.toml", "r", encoding="utf-8") as fh:
 
 setup(
     name="trovesuite",
-    version="1.0.4",
+    version="1.0.6",
     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.6/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.5"
+__author__ = "Bright Debrah Owusu"
+__email__ = "owusu.debrah@deladetech.com"
+
+__all__ = [
+    "AuthService",
+    "NotificationService"
+]

trovesuite-1.0.6/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.6/src/trovesuite/auth/auth_controller.py

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

{trovesuite-1.0.4 → trovesuite-1.0.6}/src/trovesuite/entities/health.py

@@ -1,8 +1,8 @@
 from fastapi import APIRouter
-from src.entities.shared.shared_response import Respons
-from src.configs.settings import db_settings
-from src.configs.database import DatabaseManager
-from src.configs.logging import get_logger
+from .sh_response import Respons
+from ..configs.settings import db_settings
+from ..configs.database import DatabaseManager
+from ..configs.logging import get_logger
 
 health_check_router = APIRouter(tags=["Health Path"])
 logger = get_logger("health")

trovesuite-1.0.6/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.6/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.6/src/trovesuite/notification/notification_controller.py

@@ -0,0 +1,21 @@
+from .notification_write_dto import (
+    NotificationEmailControllerWriteDto,
+    NotificationSMSControllerWriteDto
+)
+from .notification_read_dto import (
+    NotificationEmailControllerReadDto,
+    NotificationSMSControllerReadDto
+)
+from .notification_service import NotificationService
+from ..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.6/src/trovesuite/notification/notification_read_dto.py

@@ -0,0 +1,21 @@
+from .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.6/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 ..entities.sh_response import Respons
+from .notification_read_dto import (
+    NotificationEmailServiceReadDto,
+    NotificationSMSServiceReadDto
+)
+from .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.6/src/trovesuite/notification/notification_write_dto.py

@@ -0,0 +1,21 @@
+from pydantic import BaseModel
+from .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.4 → trovesuite-1.0.6/src/trovesuite.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trovesuite
-Version: 1.0.4
+Version: 1.0.6
 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
@@ -119,10 +119,28 @@ poetry install --with dev
 
 ## Quick Start
 
+> **✅ Package Status**: All import issues have been resolved in version 1.0.5. The package now works correctly when installed from PyPI or wheel files.
+
+### 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
@@ -137,7 +155,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)
 
@@ -149,6 +167,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
@@ -166,7 +208,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
@@ -395,8 +437,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
@@ -557,15 +675,65 @@ poetry install
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Troubleshooting
+
+### Import Issues
+
+If you encounter import errors, make sure you're using the correct import patterns:
+
+```python
+# ✅ Correct imports
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# ❌ Incorrect imports (will fail)
+from trovesuite.auth.auth_write_dto import AuthServiceWriteDto  # Too specific
+from trovesuite.notification.notification_write_dto import NotificationEmailServiceWriteDto  # Too specific
+```
+
+### Package Installation
+
+If you're having issues with the package installation:
+
+1. **Make sure you have the latest version**:
+   ```bash
+   pip install --upgrade trovesuite
+   ```
+
+2. **Force reinstall if needed**:
+   ```bash
+   pip install --force-reinstall trovesuite
+   ```
+
+3. **Check your Python environment**:
+   ```bash
+   python -c "import trovesuite; print('Package installed successfully')"
+   ```
+
+### Common Issues
+
+- **ImportError: No module named 'src'**: This was fixed in version 1.0.5. Update to the latest version.
+- **AttributeError: module has no attribute 'AuthServiceWriteDto'**: Use `from trovesuite.auth import AuthServiceWriteDto` instead of importing from the main package.
+
 ## Support
 
 For support, email brightgclt@gmail.com or create a work item in the [Azure DevOps repository](https://dev.azure.com/brightgclt/trovesuite/_workitems/create).
 
 ## Changelog
 
+### 1.0.5
+- Fixed all import issues across auth, notification, and entities modules
+- Changed absolute imports (`from src.trovesuite.`) to relative imports (`from .` and `from ..`)
+- Ensured package works correctly when installed from PyPI or wheel
+- Added service write DTOs to module exports for easier usage
+- Updated documentation with simplified import patterns
+- All services and DTOs now import correctly in clean environments
+- Package builds and installs without import errors
+
 ### 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
@@ -574,3 +742,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.4 → trovesuite-1.0.6}/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.4/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.4/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"
-]
-

trovesuite-1.0.4/src/trovesuite/auth/auth_controller.py

@@ -1,11 +0,0 @@
-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=Respons[AuthControllerReadDto])
-async def authorize(data: AuthControllerWriteDto):
-    return AuthService.authorize(data=data)