feat: Initial commit

Author: CodeWithKyrian

.github/workflows/tests.yml

@@ -0,0 +1,39 @@
+name: Tests
+
+on: ['push', 'pull_request']
+
+jobs:
+  ci:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        php: [8.1, 8.2, 8.3, 8.4]
+      max-parallel: 4
+
+    name: Tests PHP${{ matrix.php }} - ${{ matrix.os }}
+
+    steps:
+
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.composer/cache/files
+          key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+
+      - name: Install Composer dependencies
+        run: composer update --no-interaction --prefer-dist
+
+      - name: Run Tests
+        run: composer test

.gitignore

@@ -0,0 +1,65 @@
+# Composer dependencies
+/vendor/
+/composer.lock
+
+# PHPUnit
+/phpunit.xml
+.phpunit.result.cache
+
+# PHP CS Fixer
+/.php-cs-fixer.cache
+/.php-cs-fixer.php
+
+# Editor directories and files
+/.idea
+/.vscode
+*.sublime-project
+*.sublime-workspace
+
+# Operating system files
+.DS_Store
+Thumbs.db
+
+# Local environment files
+/.env
+/.env.backup
+/.env.local
+
+# PHP CodeSniffer
+/.phpcs.xml
+/.phpcs.xml.dist
+/phpcs.xml
+/phpcs.xml.dist
+
+# PHPStan
+/phpstan.neon
+/phpstan.neon.dist
+
+# Local development tools
+/.php_cs
+/.php_cs.cache
+/.php_cs.dist
+/_ide_helper.php
+/.php-cs-fixer.php
+
+# Build artifacts
+/build/
+/coverage/
+
+# PHPUnit coverage reports
+/clover.xml
+/coverage.xml
+/coverage/
+
+# Laravel generated files
+bootstrap/cache/
+.phpunit.result.cache
+
+# Local Composer dependencies
+composer.phar
+
+workbench
+playground
+
+# Log files
+*.log

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kyrian Obikwelu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.