create-prisma-php-app 1.0.0 → 1.0.2

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

@@ -1,214 +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\Rfc4122;
-
-use Ramsey\Uuid\Exception\InvalidArgumentException;
-use Ramsey\Uuid\Fields\SerializableFieldsTrait;
-use Ramsey\Uuid\Type\Hexadecimal;
-use Ramsey\Uuid\Variant;
-
-use function bin2hex;
-use function dechex;
-use function hexdec;
-use function sprintf;
-use function str_pad;
-use function strlen;
-use function substr;
-use function unpack;
-
-use const STR_PAD_LEFT;
-
-/**
- * RFC 4122 variant UUIDs are comprised of a set of named fields
- *
- * Internally, this class represents the fields together as a 16-byte binary
- * string.
- *
- * @psalm-immutable
- */
-final class Fields implements FieldsInterface
-{
-    use MaxTrait;
-    use NilTrait;
-    use SerializableFieldsTrait;
-    use VariantTrait;
-    use VersionTrait;
-
-    /**
-     * @param non-empty-string $bytes A 16-byte binary string representation of a UUID
-     *
-     * @throws InvalidArgumentException if the byte string is not exactly 16 bytes
-     * @throws InvalidArgumentException if the byte string does not represent an RFC 4122 UUID
-     * @throws InvalidArgumentException if the byte string does not contain a valid version
-     */
-    public function __construct(private readonly string $bytes)
-    {
-        if (strlen($this->bytes) !== 16) {
-            throw new InvalidArgumentException(
-                'The byte string must be 16 bytes long; '
-                . 'received ' . strlen($this->bytes) . ' bytes'
-            );
-        }
-
-        if (!$this->isCorrectVariant()) {
-            throw new InvalidArgumentException(
-                'The byte string received does not conform to the RFC 4122 variant'
-            );
-        }
-
-        if (!$this->isCorrectVersion()) {
-            throw new InvalidArgumentException(
-                'The byte string received does not contain a valid RFC 4122 version'
-            );
-        }
-    }
-
-    public function getBytes(): string
-    {
-        return $this->bytes;
-    }
-
-    public function getClockSeq(): Hexadecimal
-    {
-        if ($this->isMax()) {
-            $clockSeq = 0xffff;
-        } elseif ($this->isNil()) {
-            $clockSeq = 0x0000;
-        } else {
-            $clockSeq = hexdec(bin2hex(substr($this->bytes, 8, 2))) & 0x3fff;
-        }
-
-        return new Hexadecimal(str_pad(dechex($clockSeq), 4, '0', STR_PAD_LEFT));
-    }
-
-    public function getClockSeqHiAndReserved(): Hexadecimal
-    {
-        /** @var non-empty-string $clockSeqHiAndReserved */
-        $clockSeqHiAndReserved = bin2hex(substr($this->bytes, 8, 1));
-
-        return new Hexadecimal($clockSeqHiAndReserved);
-    }
-
-    public function getClockSeqLow(): Hexadecimal
-    {
-        /** @var non-empty-string $clockSeqLow */
-        $clockSeqLow = bin2hex(substr($this->bytes, 9, 1));
-
-        return new Hexadecimal($clockSeqLow);
-    }
-
-    public function getNode(): Hexadecimal
-    {
-        /** @var non-empty-string $node */
-        $node = bin2hex(substr($this->bytes, 10));
-
-        return new Hexadecimal($node);
-    }
-
-    public function getTimeHiAndVersion(): Hexadecimal
-    {
-        /** @var non-empty-string $timeHiAndVersion */
-        $timeHiAndVersion = bin2hex(substr($this->bytes, 6, 2));
-
-        return new Hexadecimal($timeHiAndVersion);
-    }
-
-    public function getTimeLow(): Hexadecimal
-    {
-        /** @var non-empty-string $timeLow */
-        $timeLow = bin2hex(substr($this->bytes, 0, 4));
-
-        return new Hexadecimal($timeLow);
-    }
-
-    public function getTimeMid(): Hexadecimal
-    {
-        /** @var non-empty-string $timeMid */
-        $timeMid = bin2hex(substr($this->bytes, 4, 2));
-
-        return new Hexadecimal($timeMid);
-    }
-
-    /**
-     * Returns the full 60-bit timestamp, without the version
-     *
-     * For version 2 UUIDs, the time_low field is the local identifier and
-     * should not be returned as part of the time. For this reason, we set the
-     * bottom 32 bits of the timestamp to 0's. As a result, there is some loss
-     * of fidelity of the timestamp, for version 2 UUIDs. The timestamp can be
-     * off by a range of 0 to 429.4967295 seconds (or 7 minutes, 9 seconds, and
-     * 496730 microseconds).
-     *
-     * For version 6 UUIDs, the timestamp order is reversed from the typical RFC
-     * 4122 order (the time bits are in the correct bit order, so that it is
-     * monotonically increasing). In returning the timestamp value, we put the
-     * bits in the order: time_low + time_mid + time_hi.
-     */
-    public function getTimestamp(): Hexadecimal
-    {
-        /** @var non-empty-string $timestamp */
-        $timestamp = match ($this->getVersion()) {
-            Version::DceSecurity => sprintf(
-                '%03x%04s%08s',
-                hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff,
-                $this->getTimeMid()->toString(),
-                ''
-            ),
-            Version::ReorderedTime => sprintf(
-                '%08s%04s%03x',
-                $this->getTimeLow()->toString(),
-                $this->getTimeMid()->toString(),
-                hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff
-            ),
-            // The Unix timestamp in version 7 UUIDs is a 48-bit number,
-            // but for consistency, we will return a 60-bit number, padded
-            // to the left with zeros.
-            Version::UnixTime => sprintf(
-                '%011s%04s',
-                $this->getTimeLow()->toString(),
-                $this->getTimeMid()->toString(),
-            ),
-            default => sprintf(
-                '%03x%04s%08s',
-                hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff,
-                $this->getTimeMid()->toString(),
-                $this->getTimeLow()->toString()
-            ),
-        };
-
-        return new Hexadecimal($timestamp);
-    }
-
-    public function getVersion(): ?Version
-    {
-        if ($this->isNil() || $this->isMax()) {
-            return null;
-        }
-
-        /** @var int[] $parts */
-        $parts = unpack('n*', $this->bytes);
-
-        return Version::tryFrom($parts[4] >> 12);
-    }
-
-    private function isCorrectVariant(): bool
-    {
-        if ($this->isNil() || $this->isMax()) {
-            return true;
-        }
-
-        return $this->getVariant() === Variant::Rfc4122;
-    }
-}

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

