create-prisma-php-app 1.0.0 → 1.0.1

package/vendor/ramsey/uuid/src/Codec/OrderedTimeCodec.php

@@ -1,114 +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\Codec;
-
-use Ramsey\Uuid\Exception\InvalidArgumentException;
-use Ramsey\Uuid\Exception\UnsupportedOperationException;
-use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface;
-use Ramsey\Uuid\Rfc4122\Version;
-use Ramsey\Uuid\UuidInterface;
-
-use function strlen;
-use function substr;
-
-/**
- * OrderedTimeCodec encodes and decodes a UUID, optimizing the byte order for
- * more efficient storage
- *
- * For binary representations of version 1 UUID, this codec may be used to
- * reorganize the time fields, making the UUID closer to sequential when storing
- * the bytes. According to Percona, this optimization can improve database
- * INSERTs and SELECTs using the UUID column as a key.
- *
- * The string representation of the UUID will remain unchanged. Only the binary
- * representation is reordered.
- *
- * **PLEASE NOTE:** Binary representations of UUIDs encoded with this codec must
- * be decoded with this codec. Decoding using another codec can result in
- * malformed UUIDs.
- *
- * @link https://www.percona.com/blog/2014/12/19/store-uuid-optimized-way/ Storing UUID Values in MySQL
- *
- * @psalm-immutable
- */
-class OrderedTimeCodec extends StringCodec
-{
-    /**
-     * Returns a binary string representation of a UUID, with the timestamp
-     * fields rearranged for optimized storage
-     *
-     * @inheritDoc
-     */
-    public function encodeBinary(UuidInterface $uuid): string
-    {
-        if (
-            !($uuid->getFields() instanceof Rfc4122FieldsInterface)
-            || $uuid->getFields()->getVersion() !== Version::Time
-        ) {
-            throw new InvalidArgumentException(
-                'Expected RFC 4122 version 1 (time-based) UUID'
-            );
-        }
-
-        $bytes = $uuid->getFields()->getBytes();
-
-        return $bytes[6] . $bytes[7]
-            . $bytes[4] . $bytes[5]
-            . $bytes[0] . $bytes[1] . $bytes[2] . $bytes[3]
-            . substr($bytes, 8);
-    }
-
-    /**
-     * Returns a UuidInterface derived from an ordered-time binary string
-     * representation
-     *
-     * @throws InvalidArgumentException if $bytes is an invalid length
-     *
-     * @inheritDoc
-     */
-    public function decodeBytes(string $bytes): UuidInterface
-    {
-        if (strlen($bytes) !== 16) {
-            throw new InvalidArgumentException(
-                '$bytes string should contain 16 characters.'
-            );
-        }
-
-        /**
-         * Rearrange the bytes to their original order.
-         *
-         * @psalm-suppress UnnecessaryVarAnnotation
-         * @phpstan-var non-empty-string $rearrangedBytes
-         */
-        $rearrangedBytes = $bytes[4] . $bytes[5] . $bytes[6] . $bytes[7]
-            . $bytes[2] . $bytes[3]
-            . $bytes[0] . $bytes[1]
-            . substr($bytes, 8);
-
-        $uuid = parent::decodeBytes($rearrangedBytes);
-
-        if (
-            !($uuid->getFields() instanceof Rfc4122FieldsInterface)
-            || $uuid->getFields()->getVersion() !== Version::Time
-        ) {
-            throw new UnsupportedOperationException(
-                'Attempting to decode a non-time-based UUID using '
-                . 'OrderedTimeCodec'
-            );
-        }
-
-        return $uuid;
-    }
-}

package/vendor/ramsey/uuid/src/Codec/StringCodec.php

