File: src/App/Metadata/Data/HookData.php

<?php

/**
 * HookData.php
 *
 * Hook metadata for Jaxon classes.
 *
 * @package jaxon-core
 * @author Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @copyright 2025 Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-core
 */

namespace Jaxon\App\Metadata\Data;

use Jaxon\Exception\SetupException;

use function addslashes;
use function preg_match;

abstract class HookData extends AbstractData
{
    /**
     * @var array
     */
    protected $aCalls = [];

    /**
     * @return string
     */
    abstract protected function getType(): string;

    /**
     * @return string
     */
    public function getName(): string
    {
        return '__' . $this->getType();
    }

    /**
     * @return mixed
     */
    public function getValue(): mixed
    {
        return $this->aCalls;
    }

    /**
     * @param string $sMethod
     *
     * @return void
     */
    protected function validateMethod(string $sMethod): void
    {
        if(preg_match('/^[a-zA-Z][a-zA-Z0-9_]*$/', $sMethod) > 0)
        {
            return;
        }
        $sType = $this->getType();
        throw new SetupException("$sMethod is not a valid \"call\" value for $sType.");
    }

    /**
     * @param string $sMethod
     * @param array $aParams
     *
     * @return void
     */
    public function addCall(string $sMethod, array $aParams): void
    {
        $this->validateMethod($sMethod);

        $this->aCalls[$sMethod] = $aParams;
    }

    /**
     * @inheritDoc
     */
    public function encode(string $sVarName): array
    {
        $aCalls = [];
        foreach($this->aCalls as $sMethod => $aParams)
        {
            $sParams = addslashes(json_encode($aParams));
            $aCalls[] = "{$sVarName}->addCall('$sMethod', json_decode(\"$sParams\", true));";
        }
        return $aCalls;
    }
}