IBX-7057: Provided Notifications API (#1)

Co-authored-by: Andrew Longosz <alongosz@users.noreply.github.com>
Co-authored-by: Konrad Oboza <konrad.oboza@ibexa.co>

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "eslint-config-ibexa/eslint"
+}

.github/pull_request_template.md

@@ -1,16 +1,16 @@
-| Question                       | Answer                                                |
-|--------------------------------|-------------------------------------------------------|
-| **JIRA issue**                 | [IBX-XXXXX](https://issues.ibexa.co/browse/IBX-XXXXX) |
-| **Type**                       | feature/bug/improvement                               |
-| **Target eZ Platform version** | `v4.x` - please update `x` accordingly                |
-| **BC breaks**                  | yes/no                                                |
-| **Doc needed**                 | yes/no                                                |
+| Question                 | Answer                                              |
+|--------------------------|-----------------------------------------------------|
+| **JIRA issue**           | [IBX-XXXX](https://issues.ibexa.co/browse/IBX-XXXX) |
+| **Type**                 | feature/bug/improvement                             |
+| **Target Ibexa version** | `v4.6`                                              |
+| **BC breaks**            | yes/no                                              |
 
 <!-- Replace this comment with Pull Request description -->
 
 #### Checklist:
 - [ ] Provided PR description.
 - [ ] Tested the solution manually.
 - [ ] Provided automated test coverage.
-- [ ] Checked that target branch is set correctly (master for features, the oldest supported for bugs).
-- [ ] Asked for a review (ping `@ibexa/engineering`).
+- [ ] Checked that target branch is set correctly (main for features, the oldest supported for bugs).
+- [ ] Ran PHP CS Fixer for new PHP code (use `$ composer fix-cs`).
+- [ ] Asked for a review (ping for example `@ibexa/php-dev` for back-end changes and/or `@ibexa/javascript-dev` for front-end changes).

.github/workflows/backend-ci.yaml

@@ -0,0 +1,184 @@
+name: Backend build
+
+on:
+    push:
+        branches:
+            - main
+            - '[0-9]+.[0-9]+'
+    pull_request: ~
+
+jobs:
+    cs-fix:
+        name: Run code style check
+        runs-on: "ubuntu-22.04"
+        strategy:
+            matrix:
+                php:
+                    - '8.1'
+        steps:
+            -   uses: actions/checkout@v3
+
+            -   name: Setup PHP Action
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+                    extensions: 'pdo_sqlite, gd'
+                    tools: cs2pr
+
+            -   uses: ramsey/composer-install@v2
+                with:
+                    dependency-versions: "highest"
+
+            -   name: Run code style check
+                run: composer run-script check-cs -- --format=checkstyle | cs2pr
+
+    deptrac:
+        name: Deptrac
+        runs-on: ubuntu-latest
+        steps:
+            -   uses: actions/checkout@v3
+            -   name: Deptrac
+                uses: smoench/deptrac-action@master
+
+    tests:
+        name: Tests
+        runs-on: "ubuntu-22.04"
+        timeout-minutes: 10
+
+        strategy:
+            fail-fast: false
+            matrix:
+                php:
+                    - '7.4'
+                    - '8.1'
+                    - '8.2'
+
+        steps:
+            -   uses: actions/checkout@v3
+
+            -   name: Setup PHP Action
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+                    extensions: pdo_sqlite, gd
+                    tools: cs2pr
+
+            -   uses: ramsey/composer-install@v2
+                with:
+                    dependency-versions: "highest"
+                    composer-options: "--prefer-dist --no-progress --no-suggest"
+
+            -   name: Setup problem matchers for PHPUnit
+                run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+            -   name: Run PHPStan analysis
+                run: composer run-script phpstan
+
+            -   name: Run test suite
+                run: composer run-script --timeout=600 test
+
+    integration-tests-postgres:
+        name: PostgreSQL integration tests
+        needs: tests
+        services:
+            postgres:
+                image: postgres:10
+                ports:
+                    - 5432
+                env:
+                    POSTGRES_PASSWORD: postgres
+                    POSTGRES_DB: testdb
+                options: >-
+                    --health-cmd pg_isready
+                    --health-interval 10s
+                    --health-timeout 5s
+                    --health-retries 5
+                    --tmpfs /var/lib/postgres
+        runs-on: "ubuntu-22.04"
+        timeout-minutes: 10
+
+        strategy:
+            fail-fast: false
+            matrix:
+                php:
+                    - '7.4'
+                    - '8.1'
+                    - '8.2'
+
+        steps:
+            -   uses: actions/checkout@v3
+
+            -   name: Setup PHP Action
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+                    extensions: pdo_pgsql, gd
+                    tools: cs2pr
+
+            -   uses: ramsey/composer-install@v2
+                with:
+                    dependency-versions: "highest"
+
+            -   name: Setup problem matchers for PHPUnit
+                run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+            -   name: Run integration test suite vs Postgresql
+                run: composer run-script --timeout=600 test -- --testsuite integration
+                env:
+                    DATABASE_URL: "pgsql://postgres:postgres@localhost:${{ job.services.postgres.ports[5432] }}/testdb?server_version=10"
+
+    integration-tests-mysql:
+        name: MySQL integration tests
+        needs: tests
+        services:
+            mysql:
+                image: ghcr.io/ibexa/core/mysql
+                ports:
+                    - 3306/tcp
+                env:
+                    MYSQL_RANDOM_ROOT_PASSWORD: true
+                    MYSQL_USER: mysql
+                    MYSQL_PASSWORD: mysql
+                    MYSQL_DATABASE: testdb
+                options: >-
+                    --health-cmd="mysqladmin ping"
+                    --health-interval=10s
+                    --health-timeout=5s
+                    --health-retries=5
+                    --tmpfs=/var/lib/mysql
+        runs-on: "ubuntu-22.04"
+        timeout-minutes: 10
+
+        strategy:
+            fail-fast: false
+            matrix:
+                php:
+                    - '7.4'
+                    - '8.1'
+                    - '8.2'
+
+        steps:
+            -   uses: actions/checkout@v3
+
+            -   name: Setup PHP Action
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+                    extensions: pdo_mysql, gd, redis
+                    tools: cs2pr
+
+            -   uses: ramsey/composer-install@v2
+                with:
+                    dependency-versions: "highest"
+
+            -   name: Setup problem matchers for PHPUnit
+                run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+            -   name: Run integration test suite vs MySQL
+                run: composer run-script --timeout=600 test -- --testsuite integration
+                env:
+                    DATABASE_URL: "mysql://mysql:mysql@127.0.0.1:${{ job.services.mysql.ports[3306] }}/testdb"

.github/workflows/pr-check.yaml

@@ -2,7 +2,7 @@
 name: PR check
 on:
   pull_request:
-    types: 
+    types:
       - opened
       - synchronize
       - reopened

.github/workflows/release.yaml

@@ -1,6 +1,6 @@
 name: Call Automatic Changelog Generator for tag Workflow
 
-on:  
+on:
   push:
     tags:
       - 'v*'

.gitignore

@@ -0,0 +1,7 @@
+/.php-cs-fixer.cache
+/.phpunit.result.cache
+/composer.lock
+/node_modules/
+/vendor
+/yarn.lock
+/var

.php-cs-fixer.php

@@ -0,0 +1,14 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+return \Ibexa\CodeStyle\PhpCsFixer\InternalConfigFactory::build()->setFinder(
+    PhpCsFixer\Finder::create()
+        ->in(__DIR__ . '/src')
+        ->in(__DIR__ . '/tests')
+        ->files()->name('*.php')
+);

COPYRIGHT

@@ -3,7 +3,7 @@ Copyright (C) 1999-2023 Ibexa AS (formerly eZ Systems AS). All rights reserved.
 This source code is available separately under the following licenses:
 
 A - Ibexa Business Use License Agreement (Ibexa BUL),
-version 2.3 or later versions (as license terms may be updated from time to time)
+version 2.4 or later versions (as license terms may be updated from time to time)
 Ibexa BUL is granted by having a valid Ibexa DXP (formerly eZ Platform Enterprise) subscription,
 as described at: https://www.ibexa.co/product
 For the full Ibexa BUL license text, please see:
@@ -12,9 +12,7 @@ For the full Ibexa BUL license text, please see:
 
 AND
 
-B - Ibexa Trial and Test License Agreement (Ibexa TTL),
-version 2.2 or later versions (as license terms may be updated from time to time)
-Trial can be granted by Ibexa, reach out to Ibexa AS for evaluation access: https://www.ibexa.co/about-ibexa/contact-us
-For the full Ibexa TTL license text, please see:
+B - GNU General Public License, version 2
+Grants an copyleft open source license with ABSOLUTELY NO WARRANTY. For the full GPL license text, please see:
 - LICENSE file placed in the root of this source code, or
-- https://www.ibexa.co/software-information/licenses-and-agreements (latest version applies)
+- https://www.gnu.org/licenses/old-licenses/gpl-2.0.html