Merge branch 'main' into tests-php84

* main: (103 commits)
  Update PHPStan parameters
  Change schedule running
  Fix dutch translations (#231)
  fix: remove additional prompt for name (#227)
  [fix] name mapping in request data classes (#226)
  fix: define getTitle method on Settings pages to use localised name (#224)
  Set OG images
  Fix code styling
  Demo Mode (#223)
  Fix code styling
  fix: make user command does not accept a name argument (#216)
  Apply ordering of component groups to status page
  Use root language for local dialects
  Compile Assets
  Updated PH localization (#213)
  Bump vite from 5.4.8 to 5.4.14 (#214)
  Fix code styling
  Support the `HTTP_REMOTE_USER` header (#208)
  New adjustments added for German translation and added Dutch (#209)
  Fix code styling
  ...

Author: jbrooksuk

.github/workflows/build-api-docs.yml

@@ -0,0 +1,50 @@
+name: Build API Reference
+
+on:
+  schedule:
+    - cron: '0 7 * * *'
+  workflow_dispatch:
+
+env:
+  DOCS_REPOSITORY: cachethq/docs
+  DOCS_BRANCH: 3.x
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.3
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+
+      - name: Install dependencies
+        run: composer install
+
+      - name: Install Scramble PRO
+        run: |
+          composer config repositories.scramble-pro '{"type": "composer", "url": "https://satis.dedoc.co"}'
+          composer config http-basic.satis.dedoc.co ${{ secrets.SCRAMBLE_USERNAME }} ${{ secrets.SCRAMBLE_KEY }}
+          composer require dedoc/scramble-pro:0.7.0-alpha.1 --dev
+
+      - name: Checkout documentation repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.DOCS_API_TOKEN }}
+          repository: ${{ env.DOCS_REPOSITORY }}
+          ref: ${{ env.DOCS_BRANCH }}
+          path: 'docs-repository'
+
+      - name: Build API docs
+        run: php vendor/bin/testbench scramble:export --path=docs-repository/api-reference/openapi.json
+
+      - name: Commit and push generated specification
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "Generated API specification from ${{ github.repository }}/${{ github.ref}}@${{ github.sha }}"
+          repository: "docs-repository"

.github/workflows/run-tests.yml

@@ -98,7 +98,7 @@ jobs:
           DB_USERNAME: cachet
           DB_PASSWORD: password
 
-  postgres:
+  postgres13:
     runs-on: ubuntu-latest
 
     services:
@@ -155,6 +155,120 @@ jobs:
           DB_USERNAME: cachet
           DB_PASSWORD: password
 
+  postgres14:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:14
+        env:
+          POSTGRES_DB: cachet
+          POSTGRES_USER: cachet
+          POSTGRES_PASSWORD: password
+        ports:
+          - 5432:5432
+        options: --health-cmd="pg_isready" --health-interval=10s --health-timeout=5s --health-retries=3
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php: [ 8.3, 8.2 ]
+        laravel: [ 11.x ]
+        stability: [ prefer-lowest, prefer-stable ]
+
+    name: Tests - P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - PostgreSQL 14
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          composer require "laravel/framework:${{ matrix.laravel }}" --no-interaction --no-update
+          composer update --${{ matrix.stability }} --prefer-dist --no-interaction
+
+      - name: Install frontend dependencies
+        run: npm ci
+
+      - name: Build assets
+        run: npm run build
+
+      - name: Build tests environment
+        run: composer build
+
+      - name: Execute tests
+        run: composer test
+        env:
+          DB_CONNECTION: mysql
+          DB_HOST: localhost
+          DB_DATABASE: cachet
+          DB_USERNAME: cachet
+          DB_PASSWORD: password
+
+  postgres15:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_DB: cachet
+          POSTGRES_USER: cachet
+          POSTGRES_PASSWORD: password
+        ports:
+          - 5432:5432
+        options: --health-cmd="pg_isready" --health-interval=10s --health-timeout=5s --health-retries=3
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php: [ 8.3, 8.2 ]
+        laravel: [ 11.x ]
+        stability: [ prefer-lowest, prefer-stable ]
+
+    name: Tests - P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - PostgreSQL 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          composer require "laravel/framework:${{ matrix.laravel }}" --no-interaction --no-update
+          composer update --${{ matrix.stability }} --prefer-dist --no-interaction
+
+      - name: Install frontend dependencies
+        run: npm ci
+
+      - name: Build assets
+        run: npm run build
+
+      - name: Build tests environment
+        run: composer build
+
+      - name: Execute tests
+        run: composer test
+        env:
+          DB_CONNECTION: mysql
+          DB_HOST: localhost
+          DB_DATABASE: cachet
+          DB_USERNAME: cachet
+          DB_PASSWORD: password
+
   sqlite:
     runs-on: ubuntu-latest
     strategy:
@@ -199,7 +313,9 @@ jobs:
     needs:
       - static-analysis
       - mysql
-      - postgres
+      - postgres13
+      - postgres14
+      - postgres15
       - sqlite
     runs-on: ubuntu-latest
 

README.md

@@ -39,10 +39,13 @@ Cachet 3.x is currently in development and is not yet completely ready for produ
 - [ ] Subscribers
 - [x] API
   - Complete but may need some tweaks as we progress.
-- [ ] Webhooks
+- [x] Webhooks
 - [x] Dashboard
 - [x] Localization
-- [ ] Status Page Customization
+- [x] Status Page Customization
+- [ ] Meta
+- [ ] Tags
+- [x] User Management
 
 ## Stack
 
@@ -55,17 +58,7 @@ Cachet is built on:
 
 ## Development
 
-1. Clone this repository.
-2. Run the following commands from within the `core` directory:
-    ```shell
-   npm install
-   composer update
-   composer dev
-    ```
-3. Develop Cachet.
-
-> [!NOTE] 
-> HMR is not enabled. Manual refreshes are needed to view changes.
+To get started developing Cachet, please check out the [Development Guide](https://docs.cachethq.io/v3.x/development).
 
 ### Dashboard Credentials
 
@@ -81,6 +74,7 @@ Login to the account at `/dashboard` and use credentials:
     <a href="https://jump24.co.uk"><img width="100px" src="https://github.com/jumptwentyfour.png" alt="Jump24"></a>
     <a href="https://dreamtilt.com.au"><img width="100px" src="https://github.com/dreamtilt.png" alt="Dreamtilt"></a>
     <a href="https://xyphen-it.nl"><img width="100px" src="https://github.com/xyphen-it.png" alt="Xyphen-IT"></a>
+    <a href="https://coderabbit.ai/"><img width="100px" src="https://github.com/coderabbitai.png" alt="Code Rabbit"></a>
 </p>
 
 ## Security Vulnerabilities

composer.json

@@ -1,23 +1,23 @@
 {
     "name": "cachethq/core",
     "description": "Cachet core package.",
+    "license": "proprietary",
     "keywords": [
         "cachet",
         "status page",
         "laravel"
     ],
-    "homepage": "https://cachethq.io",
-    "license": "proprietary",
-    "support": {
-        "issues": "https://github.com/cachethq/core/issues",
-        "source": "https://github.com/cachethq/core"
-    },
     "authors": [
         {
             "name": "James Brooks",
             "email": "james@alt-three.com"
         }
     ],
+    "homepage": "https://cachethq.io",
+    "support": {
+        "issues": "https://github.com/cachethq/core/issues",
+        "source": "https://github.com/cachethq/core"
+    },
     "require": {
         "php": "^8.2",
         "doctrine/dbal": "^3.6",
@@ -29,21 +29,26 @@
         "illuminate/events": "^11.23.0",
         "illuminate/queue": "^11.23.0",
         "illuminate/support": "^11.23.0",
+        "laravel/sanctum": "^4.0",
         "nesbot/carbon": "^2.70",
         "spatie/laravel-data": "^4.11",
         "spatie/laravel-query-builder": "^5.5",
         "spatie/laravel-settings": "^3.2",
-        "timacdonald/json-api": "^v1.0.0-beta.4",
+        "spatie/laravel-webhook-server": "^3.8",
+        "timacdonald/json-api": "^1.0.0-beta.4",
         "twig/twig": "^3.0"
     },
     "require-dev": {
+        "dedoc/scramble": "0.12.0-alpha.1",
         "larastan/larastan": "^3.0",
         "laravel/pail": "^1.1",
         "orchestra/testbench": "^9.5.1",
         "pestphp/pest": "^3.2",
         "pestphp/pest-plugin-laravel": "^3.0",
         "pestphp/pest-plugin-livewire": "*"
     },
+    "minimum-stability": "dev",
+    "prefer-stable": true,
     "autoload": {
         "psr-4": {
             "Cachet\\": "src",
@@ -53,38 +58,18 @@
     },
     "autoload-dev": {
         "psr-4": {
-            "Cachet\\Tests\\": "tests",
             "Cachet\\Database\\Factories\\": "database/factories",
+            "Cachet\\Tests\\": "tests",
             "Workbench\\App\\": "workbench/app/",
             "Workbench\\Database\\Factories\\": "workbench/database/factories/",
             "Workbench\\Database\\Seeders\\": "workbench/database/seeders/"
         }
     },
-    "scripts": {
-        "post-autoload-dump": "@prepare",
-        "test": "vendor/bin/pest",
-        "canvas": "@php vendor/bin/canvas",
-        "clear": "@php vendor/bin/testbench package:purge-skeleton --ansi",
-        "prepare": "@php vendor/bin/testbench package:discover --ansi",
-        "build": [
-            "@prepare",
-            "@clear",
-            "@php vendor/bin/testbench workbench:build"
-        ],
-        "dev": [
-            "@build",
-            "Composer\\Config::disableProcessTimeout",
-            "npx concurrently -c \"#93c5fd,#c4b5fd,#fb7185,#fdba74\" \"php vendor/bin/testbench serve\" \"php vendor/bin/testbench queue:listen --tries=1\" \"php vendor/bin/testbench pail\" \"npm run dev\" --names=server,queue,logs,vite"
-        ],
-        "start": [
-            "@dev"
-        ]
-    },
     "config": {
-        "sort-packages": true,
         "allow-plugins": {
             "pestphp/pest-plugin": true
-        }
+        },
+        "sort-packages": true
     },
     "extra": {
         "branch-alias": {
@@ -97,6 +82,24 @@
             ]
         }
     },
-    "minimum-stability": "dev",
-    "prefer-stable": true
+    "scripts": {
+        "post-autoload-dump": "@prepare",
+        "build": [
+            "@prepare",
+            "@clear",
+            "@php vendor/bin/testbench workbench:build"
+        ],
+        "canvas": "@php vendor/bin/canvas",
+        "clear": "@php vendor/bin/testbench package:purge-skeleton --ansi",
+        "dev": [
+            "@build",
+            "Composer\\Config::disableProcessTimeout",
+            "npx concurrently -c \"#93c5fd,#c4b5fd,#fb7185,#fdba74\" \"php vendor/bin/testbench serve\" \"php vendor/bin/testbench queue:listen --tries=1\" \"php vendor/bin/testbench pail\" \"npm run dev\" --names=server,queue,logs,vite"
+        ],
+        "prepare": "@php vendor/bin/testbench package:discover --ansi",
+        "start": [
+            "@dev"
+        ],
+        "test": "vendor/bin/pest"
+    }
 }