<?php

namespace App\Provisioning\Steps\Host;

use App\Models\Host;
use App\Models\ProvisioningRun;
use App\Provisioning\Contracts\ProvisioningStep;
use App\Provisioning\Steps\ManagesRunResources;
use App\Services\Ssh\RemoteShell;

/**
 * Shared helpers for host-onboarding steps: subject resolution, key login, and
 * idempotency breadcrumbs (run_resources).
 */
abstract class HostStep implements ProvisioningStep
{
    use ManagesRunResources;

    public function label(): string
    {
        return 'hosts.step.'.$this->key();
    }

    public function maxDuration(): int
    {
        return 300;
    }

    protected function host(ProvisioningRun $run): Host
    {
        /** @var Host $host */
        $host = $run->subject;

        return $host;
    }

    protected function keyLogin(RemoteShell $shell, Host $host): void
    {
        $shell->connectWithKey(
            $host->public_ip,
            'root',
            (string) config('provisioning.ssh.private_key'),
            $host->ssh_host_key, // pinned during EstablishSshTrust
        );
    }
}