update2

pfosten/vendor/ramsey/uuid/CHANGELOG.md

@@ -1,5 +1,46 @@
 # ramsey/uuid Changelog
 
+## 3.8.0
+
+_Released: 2018-07-19_
+
+  * Add support for determining MAC address on FreeBSD systems ([#212](https://github.com/ramsey/uuid/pull/212))
+  * Add a polyfill for PHP ctype functions to support systems where the ctype functions are not part of the PHP build ([#223](https://github.com/ramsey/uuid/pull/223))
+  * Improve validation to disallow UUIDs with a trailing newline character ([#225](https://github.com/ramsey/uuid/pull/225))
+  * Add annotations for thrown exceptions for improved IDE hinting ([#232](https://github.com/ramsey/uuid/pull/232))
+  * Improve documentation, testing, and project metadata (i.e. `.gitattributes`, etc.)
+
+## 3.7.3
+
+_Released: 2018-01-19_
+
+  * In rare cases, when using `glob()` to find `/sys/class/net/*/address` files on Linux, `glob()` encountered errors, returning `false` instead of an empty array, causing `array_map()` to emit warnings since its second parameter was not an array; this release gracefully handles cases where `glob()` returns `false` [#203](https://github.com/ramsey/uuid/issues/203)
+  * Fixed an off-by-one error in `DefaultTimeGenerator` and switching to `random_int()` from `mt_rand()` for better random numbers [#206](https://github.com/ramsey/uuid/pull/206)
+
+## 3.7.2
+
+_Released: 2018-01-13_
+
+  * On Linux, first check sysfs to determine node identifier; this provides a reliable way to identify the node on Docker images, etc. [#185](https://github.com/ramsey/uuid/pull/185)
+
+## 3.7.1
+
+_Released: 2017-09-22_
+
+  * Use `random_bytes()` when generating random nodes
+  * Set the multicast bit for random nodes, according to RFC 4122, §4.5, [#170](https://github.com/ramsey/uuid/pull/170), [#171](https://github.com/ramsey/uuid/pull/171), [#182](https://github.com/ramsey/uuid/pull/182)
+
+## 3.7.0
+
+_Released: 2017-08-04_
+
+  * Add UUID version constants [#173](https://github.com/ramsey/uuid/issues/173), [#177](https://github.com/ramsey/uuid/pull/177)
+    * `Uuid::UUID_TYPE_TIME`
+    * `Uuid::UUID_TYPE_IDENTIFIER`
+    * `Uuid::UUID_TYPE_HASH_MD5`
+    * `Uuid::UUID_TYPE_RANDOM`
+    * `Uuid::UUID_TYPE_HASH_SHA1`
+
 ## 3.6.1
 
 _Released: 2017-03-26_

pfosten/vendor/ramsey/uuid/CONTRIBUTING.md

@@ -60,7 +60,7 @@ composer test
 
 ### Locally Test With Emulated MIPS Architecture
 
-The following commands use [Vagrant](https://www.vagrantup.com/) to start an Ubuntu VM, install necessary dependencies, and then run the `util/run-tests.sh` script that will download a Docker image emulating the MIPS architecture. This is especially helpful for testing UUID generation in a big-endian environment.
+The following commands use [Vagrant](https://www.vagrantup.com/) to start an Ubuntu VM, install necessary dependencies, and then run the `tools/run-tests.sh` script that will download a Docker image emulating the MIPS architecture. This is especially helpful for testing UUID generation in a big-endian environment.
 
 ```
 vagrant init ubuntu/trusty64
@@ -71,5 +71,5 @@ cd /vagrant
 curl -sS https://getcomposer.org/installer | php
 php composer.phar install --no-interaction --prefer-dist
 mkdir -p build/logs
-ARCH=mips PHP_VERSION=5.6.14 TRAVIS_BUILD_DIR=/vagrant ./util/run-tests.sh
+ARCH=mips PHP_VERSION=5.6.14 TRAVIS_BUILD_DIR=/vagrant ./tools/run-tests.sh
 ```

pfosten/vendor/ramsey/uuid/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2012-2017 Ben Ramsey <ben@benramsey.com>
+Copyright (c) 2012-2018 Ben Ramsey <ben@benramsey.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

pfosten/vendor/ramsey/uuid/composer.json

@@ -26,23 +26,23 @@
     },
     "require": {
         "php": "^5.4 || ^7.0",
-        "paragonie/random_compat": "^1.0|^2.0"
+        "paragonie/random_compat": "^1.0|^2.0|9.99.99",
+        "symfony/polyfill-ctype": "^1.8"
     },
     "require-dev": {
-        "moontoast/math": "^1.1",
-        "ircmaxell/random-lib": "^1.1",
-        "phpunit/phpunit": "^4.7|>=5.0 <5.4",
-        "squizlabs/php_codesniffer": "^2.3",
-        "jakub-onderka/php-parallel-lint": "^0.9.0",
-        "satooshi/php-coveralls": "^0.6.1",
-        "apigen/apigen": "^4.1",
-        "mockery/mockery": "^0.9.4",
-        "goaop/framework": "1.0.0-alpha.2 | ^1.0 | ^2.1",
+        "codeception/aspect-mock": "^1.0 | ~2.0.0",
         "doctrine/annotations": "~1.2.0",
-        "codeception/aspect-mock": "^1.0 | ^2.0",
-        "php-mock/php-mock-phpunit": "^0.3|^1.1"
+        "goaop/framework": "1.0.0-alpha.2 | ^1.0 | ~2.1.0",
+        "ircmaxell/random-lib": "^1.1",
+        "jakub-onderka/php-parallel-lint": "^0.9.0",
+        "mockery/mockery": "^0.9.9",
+        "moontoast/math": "^1.1",
+        "php-mock/php-mock-phpunit": "^0.3|^1.1",
+        "phpunit/phpunit": "^4.7|^5.0|^6.5",
+        "squizlabs/php_codesniffer": "^2.3"
     },
     "suggest": {
+        "ext-ctype": "Provides support for PHP Ctype functions",
         "ircmaxell/random-lib": "Provides RandomLib for use with the RandomLibAdapter",
         "ext-libsodium": "Provides the PECL libsodium extension for use with the SodiumRandomGenerator",
         "ext-uuid": "Provides the PECL UUID extension for use with the PeclUuidTimeGenerator and PeclUuidRandomGenerator",
@@ -72,7 +72,9 @@
             "@lint",
             "@phpunit",
             "@phpcs"
-        ],
-        "build-docs": "apigen generate --source='src' --destination='build/apidocs' --template-theme='bootstrap' --deprecated --todo"
+        ]
+    },
+    "config": {
+        "sort-packages": true
     }
 }

pfosten/vendor/ramsey/uuid/src/Codec/CodecInterface.php

@@ -42,6 +42,7 @@ interface CodecInterface
      *
      * @param string $encodedUuid
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function decode($encodedUuid);
 
@@ -50,6 +51,8 @@ interface CodecInterface
      *
      * @param string $bytes
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
+     * @throws \InvalidArgumentException if string has not 16 characters
      */
     public function decodeBytes($bytes);
 }

pfosten/vendor/ramsey/uuid/src/Codec/GuidStringCodec.php

@@ -60,6 +60,7 @@ class GuidStringCodec extends StringCodec
      *
      * @param string $encodedUuid
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function decode($encodedUuid)
     {
@@ -75,6 +76,7 @@ class GuidStringCodec extends StringCodec
      *
      * @param string $bytes
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function decodeBytes($bytes)
     {

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

@@ -50,6 +50,7 @@ class OrderedTimeCodec extends StringCodec
      *
      * @param string $bytes
      * @return UuidInterface
+     * @throws \InvalidArgumentException if string has not 16 characters
      */
     public function decodeBytes($bytes)
     {

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

@@ -74,6 +74,7 @@ class StringCodec implements CodecInterface
      *
      * @param string $encodedUuid
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function decode($encodedUuid)
     {
@@ -88,6 +89,7 @@ class StringCodec implements CodecInterface
      *
      * @param string $bytes
      * @return UuidInterface
+     * @throws \InvalidArgumentException if string has not 16 characters
      */
     public function decodeBytes($bytes)
     {
@@ -115,6 +117,7 @@ class StringCodec implements CodecInterface
      *
      * @param string $encodedUuid
      * @return array
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     protected function extractComponents($encodedUuid)
     {

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

@@ -60,6 +60,7 @@ class TimestampFirstCombCodec extends StringCodec
      * @param string $encodedUuid
      *
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function decode($encodedUuid)
     {
@@ -76,6 +77,7 @@ class TimestampFirstCombCodec extends StringCodec
      * @param string $bytes
      *
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function decodeBytes($bytes)
     {

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

@@ -28,6 +28,7 @@ interface NumberConverterInterface
      *
      * @param string $hex The hexadecimal string representation to convert
      * @return mixed
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
      */
     public function fromHex($hex);
 
@@ -39,6 +40,7 @@ interface NumberConverterInterface
      *     a true integer, a string integer, or a object representation that
      *     this converter can understand
      * @return string Hexadecimal string
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
      */
     public function toHex($integer);
 }

pfosten/vendor/ramsey/uuid/src/Converter/Time/DegradedTimeConverter.php

@@ -30,7 +30,7 @@ class DegradedTimeConverter implements TimeConverterInterface
      * @param string $seconds
      * @param string $microSeconds
      * @return void
-     * @throws UnsatisfiedDependencyException
+     * @throws UnsatisfiedDependencyException if called on a 32-bit system and `Moontoast\Math\BigNumber` is not present
      */
     public function calculateTime($seconds, $microSeconds)
     {

pfosten/vendor/ramsey/uuid/src/Converter/TimeConverterInterface.php

@@ -27,6 +27,8 @@ interface TimeConverterInterface
      * @param string $seconds
      * @param string $microSeconds
      * @return string[] An array guaranteed to contain `low`, `mid`, and `high` keys
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called on a 32-bit system and
+     *     `Moontoast\Math\BigNumber` is not present
      * @link http://tools.ietf.org/html/rfc4122#section-4.2.2
      */
     public function calculateTime($seconds, $microSeconds);

pfosten/vendor/ramsey/uuid/src/DegradedUuid.php

@@ -24,6 +24,9 @@ use Ramsey\Uuid\Exception\UnsupportedOperationException;
  */
 class DegradedUuid extends Uuid
 {
+    /**
+     * @inheritdoc
+     */
     public function getDateTime()
     {
         if ($this->getVersion() != 1) {

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

@@ -53,6 +53,9 @@ class CombGenerator implements RandomGeneratorInterface
      *
      * @param integer $length The number of bytes of random binary data to generate
      * @return string A binary string
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException if length is not a positive integer
+     * @throws \Exception
      */
     public function generate($length)
     {

pfosten/vendor/ramsey/uuid/src/Generator/DefaultTimeGenerator.php

@@ -72,6 +72,10 @@ class DefaultTimeGenerator implements TimeGeneratorInterface
      *     could arise when the clock is set backwards in time or if the node ID
      *     changes.
      * @return string A binary string
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called on a 32-bit system and
+     *     `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function generate($node = null, $clockSeq = null)
     {
@@ -79,7 +83,7 @@ class DefaultTimeGenerator implements TimeGeneratorInterface
 
         if ($clockSeq === null) {
             // Not using "stable storage"; see RFC 4122, Section 4.2.1.1
-            $clockSeq = mt_rand(0, 1 << 14);
+            $clockSeq = random_int(0, 0x3fff);
         }
 
         // Create a 60-bit time value as a count of 100-nanosecond intervals
@@ -111,6 +115,8 @@ class DefaultTimeGenerator implements TimeGeneratorInterface
      *
      * @param string|int $node A node value that may be used to override the node provider
      * @return string Hexadecimal representation of the node ID
+     * @throws \InvalidArgumentException
+     * @throws \Exception
      */
     protected function getValidNode($node)
     {

pfosten/vendor/ramsey/uuid/src/Generator/RandomBytesGenerator.php

@@ -28,6 +28,7 @@ class RandomBytesGenerator implements RandomGeneratorInterface
      *
      * @param integer $length The number of bytes of random binary data to generate
      * @return string A binary string
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function generate($length)
     {

pfosten/vendor/ramsey/uuid/src/Generator/RandomGeneratorInterface.php

@@ -25,6 +25,9 @@ interface RandomGeneratorInterface
      *
      * @param integer $length The number of bytes of random binary data to generate
      * @return string A binary string
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function generate($length);
 }

pfosten/vendor/ramsey/uuid/src/Generator/TimeGeneratorInterface.php

@@ -30,6 +30,10 @@ interface TimeGeneratorInterface
      *     could arise when the clock is set backwards in time or if the node ID
      *     changes.
      * @return string A binary string
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called on a 32-bit system and
+     *     `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function generate($node = null, $clockSeq = null);
 }

pfosten/vendor/ramsey/uuid/src/Provider/Node/FallbackNodeProvider.php

@@ -43,6 +43,7 @@ class FallbackNodeProvider implements NodeProviderInterface
      * and returning the first non-empty value found
      *
      * @return string System node ID as a hexadecimal string
+     * @throws \Exception
      */
     public function getNode()
     {

pfosten/vendor/ramsey/uuid/src/Provider/Node/RandomNodeProvider.php

@@ -28,9 +28,15 @@ class RandomNodeProvider implements NodeProviderInterface
      * Returns the system node ID
      *
      * @return string System node ID as a hexadecimal string
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function getNode()
     {
-        return sprintf('%06x%06x', mt_rand(0, 0xffffff), mt_rand(0, 0xffffff));
+        $node = hexdec(bin2hex(random_bytes(6)));
+
+        // Set the multicast bit; see RFC 4122, section 4.5.
+        $node = $node | 0x010000000000;
+
+        return str_pad(dechex($node), 12, '0', STR_PAD_LEFT);
     }
 }

pfosten/vendor/ramsey/uuid/src/Provider/Node/SystemNodeProvider.php

@@ -38,14 +38,19 @@ class SystemNodeProvider implements NodeProviderInterface
         $pattern = '/[^:]([0-9A-Fa-f]{2}([:-])[0-9A-Fa-f]{2}(\2[0-9A-Fa-f]{2}){4})[^:]/';
         $matches = array();
 
+        // first try a  linux specific way
+        $node = $this->getSysfs();
+
         // Search the ifconfig output for all MAC addresses and return
         // the first one found
-        $node = false;
-        if (preg_match_all($pattern, $this->getIfconfig(), $matches, PREG_PATTERN_ORDER)) {
-            $node = $matches[1][0];
+        if ($node === false) {
+            if (preg_match_all($pattern, $this->getIfconfig(), $matches, PREG_PATTERN_ORDER)) {
+                $node = $matches[1][0];
+            }
+        }
+        if ($node !== false) {
             $node = str_replace([':', '-'], '', $node);
         }
-
         return $node;
     }
 
@@ -57,6 +62,10 @@ class SystemNodeProvider implements NodeProviderInterface
      */
     protected function getIfconfig()
     {
+        if (strpos(strtolower(ini_get('disable_functions')), 'passthru') !== false) {
+            return '';
+        }
+
         ob_start();
         switch (strtoupper(substr(php_uname('a'), 0, 3))) {
             case 'WIN':
@@ -65,6 +74,9 @@ class SystemNodeProvider implements NodeProviderInterface
             case 'DAR':
                 passthru('ifconfig 2>&1');
                 break;
+            case 'FRE':
+                passthru('netstat -i -f link 2>&1');
+                break;
             case 'LIN':
             default:
                 passthru('netstat -ie 2>&1');
@@ -73,4 +85,41 @@ class SystemNodeProvider implements NodeProviderInterface
 
         return ob_get_clean();
     }
+
+    /**
+     * Returns mac address from the first system interface via the sysfs interface
+     *
+     * @return string|bool
+     */
+    protected function getSysfs()
+    {
+        $mac = false;
+
+        if (strtoupper(php_uname('s')) === 'LINUX') {
+            $addressPaths = glob('/sys/class/net/*/address', GLOB_NOSORT);
+
+            if (empty($addressPaths)) {
+                return false;
+            }
+
+            array_walk($addressPaths, function ($addressPath) use (&$macs) {
+                $macs[] = file_get_contents($addressPath);
+            });
+
+            $macs = array_map('trim', $macs);
+
+            // remove invalid entries
+            $macs = array_filter($macs, function ($mac) {
+                return
+                    // localhost adapter
+                    $mac !== '00:00:00:00:00:00' &&
+                    // must match  mac adress
+                    preg_match('/^([0-9a-f]{2}:){5}[0-9a-f]{2}$/i', $mac);
+            });
+
+            $mac = reset($macs);
+        }
+
+        return $mac;
+    }
 }

pfosten/vendor/ramsey/uuid/src/Provider/NodeProviderInterface.php

@@ -24,6 +24,7 @@ interface NodeProviderInterface
      * Returns the system node ID
      *
      * @return string System node ID as a hexadecimal string
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function getNode();
 }

pfosten/vendor/ramsey/uuid/src/Uuid.php

@@ -95,6 +95,31 @@ class Uuid implements UuidInterface
      */
     const VALID_PATTERN = '^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$';
 
+    /**
+     * Version 1 (time-based) UUID object constant identifier
+     */
+    const UUID_TYPE_TIME = 1;
+
+    /**
+     * Version 2 (identifier-based) UUID object constant identifier
+     */
+    const UUID_TYPE_IDENTIFIER = 2;
+
+    /**
+     * Version 3 (name-based and hashed with MD5) UUID object constant identifier
+     */
+    const UUID_TYPE_HASH_MD5 = 3;
+
+    /**
+     * Version 4 (random) UUID object constant identifier
+     */
+    const UUID_TYPE_RANDOM = 4;
+
+    /**
+     * Version 5 (name-based and hashed with SHA1) UUID object constant identifier
+     */
+    const UUID_TYPE_HASH_SHA1 = 5;
+
     /**
      * The factory to use when creating UUIDs.
      * @var UuidFactoryInterface
@@ -204,6 +229,7 @@ class Uuid implements UuidInterface
      *
      * @param string $serialized
      * @link http://php.net/manual/en/class.serializable.php
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function unserialize($serialized)
     {
@@ -307,6 +333,9 @@ class Uuid implements UuidInterface
         return $this->converter;
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getDateTime()
     {
         if ($this->getVersion() != 1) {
@@ -359,6 +388,9 @@ class Uuid implements UuidInterface
         return str_replace('-', '', $this->toString());
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getInteger()
     {
         return $this->converter->fromHex($this->getHex());
@@ -368,6 +400,7 @@ class Uuid implements UuidInterface
      * Returns the least significant 64 bits of this UUID's 128 bit value.
      *
      * @return mixed Converted representation of the unsigned 64-bit integer value
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
      */
     public function getLeastSignificantBits()
     {
@@ -388,6 +421,7 @@ class Uuid implements UuidInterface
      * Returns the most significant 64 bits of this UUID's 128 bit value.
      *
      * @return mixed Converted representation of the unsigned 64-bit integer value
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
      */
     public function getMostSignificantBits()
     {
@@ -509,6 +543,9 @@ class Uuid implements UuidInterface
         return hexdec($this->getTimestampHex());
     }
 
+    /**
+     * @inheritdoc
+     */
     public function getTimestampHex()
     {
         if ($this->getVersion() != 1) {
@@ -587,6 +624,8 @@ class Uuid implements UuidInterface
      *
      * @param string $bytes
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
+     * @throws \InvalidArgumentException
      */
     public static function fromBytes($bytes)
     {
@@ -598,6 +637,7 @@ class Uuid implements UuidInterface
      *
      * @param string $name A string that specifies a UUID
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public static function fromString($name)
     {
@@ -609,6 +649,8 @@ class Uuid implements UuidInterface
      *
      * @param string $integer String representation of 128-bit integer
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public static function fromInteger($integer)
     {
@@ -629,7 +671,7 @@ class Uuid implements UuidInterface
             return true;
         }
 
-        if (!preg_match('/' . self::VALID_PATTERN . '/', $uuid)) {
+        if (!preg_match('/' . self::VALID_PATTERN . '/D', $uuid)) {
             return false;
         }
 
@@ -645,6 +687,10 @@ class Uuid implements UuidInterface
      *     could arise when the clock is set backwards in time or if the node ID
      *     changes.
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called on a 32-bit system and
+     *     `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public static function uuid1($node = null, $clockSeq = null)
     {
@@ -658,6 +704,7 @@ class Uuid implements UuidInterface
      * @param string $ns The UUID namespace in which to create the named UUID
      * @param string $name The name to create a UUID for
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public static function uuid3($ns, $name)
     {
@@ -668,6 +715,9 @@ class Uuid implements UuidInterface
      * Generate a version 4 (random) UUID.
      *
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception
      */
     public static function uuid4()
     {
@@ -681,6 +731,7 @@ class Uuid implements UuidInterface
      * @param string $ns The UUID namespace in which to create the named UUID
      * @param string $name The name to create a UUID for
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public static function uuid5($ns, $name)
     {

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

@@ -180,17 +180,26 @@ class UuidFactory implements UuidFactoryInterface
         $this->uuidBuilder = $builder;
     }
 
+    /**
+     * @inheritdoc
+     */
     public function fromBytes($bytes)
     {
         return $this->codec->decodeBytes($bytes);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function fromString($uuid)
     {
         $uuid = strtolower($uuid);
         return $this->codec->decode($uuid);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function fromInteger($integer)
     {
         $hex = $this->numberConverter->toHex($integer);
@@ -199,6 +208,9 @@ class UuidFactory implements UuidFactoryInterface
         return $this->fromString($hex);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function uuid1($node = null, $clockSeq = null)
     {
         $bytes = $this->timeGenerator->generate($node, $clockSeq);
@@ -207,11 +219,17 @@ class UuidFactory implements UuidFactoryInterface
         return $this->uuidFromHashedName($hex, 1);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function uuid3($ns, $name)
     {
         return $this->uuidFromNsAndName($ns, $name, 3, 'md5');
     }
 
+    /**
+     * @inheritdoc
+     */
     public function uuid4()
     {
         $bytes = $this->randomGenerator->generate(16);
@@ -224,6 +242,9 @@ class UuidFactory implements UuidFactoryInterface
         return $this->uuidFromHashedName($hex, 4);
     }
 
+    /**
+     * @inheritdoc
+     */
     public function uuid5($ns, $name)
     {
         return $this->uuidFromNsAndName($ns, $name, 5, 'sha1');
@@ -253,6 +274,7 @@ class UuidFactory implements UuidFactoryInterface
      * @param string $hashFunction The hash function to use when hashing together
      *     the namespace and name
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     protected function uuidFromNsAndName($ns, $name, $version, $hashFunction)
     {

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

@@ -23,12 +23,16 @@ interface UuidFactoryInterface
     /**
      * Generate a version 1 UUID from a host ID, sequence number, and the current time.
      *
-     * @param int|string $node A 48-bit number representing the hardware address
+     * @param int|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 $clockSeq A 14-bit number used to help avoid duplicates that
+     * @param int|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
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called on a 32-bit system and
+     *     `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception if it was not possible to gather sufficient entropy
      */
     public function uuid1($node = null, $clockSeq = null);
 
@@ -39,6 +43,7 @@ interface UuidFactoryInterface
      * @param string $ns The UUID namespace in which to create the named UUID
      * @param string $name The name to create a UUID for
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function uuid3($ns, $name);
 
@@ -46,6 +51,9 @@ interface UuidFactoryInterface
      * Generate a version 4 (random) UUID.
      *
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+     * @throws \InvalidArgumentException
+     * @throws \Exception
      */
     public function uuid4();
 
@@ -56,6 +64,7 @@ interface UuidFactoryInterface
      * @param string $ns The UUID namespace in which to create the named UUID
      * @param string $name The name to create a UUID for
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function uuid5($ns, $name);
 
@@ -64,6 +73,8 @@ interface UuidFactoryInterface
      *
      * @param string $bytes A 16-byte string representation of a UUID
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
+     * @throws \InvalidArgumentException if string has not 16 characters
      */
     public function fromBytes($bytes);
 
@@ -72,6 +83,7 @@ interface UuidFactoryInterface
      *
      * @param string $uuid A string representation of a UUID
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function fromString($uuid);
 
@@ -84,6 +96,8 @@ interface UuidFactoryInterface
      * @param mixed $integer The integer to use when creating a `Uuid` from an
      *     integer; may be of any type understood by the configured number converter
      * @return UuidInterface
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+     * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
      */
     public function fromInteger($integer);
 }

pfosten/vendor/ramsey/uuid/src/UuidInterface.php

@@ -123,6 +123,8 @@ interface UuidInterface extends \JsonSerializable, \Serializable
      *
      * @return \DateTime A PHP DateTime representation of the date
      * @throws UnsupportedOperationException If this UUID is not a version 1 UUID
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called in a 32-bit system and
+     *     `Moontoast\Math\BigNumber` is not present
      */
     public function getDateTime();
 
@@ -131,6 +133,7 @@ interface UuidInterface extends \JsonSerializable, \Serializable
      * representation.
      *
      * @return mixed Converted representation of the unsigned 128-bit integer value
+     * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
      */
     public function getInteger();