chore: initial import

Author: jaine

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        db: [mysql, postgres]
+
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: blackcat_test
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -uroot -proot"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: blackcat_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready -U postgres -d blackcat_test -h 127.0.0.1"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: mbstring, json, dom, pdo, pdo_mysql, pdo_pgsql, sodium
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --no-interaction --no-progress --prefer-dist
+
+      - name: Init blackcat-database packages
+        run: |
+          git -C vendor/blackcatacademy/blackcat-database submodule update --init packages/auth-events packages/device-codes packages/email-verifications packages/login-attempts packages/magic-links packages/notifications packages/password-resets packages/rate-limit-counters packages/register-events packages/sessions packages/tenants packages/users packages/verify-events packages/webauthn-challenges packages/webauthn-credentials
+          composer dump-autoload -o
+
+      - name: Static analysis
+        run: vendor/bin/phpstan analyse --configuration=phpstan.neon --memory-limit=1G
+
+      - name: Tests (unit + integration)
+        env:
+          DB_DSN: ${{ matrix.db == 'mysql' && 'mysql:host=127.0.0.1;port=3306;dbname=blackcat_test;charset=utf8mb4' || 'pgsql:host=127.0.0.1;port=5432;dbname=blackcat_test' }}
+          DB_USER: ${{ matrix.db == 'mysql' && 'root' || 'postgres' }}
+          DB_PASSWORD: ${{ matrix.db == 'mysql' && 'root' || 'postgres' }}
+        run: vendor/bin/phpunit

.gitignore

@@ -0,0 +1,15 @@
+/.idea/
+/.vscode/
+/.DS_Store
+
+# Dependencies
+/vendor/
+
+# Caches / tooling
+/.phpunit.cache/
+/.phpunit.result.cache
+/var/
+
+# Reports / builds
+/coverage/
+/build/

README.md

@@ -0,0 +1,17 @@
+#!/usr/bin/env php
+<?php
+declare(strict_types=1);
+
+require __DIR__ . '/../vendor/autoload.php';
+
+use BlackCat\Auth\CLI\Application;
+use BlackCat\Auth\Foundation\AuthRuntime;
+use Psr\Log\NullLogger;
+
+$configPath = $argv[1] ?? getenv('BLACKCAT_AUTH_CONFIG') ?? __DIR__ . '/../config/example.auth.php';
+$command = $argv[2] ?? 'help';
+$args = array_slice($argv, 3);
+
+$runtime = AuthRuntime::fromFile($configPath, new NullLogger());
+$app = new Application($runtime);
+exit($app->run($command, $args));