Implement localization for API responses and error messages

- Added localization support for API responses in English and Spanish.
- Introduced a middleware to set the API locale based on the Accept-Language header.
- Updated various exception messages and validation responses to use localized strings.
- Created new language files for English and Spanish translations.
- Refactored existing code to replace hardcoded messages with localized strings.
- Added tests to verify localization functionality and response correctness.

lang/es/api.php

@@ -0,0 +1,104 @@
+<?php
+
+return [
+    'auth' => [
+        'unauthenticated' => 'No autenticado.',
+        'invalid_credentials' => 'Email o contraseña incorrectos.',
+        'login_success' => 'Sesión iniciada correctamente.',
+        'logout_success' => 'Sesión cerrada correctamente.',
+        'register_success' => 'Usuario registrado correctamente.',
+        'password_reset_requested' => 'Si el email está registrado, recibirás un código para recuperar tu contraseña.',
+        'password_reset_invalid' => 'La solicitud de recuperación es inválida o ya fue utilizada.',
+        'password_updated' => 'Contraseña modificada correctamente.',
+        'reset_code_invalid' => 'El código ingresado es inválido.',
+        'reset_code_valid' => 'Código validado correctamente.',
+        'invalid_tenant_or_return_url' => 'El tenant o la URL de retorno no son válidos.',
+        'request_expired' => 'La solicitud de autenticación expiró. Intenta nuevamente.',
+        'invalid_return_url' => 'La URL de retorno no es válida.',
+        'oauth_code_expired' => 'El código de autenticación expiró o ya fue utilizado.',
+        'tenant_mismatch' => 'El tenant no coincide con la solicitud de autenticación.',
+        'google_email_required' => 'Google no devolvió un email para la cuenta.',
+        'google_email_unverified' => 'La cuenta de Google debe tener el email verificado.',
+    ],
+    'cart' => [
+        'item_added' => 'Producto agregado al carrito.',
+        'quantity_updated' => 'Cantidad de producto actualizada.',
+        'item_removed' => 'Producto eliminado del carrito.',
+        'positive_quantity' => 'La cantidad debe ser mayor a cero.',
+        'insufficient_stock' => 'Stock insuficiente para el producto solicitado. Máximo disponible: :max.',
+        'max_quantity' => 'El máximo que se puede agregar es :max.',
+        'bundle_variant_forbidden' => 'Un bundle no admite una variante.',
+        'empty_bundle' => 'El bundle no tiene componentes.',
+        'variant_required' => 'Debe seleccionar una variante para este ítem.',
+    ],
+    'purchase' => [
+        'source_required' => 'Se requiere un carrito o un producto directo.',
+        'payment_method_required' => 'Debes seleccionar el método de pago antes de finalizar la compra.',
+        'not_editable' => 'La compra ya no se puede modificar.',
+        'item_not_editable' => 'El producto de la compra ya no se puede modificar.',
+        'insufficient_stock' => 'No hay suficiente stock disponible.',
+        'cannot_confirm' => 'Una compra cancelada, rechazada o vencida no se puede confirmar.',
+        'inconsistent_reservation' => 'La compra tiene una reserva de stock inconsistente.',
+        'paid_cannot_cancel' => 'Una compra pagada no se puede cancelar.',
+        'direct_item_max_stock' => 'Stock insuficiente. Máximo disponible: :max.',
+        'empty_cart' => 'El carrito seleccionado no contiene productos.',
+        'catalog_item_missing' => 'No se pudieron cargar uno o más productos del catálogo.',
+        'catalog_item_wrong_tenant' => 'Uno o más productos no pertenecen al tenant.',
+        'inactive_cart' => 'El carrito seleccionado ya no está activo.',
+        'not_available_for_payment' => 'La compra ya no está disponible para el pago.',
+    ],
+    'ticket' => [
+        'not_available' => 'Uno o más tickets no están disponibles.',
+        'positive_quantity' => 'La cantidad de tickets a generar debe ser mayor a cero.',
+        'empty_bundle' => 'El bundle :bundle no tiene componentes.',
+        'disabled' => 'El producto :product no tiene tickets habilitados.',
+        'expired' => 'El producto :product alcanzó su fecha máxima de uso.',
+        'invalid_variant' => 'La variante :variant no pertenece al producto :product.',
+        'purchase_without_user' => 'La compra :purchase no tiene un usuario asociado.',
+        'product_not_found' => 'No se encontró el producto de la línea de compra :purchase_item.',
+    ],
+    'integration' => [
+        'not_configured' => 'La integración no está configurada para este tenant.',
+        'configured' => 'Integración configurada correctamente.',
+        'validation_failed' => 'Error validando la configuración: :error',
+        'invalid_payment_method' => 'Método de pago inválido.',
+        'account_info_failed' => 'No se pudo obtener la información de la cuenta.',
+        'qr_generation_failed' => 'No se pudo generar el código QR.',
+        'webhook_failed' => 'No se pudo procesar el webhook.',
+    ],
+    'mail' => [
+        'test_sent' => 'Correo de prueba enviado correctamente.',
+    ],
+    'catalog' => [
+        'standard_with_components' => 'Un ítem standard no puede tener componentes.',
+        'duplicate_component' => 'El componente está duplicado.',
+        'component_wrong_tenant' => 'El ítem no pertenece al tenant del bundle.',
+        'invalid_component' => 'El componente debe ser un ítem standard distinto del bundle.',
+        'component_variant_required' => 'Debe seleccionar una variante para este componente.',
+        'component_variant_forbidden' => 'El componente con inventario directo no admite una variante.',
+        'component_variant_invalid' => 'La variante no pertenece al componente indicado.',
+        'bundle_component_required' => 'Un bundle debe tener al menos un componente.',
+        'bundle_field_forbidden' => ':field no se admite para un bundle.',
+        'attachment_not_found' => 'El attachment indicado no existe.',
+        'attribute_not_found' => 'El atributo :attribute no existe para el tenant del ítem.',
+        'managed_inventory_fields' => 'inventory_id, reserved_stock y sold_units son administrados internamente.',
+        'attribute_not_on_item' => 'El atributo no pertenece al ítem de catálogo.',
+        'invalid_effective_date_range' => 'La fecha máxima efectiva debe ser posterior o igual a la fecha mínima efectiva.',
+        'variants_required' => 'Un ítem con attribute_codes debe tener variantes.',
+        'variants_forbidden' => 'Un ítem sin attribute_codes no puede tener variantes.',
+        'direct_inventory_forbidden' => 'Un ítem con variantes no puede tener inventario directo.',
+    ],
+    'menu' => [
+        'schema_required' => 'El schema es obligatorio para los menús estáticos.',
+        'not_found' => 'El menú indicado no existe.',
+    ],
+    'tenant' => [
+        'invalid_carousel_image' => 'La imagen indicada no existe o no es un attachment de tipo imagen.',
+    ],
+    'errors' => [
+        'forbidden' => 'No tienes permiso para realizar esta acción.',
+        'not_found' => 'El recurso solicitado no fue encontrado.',
+        'method_not_allowed' => 'El método HTTP no está permitido para esta ruta.',
+        'request_failed' => 'No se pudo procesar la solicitud.',
+    ],
+];

