create-prisma-php-app 1.0.0

package/vendor/ramsey/uuid/src/FeatureSet.php

@@ -0,0 +1,395 @@
+<?php
+
+/**
+ * This file is part of the ramsey/uuid library
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+declare(strict_types=1);
+
+namespace Ramsey\Uuid;
+
+use Ramsey\Uuid\Builder\FallbackBuilder;
+use Ramsey\Uuid\Builder\UuidBuilderInterface;
+use Ramsey\Uuid\Codec\CodecInterface;
+use Ramsey\Uuid\Codec\GuidStringCodec;
+use Ramsey\Uuid\Codec\StringCodec;
+use Ramsey\Uuid\Converter\Number\GenericNumberConverter;
+use Ramsey\Uuid\Converter\NumberConverterInterface;
+use Ramsey\Uuid\Converter\Time\GenericTimeConverter;
+use Ramsey\Uuid\Converter\Time\PhpTimeConverter;
+use Ramsey\Uuid\Converter\TimeConverterInterface;
+use Ramsey\Uuid\Generator\DceSecurityGenerator;
+use Ramsey\Uuid\Generator\DceSecurityGeneratorInterface;
+use Ramsey\Uuid\Generator\NameGeneratorFactory;
+use Ramsey\Uuid\Generator\NameGeneratorInterface;
+use Ramsey\Uuid\Generator\PeclUuidNameGenerator;
+use Ramsey\Uuid\Generator\PeclUuidRandomGenerator;
+use Ramsey\Uuid\Generator\PeclUuidTimeGenerator;
+use Ramsey\Uuid\Generator\RandomGeneratorFactory;
+use Ramsey\Uuid\Generator\RandomGeneratorInterface;
+use Ramsey\Uuid\Generator\TimeGeneratorFactory;
+use Ramsey\Uuid\Generator\TimeGeneratorInterface;
+use Ramsey\Uuid\Generator\UnixTimeGenerator;
+use Ramsey\Uuid\Guid\GuidBuilder;
+use Ramsey\Uuid\Math\BrickMathCalculator;
+use Ramsey\Uuid\Math\CalculatorInterface;
+use Ramsey\Uuid\Nonstandard\UuidBuilder as NonstandardUuidBuilder;
+use Ramsey\Uuid\Provider\Dce\SystemDceSecurityProvider;
+use Ramsey\Uuid\Provider\DceSecurityProviderInterface;
+use Ramsey\Uuid\Provider\Node\FallbackNodeProvider;
+use Ramsey\Uuid\Provider\Node\RandomNodeProvider;
+use Ramsey\Uuid\Provider\Node\SystemNodeProvider;
+use Ramsey\Uuid\Provider\NodeProviderInterface;
+use Ramsey\Uuid\Provider\Time\SystemTimeProvider;
+use Ramsey\Uuid\Provider\TimeProviderInterface;
+use Ramsey\Uuid\Rfc4122\UuidBuilder as Rfc4122UuidBuilder;
+use Ramsey\Uuid\Validator\GenericValidator;
+use Ramsey\Uuid\Validator\ValidatorInterface;
+
+use const PHP_INT_SIZE;
+
+/**
+ * FeatureSet detects and exposes available features in the current environment
+ *
+ * A feature set is used by UuidFactory to determine the available features and
+ * capabilities of the environment.
+ */
+class FeatureSet
+{
+    private ?TimeProviderInterface $timeProvider = null;
+    private CalculatorInterface $calculator;
+    private CodecInterface $codec;
+    private DceSecurityGeneratorInterface $dceSecurityGenerator;
+    private NameGeneratorInterface $nameGenerator;
+    private NodeProviderInterface $nodeProvider;
+    private NumberConverterInterface $numberConverter;
+    private RandomGeneratorInterface $randomGenerator;
+    private TimeConverterInterface $timeConverter;
+    private TimeGeneratorInterface $timeGenerator;
+    private TimeGeneratorInterface $unixTimeGenerator;
+    private UuidBuilderInterface $builder;
+    private ValidatorInterface $validator;
+
+    /**
+     * @param bool $useGuids True build UUIDs using the GuidStringCodec
+     * @param bool $force32Bit True to force the use of 32-bit functionality
+     *     (primarily for testing purposes)
+     * @param bool $ignoreSystemNode True to disable attempts to check for the
+     *     system node ID (primarily for testing purposes)
+     * @param bool $enablePecl True to enable the use of the PeclUuidTimeGenerator
+     *     to generate version 1 UUIDs
+     */
+    public function __construct(
+        bool $useGuids = false,
+        private bool $force32Bit = false,
+        private bool $ignoreSystemNode = false,
+        private bool $enablePecl = false
+    ) {
+        $this->randomGenerator = $this->buildRandomGenerator();
+        $this->setCalculator(new BrickMathCalculator());
+        $this->builder = $this->buildUuidBuilder($useGuids);
+        $this->codec = $this->buildCodec($useGuids);
+        $this->nodeProvider = $this->buildNodeProvider();
+        $this->nameGenerator = $this->buildNameGenerator();
+        $this->setTimeProvider(new SystemTimeProvider());
+        $this->setDceSecurityProvider(new SystemDceSecurityProvider());
+        $this->validator = new GenericValidator();
+
+        assert($this->timeProvider !== null);
+        $this->unixTimeGenerator = $this->buildUnixTimeGenerator();
+    }
+
+    /**
+     * Returns the builder configured for this environment
+     */
+    public function getBuilder(): UuidBuilderInterface
+    {
+        return $this->builder;
+    }
+
+    /**
+     * Returns the calculator configured for this environment
+     */
+    public function getCalculator(): CalculatorInterface
+    {
+        return $this->calculator;
+    }
+
+    /**
+     * Returns the codec configured for this environment
+     */
+    public function getCodec(): CodecInterface
+    {
+        return $this->codec;
+    }
+
+    /**
+     * Returns the DCE Security generator configured for this environment
+     */
+    public function getDceSecurityGenerator(): DceSecurityGeneratorInterface
+    {
+        return $this->dceSecurityGenerator;
+    }
+
+    /**
+     * Returns the name generator configured for this environment
+     */
+    public function getNameGenerator(): NameGeneratorInterface
+    {
+        return $this->nameGenerator;
+    }
+
+    /**
+     * Returns the node provider configured for this environment
+     */
+    public function getNodeProvider(): NodeProviderInterface
+    {
+        return $this->nodeProvider;
+    }
+
+    /**
+     * Returns the number converter configured for this environment
+     */
+    public function getNumberConverter(): NumberConverterInterface
+    {
+        return $this->numberConverter;
+    }
+
+    /**
+     * Returns the random generator configured for this environment
+     */
+    public function getRandomGenerator(): RandomGeneratorInterface
+    {
+        return $this->randomGenerator;
+    }
+
+    /**
+     * Returns the time converter configured for this environment
+     */
+    public function getTimeConverter(): TimeConverterInterface
+    {
+        return $this->timeConverter;
+    }
+
+    /**
+     * Returns the time generator configured for this environment
+     */
+    public function getTimeGenerator(): TimeGeneratorInterface
+    {
+        return $this->timeGenerator;
+    }
+
+    /**
+     * Returns the Unix Epoch time generator configured for this environment
+     */
+    public function getUnixTimeGenerator(): TimeGeneratorInterface
+    {
+        return $this->unixTimeGenerator;
+    }
+
+    /**
+     * Returns the validator configured for this environment
+     */
+    public function getValidator(): ValidatorInterface
+    {
+        return $this->validator;
+    }
+
+    /**
+     * Sets the calculator to use in this environment
+     */
+    public function setCalculator(CalculatorInterface $calculator): void
+    {
+        $this->calculator = $calculator;
+        $this->numberConverter = $this->buildNumberConverter($calculator);
+        $this->timeConverter = $this->buildTimeConverter($calculator);
+
+        /** @psalm-suppress RedundantPropertyInitializationCheck */
+        if (isset($this->timeProvider)) {
+            $this->timeGenerator = $this->buildTimeGenerator($this->timeProvider);
+        }
+    }
+
+    /**
+     * Sets the DCE Security provider to use in this environment
+     */
+    public function setDceSecurityProvider(DceSecurityProviderInterface $dceSecurityProvider): void
+    {
+        $this->dceSecurityGenerator = $this->buildDceSecurityGenerator($dceSecurityProvider);
+    }
+
+    /**
+     * Sets the node provider to use in this environment
+     */
+    public function setNodeProvider(NodeProviderInterface $nodeProvider): void
+    {
+        $this->nodeProvider = $nodeProvider;
+
+        if (isset($this->timeProvider)) {
+            $this->timeGenerator = $this->buildTimeGenerator($this->timeProvider);
+        }
+    }
+
+    /**
+     * Sets the time provider to use in this environment
+     */
+    public function setTimeProvider(TimeProviderInterface $timeProvider): void
+    {
+        $this->timeProvider = $timeProvider;
+        $this->timeGenerator = $this->buildTimeGenerator($timeProvider);
+    }
+
+    /**
+     * Set the validator to use in this environment
+     */
+    public function setValidator(ValidatorInterface $validator): void
+    {
+        $this->validator = $validator;
+    }
+
+    /**
+     * Returns a codec configured for this environment
+     *
+     * @param bool $useGuids Whether to build UUIDs using the GuidStringCodec
+     */
+    private function buildCodec(bool $useGuids = false): CodecInterface
+    {
+        if ($useGuids) {
+            return new GuidStringCodec($this->builder);
+        }
+
+        return new StringCodec($this->builder);
+    }
+
+    /**
+     * Returns a DCE Security generator configured for this environment
+     */
+    private function buildDceSecurityGenerator(
+        DceSecurityProviderInterface $dceSecurityProvider
+    ): DceSecurityGeneratorInterface {
+        return new DceSecurityGenerator(
+            $this->numberConverter,
+            $this->timeGenerator,
+            $dceSecurityProvider
+        );
+    }
+
+    /**
+     * Returns a node provider configured for this environment
+     */
+    private function buildNodeProvider(): NodeProviderInterface
+    {
+        if ($this->ignoreSystemNode) {
+            return new RandomNodeProvider();
+        }
+
+        return new FallbackNodeProvider([
+            new SystemNodeProvider(),
+            new RandomNodeProvider(),
+        ]);
+    }
+
+    /**
+     * Returns a number converter configured for this environment
+     */
+    private function buildNumberConverter(CalculatorInterface $calculator): NumberConverterInterface
+    {
+        return new GenericNumberConverter($calculator);
+    }
+
+    /**
+     * Returns a random generator configured for this environment
+     */
+    private function buildRandomGenerator(): RandomGeneratorInterface
+    {
+        if ($this->enablePecl) {
+            return new PeclUuidRandomGenerator();
+        }
+
+        return (new RandomGeneratorFactory())->getGenerator();
+    }
+
+    /**
+     * Returns a time generator configured for this environment
+     *
+     * @param TimeProviderInterface $timeProvider The time provider to use with
+     *     the time generator
+     */
+    private function buildTimeGenerator(TimeProviderInterface $timeProvider): TimeGeneratorInterface
+    {
+        if ($this->enablePecl) {
+            return new PeclUuidTimeGenerator();
+        }
+
+        return (new TimeGeneratorFactory(
+            $this->nodeProvider,
+            $this->timeConverter,
+            $timeProvider
+        ))->getGenerator();
+    }
+
+    /**
+     * Returns a Unix Epoch time generator configured for this environment
+     */
+    private function buildUnixTimeGenerator(): TimeGeneratorInterface
+    {
+        return new UnixTimeGenerator($this->randomGenerator);
+    }
+
+    /**
+     * Returns a name generator configured for this environment
+     */
+    private function buildNameGenerator(): NameGeneratorInterface
+    {
+        if ($this->enablePecl) {
+            return new PeclUuidNameGenerator();
+        }
+
+        return (new NameGeneratorFactory())->getGenerator();
+    }
+
+    /**
+     * Returns a time converter configured for this environment
+     */
+    private function buildTimeConverter(CalculatorInterface $calculator): TimeConverterInterface
+    {
+        $genericConverter = new GenericTimeConverter($calculator);
+
+        if ($this->is64BitSystem()) {
+            return new PhpTimeConverter($calculator, $genericConverter);
+        }
+
+        return $genericConverter;
+    }
+
+    /**
+     * Returns a UUID builder configured for this environment
+     *
+     * @param bool $useGuids Whether to build UUIDs using the GuidStringCodec
+     */
+    private function buildUuidBuilder(bool $useGuids = false): UuidBuilderInterface
+    {
+        if ($useGuids) {
+            return new GuidBuilder($this->numberConverter, $this->timeConverter);
+        }
+
+        return new FallbackBuilder([
+            new Rfc4122UuidBuilder($this->numberConverter, $this->timeConverter),
+            new NonstandardUuidBuilder($this->numberConverter, $this->timeConverter),
+        ]);
+    }
+
+    /**
+     * Returns true if the PHP build is 64-bit
+     */
+    private function is64BitSystem(): bool
+    {
+        return PHP_INT_SIZE === 8 && !$this->force32Bit;
+    }
+}