@@ -1,128 +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\Codec;
-
-use Ramsey\Uuid\Builder\UuidBuilderInterface;
-use Ramsey\Uuid\Exception\InvalidArgumentException;
-use Ramsey\Uuid\Exception\InvalidUuidStringException;
-use Ramsey\Uuid\Uuid;
-use Ramsey\Uuid\UuidInterface;
-
-use function bin2hex;
-use function hex2bin;
-use function implode;
-use function sprintf;
-use function str_replace;
-use function strlen;
-use function substr;
-
-/**
- * StringCodec encodes and decodes RFC 4122 UUIDs
- *
- * @link http://tools.ietf.org/html/rfc4122
- *
- * @psalm-immutable
- */
-class StringCodec implements CodecInterface
-{
-    /**
-     * Constructs a StringCodec
-     *
-     * @param UuidBuilderInterface $builder The builder to use when encoding UUIDs
-     */
-    public function __construct(private UuidBuilderInterface $builder)
-    {
-    }
-
-    public function encode(UuidInterface $uuid): string
-    {
-        $hex = bin2hex($uuid->getFields()->getBytes());
-
-        /** @var non-empty-string */
-        return sprintf(
-            '%08s-%04s-%04s-%04s-%012s',
-            substr($hex, 0, 8),
-            substr($hex, 8, 4),
-            substr($hex, 12, 4),
-            substr($hex, 16, 4),
-            substr($hex, 20),
-        );
-    }
-
-    public function encodeBinary(UuidInterface $uuid): string
-    {
-        return $uuid->getFields()->getBytes();
-    }
-
-    /**
-     * @throws InvalidUuidStringException
-     *
-     * @inheritDoc
-     */
-    public function decode(string $encodedUuid): UuidInterface
-    {
-        return $this->builder->build($this, $this->getBytes($encodedUuid));
-    }
-
-    public function decodeBytes(string $bytes): UuidInterface
-    {
-        if (strlen($bytes) !== 16) {
-            throw new InvalidArgumentException(
-                '$bytes string should contain 16 characters.'
-            );
-        }
-
-        return $this->builder->build($this, $bytes);
-    }
-
-    /**
-     * Returns the UUID builder
-     */
-    protected function getBuilder(): UuidBuilderInterface
-    {
-        return $this->builder;
-    }
-
-    /**
-     * Returns a byte string of the UUID
-     *
-     * @return non-empty-string
-     */
-    protected function getBytes(string $encodedUuid): string
-    {
-        $parsedUuid = str_replace(
-            ['urn:', 'uuid:', 'URN:', 'UUID:', '{', '}', '-'],
-            '',
-            $encodedUuid
-        );
-
-        $components = [
-            substr($parsedUuid, 0, 8),
-            substr($parsedUuid, 8, 4),
-            substr($parsedUuid, 12, 4),
-            substr($parsedUuid, 16, 4),
-            substr($parsedUuid, 20),
-        ];
-
-        if (!Uuid::isValid(implode('-', $components))) {
-            throw new InvalidUuidStringException(
-                'Invalid UUID string: ' . $encodedUuid
-            );
-        }
-
-        /** @var non-empty-string */
-        return (string) hex2bin($parsedUuid);
-    }
-}

package/vendor/ramsey/uuid/src/Codec/TimestampFirstCombCodec.php

@@ -1,105 +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\Codec;
-
-use Ramsey\Uuid\Exception\InvalidUuidStringException;
-use Ramsey\Uuid\UuidInterface;
-
-use function bin2hex;
-use function sprintf;
-use function substr;
-use function substr_replace;
-
-/**
- * TimestampFirstCombCodec encodes and decodes COMBs, with the timestamp as the
- * first 48 bits
- *
- * In contrast with the TimestampLastCombCodec, the TimestampFirstCombCodec
- * adds the timestamp to the first 48 bits of the COMB. To generate a
- * timestamp-first COMB, set the TimestampFirstCombCodec as the codec, along
- * with the CombGenerator as the random generator.
- *
- * ``` php
- * $factory = new UuidFactory();
- *
- * $factory->setCodec(new TimestampFirstCombCodec($factory->getUuidBuilder()));
- *
- * $factory->setRandomGenerator(new CombGenerator(
- *     $factory->getRandomGenerator(),
- *     $factory->getNumberConverter()
- * ));
- *
- * $timestampFirstComb = $factory->uuid4();
- * ```
- *
- * @link https://www.informit.com/articles/printerfriendly/25862 The Cost of GUIDs as Primary Keys
- *
- * @psalm-immutable
- */
-class TimestampFirstCombCodec extends StringCodec
-{
-    public function encode(UuidInterface $uuid): string
-    {
-        $bytes = $this->swapBytes($uuid->getFields()->getBytes());
-
-        /** @var non-empty-string */
-        return sprintf(
-            '%08s-%04s-%04s-%04s-%012s',
-            bin2hex(substr($bytes, 0, 4)),
-            bin2hex(substr($bytes, 4, 2)),
-            bin2hex(substr($bytes, 6, 2)),
-            bin2hex(substr($bytes, 8, 2)),
-            bin2hex(substr($bytes, 10))
-        );
-    }
-
-    public function encodeBinary(UuidInterface $uuid): string
-    {
-        return $this->swapBytes($uuid->getFields()->getBytes());
-    }
-
-    /**
-     * @throws InvalidUuidStringException
-     *
-     * @inheritDoc
-     */
-    public function decode(string $encodedUuid): UuidInterface
-    {
-        $bytes = $this->getBytes($encodedUuid);
-
-        return $this->getBuilder()->build($this, $this->swapBytes($bytes));
-    }
-
-    public function decodeBytes(string $bytes): UuidInterface
-    {
-        return $this->getBuilder()->build($this, $this->swapBytes($bytes));
-    }
-
-    /**
-     * Swaps bytes according to the timestamp-first COMB rules
-     *
-     * @return non-empty-string
-     */
-    private function swapBytes(string $bytes): string
-    {
-        $first48Bits = substr($bytes, 0, 6);
-        $last48Bits = substr($bytes, -6);
-
-        $bytes = substr_replace($bytes, $last48Bits, 0, 6);
-
-        /** @var non-empty-string */
-        return substr_replace($bytes, $first48Bits, -6);
-    }
-}