lang/es/validation.php

@@ -0,0 +1,57 @@
+<?php
+
+return [
+    'after_or_equal' => ':Attribute debe ser una fecha posterior o igual a :date.',
+    'array' => ':Attribute debe ser un arreglo.',
+    'boolean' => 'El campo :attribute debe ser verdadero o falso.',
+    'confirmed' => 'La confirmación de :attribute no coincide.',
+    'date' => ':Attribute no es una fecha válida.',
+    'distinct' => 'El campo :attribute tiene un valor duplicado.',
+    'email' => ':Attribute debe ser una dirección de email válida.',
+    'exists' => 'El valor seleccionado para :attribute no es válido.',
+    'file' => ':Attribute debe ser un archivo.',
+    'integer' => ':Attribute debe ser un número entero.',
+    'max' => [
+        'array' => ':Attribute no debe tener más de :max elementos.',
+        'file' => ':Attribute no debe superar los :max kilobytes.',
+        'numeric' => ':Attribute no debe ser mayor que :max.',
+        'string' => ':Attribute no debe tener más de :max caracteres.',
+    ],
+    'min' => [
+        'array' => ':Attribute debe tener al menos :min elementos.',
+        'file' => ':Attribute debe pesar al menos :min kilobytes.',
+        'numeric' => ':Attribute debe ser al menos :min.',
+        'string' => ':Attribute debe tener al menos :min caracteres.',
+    ],
+    'numeric' => ':Attribute debe ser un número.',
+    'password' => [
+        'letters' => ':Attribute debe contener al menos una letra.',
+        'mixed' => ':Attribute debe contener al menos una letra mayúscula y una minúscula.',
+        'numbers' => ':Attribute debe contener al menos un número.',
+        'symbols' => ':Attribute debe contener al menos un símbolo.',
+        'uncompromised' => ':Attribute aparece en una filtración de datos. Elige una contraseña diferente.',
+    ],
+    'prohibited' => 'El campo :attribute está prohibido.',
+    'regex' => 'El formato de :attribute no es válido.',
+    'required' => 'El campo :attribute es obligatorio.',
+    'required_with' => 'El campo :attribute es obligatorio cuando :values está presente.',
+    'required_without' => 'El campo :attribute es obligatorio cuando :values no está presente.',
+    'string' => ':Attribute debe ser texto.',
+    'unique' => 'El valor de :attribute ya está en uso.',
+    'url' => ':Attribute debe ser una URL válida.',
+    'uuid' => ':Attribute debe ser un UUID válido.',
+    'attributes' => [
+        'cantidad' => 'cantidad',
+        'catalog_item_id' => 'producto',
+        'codigo' => 'código',
+        'dni' => 'DNI',
+        'email' => 'email',
+        'nombre_apellido' => 'nombre y apellido',
+        'oauth_code' => 'código de autenticación',
+        'password' => 'contraseña',
+        'password_confirmation' => 'confirmación de contraseña',
+        'telefono' => 'teléfono',
+        'tenant_codigo' => 'tenant',
+        'variant_id' => 'variante',
+    ],
+];