trovesuite 1.0.8__py3-none-any.whl → 1.0.10__py3-none-any.whl

{trovesuite-1.0.8.dist-info → trovesuite-1.0.10.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: trovesuite
-Version: 1.0.8
-Summary: A comprehensive authentication and authorization service for ERP systems
-Home-page: https://github.com/deladetech/trovesuite-auth-service
+Version: 1.0.10
+Summary: TroveSuite services package providing authentication, authorization, notifications, Azure Storage, and other enterprise services for TroveSuite applications
+Home-page: https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Author: Bright Debrah Owusu
 Author-email: Bright Debrah Owusu <owusu.debrah@deladetech.com>
 Maintainer-email: Bright Debrah Owusu <owusu.debrah@deladetech.com>
@@ -11,7 +11,7 @@ Project-URL: Homepage, https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Project-URL: Repository, https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Project-URL: Documentation, https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Project-URL: Bug Tracker, https://dev.azure.com/brightgclt/trovesuite/_workitems/create
-Keywords: authentication,authorization,jwt,erp,fastapi,security
+Keywords: authentication,authorization,notifications,jwt,trovesuite,fastapi,security,tenant,permissions,enterprise,services,azure,storage,blob,cloud-storage
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -34,6 +34,10 @@ 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
+Requires-Dist: azure-storage-blob>=12.19.0
+Requires-Dist: azure-identity>=1.15.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.2; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
@@ -49,19 +53,21 @@ Dynamic: home-page
 Dynamic: license-file
 Dynamic: requires-python
 
-# TroveSuite Auth Service
+# TroveSuite Packages
 
-A comprehensive authentication and authorization service for ERP systems. This package provides JWT token validation, user authorization, and permission checking capabilities.
+TroveSuite package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications.
 
 ## Features
 
-- **JWT Token Validation**: Secure token decoding and validation
-- **User Authorization**: Multi-level authorization with tenant verification
+- **Authentication Services**: JWT token validation and user authentication
+- **Authorization Services**: Multi-level authorization with tenant verification
+- **Notification Services**: Send and manage notifications for users
 - **Permission Checking**: Hierarchical permission system (organization > business > app > location > resource)
 - **Database Integration**: PostgreSQL support with connection pooling
 - **Logging**: Comprehensive logging with multiple output formats
 - **Azure Integration**: Support for Azure Storage Queues and Managed Identity
 - **FastAPI Ready**: Built for FastAPI applications
+- **Extensible**: Easy to add new services and functionality
 
 ## Installation
 
@@ -115,10 +121,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
@@ -133,7 +157,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)
 
@@ -145,6 +169,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
@@ -162,7 +210,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
@@ -391,8 +439,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
@@ -553,15 +677,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
@@ -570,3 +744,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.10.dist-info/RECORD

@@ -0,0 +1,33 @@
+trovesuite/__init__.py,sha256=QIY7iN7TVyJKjCoB6CBA4pSqm_mL41frcFgFS4maO8k,555
+trovesuite/auth/__init__.py,sha256=OjZllVvjul1glDazJ-d5TrNjgHFigFlQQi1G99DYshk,239
+trovesuite/auth/auth_base.py,sha256=rZHQVLeJRBQ8GClgF5UwG-er4_HXVX5-nt8o6_Z29uY,75
+trovesuite/auth/auth_controller.py,sha256=PAgaVlf5TYEfkSfK4vGGsvO84i8zEmeVVXyUF2YBppI,420
+trovesuite/auth/auth_read_dto.py,sha256=pQT1ouRVZMAiJn4wAG7NQOKQKTquTMWUe-dYcpLTmEo,533
+trovesuite/auth/auth_service.py,sha256=if2RFI6F1DpbNEuCTSpPbhHVBdYQEg4hVkoxTCnvC4k,14298
+trovesuite/auth/auth_write_dto.py,sha256=rdwI7w6-9QZGv1H0PAGrjkLBCzaMHjgPIXeLb9RmNec,234
+trovesuite/configs/__init__.py,sha256=h1mSZOaZ3kUy1ZMO_m9O9KklsxywM0RfMVZLh9h9WvQ,328
+trovesuite/configs/database.py,sha256=IPSu8fXjxyYeJ3bFknJG06Qm2L2ub6Ht19xhKv8g7nA,11731
+trovesuite/configs/logging.py,sha256=mGjR2d4urVNry9l5_aXycMMtcY2RAFIpEL35hw33KZg,9308
+trovesuite/configs/settings.py,sha256=yUbkiFi4QdO9JZG1RRFbP4tYurT47HmN-ohgYcs2SHM,2561
+trovesuite/entities/__init__.py,sha256=Dbl_03Bueyh2vOP2hykd40MmNMrl5nNHSRGP-kqwwNo,160
+trovesuite/entities/health.py,sha256=KaW7yxTQdymIPlnkJJkDqEebBXkD0a7A66i5GgNZLoE,2700
+trovesuite/entities/sh_response.py,sha256=1_sw3PpVaDxWsNiBU0W9YLHZgTFxEj4JJBLBfSY63Ho,1579
+trovesuite/notification/__init__.py,sha256=mjglzmlk29SREP6LfvBYGmCSc-K1SKKAEx_OJdJ2Vrs,394
+trovesuite/notification/notification_base.py,sha256=6Xo0Gnnpg3RgN1_SRkAcH-K4l7DwNDZvn1gRm3oMWyk,320
+trovesuite/notification/notification_controller.py,sha256=VVy1xj4GL8_Wj7wMMTwozXXX8i_2WSJqC_NyNse35TI,847
+trovesuite/notification/notification_read_dto.py,sha256=K0DFLyAArvtqOGS7q1VzmqO28StTMbcNCgpmhzhad8E,423
+trovesuite/notification/notification_service.py,sha256=sf_lJWcrmRIUeEabdEYLaSdRz2H1D3RBEwKMOA1h2pY,2433
+trovesuite/notification/notification_write_dto.py,sha256=PGpww3PomrmJgXTgpwGhXasv_fC8mgUQvTloaTqaSTA,452
+trovesuite/storage/__init__.py,sha256=lO9E2QvzNFOfUocfITnIBuSR6-eg1zVYLrEVIEq3SXc,1334
+trovesuite/storage/storage_base.py,sha256=nOdnjlwP4xiGdbpdeh5rLDAzkWHZd9M_7lznvNlqsV4,1899
+trovesuite/storage/storage_controller.py,sha256=Yzki0L-jmSPbiw8spFm6Z84Bq-WZfih_0GsfbNRHssM,6569
+trovesuite/storage/storage_read_dto.py,sha256=o7EVJdwrwVZAaeyGU9O01WMECGVaytkvLRwruA256hQ,1471
+trovesuite/storage/storage_service.py,sha256=V7LIePIV6b_iuhm-9x8r4zwpZHgeRPL1YIe5IBnxhco,19768
+trovesuite/storage/storage_write_dto.py,sha256=vl1iCZ93bpFmpvkCrn587QtMtOA_TPDseXSoTuj9RTQ,1355
+trovesuite/utils/__init__.py,sha256=3UPKTz9cluTgAM-ldNsJxsnoPTZiqacXlAmzUEHy6q8,143
+trovesuite/utils/helper.py,sha256=lvZ1mvaqY84dkIPB5Ov0uwYDOWBziAS8twobEJZh2Ik,1002
+trovesuite-1.0.10.dist-info/licenses/LICENSE,sha256=EJT35ct-Q794JYPdAQy3XNczQGKkU1HzToLeK1YVw2s,1070
+trovesuite-1.0.10.dist-info/METADATA,sha256=LMpOSCZRz-a7s54MlVZLsRBmsb7jL1y9x5EjegdYYK4,21737
+trovesuite-1.0.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+trovesuite-1.0.10.dist-info/top_level.txt,sha256=GzKhG_-MTaxeHrIgkGkBH_nof2vroGFBrjeHKWUIwNc,11
+trovesuite-1.0.10.dist-info/RECORD,,

