Initial commit 2/25/2025

16 files changed, 1338 insertions, 0 deletions

diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php
new file mode 100644
index 0000000..5604398
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+interface AdapterInterface extends ReaderInterface, WriterInterface
+{
+    /**
+     * Create a new instance of the adapter, if it is available.
+     *
+     * @return \PhpOption\Option<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    public static function create();
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php
new file mode 100644
index 0000000..af0aae1
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php
@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+use PhpOption\None;
+use PhpOption\Option;
+use PhpOption\Some;
+
+final class ApacheAdapter implements AdapterInterface
+{
+    /**
+     * Create a new apache adapter instance.
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Create a new instance of the adapter, if it is available.
+     *
+     * @return \PhpOption\Option<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    public static function create()
+    {
+        if (self::isSupported()) {
+            /** @var \PhpOption\Option<AdapterInterface> */
+            return Some::create(new self());
+        }
+
+        return None::create();
+    }
+
+    /**
+     * Determines if the adapter is supported.
+     *
+     * This happens if PHP is running as an Apache module.
+     *
+     * @return bool
+     */
+    private static function isSupported()
+    {
+        return \function_exists('apache_getenv') && \function_exists('apache_setenv');
+    }
+
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name)
+    {
+        /** @var \PhpOption\Option<string> */
+        return Option::fromValue(apache_getenv($name))->filter(static function ($value) {
+            return \is_string($value) && $value !== '';
+        });
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        return apache_setenv($name, $value);
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        return apache_setenv($name, '');
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php
new file mode 100644
index 0000000..df64cf6
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+use PhpOption\Option;
+use PhpOption\Some;
+
+final class ArrayAdapter implements AdapterInterface
+{
+    /**
+     * The variables and their values.
+     *
+     * @var array<string,string>
+     */
+    private $variables;
+
+    /**
+     * Create a new array adapter instance.
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        $this->variables = [];
+    }
+
+    /**
+     * Create a new instance of the adapter, if it is available.
+     *
+     * @return \PhpOption\Option<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    public static function create()
+    {
+        /** @var \PhpOption\Option<AdapterInterface> */
+        return Some::create(new self());
+    }
+
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name)
+    {
+        return Option::fromArraysValue($this->variables, $name);
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        $this->variables[$name] = $value;
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        unset($this->variables[$name]);
+
+        return true;
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php
new file mode 100644
index 0000000..9eb1947
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php
@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+use PhpOption\Option;
+use PhpOption\Some;
+
+final class EnvConstAdapter implements AdapterInterface
+{
+    /**
+     * Create a new env const adapter instance.
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Create a new instance of the adapter, if it is available.
+     *
+     * @return \PhpOption\Option<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    public static function create()
+    {
+        /** @var \PhpOption\Option<AdapterInterface> */
+        return Some::create(new self());
+    }
+
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name)
+    {
+        /** @var \PhpOption\Option<string> */
+        return Option::fromArraysValue($_ENV, $name)
+            ->filter(static function ($value) {
+                return \is_scalar($value);
+            })
+            ->map(static function ($value) {
+                if ($value === false) {
+                    return 'false';
+                }
+
+                if ($value === true) {
+                    return 'true';
+                }
+
+                /** @psalm-suppress PossiblyInvalidCast */
+                return (string) $value;
+            });
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        $_ENV[$name] = $value;
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        unset($_ENV[$name]);
+
+        return true;
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php
new file mode 100644
index 0000000..fed8b9b
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+final class GuardedWriter implements WriterInterface
+{
+    /**
+     * The inner writer to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface
+     */
+    private $writer;
+
+    /**
+     * The variable name allow list.
+     *
+     * @var string[]
+     */
+    private $allowList;
+
+    /**
+     * Create a new guarded writer instance.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface $writer
+     * @param string[]                                   $allowList
+     *
+     * @return void
+     */
+    public function __construct(WriterInterface $writer, array $allowList)
+    {
+        $this->writer = $writer;
+        $this->allowList = $allowList;
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        // Don't set non-allowed variables
+        if (!$this->isAllowed($name)) {
+            return false;
+        }
+
+        // Set the value on the inner writer
+        return $this->writer->write($name, $value);
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        // Don't clear non-allowed variables
+        if (!$this->isAllowed($name)) {
+            return false;
+        }
+
+        // Set the value on the inner writer
+        return $this->writer->delete($name);
+    }
+
+    /**
+     * Determine if the given variable is allowed.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    private function isAllowed(string $name)
+    {
+        return \in_array($name, $this->allowList, true);
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php
new file mode 100644
index 0000000..399e6f9
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php
@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+final class ImmutableWriter implements WriterInterface
+{
+    /**
+     * The inner writer to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface
+     */
+    private $writer;
+
+    /**
+     * The inner reader to use.
+     *
+     * @var \Dotenv\Repository\Adapter\ReaderInterface
+     */
+    private $reader;
+
+    /**
+     * The record of loaded variables.
+     *
+     * @var array<string,string>
+     */
+    private $loaded;
+
+    /**
+     * Create a new immutable writer instance.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface $writer
+     * @param \Dotenv\Repository\Adapter\ReaderInterface $reader
+     *
+     * @return void
+     */
+    public function __construct(WriterInterface $writer, ReaderInterface $reader)
+    {
+        $this->writer = $writer;
+        $this->reader = $reader;
+        $this->loaded = [];
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        // Don't overwrite existing environment variables
+        // Ruby's dotenv does this with `ENV[key] ||= value`
+        if ($this->isExternallyDefined($name)) {
+            return false;
+        }
+
+        // Set the value on the inner writer
+        if (!$this->writer->write($name, $value)) {
+            return false;
+        }
+
+        // Record that we have loaded the variable
+        $this->loaded[$name] = '';
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        // Don't clear existing environment variables
+        if ($this->isExternallyDefined($name)) {
+            return false;
+        }
+
+        // Clear the value on the inner writer
+        if (!$this->writer->delete($name)) {
+            return false;
+        }
+
+        // Leave the variable as fair game
+        unset($this->loaded[$name]);
+
+        return true;
+    }
+
+    /**
+     * Determine if the given variable is externally defined.
+     *
+     * That is, is it an "existing" variable.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    private function isExternallyDefined(string $name)
+    {
+        return $this->reader->read($name)->isDefined() && !isset($this->loaded[$name]);
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php
new file mode 100644
index 0000000..0cfda6f
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+use PhpOption\None;
+
+final class MultiReader implements ReaderInterface
+{
+    /**
+     * The set of readers to use.
+     *
+     * @var \Dotenv\Repository\Adapter\ReaderInterface[]
+     */
+    private $readers;
+
+    /**
+     * Create a new multi-reader instance.
+     *
+     * @param \Dotenv\Repository\Adapter\ReaderInterface[] $readers
+     *
+     * @return void
+     */
+    public function __construct(array $readers)
+    {
+        $this->readers = $readers;
+    }
+
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name)
+    {
+        foreach ($this->readers as $reader) {
+            $result = $reader->read($name);
+            if ($result->isDefined()) {
+                return $result;
+            }
+        }
+
+        return None::create();
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php
new file mode 100644
index 0000000..15a9d8f
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+final class MultiWriter implements WriterInterface
+{
+    /**
+     * The set of writers to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface[]
+     */
+    private $writers;
+
+    /**
+     * Create a new multi-writer instance.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface[] $writers
+     *
+     * @return void
+     */
+    public function __construct(array $writers)
+    {
+        $this->writers = $writers;
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        foreach ($this->writers as $writers) {
+            if (!$writers->write($name, $value)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        foreach ($this->writers as $writers) {
+            if (!$writers->delete($name)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php
new file mode 100644
index 0000000..6d017cd
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php
@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+use PhpOption\None;
+use PhpOption\Option;
+use PhpOption\Some;
+
+final class PutenvAdapter implements AdapterInterface
+{
+    /**
+     * Create a new putenv adapter instance.
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Create a new instance of the adapter, if it is available.
+     *
+     * @return \PhpOption\Option<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    public static function create()
+    {
+        if (self::isSupported()) {
+            /** @var \PhpOption\Option<AdapterInterface> */
+            return Some::create(new self());
+        }
+
+        return None::create();
+    }
+
+    /**
+     * Determines if the adapter is supported.
+     *
+     * @return bool
+     */
+    private static function isSupported()
+    {
+        return \function_exists('getenv') && \function_exists('putenv');
+    }
+
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name)
+    {
+        /** @var \PhpOption\Option<string> */
+        return Option::fromValue(\getenv($name), false)->filter(static function ($value) {
+            return \is_string($value);
+        });
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        \putenv("$name=$value");
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        \putenv($name);
+
+        return true;
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php
new file mode 100644
index 0000000..306a63f
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+interface ReaderInterface
+{
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name);
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php
new file mode 100644
index 0000000..98c0f04
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+final class ReplacingWriter implements WriterInterface
+{
+    /**
+     * The inner writer to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface
+     */
+    private $writer;
+
+    /**
+     * The inner reader to use.
+     *
+     * @var \Dotenv\Repository\Adapter\ReaderInterface
+     */
+    private $reader;
+
+    /**
+     * The record of seen variables.
+     *
+     * @var array<string,string>
+     */
+    private $seen;
+
+    /**
+     * Create a new replacement writer instance.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface $writer
+     * @param \Dotenv\Repository\Adapter\ReaderInterface $reader
+     *
+     * @return void
+     */
+    public function __construct(WriterInterface $writer, ReaderInterface $reader)
+    {
+        $this->writer = $writer;
+        $this->reader = $reader;
+        $this->seen = [];
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        if ($this->exists($name)) {
+            return $this->writer->write($name, $value);
+        }
+
+        // succeed if nothing to do
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        if ($this->exists($name)) {
+            return $this->writer->delete($name);
+        }
+
+        // succeed if nothing to do
+        return true;
+    }
+
+    /**
+     * Does the given environment variable exist.
+     *
+     * Returns true if it currently exists, or existed at any point in the past
+     * that we are aware of.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    private function exists(string $name)
+    {
+        if (isset($this->seen[$name])) {
+            return true;
+        }
+
+        if ($this->reader->read($name)->isDefined()) {
+            $this->seen[$name] = '';
+
+            return true;
+        }
+
+        return false;
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php
new file mode 100644
index 0000000..f93b6e5
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php
@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+use PhpOption\Option;
+use PhpOption\Some;
+
+final class ServerConstAdapter implements AdapterInterface
+{
+    /**
+     * Create a new server const adapter instance.
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Create a new instance of the adapter, if it is available.
+     *
+     * @return \PhpOption\Option<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    public static function create()
+    {
+        /** @var \PhpOption\Option<AdapterInterface> */
+        return Some::create(new self());
+    }
+
+    /**
+     * Read an environment variable, if it exists.
+     *
+     * @param non-empty-string $name
+     *
+     * @return \PhpOption\Option<string>
+     */
+    public function read(string $name)
+    {
+        /** @var \PhpOption\Option<string> */
+        return Option::fromArraysValue($_SERVER, $name)
+            ->filter(static function ($value) {
+                return \is_scalar($value);
+            })
+            ->map(static function ($value) {
+                if ($value === false) {
+                    return 'false';
+                }
+
+                if ($value === true) {
+                    return 'true';
+                }
+
+                /** @psalm-suppress PossiblyInvalidCast */
+                return (string) $value;
+            });
+    }
+
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value)
+    {
+        $_SERVER[$name] = $value;
+
+        return true;
+    }
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name)
+    {
+        unset($_SERVER[$name]);
+
+        return true;
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php b/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php
new file mode 100644
index 0000000..4cb3d61
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository\Adapter;
+
+interface WriterInterface
+{
+    /**
+     * Write to an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     * @param string           $value
+     *
+     * @return bool
+     */
+    public function write(string $name, string $value);
+
+    /**
+     * Delete an environment variable, if possible.
+     *
+     * @param non-empty-string $name
+     *
+     * @return bool
+     */
+    public function delete(string $name);
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php b/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php
new file mode 100644
index 0000000..e4b8fb7
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository;
+
+use Dotenv\Repository\Adapter\ReaderInterface;
+use Dotenv\Repository\Adapter\WriterInterface;
+use InvalidArgumentException;
+
+final class AdapterRepository implements RepositoryInterface
+{
+    /**
+     * The reader to use.
+     *
+     * @var \Dotenv\Repository\Adapter\ReaderInterface
+     */
+    private $reader;
+
+    /**
+     * The writer to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface
+     */
+    private $writer;
+
+    /**
+     * Create a new adapter repository instance.
+     *
+     * @param \Dotenv\Repository\Adapter\ReaderInterface $reader
+     * @param \Dotenv\Repository\Adapter\WriterInterface $writer
+     *
+     * @return void
+     */
+    public function __construct(ReaderInterface $reader, WriterInterface $writer)
+    {
+        $this->reader = $reader;
+        $this->writer = $writer;
+    }
+
+    /**
+     * Determine if the given environment variable is defined.
+     *
+     * @param string $name
+     *
+     * @return bool
+     */
+    public function has(string $name)
+    {
+        return '' !== $name && $this->reader->read($name)->isDefined();
+    }
+
+    /**
+     * Get an environment variable.
+     *
+     * @param string $name
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return string|null
+     */
+    public function get(string $name)
+    {
+        if ('' === $name) {
+            throw new InvalidArgumentException('Expected name to be a non-empty string.');
+        }
+
+        return $this->reader->read($name)->getOrElse(null);
+    }
+
+    /**
+     * Set an environment variable.
+     *
+     * @param string $name
+     * @param string $value
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return bool
+     */
+    public function set(string $name, string $value)
+    {
+        if ('' === $name) {
+            throw new InvalidArgumentException('Expected name to be a non-empty string.');
+        }
+
+        return $this->writer->write($name, $value);
+    }
+
+    /**
+     * Clear an environment variable.
+     *
+     * @param string $name
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return bool
+     */
+    public function clear(string $name)
+    {
+        if ('' === $name) {
+            throw new InvalidArgumentException('Expected name to be a non-empty string.');
+        }
+
+        return $this->writer->delete($name);
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php b/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php
new file mode 100644
index 0000000..7607924
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php
@@ -0,0 +1,272 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository;
+
+use Dotenv\Repository\Adapter\AdapterInterface;
+use Dotenv\Repository\Adapter\EnvConstAdapter;
+use Dotenv\Repository\Adapter\GuardedWriter;
+use Dotenv\Repository\Adapter\ImmutableWriter;
+use Dotenv\Repository\Adapter\MultiReader;
+use Dotenv\Repository\Adapter\MultiWriter;
+use Dotenv\Repository\Adapter\ReaderInterface;
+use Dotenv\Repository\Adapter\ServerConstAdapter;
+use Dotenv\Repository\Adapter\WriterInterface;
+use InvalidArgumentException;
+use PhpOption\Some;
+use ReflectionClass;
+
+final class RepositoryBuilder
+{
+    /**
+     * The set of default adapters.
+     */
+    private const DEFAULT_ADAPTERS = [
+        ServerConstAdapter::class,
+        EnvConstAdapter::class,
+    ];
+
+    /**
+     * The set of readers to use.
+     *
+     * @var \Dotenv\Repository\Adapter\ReaderInterface[]
+     */
+    private $readers;
+
+    /**
+     * The set of writers to use.
+     *
+     * @var \Dotenv\Repository\Adapter\WriterInterface[]
+     */
+    private $writers;
+
+    /**
+     * Are we immutable?
+     *
+     * @var bool
+     */
+    private $immutable;
+
+    /**
+     * The variable name allow list.
+     *
+     * @var string[]|null
+     */
+    private $allowList;
+
+    /**
+     * Create a new repository builder instance.
+     *
+     * @param \Dotenv\Repository\Adapter\ReaderInterface[] $readers
+     * @param \Dotenv\Repository\Adapter\WriterInterface[] $writers
+     * @param bool                                         $immutable
+     * @param string[]|null                                $allowList
+     *
+     * @return void
+     */
+    private function __construct(array $readers = [], array $writers = [], bool $immutable = false, ?array $allowList = null)
+    {
+        $this->readers = $readers;
+        $this->writers = $writers;
+        $this->immutable = $immutable;
+        $this->allowList = $allowList;
+    }
+
+    /**
+     * Create a new repository builder instance with no adapters added.
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public static function createWithNoAdapters()
+    {
+        return new self();
+    }
+
+    /**
+     * Create a new repository builder instance with the default adapters added.
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public static function createWithDefaultAdapters()
+    {
+        $adapters = \iterator_to_array(self::defaultAdapters());
+
+        return new self($adapters, $adapters);
+    }
+
+    /**
+     * Return the array of default adapters.
+     *
+     * @return \Generator<\Dotenv\Repository\Adapter\AdapterInterface>
+     */
+    private static function defaultAdapters()
+    {
+        foreach (self::DEFAULT_ADAPTERS as $adapter) {
+            $instance = $adapter::create();
+            if ($instance->isDefined()) {
+                yield $instance->get();
+            }
+        }
+    }
+
+    /**
+     * Determine if the given name if of an adapterclass.
+     *
+     * @param string $name
+     *
+     * @return bool
+     */
+    private static function isAnAdapterClass(string $name)
+    {
+        if (!\class_exists($name)) {
+            return false;
+        }
+
+        return (new ReflectionClass($name))->implementsInterface(AdapterInterface::class);
+    }
+
+    /**
+     * Creates a repository builder with the given reader added.
+     *
+     * Accepts either a reader instance, or a class-string for an adapter. If
+     * the adapter is not supported, then we silently skip adding it.
+     *
+     * @param \Dotenv\Repository\Adapter\ReaderInterface|string $reader
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public function addReader($reader)
+    {
+        if (!(\is_string($reader) && self::isAnAdapterClass($reader)) && !($reader instanceof ReaderInterface)) {
+            throw new InvalidArgumentException(
+                \sprintf(
+                    'Expected either an instance of %s or a class-string implementing %s',
+                    ReaderInterface::class,
+                    AdapterInterface::class
+                )
+            );
+        }
+
+        $optional = Some::create($reader)->flatMap(static function ($reader) {
+            return \is_string($reader) ? $reader::create() : Some::create($reader);
+        });
+
+        $readers = \array_merge($this->readers, \iterator_to_array($optional));
+
+        return new self($readers, $this->writers, $this->immutable, $this->allowList);
+    }
+
+    /**
+     * Creates a repository builder with the given writer added.
+     *
+     * Accepts either a writer instance, or a class-string for an adapter. If
+     * the adapter is not supported, then we silently skip adding it.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface|string $writer
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public function addWriter($writer)
+    {
+        if (!(\is_string($writer) && self::isAnAdapterClass($writer)) && !($writer instanceof WriterInterface)) {
+            throw new InvalidArgumentException(
+                \sprintf(
+                    'Expected either an instance of %s or a class-string implementing %s',
+                    WriterInterface::class,
+                    AdapterInterface::class
+                )
+            );
+        }
+
+        $optional = Some::create($writer)->flatMap(static function ($writer) {
+            return \is_string($writer) ? $writer::create() : Some::create($writer);
+        });
+
+        $writers = \array_merge($this->writers, \iterator_to_array($optional));
+
+        return new self($this->readers, $writers, $this->immutable, $this->allowList);
+    }
+
+    /**
+     * Creates a repository builder with the given adapter added.
+     *
+     * Accepts either an adapter instance, or a class-string for an adapter. If
+     * the adapter is not supported, then we silently skip adding it. We will
+     * add the adapter as both a reader and a writer.
+     *
+     * @param \Dotenv\Repository\Adapter\WriterInterface|string $adapter
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public function addAdapter($adapter)
+    {
+        if (!(\is_string($adapter) && self::isAnAdapterClass($adapter)) && !($adapter instanceof AdapterInterface)) {
+            throw new InvalidArgumentException(
+                \sprintf(
+                    'Expected either an instance of %s or a class-string implementing %s',
+                    WriterInterface::class,
+                    AdapterInterface::class
+                )
+            );
+        }
+
+        $optional = Some::create($adapter)->flatMap(static function ($adapter) {
+            return \is_string($adapter) ? $adapter::create() : Some::create($adapter);
+        });
+
+        $readers = \array_merge($this->readers, \iterator_to_array($optional));
+        $writers = \array_merge($this->writers, \iterator_to_array($optional));
+
+        return new self($readers, $writers, $this->immutable, $this->allowList);
+    }
+
+    /**
+     * Creates a repository builder with mutability enabled.
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public function immutable()
+    {
+        return new self($this->readers, $this->writers, true, $this->allowList);
+    }
+
+    /**
+     * Creates a repository builder with the given allow list.
+     *
+     * @param string[]|null $allowList
+     *
+     * @return \Dotenv\Repository\RepositoryBuilder
+     */
+    public function allowList(?array $allowList = null)
+    {
+        return new self($this->readers, $this->writers, $this->immutable, $allowList);
+    }
+
+    /**
+     * Creates a new repository instance.
+     *
+     * @return \Dotenv\Repository\RepositoryInterface
+     */
+    public function make()
+    {
+        $reader = new MultiReader($this->readers);
+        $writer = new MultiWriter($this->writers);
+
+        if ($this->immutable) {
+            $writer = new ImmutableWriter($writer, $reader);
+        }
+
+        if ($this->allowList !== null) {
+            $writer = new GuardedWriter($writer, $this->allowList);
+        }
+
+        return new AdapterRepository($reader, $writer);
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php b/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php
new file mode 100644
index 0000000..d9b18a4
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Repository;
+
+interface RepositoryInterface
+{
+    /**
+     * Determine if the given environment variable is defined.
+     *
+     * @param string $name
+     *
+     * @return bool
+     */
+    public function has(string $name);
+
+    /**
+     * Get an environment variable.
+     *
+     * @param string $name
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return string|null
+     */
+    public function get(string $name);
+
+    /**
+     * Set an environment variable.
+     *
+     * @param string $name
+     * @param string $value
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return bool
+     */
+    public function set(string $name, string $value);
+
+    /**
+     * Clear an environment variable.
+     *
+     * @param string $name
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return bool
+     */
+    public function clear(string $name);
+}