@@ -1,129 +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\Rfc4122;
-
-use Ramsey\Uuid\Fields\FieldsInterface as BaseFieldsInterface;
-use Ramsey\Uuid\Type\Hexadecimal;
-use Ramsey\Uuid\Variant;
-
-/**
- * RFC 4122 defines fields for a specific variant of UUID
- *
- * The fields of an RFC 4122 variant UUID are:
- *
- * * **time_low**: The low field of the timestamp, an unsigned 32-bit integer
- * * **time_mid**: The middle field of the timestamp, an unsigned 16-bit integer
- * * **time_hi_and_version**: The high field of the timestamp multiplexed with
- *   the version number, an unsigned 16-bit integer
- * * **clock_seq_hi_and_reserved**: The high field of the clock sequence
- *   multiplexed with the variant, an unsigned 8-bit integer
- * * **clock_seq_low**: The low field of the clock sequence, an unsigned
- *   8-bit integer
- * * **node**: The spatially unique node identifier, an unsigned 48-bit
- *   integer
- *
- * @link http://tools.ietf.org/html/rfc4122#section-4.1 RFC 4122, § 4.1: Format
- *
- * @psalm-immutable
- */
-interface FieldsInterface extends BaseFieldsInterface
-{
-    /**
-     * Returns the full 16-bit clock sequence, with the variant bits (two most
-     * significant bits) masked out
-     */
-    public function getClockSeq(): Hexadecimal;
-
-    /**
-     * Returns the high field of the clock sequence multiplexed with the variant
-     */
-    public function getClockSeqHiAndReserved(): Hexadecimal;
-
-    /**
-     * Returns the low field of the clock sequence
-     */
-    public function getClockSeqLow(): Hexadecimal;
-
-    /**
-     * Returns the node field
-     */
-    public function getNode(): Hexadecimal;
-
-    /**
-     * Returns the high field of the timestamp multiplexed with the version
-     */
-    public function getTimeHiAndVersion(): Hexadecimal;
-
-    /**
-     * Returns the low field of the timestamp
-     */
-    public function getTimeLow(): Hexadecimal;
-
-    /**
-     * Returns the middle field of the timestamp
-     */
-    public function getTimeMid(): Hexadecimal;
-
-    /**
-     * Returns the full 60-bit timestamp, without the version
-     */
-    public function getTimestamp(): Hexadecimal;
-
-    /**
-     * Returns the variant
-     *
-     * The variant number describes the layout of the UUID. The variant
-     * number has the following meaning:
-     *
-     * - 0 - Reserved for NCS backward compatibility
-     * - 2 - The RFC 4122 variant
-     * - 6 - Reserved, Microsoft Corporation backward compatibility
-     * - 7 - Reserved for future definition
-     *
-     * For RFC 4122 variant UUIDs, this value should always be the integer `2`.
-     *
-     * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant
-     */
-    public function getVariant(): Variant;
-
-    /**
-     * Returns the version
-     *
-     * The version number describes how the UUID was generated and has the
-     * following meaning:
-     *
-     * 1. Gregorian time UUID
-     * 2. DCE security UUID
-     * 3. Name-based UUID hashed with MD5
-     * 4. Randomly generated UUID
-     * 5. Name-based UUID hashed with SHA-1
-     * 6. Reordered time UUID
-     * 7. Unix Epoch time UUID
-     *
-     * This returns `null` if the UUID is not an RFC 4122 variant, since version
-     * is only meaningful for this variant.
-     *
-     * @link http://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version
-     */
-    public function getVersion(): ?Version;
-
-    /**
-     * Returns true if these fields represent a nil UUID
-     *
-     * The nil UUID is special form of UUID that is specified to have all 128
-     * bits set to zero.
-     */
-    public function isNil(): bool;
-}

