"""Erros de domínio → resposta HTTP padronizada `{"error": {"code", "message"}}`.""" from __future__ import annotations class ServiceError(Exception): status = 500 code = "internal_error" message = "Erro interno." retry_after: int | None = None def __init__(self, message: str | None = None, retry_after: int | None = None): super().__init__(message or self.message) if message: self.message = message if retry_after is not None: self.retry_after = retry_after class Unauthorized(ServiceError): status, code, message = 401, "unauthorized", "Chave de serviço ausente ou inválida." class InsufficientScope(ServiceError): """403: a chave é válida, mas não tem o escopo da operação (ADR 0027 §10).""" status, code, message = 403, "insufficient_scope", "A chave não tem o escopo desta operação." def __init__(self, scope: str): super().__init__() self.scope = scope class InvalidRequest(ServiceError): status, code, message = 422, "invalid_request", "Requisição inválida." class TextTooLong(ServiceError): status, code, message = 422, "text_too_long", "Texto acima do limite." class VoiceNotFound(ServiceError): status, code, message = 422, "voice_not_found", "Voz fora do catálogo." class VoiceDetailNotFound(ServiceError): """404 de GET /v1/voices/{voiceId} (a síntese continua com 422 voice_not_found).""" status, code, message = 404, "voice_not_found", "Voz fora do catálogo." class AudioTooLong(ServiceError): status, code, message = 422, "audio_too_long", "Áudio passaria do limite de duração." class IdempotencyConflict(ServiceError): status, code = 409, "idempotency_conflict" message = "Este requestId já foi usado com outro conteúdo." class QueueFull(ServiceError): status, code, message, retry_after = 503, "queue_full", "Fila cheia.", 5 class QueueTimeout(ServiceError): status, code, message, retry_after = 503, "queue_timeout", "Tempo de espera na fila esgotado.", 5 class SynthesisTimeout(ServiceError): status, code, message = 504, "synthesis_timeout", "Síntese passou do tempo limite." class SynthesisFailed(ServiceError): status, code, message = 500, "synthesis_failed", "Falha na síntese." class EngineUnavailable(ServiceError): # 502: o motor depende de um serviço de fora (Edge TTS) que não respondeu. Tente de novo ou use uma voz offline. status, code, message, retry_after = 502, "engine_unavailable", "Motor de voz indisponível (sem internet?).", 5 class RvcFailed(ServiceError): status, code = 422, "rvc_failed" message = "O modelo RVC desta voz não pôde ser usado (arquivo inválido ou incompatível com o Applio 3.7.0)." class RvcUnavailable(ServiceError): status, code, message = 501, "rvc_disabled", "Voz de personagem (RVC) exige o Applio instalado pelo setup." class CloneUnavailable(ServiceError): # 503: a voz clonada depende do processo de clonagem (voice/.venv-clone, porta 4511), que não respondeu. status, code, retry_after = 503, "clone_unavailable", 10 message = "A clonagem de voz não está rodando: rode setup.bat -Clone e reinicie o start.bat." # ---------- transcrição ---------- class InvalidAudio(ServiceError): status, code, message = 422, "invalid_audio", "Áudio ilegível ou em formato não suportado." class AudioTooLarge(ServiceError): status, code, message = 413, "audio_too_large", "Áudio acima do limite de bytes." class LanguageNotSupported(ServiceError): status, code, message = 422, "language_not_supported", "Idioma não atendido." class SttDisabled(ServiceError): # 501: configuração do serviço, não sobrecarga (o 503 do serviço quer dizer "fila cheia"). status, code, message = 501, "stt_disabled", "Transcrição desligada neste serviço." class JobNotFound(ServiceError): # 410 (e não 404): o 404 genérico do serviço significa rota errada (= `misconfigured` no backend). status, code, message = 410, "job_not_found", "Job desconhecido ou expirado." class TranscriptionTimeout(ServiceError): status, code, message = 504, "transcription_timeout", "Transcrição passou do tempo limite." class TranscriptionFailed(ServiceError): status, code, message = 500, "transcription_failed", "Falha na transcrição."