<?php

/**
 * Freeform for Craft CMS.
 *
 * @author        Solspace, Inc.
 * @copyright     Copyright (c) 2008-2026, Solspace, Inc.
 *
 * @see           https://docs.solspace.com/craft/freeform
 *
 * @license       https://docs.solspace.com/license-agreement
 */

namespace Solspace\Freeform\Integrations\CRM\Zoho;

use GuzzleHttp\Client;
use Solspace\Freeform\Attributes\Property\Flag;
use Solspace\Freeform\Attributes\Property\Input;
use Solspace\Freeform\Freeform;
use Solspace\Freeform\Library\Exceptions\Integrations\IntegrationException;
use Solspace\Freeform\Library\Integrations\DataObjects\FieldObject;
use Solspace\Freeform\Library\Integrations\OAuth\OAuth2ConnectorInterface;
use Solspace\Freeform\Library\Integrations\OAuth\OAuth2RefreshTokenInterface;
use Solspace\Freeform\Library\Integrations\OAuth\OAuth2RefreshTokenTrait;
use Solspace\Freeform\Library\Integrations\OAuth\OAuth2Trait;
use Solspace\Freeform\Library\Integrations\Types\CRM\CRMIntegration;
use Solspace\Freeform\Library\Logging\FreeformLogger;

abstract class BaseZohoIntegration extends CRMIntegration implements OAuth2ConnectorInterface, OAuth2RefreshTokenInterface, ZohoIntegrationInterface
{
    use OAuth2RefreshTokenTrait;
    use OAuth2Trait;

    protected const LOG_CATEGORY = 'Zoho';

    protected const CATEGORY_LEAD = 'Lead';

    protected const CATEGORY_DEAL = 'Deal';

    protected const CATEGORY_ACCOUNT = 'Account';

    protected const CATEGORY_CONTACT = 'Contact';

    #[Flag(self::FLAG_INTERNAL)]
    #[Input\Hidden]
    protected string $accountsServer = '';

    #[Flag(self::FLAG_INTERNAL)]
    #[Input\Hidden]
    protected string $location = '';

    #[Flag(self::FLAG_INTERNAL)]
    #[Input\Hidden]
    protected string $apiDomain = '';

    #[Flag(self::FLAG_GLOBAL_PROPERTY)]
    #[Input\BooleanEnv(
        instructions: 'Enable this if your Zoho account is in Sandbox mode (connects to `sandbox.zohoapis.{domain}` instead of `www.zohoapis.com` or `www.zohoapis.{domain}`).',
        order: 1,
    )]
    protected string $sandboxMode = 'false';

    #[Flag(self::FLAG_GLOBAL_PROPERTY)]
    #[Input\BooleanEnv(
        instructions: 'Enable this if your Zoho account is in Developer mode (connects to `developer.zohoapis.{domain}` instead of `www.zohoapis.com`, `www.zohoapis.{domain}` or `sandbox.zohoapis.{domain}`).',
        order: 2,
    )]
    protected string $developerMode = 'false';

    public function checkConnection(Client $client): bool
    {
        $response = $client->get($this->getEndpoint('/settings/modules'));

        $json = json_decode((string) $response->getBody(), false);

        return !empty($json);
    }

    public function getAccountsServer(): ?string
    {
        return $this->accountsServer;
    }

    public function setAccountsServer(?string $accountsServer): self
    {
        $this->accountsServer = $accountsServer;

        return $this;
    }

    public function getLocation(): ?string
    {
        return $this->location;
    }

    public function setLocation(?string $location): self
    {
        $this->location = $location;

        return $this;
    }

    public function getApiDomain(): ?string
    {
        return $this->apiDomain;
    }

    public function setApiDomain(?string $apiDomain): self
    {
        $this->apiDomain = $apiDomain;

        return $this;
    }

    public function fetchFields(string $category, Client $client): array
    {
        $response = $client->get($this->getEndpoint('/settings/fields?module='.$category.'s'));
        $json = json_decode((string) $response->getBody());

        if (!isset($json->fields) || !$json->fields) {
            throw new IntegrationException('Could not fetch fields for '.$category);
        }

        $fieldList = [];

        foreach ($json->fields as $field) {
            if ($field->read_only || $field->field_read_only) {
                continue;
            }

            $type = match ($field->data_type) {
                'integer', 'number', 'bigint', 'currency' => FieldObject::TYPE_NUMERIC,
                'double', 'decimal' => FieldObject::TYPE_FLOAT,
                'boolean' => FieldObject::TYPE_BOOLEAN,
                'date' => FieldObject::TYPE_DATE,
                'timestamp', 'datetime' => FieldObject::TYPE_DATETIME,
                default => FieldObject::TYPE_STRING,
            };

            if ('list' === $field->data_type || 'picklist' === $field->data_type || 'multiselectpicklist' === $field->data_type) {
                if ('jsonobject' === $field->json_type || 'jsonarray' === $field->json_type) {
                    $type = FieldObject::TYPE_ARRAY;
                } else {
                    $type = FieldObject::TYPE_STRING;
                }
            }

            $fieldList[] = new FieldObject(
                $field->api_name,
                $field->field_label,
                $type,
                $category,
                $field->system_mandatory,
            );
        }

        return $fieldList;
    }

    protected function isSandboxMode(): bool
    {
        return $this->getProcessedBoolean($this->sandboxMode);
    }

    protected function isDeveloperMode(): bool
    {
        return $this->getProcessedBoolean($this->developerMode);
    }

    protected function getDomain(): string
    {
        $domain = 'https://accounts.zoho.com';

        $accountsServer = $this->getAccountsServer();
        if ($accountsServer) {
            $domain = $accountsServer;
        }

        return rtrim($domain, '/');
    }

    protected function processZohoResponseError(array $response): void
    {
        $data = $response['data'][0];

        if ('error' === $data['status']) {
            Freeform::getInstance()
                ->logger
                ->getLogger(FreeformLogger::CRM_INTEGRATION)
                ->error(
                    self::LOG_CATEGORY.' '.$data['message'],
                    ['exception' => $data],
                )
            ;

            throw new IntegrationException($data['message']);
        }
    }
}
