90863cd8f5
Rename folders to match PHP PSR-4 autoloading conventions: - schemas → Schemas - shared → Shared - Wordpress → WordPress (in all locations) Fixes deployment issues on Linux servers where filesystem is case-sensitive. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
122 lines
2.8 KiB
PHP
122 lines
2.8 KiB
PHP
<?php
|
||
declare(strict_types=1);
|
||
|
||
namespace ROITheme\Shared\Application\UseCases\SaveComponent;
|
||
|
||
/**
|
||
* SaveComponentResponse - DTO de salida para guardar componente
|
||
*
|
||
* RESPONSABILIDAD: Encapsular el resultado del Use Case (<28>xito o fallo)
|
||
*
|
||
* PATR<54>N: Success/Failure
|
||
* - <20>xito: success=true, data contiene el componente guardado
|
||
* - Fallo: success=false, errors contiene array de errores
|
||
*
|
||
* CARACTER<45>STICAS:
|
||
* - Inmutable
|
||
* - Constructor privado (usar factory methods)
|
||
* - Factory methods: success() y failure()
|
||
*
|
||
* USO:
|
||
* ```php
|
||
* // <20>xito
|
||
* $response = SaveComponentResponse::success(['name' => 'top_bar', ...]);
|
||
* if ($response->isSuccess()) {
|
||
* $data = $response->getData();
|
||
* }
|
||
*
|
||
* // Fallo
|
||
* $response = SaveComponentResponse::failure(['Error de validaci<63>n']);
|
||
* if (!$response->isSuccess()) {
|
||
* $errors = $response->getErrors();
|
||
* }
|
||
* ```
|
||
*
|
||
* @package ROITheme\Shared\Application\UseCases\SaveComponent
|
||
*/
|
||
final readonly class SaveComponentResponse
|
||
{
|
||
/**
|
||
* Constructor privado - usar factory methods
|
||
*
|
||
* @param bool $success Indica si la operaci<63>n fue exitosa
|
||
* @param mixed $data Datos del componente guardado (solo si success=true)
|
||
* @param array|null $errors Array de errores (solo si success=false)
|
||
*/
|
||
private function __construct(
|
||
private bool $success,
|
||
private mixed $data,
|
||
private ?array $errors
|
||
) {}
|
||
|
||
/**
|
||
* Verificar si la operaci<63>n fue exitosa
|
||
*
|
||
* @return bool
|
||
*/
|
||
public function isSuccess(): bool
|
||
{
|
||
return $this->success;
|
||
}
|
||
|
||
/**
|
||
* Obtener datos del componente guardado
|
||
*
|
||
* Solo v<>lido si isSuccess() === true
|
||
*
|
||
* @return mixed
|
||
*/
|
||
public function getData(): mixed
|
||
{
|
||
return $this->data;
|
||
}
|
||
|
||
/**
|
||
* Obtener errores
|
||
*
|
||
* Solo v<>lido si isSuccess() === false
|
||
*
|
||
* @return array|null
|
||
*/
|
||
public function getErrors(): ?array
|
||
{
|
||
return $this->errors;
|
||
}
|
||
|
||
/**
|
||
* Factory method: Crear respuesta exitosa
|
||
*
|
||
* @param mixed $data Datos del componente guardado
|
||
* @return self
|
||
*/
|
||
public static function success(mixed $data): self
|
||
{
|
||
return new self(true, $data, null);
|
||
}
|
||
|
||
/**
|
||
* Factory method: Crear respuesta de fallo
|
||
*
|
||
* @param array $errors Array de mensajes de error
|
||
* @return self
|
||
*/
|
||
public static function failure(array $errors): self
|
||
{
|
||
return new self(false, null, $errors);
|
||
}
|
||
|
||
/**
|
||
* Convertir a array para serializaci<63>n (JSON, etc.)
|
||
*
|
||
* @return array
|
||
*/
|
||
public function toArray(): array
|
||
{
|
||
return [
|
||
'success' => $this->success,
|
||
'data' => $this->data,
|
||
'errors' => $this->errors
|
||
];
|
||
}
|
||
}
|