<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

/**
 * A voice-AI vendor that call recordings can be submitted to.
 *
 * The API key is encrypted at rest by the `encrypted` cast (APP_KEY) and is
 * hidden from array/JSON serialisation, so it can never leak through a
 * datatable response, a log line or a dump of the model.
 */
class AiVoiceProvider extends Model
{
    public const DRIVER_MOCK = 'mock';

    protected $table = 'ai_voice_providers';

    protected $fillable = [
        'driver',
        'name',
        'api_key',
        'base_url',
        'transcription_model',
        'analysis_model',
        'language',
        'extra_config',
        'is_enabled',
        'is_active',
        'last_test_status',
        'last_test_message',
        'last_tested_at',
        'sort_order',
    ];

    protected $casts = [
        'api_key'       => 'encrypted',
        'extra_config'  => 'array',
        'is_enabled'    => 'boolean',
        'is_active'     => 'boolean',
        'last_tested_at' => 'datetime',
    ];

    protected $hidden = [
        'api_key',
    ];

    /**
     * The provider the Summarize button will use, or null when the feature is
     * not set up yet (nothing selected, disabled, or missing its key).
     */
    public static function active(): ?self
    {
        $provider = static::query()
            ->where('is_active', true)
            ->where('is_enabled', true)
            ->orderBy('sort_order')
            ->first();

        if (!$provider || !$provider->isReady()) {
            return null;
        }

        return $provider;
    }

    public function requiresKey(): bool
    {
        return $this->driver !== self::DRIVER_MOCK;
    }

    public function hasKey(): bool
    {
        return trim((string) $this->api_key) !== '';
    }

    public function isReady(): bool
    {
        return (bool) $this->is_enabled && (!$this->requiresKey() || $this->hasKey());
    }

    /**
     * What the settings page may show of the stored key: never the whole thing.
     */
    public function maskedKey(): string
    {
        $key = trim((string) $this->api_key);

        if ($key === '') {
            return '';
        }

        if (mb_strlen($key) <= 8) {
            return str_repeat('*', 8);
        }

        return mb_substr($key, 0, 4) . str_repeat('*', 8) . mb_substr($key, -4);
    }

    /**
     * One key out of the per-provider JSON blob, with an optional default.
     *
     * @return mixed
     */
    public function extra(string $key, $default = null)
    {
        return ($this->extra_config ?? [])[$key] ?? $default;
    }

    /**
     * Per-provider prompt override, else the global default.
     */
    public function prompt(): string
    {
        $override = trim((string) (($this->extra_config ?? [])['prompt'] ?? ''));

        if ($override !== '') {
            return $override;
        }

        return (string) config('ai_voice.default_prompt');
    }
}