feat: add automation, linting and improve DX

.build/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

.editorconfig

@@ -11,10 +11,8 @@ trim_trailing_whitespace = true
 [*.md]
 trim_trailing_whitespace = false
 
-[*.yml]
-indent_style = space
+[*.{yml,yaml}]
 indent_size = 2
 
-[*.json]
-indent_style = space
-indent_size = 4
+[Makefile]
+indent_style = tab

.env.example

@@ -0,0 +1,21 @@
+# https://docs.docker.com/compose/reference/envvars/#compose_project_name
+# With custom namespace provided, it will be used to prefix all services
+# in Docker network for current project
+COMPOSE_PROJECT_NAME=cycle-database
+APP_ENV=production
+
+DB_CONNECTION=pgsql
+DB_HOST=pgsql
+DB_PORT=5432
+
+DB_DATABASE=default
+DB_USERNAME=root
+DB_PASSWORD=Strong(!)Password
+
+DB_SQLSERVER_FORWARD_PORT=11433
+DB_MYSQL_FORWARD_PORT=13306
+DB_PGSQL_FORWARD_PORT=15432
+
+XDEBUG_MODE=coverage
+
+GITHUB_TOKEN=ghp_

.gitattributes

@@ -1,5 +1,21 @@
-/.github        export-ignore
-/.editorconfig  export-ignore
-/.gitattributes export-ignore
-/.gitignore     export-ignore
-/tests          export-ignore
+/.build                         export-ignore
+/.github                        export-ignore
+/.phive/                        export-ignore
+/tests                          export-ignore
+.editorconfig                   export-ignore
+.env.example                    export-ignore
+.gitattributes                  export-ignore
+.gitignore                      export-ignore
+.php-cs-fixer.dist.php          export-ignore
+.pre-commit-config.yaml         export-ignore
+.scrutinizer.yml                export-ignore
+.styleci.yml                    export-ignore
+.yamllint.yaml                  export-ignore
+composer.lock                   export-ignore
+composer-require-checker.json   export-ignore
+docker-compose.yaml             export-ignore
+infection.json.dist             export-ignore
+Makefile                        export-ignore
+phpunit.xml                     export-ignore
+psalm.xml                       export-ignore
+psalm-baseline.xml              export-ignore

.github/.release-please-config.json

@@ -0,0 +1,72 @@
+{
+    "release-type": "node",
+    "packages": {
+        ".": {
+            "package-name": "database",
+            "changelog-path": "/CHANGELOG.md"
+        }
+    },
+    "include-component-in-tag": false,
+    "changelog-sections": [
+        {
+            "type": "feat",
+            "section": "Features",
+            "hidden": false
+        },
+        {
+            "type": "fix",
+            "section": "Bug Fixes",
+            "hidden": false
+        },
+        {
+            "type": "perf",
+            "section": "Performance Improvements",
+            "hidden": false
+        },
+        {
+            "type": "docs",
+            "section": "Documentation",
+            "hidden": false
+        },
+        {
+            "type": "chore",
+            "section": "Miscellaneous",
+            "hidden": false
+        },
+        {
+            "type": "style",
+            "section": "Styles",
+            "hidden": true
+        },
+        {
+            "type": "revert",
+            "section": "Reverts",
+            "hidden": true
+        },
+        {
+            "type": "deps",
+            "section": "Dependencies",
+            "hidden": false
+        },
+        {
+            "type": "refactor",
+            "section": "Code Refactoring",
+            "hidden": false
+        },
+        {
+            "type": "test",
+            "section": "Tests",
+            "hidden": true
+        },
+        {
+            "type": "build",
+            "section": "Build System",
+            "hidden": true
+        },
+        {
+            "type": "ci",
+            "section": "Continuous Integration",
+            "hidden": true
+        }
+    ]
+}

.github/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+    ".": "3.0.0"
+}

.github/labeler.yml

