Release 0.8.0

.github/workflows/ci.yml

@@ -2,29 +2,150 @@ name: CI
 
 on:
   push:
+    branches: [master]
   pull_request:
 
 jobs:
-  test:
+  sqlite:
+    name: SQLite / PHP ${{ matrix.php-version }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        php-version: ['8.1', '8.2', '8.3']
+        php-version: ['8.2', '8.3', '8.4']
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-version }}
+          extensions: pdo_sqlite
           coverage: none
           tools: composer:v2
 
       - name: Install dependencies
         run: composer update --prefer-dist --no-interaction
 
-      - name: Run tests
-        run: vendor/bin/phpunit
+      - name: Run SQLite tests
+        env:
+          TEST_DB_DRIVER: sqlite
+        run: vendor/bin/phpunit --testsuite sqlite
+
+  sqlite-lowest:
+    name: SQLite / PHP 8.2 / lowest dependencies
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          extensions: pdo_sqlite
+          coverage: none
+          tools: composer:v2
+
+      - name: Validate Composer metadata
+        run: composer validate --strict
+
+      - name: Install lowest compatible dependencies
+        run: composer update --prefer-lowest --prefer-stable --prefer-dist --no-interaction
+
+      - name: Run SQLite tests
+        env:
+          TEST_DB_DRIVER: sqlite
+        run: vendor/bin/phpunit --testsuite sqlite
+
+  mysql:
+    name: MySQL / PHP ${{ matrix.php-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php-version: ['8.2', '8.3', '8.4']
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: objectiveweb_test
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -proot"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=20
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions: pdo_mysql
+          coverage: none
+          tools: composer:v2
+
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-interaction
+
+      - name: Run MySQL tests
+        env:
+          TEST_DB_DRIVER: mysql
+          MYSQL_TEST_DSN: mysql:dbname=objectiveweb_test;host=127.0.0.1;port=3306;charset=utf8mb4
+          MYSQL_TEST_USER: root
+          MYSQL_TEST_PASSWORD: root
+        run: vendor/bin/phpunit --testsuite mysql
+
+  pgsql:
+    name: PostgreSQL / PHP ${{ matrix.php-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php-version: ['8.2', '8.3', '8.4']
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_USER: postgres
+          POSTGRES_DB: objectiveweb_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready -U postgres -d objectiveweb_test"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=20
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions: pdo_pgsql
+          coverage: none
+          tools: composer:v2
+
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-interaction
+
+      - name: Run PostgreSQL tests
+        env:
+          TEST_DB_DRIVER: pgsql
+          PGSQL_TEST_DSN: pgsql:dbname=objectiveweb_test;host=127.0.0.1;port=5432
+          PGSQL_TEST_USER: postgres
+          PGSQL_TEST_PASSWORD: postgres
+        run: vendor/bin/phpunit --testsuite pgsql

CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The project follows Semantic Versioning.
+
+## 0.8.0
+
+Major modernization release of Objectiveweb DB. This is a pre-1.0 release and contains breaking changes from 0.7.
+
+### Added
+
+- Doctrine DBAL-based database abstraction with SQLite, MySQL, and PostgreSQL support.
+- Table API with CRUD operations, filtering, sorting, ranges, joins, grouping, aggregates, and row locking.
+- Optional model mapping through the public `Model` extension API, with field filtering and validation rules.
+- Table inheritance across base and child tables with transactional writes.
+- Structured SQL expressions through the public `Expr` API.
+- Transaction helpers and typed database exceptions.
+- Connection health checking and reconnection support.
+- Collection pagination metadata through `total()` and `contentRange()`.
+- Stable `Query::exec()` semantics: DBAL `Result::rowCount()` for result-set queries and affected-row count for statement queries.
+- Multi-database Docker test environment.
+- GitHub Actions coverage for SQLite, MySQL, and PostgreSQL on every supported PHP version.
+
+### Safety
+
+- Table and field identifiers are validated before SQL generation.
+- Raw string WHERE clauses are rejected.
+- UPDATE and DELETE operations without conditions are rejected.
+- Query values are passed through parameter bindings.
+
+### Compatibility
+
+- PHP 8.2, 8.3, and 8.4.
+- Doctrine DBAL 4.x.
+- SQLite.
+- MySQL 8.4.
+- PostgreSQL 16.
+
+Doctrine DBAL 4.x compatibility is part of the Objectiveweb DB 0.8.x compatibility target.
+
+The documented 0.8.x public API includes `Objectiveweb\\DB`, `Table`, `Collection`, `Query`, `Model`, and `Expr`, including the documented CRUD return contracts. Patch releases in the 0.8.x series should preserve these contracts.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guilherme Barile
+
+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.