smuuf/primi

<?php

declare(strict_types=1);

namespace Smuuf\Primi\Stdlib\Modules;

use \Smuuf\Primi\Extensions\PrimiFunc;
use \Smuuf\Primi\Values\NumberValue;
use \Smuuf\Primi\Values\StringValue;
use \Smuuf\Primi\Helpers\Interned;
use \Smuuf\Primi\Modules\NativeModule;
use \Smuuf\Primi\Modules\AllowedInSandboxTrait;

return new
/**
 * Hashing functions.
 */
class extends NativeModule {

    use AllowedInSandboxTrait;

    /**
     * Return [`crc32`](https://en.wikipedia.org/wiki/Cyclic_redundancy_check)
     * representation of a `string` value as `number`.
     *
     * ```js
     * crc32('hello') == 907060870
     * crc32('123') == 2286445522
     * ```
     */
    #[PrimiFunc]
    public static function crc32(StringValue $data): NumberValue {
        return Interned::number((string) \crc32($data->value));
    }

    /**
     * Return [`md5` hash](https://en.wikipedia.org/wiki/MD5) representation
     * of a `string` value as `string`.
     *
     * ```js
     * md5('hello') == '5d41402abc4b2a76b9719d911017c592'
     * md5('123') == '202cb962ac59075b964b07152d234b70'
     * ```
     */
    #[PrimiFunc]
    public static function md5(StringValue $data): StringValue {
        return Interned::string(\md5($data->value));
    }

    /**
     * Return [`sha256` hash](https://en.wikipedia.org/wiki/SHA-2) representation
     * of a `string` value as `string`.
     *
     * ```js
     * sha256('hello') == '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
     * sha256('123') == 'a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3'
     * ```
     */
    #[PrimiFunc]
    public static function sha256(StringValue $data): StringValue {
        return Interned::string(\hash('sha256', $data->value));
    }

};