mirror of
https://github.com/MODSetter/SurfSense.git
synced 2026-04-26 01:06:23 +02:00
656e061f84
Some checks are pending
Build and Push Docker Images / tag_release (push) Waiting to run
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Blocked by required conditions
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Blocked by required conditions
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Blocked by required conditions
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Blocked by required conditions
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Blocked by required conditions
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Blocked by required conditions
- Introduced a `ProcessingMode` enum to differentiate between basic and premium processing modes. - Updated `EtlRequest` to include a `processing_mode` field, defaulting to basic. - Enhanced ETL pipeline services to utilize the selected processing mode for Azure Document Intelligence and LlamaCloud parsing. - Modified various routes and services to handle processing mode, affecting document upload and indexing tasks. - Improved error handling and logging to include processing mode details. - Added tests to validate processing mode functionality and its impact on ETL operations.
104 lines
2.9 KiB
Python
104 lines
2.9 KiB
Python
"""Structured error hierarchy for SurfSense.
|
|
|
|
Every error response follows a backward-compatible contract:
|
|
|
|
{
|
|
"error": {
|
|
"code": "SOME_ERROR_CODE",
|
|
"message": "Human-readable, client-safe message.",
|
|
"status": 422,
|
|
"request_id": "req_...",
|
|
"timestamp": "2026-04-14T12:00:00Z",
|
|
"report_url": "https://github.com/MODSetter/SurfSense/issues"
|
|
},
|
|
"detail": "Human-readable, client-safe message." # legacy compat
|
|
}
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
ISSUES_URL = "https://github.com/MODSetter/SurfSense/issues"
|
|
|
|
GENERIC_5XX_MESSAGE = (
|
|
"An internal error occurred. Please try again or report this issue if it persists."
|
|
)
|
|
|
|
|
|
class SurfSenseError(Exception):
|
|
"""Base exception that global handlers translate into the structured envelope."""
|
|
|
|
def __init__(
|
|
self,
|
|
message: str = GENERIC_5XX_MESSAGE,
|
|
*,
|
|
code: str = "INTERNAL_ERROR",
|
|
status_code: int = 500,
|
|
safe_for_client: bool = True,
|
|
) -> None:
|
|
super().__init__(message)
|
|
self.message = message
|
|
self.code = code
|
|
self.status_code = status_code
|
|
self.safe_for_client = safe_for_client
|
|
|
|
|
|
class ConnectorError(SurfSenseError):
|
|
def __init__(self, message: str, *, code: str = "CONNECTOR_ERROR") -> None:
|
|
super().__init__(message, code=code, status_code=502)
|
|
|
|
|
|
class DatabaseError(SurfSenseError):
|
|
def __init__(
|
|
self,
|
|
message: str = "A database error occurred.",
|
|
*,
|
|
code: str = "DATABASE_ERROR",
|
|
) -> None:
|
|
super().__init__(message, code=code, status_code=500)
|
|
|
|
|
|
class ConfigurationError(SurfSenseError):
|
|
def __init__(
|
|
self,
|
|
message: str = "A configuration error occurred.",
|
|
*,
|
|
code: str = "CONFIGURATION_ERROR",
|
|
) -> None:
|
|
super().__init__(message, code=code, status_code=500)
|
|
|
|
|
|
class ExternalServiceError(SurfSenseError):
|
|
def __init__(
|
|
self,
|
|
message: str = "An external service is unavailable.",
|
|
*,
|
|
code: str = "EXTERNAL_SERVICE_ERROR",
|
|
) -> None:
|
|
super().__init__(message, code=code, status_code=502)
|
|
|
|
|
|
class NotFoundError(SurfSenseError):
|
|
def __init__(
|
|
self,
|
|
message: str = "The requested resource was not found.",
|
|
*,
|
|
code: str = "NOT_FOUND",
|
|
) -> None:
|
|
super().__init__(message, code=code, status_code=404)
|
|
|
|
|
|
class ForbiddenError(SurfSenseError):
|
|
def __init__(
|
|
self,
|
|
message: str = "You don't have permission to access this resource.",
|
|
*,
|
|
code: str = "FORBIDDEN",
|
|
) -> None:
|
|
super().__init__(message, code=code, status_code=403)
|
|
|
|
|
|
class ValidationError(SurfSenseError):
|
|
def __init__(
|
|
self, message: str = "Validation failed.", *, code: str = "VALIDATION_ERROR"
|
|
) -> None:
|
|
super().__init__(message, code=code, status_code=422)
|