package/vendor/ramsey/uuid/src/Rfc4122/MaxTrait.php

@@ -1,41 +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\Rfc4122;
-
-/**
- * Provides common functionality for max UUIDs
- *
- * The max UUID is special form of UUID that is specified to have all 128 bits
- * set to one. It is the inverse of the nil UUID.
- *
- * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.10 Max UUID
- *
- * @psalm-immutable
- */
-trait MaxTrait
-{
-    /**
-     * Returns the bytes that comprise the fields
-     */
-    abstract public function getBytes(): string;
-
-    /**
-     * Returns true if the byte string represents a max UUID
-     */
-    public function isMax(): bool
-    {
-        return $this->getBytes() === "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff";
-    }
-}

package/vendor/ramsey/uuid/src/Rfc4122/MaxUuid.php

@@ -1,27 +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\Rfc4122;
-
-use Ramsey\Uuid\Uuid;
-
-/**
- * The max UUID is special form of UUID that is specified to have all 128 bits
- * set to one
- *
- * @psalm-immutable
- */
-final class MaxUuid extends Uuid implements UuidInterface
-{
-}

package/vendor/ramsey/uuid/src/Rfc4122/NilTrait.php

@@ -1,41 +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\Rfc4122;
-
-/**
- * Provides common functionality for nil UUIDs
- *
- * The nil UUID is special form of UUID that is specified to have all 128 bits
- * set to zero.
- *
- * @link https://tools.ietf.org/html/rfc4122#section-4.1.7 RFC 4122, § 4.1.7: Nil UUID
- *
- * @psalm-immutable
- */
-trait NilTrait
-{
-    /**
-     * Returns the bytes that comprise the fields
-     */
-    abstract public function getBytes(): string;
-
-    /**
-     * Returns true if the byte string represents a nil UUID
-     */
-    public function isNil(): bool
-    {
-        return $this->getBytes() === "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
-    }
-}

package/vendor/ramsey/uuid/src/Rfc4122/NilUuid.php

@@ -1,27 +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\Rfc4122;
-
-use Ramsey\Uuid\Uuid;
-
-/**
- * The nil UUID is special form of UUID that is specified to have all 128 bits
- * set to zero
- *
- * @psalm-immutable
- */
-final class NilUuid extends Uuid implements UuidInterface
-{
-}

package/vendor/ramsey/uuid/src/Rfc4122/TimeTrait.php

@@ -1,55 +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\Rfc4122;
-
-use DateTimeImmutable;
-use DateTimeInterface;
-use Ramsey\Uuid\Exception\DateTimeException;
-use Throwable;
-
-use function str_pad;
-
-use const STR_PAD_LEFT;
-
-/**
- * Provides common functionality for getting the time from a time-based UUID
- *
- * @psalm-immutable
- */
-trait TimeTrait
-{
-    /**
-     * Returns a DateTimeInterface object representing the timestamp associated
-     * with the UUID
-     *
-     * @return DateTimeImmutable A PHP DateTimeImmutable instance representing
-     *     the timestamp of a time-based UUID
-     */
-    public function getDateTime(): DateTimeInterface
-    {
-        $time = $this->getTimeConverter()->convertTime($this->getFields()->getTimestamp());
-
-        try {
-            return new DateTimeImmutable(
-                '@'
-                . $time->getSeconds()->toString()
-                . '.'
-                . str_pad($time->getMicroseconds()->toString(), 6, '0', STR_PAD_LEFT)
-            );
-        } catch (Throwable $e) {
-            throw new DateTimeException($e->getMessage(), (int) $e->getCode(), $e);
-        }
-    }
-}

package/vendor/ramsey/uuid/src/Rfc4122/UuidBuilder.php