package/vendor/ramsey/uuid/src/Fields/FieldsInterface.php

@@ -0,0 +1,42 @@
+<?php
+
+/**
+ * This file is part of the ramsey/uuid library
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+declare(strict_types=1);
+
+namespace Ramsey\Uuid\Fields;
+
+/**
+ * UUIDs are comprised of unsigned integers, the bytes of which are separated
+ * into fields and arranged in a particular layout defined by the specification
+ * for the variant
+ *
+ * @psalm-immutable
+ */
+interface FieldsInterface
+{
+    /**
+     * @return mixed[]
+     */
+    public function __serialize(): array;
+
+    /**
+     * @param mixed[] $data
+     */
+    public function __unserialize(array $data): void;
+
+    /**
+     * Returns the bytes that comprise the fields
+     *
+     * @return non-empty-string
+     */
+    public function getBytes(): string;
+}

package/vendor/ramsey/uuid/src/Fields/SerializableFieldsTrait.php

@@ -0,0 +1,70 @@
+<?php
+
+/**
+ * This file is part of the ramsey/uuid library
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+declare(strict_types=1);
+
+namespace Ramsey\Uuid\Fields;
+
+use ValueError;
+
+use function base64_decode;
+use function sprintf;
+use function strlen;
+
+/**
+ * Provides common serialization functionality to fields
+ *
+ * @psalm-immutable
+ */
+trait SerializableFieldsTrait
+{
+    /**
+     * @param non-empty-string $bytes The bytes that comprise the fields
+     */
+    abstract public function __construct(string $bytes);
+
+    /**
+     * Returns the bytes that comprise the fields
+     *
+     * @return non-empty-string
+     */
+    abstract public function getBytes(): string;
+
+    /**
+     * @return array{bytes: non-empty-string}
+     */
+    public function __serialize(): array
+    {
+        return ['bytes' => $this->getBytes()];
+    }
+
+    /**
+     * @inheritDoc
+     * @psalm-suppress UnusedMethodCall
+     */
+    public function __unserialize(array $data): void
+    {
+        if (!isset($data['bytes'])) {
+            throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__));
+        }
+
+        assert(is_string($data['bytes']) && $data['bytes'] !== '');
+
+        if (strlen($data['bytes']) === 16) {
+            $this->__construct($data['bytes']);
+        } else {
+            /** @var non-empty-string $bytes */
+            $bytes = base64_decode($data['bytes']);
+            $this->__construct($bytes);
+        }
+    }
+}