@@ -0,0 +1,14 @@
+---
+
+# this file is for the labeler workflow job
+# Documentation https://github.com/marketplace/actions/labeler
+
+"type: documentation":
+  - changed-files:
+      - any-glob-to-any-file: [resources/*, .github/*, ./*.md]
+
+"type: maintenance":
+  - changed-files:
+      - any-glob-to-any-file: [tests/**/*, .github/workflows/*]
+
+...

.github/workflows/apply-labels.yml

@@ -0,0 +1,23 @@
+---
+
+# This workflow will triage pull requests and apply a label based on the
+# paths that are modified in the pull request.
+#
+# To use this workflow, you will need to set up a .github/labeler.yml
+# file with configuration. For more information, see:
+# https://github.com/actions/labeler/blob/master/README.md
+
+on:  # yamllint disable-line rule:truthy
+  pull_request:
+
+name: 🏷️ Add labels
+
+jobs:
+  label:
+    uses: wayofdev/gh-actions/.github/workflows/apply-labels.yml@master
+    with:
+      os: ubuntu-latest
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}
+
+...

.github/workflows/ci-mssql.yml

@@ -1,88 +1,78 @@
-on:
-  push:
+---
+
+on:  # yamllint disable-line rule:truthy
+  pull_request:
     branches:
-      - master
-      - '*.*'
-      - '*.*.*'
-  pull_request: null
+      - 2.x
 
-name: ci-mssql
+name: 🔍 Integration with SQLServer
 
 jobs:
-  tests:
-    name: PHP ${{ matrix.php }}-mssql-${{ matrix.mssql }}
-
-    env:
-      key: cache
-
-    runs-on: ubuntu-latest
-
+  test-mssql:
+    timeout-minutes: 4
+    runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: false
+      fail-fast: true
       matrix:
-        include:
-          - php: '8.0'
-            extensions: pdo, pdo_sqlsrv
-            mssql: 'server:2017-latest'
-          - php: '8.0'
-            extensions: pdo, pdo_sqlsrv
-            mssql: 'server:2019-latest'
-          - php: '8.1'
-            extensions: pdo, pdo_sqlsrv
-            mssql: 'server:2019-latest'
-          - php: '8.2'
-            extensions: pdo, pdo_sqlsrv
-            mssql: 'server:2019-latest'
-          - php: '8.3'
-            extensions: pdo, pdo_sqlsrv
-            mssql: 'server:2019-latest'
+        os:
+          - 'ubuntu-latest'
+        php-version:
+          - '8.2'
+        dependencies:
+          - locked
+        mssql-version:
+          - latest
 
     services:
       mssql:
-          image: mcr.microsoft.com/mssql/${{ matrix.mssql }}
-          env:
-              SA_PASSWORD: SSpaSS__1
-              ACCEPT_EULA: Y
-              MSSQL_PID: Developer
-          ports:
-              - 11433:1433
-          options: --name=mssql --health-cmd="/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'SSpaSS__1' -Q 'SELECT 1'" --health-interval=10s --health-timeout=5s --health-retries=3
+        image: mcr.microsoft.com/mssql/server:2019-latest
+        env:
+          ACCEPT_EULA: 'Y'
+          SA_PASSWORD: 'SSpaSS__1'
+        ports:
+          - 11433:1433
 
     steps:
-      - name: Checkout
-        uses: actions/checkout@v2
+      - name: 📦 Check out the codebase
+        uses: actions/checkout@v4.1.1
 
-      - name: Install PHP with extensions
-        uses: shivammathur/setup-php@v2
+      - name: 🛠️ Setup PHP
+        uses: shivammathur/setup-php@2.30.1
         with:
-          php-version: ${{ matrix.php }}
-          extensions: ${{ matrix.extensions }}
-          ini-values: date.timezone='UTC'
-          tools: composer:v2, pecl
+          php-version: ${{ matrix.php-version }}
+          extensions: mbstring, pdo, pdo_sqlite, pdo_sqlsrv, json
+          ini-values: error_reporting=E_ALL
+          coverage: none
 
-      - name: Determine composer cache directory on Linux
-        run: echo "COMPOSER_CACHE_DIR=$(composer config cache-dir)" >> $GITHUB_ENV
+      - name: 🛠️ Setup problem matchers
+        run: |
+          echo "::add-matcher::${{ runner.tool_cache }}/php.json"
+          echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
 
-      - name: Cache dependencies installed with composer
-        uses: actions/cache@v2
+      - name: 🤖 Validate composer.json and composer.lock
+        run: composer validate --ansi --strict
+
+      - name: 🔍 Get composer cache directory
+        uses: wayofdev/gh-actions/actions/composer/get-cache-directory@master
+
+      - name: ♻️ Restore cached dependencies installed with composer
+        uses: actions/[email protected]
         with:
           path: ${{ env.COMPOSER_CACHE_DIR }}
-          key: php${{ matrix.php }}-composer-${{ hashFiles('**/composer.json') }}
-          restore-keys: |
-            php${{ matrix.php }}-composer-
+          key: php-${{ matrix.php-version }}-composer-${{ matrix.dependencies }}-${{ hashFiles('composer.lock') }}
+          restore-keys: php-${{ matrix.php-version }}-composer-${{ matrix.dependencies }}-
 
-      - name: Update composer
-        run: composer self-update
+      - name: 🗑️ Remove PHP platform configuration
+        if: "matrix.dependencies != 'locked'"
+        run: composer config platform.php --ansi --unset
 
-      - name: Install dependencies with composer
-        if: matrix.php != '8.3'
-        run: composer update --prefer-dist --no-interaction --no-progress --optimize-autoloader --ansi
+      - name: 📥 Install "${{ matrix.dependencies }}" dependencies
+        uses: wayofdev/gh-actions/actions/composer/install@master
+        with:
+          dependencies: ${{ matrix.dependencies }}
 
-      - name: Install dependencies with composer php 8.3
-        if: matrix.php == '8.3'
-        run: composer update --ignore-platform-reqs --prefer-dist --no-interaction --no-progress --optimize-autoloader --ansi
+      - name: 🧪 Run unit tests with phpunit
+        run: php vendor/bin/phpunit --colors=always --testsuite=Unit
 
-      - name: Run tests with phpunit without coverage
-        env:
-          DB: sqlserver
-        run: vendor/bin/phpunit --group driver-sqlserver --colors=always
+      - name: 🧪 Run integration tests with phpunit
+        run: php vendor/bin/phpunit --colors=always --testsuite=DBAL --group driver-sqlserver