@@ -1,116 +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\Rfc4122;
-
-use Ramsey\Uuid\Builder\UuidBuilderInterface;
-use Ramsey\Uuid\Codec\CodecInterface;
-use Ramsey\Uuid\Converter\NumberConverterInterface;
-use Ramsey\Uuid\Converter\Time\UnixTimeConverter;
-use Ramsey\Uuid\Converter\TimeConverterInterface;
-use Ramsey\Uuid\Exception\UnableToBuildUuidException;
-use Ramsey\Uuid\Exception\UnsupportedOperationException;
-use Ramsey\Uuid\Math\BrickMathCalculator;
-use Ramsey\Uuid\Rfc4122\UuidInterface as Rfc4122UuidInterface;
-use Ramsey\Uuid\UuidInterface;
-use Throwable;
-
-/**
- * UuidBuilder builds instances of RFC 4122 UUIDs
- *
- * @psalm-immutable
- */
-class UuidBuilder implements UuidBuilderInterface
-{
-    /**
-     * Constructs the UUID builder
-     *
-     * @param NumberConverterInterface $numberConverter The number converter to
-     *     use when constructing the Uuid
-     * @param TimeConverterInterface $timeConverter The time converter to use
-     *     for converting Gregorian time extracted from version 1, 2, and 6
-     *     UUIDs to Unix timestamps
-     * @param TimeConverterInterface $unixTimeConverter The time converter
-     *     to use for converter Unix Epoch time extracted from version 7 UUIDs
-     *     to Unix timestamps
-     */
-    public function __construct(
-        private readonly NumberConverterInterface $numberConverter,
-        private readonly TimeConverterInterface $timeConverter,
-        private readonly TimeConverterInterface $unixTimeConverter = new UnixTimeConverter(new BrickMathCalculator())
-    ) {
-    }
-
-    /**
-     * Builds and returns a Uuid
-     *
-     * @param CodecInterface $codec The codec to use for building this Uuid instance
-     * @param non-empty-string $bytes The byte string from which to construct a UUID
-     *
-     * @return Rfc4122UuidInterface UuidBuilder returns instances of Rfc4122UuidInterface
-     *
-     * @psalm-pure
-     */
-    public function build(CodecInterface $codec, string $bytes): UuidInterface
-    {
-        try {
-            /** @var Fields $fields */
-            $fields = $this->buildFields($bytes);
-
-            if ($fields->isNil()) {
-                return new NilUuid($fields, $this->numberConverter, $codec, $this->timeConverter);
-            }
-
-            if ($fields->isMax()) {
-                return new MaxUuid($fields, $this->numberConverter, $codec, $this->timeConverter);
-            }
-
-            switch ($fields->getVersion()) {
-                case Version::Time:
-                    return new UuidV1($fields, $this->numberConverter, $codec, $this->timeConverter);
-                case Version::DceSecurity:
-                    return new UuidV2($fields, $this->numberConverter, $codec, $this->timeConverter);
-                case Version::HashMd5:
-                    return new UuidV3($fields, $this->numberConverter, $codec, $this->timeConverter);
-                case Version::Random:
-                    return new UuidV4($fields, $this->numberConverter, $codec, $this->timeConverter);
-                case Version::HashSha1:
-                    return new UuidV5($fields, $this->numberConverter, $codec, $this->timeConverter);
-                case Version::ReorderedTime:
-                    return new UuidV6($fields, $this->numberConverter, $codec, $this->timeConverter);
-                case Version::UnixTime:
-                    return new UuidV7($fields, $this->numberConverter, $codec, $this->unixTimeConverter);
-                case Version::Custom:
-                    return new UuidV8($fields, $this->numberConverter, $codec, $this->timeConverter);
-            }
-
-            throw new UnsupportedOperationException(
-                'The UUID version in the given fields is not supported '
-                . 'by this UUID builder'
-            );
-        } catch (Throwable $e) {
-            throw new UnableToBuildUuidException($e->getMessage(), (int) $e->getCode(), $e);
-        }
-    }
-
-    /**
-     * Proxy method to allow injecting a mock, for testing
-     *
-     * @param non-empty-string $bytes
-     */
-    protected function buildFields(string $bytes): FieldsInterface
-    {
-        return new Fields($bytes);
-    }
-}

package/vendor/ramsey/uuid/src/Rfc4122/UuidInterface.php

@@ -1,30 +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\Rfc4122;
-
-use Ramsey\Uuid\UuidInterface as BaseUuidInterface;
-
-/**
- * Also known as a Leach-Salz variant UUID, an RFC 4122 variant UUID is a
- * universally unique identifier defined by RFC 4122
- *
- * @link https://tools.ietf.org/html/rfc4122 RFC 4122
- *
- * @psalm-immutable
- */
-interface UuidInterface extends BaseUuidInterface
-{
-    public function getFields(): FieldsInterface;
-}