package/vendor/ramsey/uuid/src/Codec/TimestampLastCombCodec.php

@@ -1,51 +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\Codec;
-
-/**
- * TimestampLastCombCodec encodes and decodes COMBs, with the timestamp as the
- * last 48 bits
- *
- * The CombGenerator when used with the StringCodec (and, by proxy, the
- * TimestampLastCombCodec) adds the timestamp to the last 48 bits of the COMB.
- * The TimestampLastCombCodec is provided for the sake of consistency. In
- * practice, it is identical to the standard StringCodec but, it may be used
- * with the CombGenerator for additional context when reading code.
- *
- * Consider the following code. By default, the codec used by UuidFactory is the
- * StringCodec, but here, we explicitly set the TimestampLastCombCodec. It is
- * redundant, but it is clear that we intend this COMB to be generated with the
- * timestamp appearing at the end.
- *
- * ``` php
- * $factory = new UuidFactory();
- *
- * $factory->setCodec(new TimestampLastCombCodec($factory->getUuidBuilder()));
- *
- * $factory->setRandomGenerator(new CombGenerator(
- *     $factory->getRandomGenerator(),
- *     $factory->getNumberConverter()
- * ));
- *
- * $timestampLastComb = $factory->uuid4();
- * ```
- *
- * @link https://www.informit.com/articles/printerfriendly/25862 The Cost of GUIDs as Primary Keys
- *
- * @psalm-immutable
- */
-class TimestampLastCombCodec extends StringCodec
-{
-}

package/vendor/ramsey/uuid/src/Converter/Number/GenericNumberConverter.php

@@ -1,48 +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\Converter\Number;
-
-use Ramsey\Uuid\Converter\NumberConverterInterface;
-use Ramsey\Uuid\Math\CalculatorInterface;
-use Ramsey\Uuid\Type\Integer as IntegerObject;
-
-/**
- * GenericNumberConverter uses the provided calculator to convert decimal
- * numbers to and from hexadecimal values
- *
- * @psalm-immutable
- */
-class GenericNumberConverter implements NumberConverterInterface
-{
-    public function __construct(private CalculatorInterface $calculator)
-    {
-    }
-
-    /**
-     * @psalm-pure
-     */
-    public function fromHex(string $hex): string
-    {
-        return $this->calculator->fromBase($hex, 16)->toString();
-    }
-
-    /**
-     * @psalm-pure
-     */
-    public function toHex(string $number): string
-    {
-        return $this->calculator->toBase(new IntegerObject($number), 16);
-    }
-}

package/vendor/ramsey/uuid/src/Converter/NumberConverterInterface.php

@@ -1,53 +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\Converter;
-
-/**
- * A number converter converts UUIDs from hexadecimal characters into
- * representations of integers and vice versa
- *
- * @psalm-immutable
- */
-interface NumberConverterInterface
-{
-    /**
-     * Converts a hexadecimal number into a string integer representation of
-     * the number
-     *
-     * The integer representation returned is a string representation of the
-     * integer, to accommodate unsigned integers greater than PHP_INT_MAX.
-     *
-     * @param non-empty-string $hex The hexadecimal string representation to convert
-     *
-     * @return numeric-string String representation of an integer
-     *
-     * @psalm-pure
-     */
-    public function fromHex(string $hex): string;
-
-    /**
-     * Converts a string integer representation into a hexadecimal string
-     * representation of the number
-     *
-     * @param numeric-string $number A string integer representation to convert;
-     *     this must be a numeric string to accommodate unsigned integers
-     *     greater than PHP_INT_MAX.
-     *
-     * @return non-empty-string Hexadecimal string
-     *
-     * @psalm-pure
-     */
-    public function toHex(string $number): string;
-}