package/vendor/ramsey/uuid/src/Generator/CombGenerator.php

@@ -0,0 +1,124 @@
+<?php
+
+/**
+ * This file is part of the ramsey/uuid library
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+declare(strict_types=1);
+
+namespace Ramsey\Uuid\Generator;
+
+use Ramsey\Uuid\Converter\NumberConverterInterface;
+use Ramsey\Uuid\Exception\InvalidArgumentException;
+
+use function bin2hex;
+use function explode;
+use function hex2bin;
+use function microtime;
+use function str_pad;
+use function substr;
+
+use const STR_PAD_LEFT;
+
+/**
+ * CombGenerator generates COMBs (combined UUID/timestamp)
+ *
+ * The CombGenerator, when used with the StringCodec (and, by proxy, the
+ * TimestampLastCombCodec) or the TimestampFirstCombCodec, combines the current
+ * timestamp with a UUID (hence the name "COMB"). The timestamp either appears
+ * as the first or last 48 bits of the COMB, depending on the codec used.
+ *
+ * By default, COMBs will have the timestamp set as the last 48 bits of the
+ * identifier.
+ *
+ * ``` php
+ * $factory = new UuidFactory();
+ *
+ * $factory->setRandomGenerator(new CombGenerator(
+ *     $factory->getRandomGenerator(),
+ *     $factory->getNumberConverter()
+ * ));
+ *
+ * $comb = $factory->uuid4();
+ * ```
+ *
+ * To generate a COMB with the timestamp as the first 48 bits, set the
+ * TimestampFirstCombCodec as the codec.
+ *
+ * ``` php
+ * $factory->setCodec(new TimestampFirstCombCodec($factory->getUuidBuilder()));
+ * ```
+ *
+ * @link https://www.informit.com/articles/printerfriendly/25862 The Cost of GUIDs as Primary Keys
+ */
+class CombGenerator implements RandomGeneratorInterface
+{
+    public const TIMESTAMP_BYTES = 6;
+
+    public function __construct(
+        private readonly RandomGeneratorInterface $generator,
+        private readonly NumberConverterInterface $numberConverter
+    ) {
+    }
+
+    /**
+     * @param positive-int $length The number of bytes of random binary data to
+     *     generate
+     *
+     * @return non-empty-string
+     *
+     * @throws InvalidArgumentException if $length is not a positive integer
+     *     greater than or equal to CombGenerator::TIMESTAMP_BYTES
+     *
+     * @inheritDoc
+     */
+    public function generate(int $length): string
+    {
+        if ($length < self::TIMESTAMP_BYTES) {
+            throw new InvalidArgumentException(
+                'Length must be a positive integer greater than or equal to ' . self::TIMESTAMP_BYTES
+            );
+        }
+
+        $hash = '';
+        if (self::TIMESTAMP_BYTES > 0 && $length > self::TIMESTAMP_BYTES) {
+            $hash = $this->generator->generate($length - self::TIMESTAMP_BYTES);
+        }
+
+        $lsbTime = str_pad(
+            $this->numberConverter->toHex($this->timestamp()),
+            self::TIMESTAMP_BYTES * 2,
+            '0',
+            STR_PAD_LEFT
+        );
+
+        /** @var non-empty-string */
+        return (string) hex2bin(
+            str_pad(
+                bin2hex($hash),
+                $length - self::TIMESTAMP_BYTES,
+                '0'
+            )
+            . $lsbTime
+        );
+    }
+
+    /**
+     * Returns current timestamp as string integer, precise to 0.00001 seconds
+     *
+     * @return numeric-string
+     */
+    private function timestamp(): string
+    {
+        $time = explode(' ', microtime());
+
+        /** @var numeric-string */
+        return $time[1] . substr($time[0], 2, 5);
+    }
+}