<?php

namespace App\Http\Responses;

use Illuminate\Http\JsonResponse;
use Symfony\Component\HttpFoundation\Response;

class ApiResponse
{
    /**
     * Standard success envelope: { success, data, message, errors, meta }.
     */
    public static function success(
        mixed $data = null,
        ?string $message = null,
        array $meta = [],
        int $status = Response::HTTP_OK,
    ): JsonResponse {
        return response()->json([
            'success' => true,
            'data' => $data,
            'message' => $message,
            'errors' => null,
            'meta' => (object) $meta,
        ], $status);
    }

    /**
     * Standard error envelope. Use HTTP_UNPROCESSABLE_ENTITY for validation,
     * HTTP_NOT_FOUND for missing resources, etc.
     */
    public static function error(
        string $message,
        mixed $errors = null,
        int $status = Response::HTTP_BAD_REQUEST,
        array $meta = [],
    ): JsonResponse {
        return response()->json([
            'success' => false,
            'data' => null,
            'message' => $message,
            'errors' => $errors,
            'meta' => (object) $meta,
        ], $status);
    }
}