create-prisma-php-app 1.0.0 → 1.0.2

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

@@ -1,503 +0,0 @@
-<?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 DateTimeInterface;
-use Ramsey\Uuid\Builder\UuidBuilderInterface;
-use Ramsey\Uuid\Codec\CodecInterface;
-use Ramsey\Uuid\Converter\NumberConverterInterface;
-use Ramsey\Uuid\Converter\TimeConverterInterface;
-use Ramsey\Uuid\Generator\DceSecurityGeneratorInterface;
-use Ramsey\Uuid\Generator\DefaultTimeGenerator;
-use Ramsey\Uuid\Generator\NameGeneratorInterface;
-use Ramsey\Uuid\Generator\RandomGeneratorInterface;
-use Ramsey\Uuid\Generator\TimeGeneratorInterface;
-use Ramsey\Uuid\Generator\UnixTimeGenerator;
-use Ramsey\Uuid\Lazy\LazyUuidFromString;
-use Ramsey\Uuid\Provider\NodeProviderInterface;
-use Ramsey\Uuid\Provider\Time\FixedTimeProvider;
-use Ramsey\Uuid\Rfc4122\Version;
-use Ramsey\Uuid\Type\Hexadecimal;
-use Ramsey\Uuid\Type\Integer as IntegerObject;
-use Ramsey\Uuid\Type\Time;
-use Ramsey\Uuid\Validator\ValidatorInterface;
-
-use function bin2hex;
-use function hex2bin;
-use function str_pad;
-use function strtolower;
-use function substr;
-
-use const STR_PAD_LEFT;
-
-/**
- * @psalm-suppress MissingImmutableAnnotation
- */
-class UuidFactory implements UuidFactoryInterface
-{
-    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 $uuidBuilder;
-    private ValidatorInterface $validator;
-
-    /**
-     * @var bool whether the feature set was provided from outside, or we can
-     *     operate under "default" assumptions
-     */
-    private bool $isDefaultFeatureSet;
-
-    /**
-     * @param FeatureSet|null $features A set of available features in the current environment
-     */
-    public function __construct(?FeatureSet $features = null)
-    {
-        $this->isDefaultFeatureSet = $features === null;
-
-        $features = $features ?: new FeatureSet();
-
-        $this->codec = $features->getCodec();
-        $this->dceSecurityGenerator = $features->getDceSecurityGenerator();
-        $this->nameGenerator = $features->getNameGenerator();
-        $this->nodeProvider = $features->getNodeProvider();
-        $this->numberConverter = $features->getNumberConverter();
-        $this->randomGenerator = $features->getRandomGenerator();
-        $this->timeConverter = $features->getTimeConverter();
-        $this->timeGenerator = $features->getTimeGenerator();
-        $this->uuidBuilder = $features->getBuilder();
-        $this->validator = $features->getValidator();
-        $this->unixTimeGenerator = $features->getUnixTimeGenerator();
-    }
-
-    /**
-     * Returns the codec used by this factory
-     */
-    public function getCodec(): CodecInterface
-    {
-        return $this->codec;
-    }
-
-    /**
-     * Sets the codec to use for this factory
-     *
-     * @param CodecInterface $codec A UUID encoder-decoder
-     */
-    public function setCodec(CodecInterface $codec): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->codec = $codec;
-    }
-
-    /**
-     * Returns the name generator used by this factory
-     */
-    public function getNameGenerator(): NameGeneratorInterface
-    {
-        return $this->nameGenerator;
-    }
-
-    /**
-     * Sets the name generator to use for this factory
-     *
-     * @param NameGeneratorInterface $nameGenerator A generator to generate
-     *     binary data, based on a namespace and name
-     */
-    public function setNameGenerator(NameGeneratorInterface $nameGenerator): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->nameGenerator = $nameGenerator;
-    }
-
-    /**
-     * Returns the node provider used by this factory
-     */
-    public function getNodeProvider(): NodeProviderInterface
-    {
-        return $this->nodeProvider;
-    }
-
-    /**
-     * Returns the random generator used by this factory
-     */
-    public function getRandomGenerator(): RandomGeneratorInterface
-    {
-        return $this->randomGenerator;
-    }
-
-    /**
-     * Returns the time generator used by this factory
-     */
-    public function getTimeGenerator(): TimeGeneratorInterface
-    {
-        return $this->timeGenerator;
-    }
-
-    /**
-     * Sets the time generator to use for this factory
-     *
-     * @param TimeGeneratorInterface $generator A generator to generate binary
-     *     data, based on the time
-     */
-    public function setTimeGenerator(TimeGeneratorInterface $generator): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->timeGenerator = $generator;
-    }
-
-    /**
-     * Returns the DCE Security generator used by this factory
-     */
-    public function getDceSecurityGenerator(): DceSecurityGeneratorInterface
-    {
-        return $this->dceSecurityGenerator;
-    }
-
-    /**
-     * Sets the DCE Security generator to use for this factory
-     *
-     * @param DceSecurityGeneratorInterface $generator A generator to generate
-     *     binary data, based on a local domain and local identifier
-     */
-    public function setDceSecurityGenerator(DceSecurityGeneratorInterface $generator): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->dceSecurityGenerator = $generator;
-    }
-
-    /**
-     * Returns the number converter used by this factory
-     */
-    public function getNumberConverter(): NumberConverterInterface
-    {
-        return $this->numberConverter;
-    }
-
-    /**
-     * Sets the random generator to use for this factory
-     *
-     * @param RandomGeneratorInterface $generator A generator to generate binary
-     *     data, based on some random input
-     */
-    public function setRandomGenerator(RandomGeneratorInterface $generator): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->randomGenerator = $generator;
-    }
-
-    /**
-     * Sets the number converter to use for this factory
-     *
-     * @param NumberConverterInterface $converter A converter to use for working
-     *     with large integers (i.e. integers greater than PHP_INT_MAX)
-     */
-    public function setNumberConverter(NumberConverterInterface $converter): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->numberConverter = $converter;
-    }
-
-    /**
-     * Returns the UUID builder used by this factory
-     */
-    public function getUuidBuilder(): UuidBuilderInterface
-    {
-        return $this->uuidBuilder;
-    }
-
-    /**
-     * Sets the UUID builder to use for this factory
-     *
-     * @param UuidBuilderInterface $builder A builder for constructing instances
-     *     of UuidInterface
-     */
-    public function setUuidBuilder(UuidBuilderInterface $builder): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->uuidBuilder = $builder;
-    }
-
-    /**
-     * @psalm-mutation-free
-     */
-    public function getValidator(): ValidatorInterface
-    {
-        return $this->validator;
-    }
-
-    /**
-     * Sets the validator to use for this factory
-     *
-     * @param ValidatorInterface $validator A validator to use for validating
-     *     whether a string is a valid UUID
-     */
-    public function setValidator(ValidatorInterface $validator): void
-    {
-        $this->isDefaultFeatureSet = false;
-
-        $this->validator = $validator;
-    }
-
-    /**
-     * @psalm-pure
-     */
-    public function fromBytes(string $bytes): UuidInterface
-    {
-        return $this->codec->decodeBytes($bytes);
-    }
-
-    /**
-     * @psalm-pure
-     */
-    public function fromString(string $uuid): UuidInterface
-    {
-        $uuid = strtolower($uuid);
-
-        return $this->codec->decode($uuid);
-    }
-
-    /**
-     * @psalm-pure
-     */
-    public function fromInteger(string $integer): UuidInterface
-    {
-        $hex = $this->numberConverter->toHex($integer);
-        $hex = str_pad($hex, 32, '0', STR_PAD_LEFT);
-
-        return $this->fromString($hex);
-    }
-
-    public function fromDateTime(
-        DateTimeInterface $dateTime,
-        ?Hexadecimal $node = null,
-        ?int $clockSeq = null
-    ): UuidInterface {
-        $timeProvider = new FixedTimeProvider(
-            new Time($dateTime->format('U'), $dateTime->format('u'))
-        );
-
-        $timeGenerator = new DefaultTimeGenerator(
-            $this->nodeProvider,
-            $this->timeConverter,
-            $timeProvider
-        );
-
-        $nodeHex = $node ? $node->toString() : null;
-
-        $bytes = $timeGenerator->generate($nodeHex, $clockSeq);
-
-        return $this->uuidFromBytesAndVersion($bytes, Version::Time);
-    }
-
-    /**
-     * @psalm-pure
-     */
-    public function fromHexadecimal(Hexadecimal $hex): UuidInterface
-    {
-        return $this->codec->decode($hex->__toString());
-    }
-
-    public function uuid1(Hexadecimal | int | string | null $node = null, ?int $clockSeq = null): UuidInterface
-    {
-        $bytes = $this->timeGenerator->generate($node, $clockSeq);
-
-        return $this->uuidFromBytesAndVersion($bytes, Version::Time);
-    }
-
-    public function uuid2(
-        int $localDomain,
-        ?IntegerObject $localIdentifier = null,
-        ?Hexadecimal $node = null,
-        ?int $clockSeq = null
-    ): UuidInterface {
-        $bytes = $this->dceSecurityGenerator->generate(
-            $localDomain,
-            $localIdentifier,
-            $node,
-            $clockSeq
-        );
-
-        return $this->uuidFromBytesAndVersion($bytes, Version::DceSecurity);
-    }
-
-    /**
-     * @inheritDoc
-     * @psalm-pure
-     */
-    public function uuid3(UuidInterface | string $ns, string $name): UuidInterface
-    {
-        return $this->uuidFromNsAndName($ns, $name, Version::HashMd5, 'md5');
-    }
-
-    public function uuid4(): UuidInterface
-    {
-        $bytes = $this->randomGenerator->generate(16);
-
-        return $this->uuidFromBytesAndVersion($bytes, Version::Random);
-    }
-
-    /**
-     * @inheritDoc
-     * @psalm-pure
-     */
-    public function uuid5(UuidInterface | string $ns, string $name): UuidInterface
-    {
-        return $this->uuidFromNsAndName($ns, $name, Version::HashSha1, 'sha1');
-    }
-
-    public function uuid6(?Hexadecimal $node = null, ?int $clockSeq = null): UuidInterface
-    {
-        $nodeHex = $node?->toString();
-        $bytes = $this->timeGenerator->generate($nodeHex, $clockSeq);
-
-        // Rearrange the bytes, according to the UUID version 6 specification.
-        $v6 = $bytes[6] . $bytes[7] . $bytes[4] . $bytes[5]
-            . $bytes[0] . $bytes[1] . $bytes[2] . $bytes[3];
-        $v6 = bin2hex($v6);
-
-        // Drop the first four bits, while adding an empty four bits for the
-        // version field. This allows us to reconstruct the correct time from
-        // the bytes of this UUID.
-        /** @var non-empty-string $v6Bytes */
-        $v6Bytes = hex2bin(substr($v6, 1, 12) . '0' . substr($v6, -3));
-        $v6Bytes .= substr($bytes, 8);
-
-        return $this->uuidFromBytesAndVersion($v6Bytes, Version::ReorderedTime);
-    }
-
-    /**
-     * Returns a version 7 (Unix Epoch time) UUID
-     *
-     * @param DateTimeInterface|null $dateTime An optional date/time from which
-     *     to create the version 7 UUID. If not provided, the UUID is generated
-     *     using the current date/time.
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 7 UUID
-     */
-    public function uuid7(?DateTimeInterface $dateTime = null): UuidInterface
-    {
-        assert($this->unixTimeGenerator instanceof UnixTimeGenerator);
-        $bytes = $this->unixTimeGenerator->generate(null, null, $dateTime);
-
-        return $this->uuidFromBytesAndVersion($bytes, Version::UnixTime);
-    }
-
-    /**
-     * Returns a version 8 (Custom) UUID
-     *
-     * The bytes provided may contain any value according to your application's
-     * needs. Be aware, however, that other applications may not understand the
-     * semantics of the value.
-     *
-     * @param non-empty-string $bytes A 16-byte octet string. This is an open blob
-     *     of data that you may fill with 128 bits of information. Be aware,
-     *     however, bits 48 through 51 will be replaced with the UUID version
-     *     field, and bits 64 and 65 will be replaced with the UUID variant. You
-     *     MUST NOT rely on these bits for your application needs.
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 8 UUID
-     */
-    public function uuid8(string $bytes): UuidInterface
-    {
-        return $this->uuidFromBytesAndVersion($bytes, Version::Custom);
-    }
-
-    /**
-     * Returns a Uuid created from the provided byte string
-     *
-     * Uses the configured builder and codec and the provided byte string to
-     * construct a Uuid object.
-     *
-     * @param non-empty-string $bytes The byte string from which to construct a UUID
-     *
-     * @return UuidInterface An instance of UuidInterface, created from the
-     *     provided bytes
-     *
-     * @psalm-pure
-     */
-    public function uuid(string $bytes): UuidInterface
-    {
-        /** @psalm-suppress ImpurePropertyFetch */
-        return $this->uuidBuilder->build($this->codec, $bytes);
-    }
-
-    /**
-     * Returns a version 3 or 5 namespaced Uuid
-     *
-     * @param non-empty-string|UuidInterface $ns The namespace (must be a valid UUID)
-     * @param string $name The name to hash together with the namespace
-     * @param Version $version The version of UUID to create (3 or 5)
-     * @param non-empty-string $hashAlgorithm The hashing algorithm to use when
-     *     hashing together the namespace and name
-     *
-     * @return UuidInterface An instance of UuidInterface, created by hashing
-     *     together the provided namespace and name
-     *
-     * @psalm-pure
-     */
-    private function uuidFromNsAndName(
-        UuidInterface | string $ns,
-        string $name,
-        Version $version,
-        string $hashAlgorithm,
-    ): UuidInterface {
-        if (!($ns instanceof UuidInterface)) {
-            $ns = $this->fromString($ns);
-        }
-
-        $bytes = $this->nameGenerator->generate($ns, $name, $hashAlgorithm);
-
-        /** @var non-empty-string $bytes */
-        $bytes = substr($bytes, 0, 16);
-
-        return $this->uuidFromBytesAndVersion($bytes, $version);
-    }
-
-    /**
-     * Returns an RFC 4122 variant Uuid, created from the provided bytes and version
-     *
-     * @param non-empty-string $bytes The byte string to convert to a UUID
-     * @param Version $version The RFC 4122 version to apply to the UUID
-     *
-     * @return UuidInterface An instance of UuidInterface, created from the
-     *     byte string and version
-     *
-     * @psalm-pure
-     */
-    private function uuidFromBytesAndVersion(string $bytes, Version $version): UuidInterface
-    {
-        $bytesWithVariantAndVersion = BinaryUtils::applyVersionAndVariant($bytes, $version);
-
-        if ($this->isDefaultFeatureSet) {
-            return LazyUuidFromString::fromBytes($bytesWithVariantAndVersion);
-        }
-
-        return $this->uuid($bytesWithVariantAndVersion);
-    }
-}

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

