⚙️URL API Reference

use Siro\Core\URL;

// Generate signed URL (valid for 1 hour)
$link = URL::signed('/api/auth/reset-password', [
    'email' => 'user@test.com',
], 3600);
// https://example.com/api/auth/reset-password?payload=...&signature=...

// Validate incoming request
$request = [
    'payload' => $_GET['payload'],
    'signature' => $_GET['signature'],
];

$data = URL::validate($request['payload'], $request['signature']);
if ($data === null) {
    // Invalid or expired URL
}
// $data = ['route' => '/api/auth/reset-password', 'params' => ['email' => 'user@test.com']]

// In controller
$data = URL::validateRequest();

if ($data === null) {
    return Response::error('Invalid or expired link', 400);
}

$email = $data['params']['email'] ?? '';
// Process password reset

// Generate link
$token = bin2hex(random_bytes(32));
User::where('email', $email)->update(['reset_token' => hash('sha256', $token)]);

$link = URL::signed('/api/auth/reset-password', [
    'email' => $email,
    'token' => $token,
], 3600);

// Email the link to user
Mail::to($email)->subject('Reset Your Password')->html($link);

// Controller validates
public function resetPassword(Request $request): Response
{
    $data = URL::validateRequest();
    if ($data === null) {
        return Response::error('Invalid or expired reset link', 400);
    }
    // Process reset...
}