trovesuite-1.0.8.dist-info/RECORD

@@ -1,21 +0,0 @@
-trovesuite/__init__.py,sha256=a9jSrjmrhOey6yE2I83TO_rVJDogIwGDyL3HJBGiGqM,347
-trovesuite/auth/__init__.py,sha256=qhgPqBHiLOjMcnecLvZQPV3UKV0ADKWp91kXfkpeAi4,336
-trovesuite/auth/auth_base.py,sha256=I3-JU97KZJT89fGdL96HmQLFHXfN3CNokSChsqzeRPo,74
-trovesuite/auth/auth_controller.py,sha256=47LsxPvE2wCqpadLPf_m68M8eR7Zu9HxfSSxZQZKQyM,412
-trovesuite/auth/auth_read_dto.py,sha256=JxTwBlgUZ1S_KMaDuF0AueEhMBFrCiWgsHQDqoI2mMc,577
-trovesuite/auth/auth_service.py,sha256=ZsR6LXE6c0ej4U8rb5SdccL6cyk2t_LicIESe98sUE8,14260
-trovesuite/auth/auth_write_dto.py,sha256=OO4h_EYIxhCzhVZkoicYn31J_vw9tUNDegTeG6u65kE,230
-trovesuite/configs/__init__.py,sha256=h1mSZOaZ3kUy1ZMO_m9O9KklsxywM0RfMVZLh9h9WvQ,328
-trovesuite/configs/database.py,sha256=tXj-AYIUs-gjYrgioTnQafbDhsaIsgimWWLXR3ru-1A,7580
-trovesuite/configs/logging.py,sha256=mGjR2d4urVNry9l5_aXycMMtcY2RAFIpEL35hw33KZg,9308
-trovesuite/configs/settings.py,sha256=7Z9b-yWLSCL_NA28JfOGisQIrOvGb5PhcriQJvnZURk,7189
-trovesuite/entities/__init__.py,sha256=Dbl_03Bueyh2vOP2hykd40MmNMrl5nNHSRGP-kqwwNo,160
-trovesuite/entities/health.py,sha256=H8-XUywzvMfZy2dZwDyJGAUbmuULuZYvYIUWhiaVGdY,2729
-trovesuite/entities/sh_response.py,sha256=1_sw3PpVaDxWsNiBU0W9YLHZgTFxEj4JJBLBfSY63Ho,1579
-trovesuite/utils/__init__.py,sha256=3UPKTz9cluTgAM-ldNsJxsnoPTZiqacXlAmzUEHy6q8,143
-trovesuite/utils/helper.py,sha256=lvZ1mvaqY84dkIPB5Ov0uwYDOWBziAS8twobEJZh2Ik,1002
-trovesuite-1.0.8.dist-info/licenses/LICENSE,sha256=EJT35ct-Q794JYPdAQy3XNczQGKkU1HzToLeK1YVw2s,1070
-trovesuite-1.0.8.dist-info/METADATA,sha256=sGGcwQAl--L9L5wSFsIGSqNZQ2qOWRf3aMZ--Mv6jeo,15693
-trovesuite-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-trovesuite-1.0.8.dist-info/top_level.txt,sha256=GzKhG_-MTaxeHrIgkGkBH_nof2vroGFBrjeHKWUIwNc,11
-trovesuite-1.0.8.dist-info/RECORD,,