@@ -1,184 +0,0 @@
-<?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 DateTimeInterface;
-use Ramsey\Uuid\Type\Hexadecimal;
-use Ramsey\Uuid\Type\Integer as IntegerObject;
-use Ramsey\Uuid\Validator\ValidatorInterface;
-
-/**
- * UuidFactoryInterface defines common functionality all `UuidFactory` instances
- * must implement
- *
- * @psalm-immutable
- */
-interface UuidFactoryInterface
-{
-    /**
-     * Creates a UUID from a byte string
-     *
-     * @param non-empty-string $bytes A binary string
-     *
-     * @return UuidInterface A UuidInterface instance created from a binary
-     *     string representation
-     *
-     * @psalm-pure
-     */
-    public function fromBytes(string $bytes): UuidInterface;
-
-    /**
-     * Creates a UUID from a DateTimeInterface instance
-     *
-     * @param DateTimeInterface $dateTime The date and time
-     * @param Hexadecimal|null $node A 48-bit number representing the hardware
-     *     address
-     * @param int<0, 16383>|null $clockSeq A 14-bit number used to help avoid
-     *     duplicates that could arise when the clock is set backwards in time
-     *     or if the node ID changes
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 1 UUID created from a DateTimeInterface instance
-     */
-    public function fromDateTime(
-        DateTimeInterface $dateTime,
-        ?Hexadecimal $node = null,
-        ?int $clockSeq = null
-    ): UuidInterface;
-
-    /**
-     * Creates a UUID from a 128-bit integer string
-     *
-     * @param numeric-string $integer String representation of 128-bit integer
-     *
-     * @return UuidInterface A UuidInterface instance created from the string
-     *     representation of a 128-bit integer
-     *
-     * @psalm-pure
-     */
-    public function fromInteger(string $integer): UuidInterface;
-
-    /**
-     * Creates a UUID from the string standard representation
-     *
-     * @param non-empty-string $uuid A hexadecimal string
-     *
-     * @return UuidInterface A UuidInterface instance created from a hexadecimal
-     *     string representation
-     *
-     * @psalm-pure
-     */
-    public function fromString(string $uuid): UuidInterface;
-
-    /**
-     * Returns the validator to use for the factory
-     *
-     * @psalm-mutation-free
-     */
-    public function getValidator(): ValidatorInterface;
-
-    /**
-     * Returns a version 1 (Gregorian time) UUID from a host ID, sequence number,
-     * and the current time
-     *
-     * @param Hexadecimal|int<1, max>|non-empty-string|null $node A 48-bit number
-     *     representing the hardware address; this number may be represented as
-     *     an integer or a hexadecimal string
-     * @param int<0, 16383>|null $clockSeq A 14-bit number used to help avoid
-     *     duplicates that could arise when the clock is set backwards in time
-     *     or if the node ID changes
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 1 UUID
-     */
-    public function uuid1(Hexadecimal | int | string | null $node = null, ?int $clockSeq = null): UuidInterface;
-
-    /**
-     * Returns a version 2 (DCE Security) UUID from a local domain, local
-     * identifier, host ID, clock sequence, and the current time
-     *
-     * @param int $localDomain The local domain to use when generating bytes,
-     *     according to DCE Security
-     * @param IntegerObject|null $localIdentifier The local identifier for the
-     *     given domain; this may be a UID or GID on POSIX systems, if the local
-     *     domain is person or group, or it may be a site-defined identifier
-     *     if the local domain is org
-     * @param Hexadecimal|null $node A 48-bit number representing the hardware
-     *     address
-     * @param int<0, 63>|null $clockSeq A 6-bit number used to help avoid
-     *     duplicates that could arise when the clock is set backwards in time
-     *     or if the node ID changes
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 2 UUID
-     */
-    public function uuid2(
-        int $localDomain,
-        ?IntegerObject $localIdentifier = null,
-        ?Hexadecimal $node = null,
-        ?int $clockSeq = null
-    ): UuidInterface;
-
-    /**
-     * Returns a version 3 (name-based) UUID based on the MD5 hash of a
-     * namespace ID and a name
-     *
-     * @param non-empty-string|UuidInterface $ns The namespace (must be a valid UUID)
-     * @param string $name The name to use for creating a UUID
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 3 UUID
-     *
-     * @psalm-pure
-     */
-    public function uuid3(UuidInterface | string $ns, string $name): UuidInterface;
-
-    /**
-     * Returns a version 4 (random) UUID
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 4 UUID
-     */
-    public function uuid4(): UuidInterface;
-
-    /**
-     * Returns a version 5 (name-based) UUID based on the SHA-1 hash of a
-     * namespace ID and a name
-     *
-     * @param non-empty-string|UuidInterface $ns The namespace (must be a valid UUID)
-     * @param string $name The name to use for creating a UUID
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 5 UUID
-     *
-     * @psalm-pure
-     */
-    public function uuid5(UuidInterface | string $ns, string $name): UuidInterface;
-
-    /**
-     * Returns a version 6 (reordered time) UUID from a host ID, sequence number,
-     * and the current time
-     *
-     * @param Hexadecimal|null $node A 48-bit number representing the hardware
-     *     address
-     * @param int<0, 16383>|null $clockSeq A 14-bit number used to help avoid
-     *     duplicates that could arise when the clock is set backwards in time
-     *     or if the node ID changes
-     *
-     * @return UuidInterface A UuidInterface instance that represents a
-     *     version 6 UUID
-     */
-    public function uuid6(?Hexadecimal $node = null, ?int $clockSeq = null): UuidInterface;
-}