package/vendor/ramsey/uuid/src/Converter/Time/GenericTimeConverter.php

@@ -1,118 +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\Converter\Time;
-
-use Ramsey\Uuid\Converter\TimeConverterInterface;
-use Ramsey\Uuid\Math\CalculatorInterface;
-use Ramsey\Uuid\Math\RoundingMode;
-use Ramsey\Uuid\Type\Hexadecimal;
-use Ramsey\Uuid\Type\Integer as IntegerObject;
-use Ramsey\Uuid\Type\Time;
-
-use function explode;
-use function str_pad;
-
-use const STR_PAD_LEFT;
-
-/**
- * GenericTimeConverter uses the provided calculator to calculate and convert
- * time values
- *
- * @psalm-immutable
- */
-class GenericTimeConverter implements TimeConverterInterface
-{
-    /**
-     * The number of 100-nanosecond intervals from the Gregorian calendar epoch
-     * to the Unix epoch.
-     */
-    private const GREGORIAN_TO_UNIX_INTERVALS = '122192928000000000';
-
-    /**
-     * The number of 100-nanosecond intervals in one second.
-     */
-    private const SECOND_INTERVALS = '10000000';
-
-    /**
-     * The number of 100-nanosecond intervals in one microsecond.
-     */
-    private const MICROSECOND_INTERVALS = '10';
-
-    public function __construct(private readonly CalculatorInterface $calculator)
-    {
-    }
-
-    public function calculateTime(string $seconds, string $microseconds): Hexadecimal
-    {
-        $timestamp = new Time($seconds, $microseconds);
-
-        // Convert the seconds into a count of 100-nanosecond intervals.
-        $sec = $this->calculator->multiply(
-            $timestamp->getSeconds(),
-            new IntegerObject(self::SECOND_INTERVALS)
-        );
-
-        // Convert the microseconds into a count of 100-nanosecond intervals.
-        $usec = $this->calculator->multiply(
-            $timestamp->getMicroseconds(),
-            new IntegerObject(self::MICROSECOND_INTERVALS)
-        );
-
-        // Combine the seconds and microseconds intervals and add the count of
-        // 100-nanosecond intervals from the Gregorian calendar epoch to the
-        // Unix epoch. This gives us the correct count of 100-nanosecond
-        // intervals since the Gregorian calendar epoch for the given seconds
-        // and microseconds.
-        /** @var IntegerObject $uuidTime */
-        $uuidTime = $this->calculator->add(
-            $sec,
-            $usec,
-            new IntegerObject(self::GREGORIAN_TO_UNIX_INTERVALS)
-        );
-
-        $uuidTimeHex = str_pad(
-            $this->calculator->toHexadecimal($uuidTime)->toString(),
-            16,
-            '0',
-            STR_PAD_LEFT
-        );
-
-        return new Hexadecimal($uuidTimeHex);
-    }
-
-    public function convertTime(Hexadecimal $uuidTimestamp): Time
-    {
-        // From the total, subtract the number of 100-nanosecond intervals from
-        // the Gregorian calendar epoch to the Unix epoch. This gives us the
-        // number of 100-nanosecond intervals from the Unix epoch, which also
-        // includes the micro-time.
-        $epochNanoseconds = $this->calculator->subtract(
-            $this->calculator->toInteger($uuidTimestamp),
-            new IntegerObject(self::GREGORIAN_TO_UNIX_INTERVALS)
-        );
-
-        // Convert the 100-nanosecond intervals into seconds and microseconds.
-        $unixTimestamp = $this->calculator->divide(
-            RoundingMode::HALF_UP,
-            6,
-            $epochNanoseconds,
-            new IntegerObject(self::SECOND_INTERVALS)
-        );
-
-        $split = explode('.', (string) $unixTimestamp, 2);
-
-        return new Time($split[0], $split[1] ?? 0);
-    }
-}