Merge branch 'tempestphp:main' into read-file-locking

Author: ewingd

.github/workflows/integration-tests.yml

@@ -89,6 +89,10 @@ jobs:
       - name: Install dependencies
         run: composer update --${{ matrix.stability }} --prefer-dist --no-interaction
 
+      - name: "Setup Redis"
+        if: ${{ matrix.os != 'windows-latest' }}
+        uses: supercharge/[email protected]
+
       - name: "Setup MySQL"
         if: ${{ matrix.database == 'mysql' }}
         uses: ankane/setup-mysql@v1
@@ -104,7 +108,7 @@ jobs:
         run: php -r "copy('tests/Fixtures/Config/database.${{ matrix.database }}.php', 'tests/Fixtures/Config/database.config.php');"
 
       - name: Tempest about
-        run: php ./tempest about
+        run: php ./tempest about -v
 
       - name: List discovered locations
         run: php ./tempest discovery:status

CHANGELOG.md

@@ -2,7 +2,47 @@
 
 All notable changes to this project will be documented in this file.
 
-## [1.2.2](https://github.com/tempestphp/tempest-framework/compare/v1.2.1..1.2.2)  —  2025-07-08
+## [1.4.0](https://github.com/tempestphp/tempest-framework/compare/v1.3.1..1.4.0)  —  2025-07-17
+
+### 🚀 Features
+
+- **auth**: add class-level permission support (#1405) ([1404246](https://github.com/tempestphp/tempest-framework/commit/14042463f81e6915a61212abaf468a351ca5b2b9))
+- **mailer**: introduce mailer component (#1227) ([3f5f31e](https://github.com/tempestphp/tempest-framework/commit/3f5f31eacfc80a6ba8ac724f042eefd5cf8e6412))
+- **support**: add json encode/decode to array and string utilities (#1396) ([978bba2](https://github.com/tempestphp/tempest-framework/commit/978bba2d3f5017c4c90920d272c2c3d143aa2485))
+- **vite**: inject react refresh when needed (#1406) ([b57bf7f](https://github.com/tempestphp/tempest-framework/commit/b57bf7f9c79179f7135c1eb72894406d80d6a606))
+
+### 🐛 Bug fixes
+
+- **mail**: fix typos (#1410) ([0e29b0e](https://github.com/tempestphp/tempest-framework/commit/0e29b0e83be94a968d4f004d87191ad70b385f3d))
+- **mailer**: small tweaks and bugfixes (#1408) ([f80536a](https://github.com/tempestphp/tempest-framework/commit/f80536a5ba5784978df9cad9cc8453be564b0110))
+- **vite**: exclude `.tempest` from vite's file watcher (#1384) ([e1bdcf2](https://github.com/tempestphp/tempest-framework/commit/e1bdcf2daedcdd2076b33048de2bcd963a403dca))
+
+
+## [1.3.0](https://github.com/tempestphp/tempest-framework/compare/v1.2.3..v1.3.0)  —  2025-07-10
+
+### 🚀 Features
+
+- **database**: run `migrate:fresh` without validation by default (#1390) ([665c825](https://github.com/tempestphp/tempest-framework/commit/665c825230a6803e0e52a64d08c28623aa267b48))
+
+### 🐛 Bug fixes
+
+- **commandbus**: require console as a dependency (#1397) ([e56cb6d](https://github.com/tempestphp/tempest-framework/commit/e56cb6d72678e632c413c01ba7dc317396f1e7ba))
+- **router**: change the `Bindable::resolve` return type from `static` to `self` (#1391) ([3ac0e3a](https://github.com/tempestphp/tempest-framework/commit/3ac0e3aa0489ecd57e0d7dbe23c7e84ad392bfa2))
+- **view**: remove multiline comments before AST parsing (#1395) ([f2c03df](https://github.com/tempestphp/tempest-framework/commit/f2c03df89977fdf0008b40c1777f31cde91108ca))
+
+### 🚜 Refactor
+
+- **mapper**: remove redundant string check (#1393) ([9d0bf46](https://github.com/tempestphp/tempest-framework/commit/9d0bf46854e55eb22b9572847c8e000bddd3a2e3))
+
+
+## [1.2.3](https://github.com/tempestphp/tempest-framework/compare/v1.2.2..v1.2.3)  —  2025-07-08
+
+### 🐛 Bug fixes
+
+- **database**: fix datetime serialization for mysql database (#1383) ([dde0e84](https://github.com/tempestphp/tempest-framework/commit/dde0e84a6bba614c4fa3932914ffaee2dd4916e7))
+
+
+## [1.2.2](https://github.com/tempestphp/tempest-framework/compare/v1.2.1..v1.2.2)  —  2025-07-08
 
 ### 🚀 Features
 

bin/release

@@ -18,7 +18,7 @@ use Composer\Semver\VersionParser;
 use Tempest\Console\Console;
 use Tempest\Console\ConsoleApplication;
 use Tempest\Console\Exceptions\InterruptException;
-use Tempest\Http\Status;
+use Tempest\Http\Response;
 use Tempest\HttpClient\HttpClient;
 use Tempest\Support\Json;
 
@@ -168,28 +168,51 @@ function performPreReleaseChecks(string $remote, string $branch): void
     }
 }
 
-/** 
+/**
  * Disables the protection ruleset, so the release branch can be pushed to without a pull request.
  */
 function updateBranchProtection(bool $enabled): void
 {
     // https://github.com/tempestphp/tempest-framework/settings/rules/1879240
     $ruleset = '1879240';
     $token = Tempest\env('RELEASE_GITHUB_TOKEN');
-    $url = "https://api.github.com/repos/tempestphp/tempest-framework/rulesets/{$ruleset}";
+    $uri = "https://api.github.com/repos/tempestphp/tempest-framework/rulesets/{$ruleset}";
 
     $httpClient = Tempest\get(HttpClient::class);
     $response = $httpClient->put(
-        uri: $url, 
+        uri: $uri,
         headers: ['Authorization' => "Bearer {$token}"],
-        body: Json\encode(['enforcement' => $enabled ? 'active' : 'disabled'])
+        body: Json\encode(['enforcement' => $enabled ? 'active' : 'disabled']),
     );
 
-    if ($response->status !== Status::OK) {
+    if (! $response->status->isSuccessful()) {
         throw new Exception('Failed to update branch ruleset.');
     }
 }
 
+function triggerSubsplit(): void
+{
+    $token = Tempest\env('RELEASE_GITHUB_TOKEN');
+    $uri = 'https://api.github.com/repos/tempestphp/tempest-framework/actions/workflows/subsplit-packages.yml/dispatches';
+
+    $httpClient = Tempest\get(HttpClient::class);
+
+    $response = $httpClient->post(
+        uri: $uri,
+        headers: [
+            'Authorization' => "Bearer {$token}",
+            'Accept' => 'application/vnd.github+json',
+            'X-GitHub-Api-Version' => '2022-11-28',
+        ],
+        body: Json\encode(['ref' => 'main']),
+    );
+
+    if (! $response->status->isSuccessful()) {
+        throw new Exception('Failed to update branch ruleset.');
+    }
+}
+
+
 /**
  * Gets the current version.
  */
@@ -210,9 +233,9 @@ function suggestNextVersions(string $current): array
     }
 
     $isStable = ! isset($matches[4]);
-    $major = (int) $matches[1];
-    $minor = (int) $matches[2];
-    $patch = (int) $matches[3];
+    $major = (int)$matches[1];
+    $minor = (int)$matches[2];
+    $patch = (int)$matches[3];
 
     // Current version is stable
     if ($isStable) {
@@ -280,8 +303,8 @@ function updateJsonFile(string $path, Closure $callback): void
     $content = $callback(json_decode($content, associative: true), $indent);
     $content = preg_replace_callback(
         '/^ +/m',
-        fn ($m) => str_repeat($indent, \strlen($m[0]) / 4),
-        json_encode($content, \JSON_PRETTY_PRINT | \JSON_UNESCAPED_SLASHES),
+        fn ($m) => str_repeat($indent, strlen($m[0]) / 4),
+        json_encode($content, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES),
     );
 
     file_put_contents($path, $content . "\n");
@@ -329,13 +352,13 @@ try {
     $new = $console->ask(
         question: 'What should the new version be?',
         options: arr(suggestNextVersions($current))
-            ->map(fn (string $version, string $type) => (string) str($type)->replace('_', ' ')->append(': ', $version))
+            ->map(fn (string $version, string $type) => (string)str($type)->replace('_', ' ')->append(': ', $version))
             ->values()
             ->toArray(),
     );
 
     $isMajor = str_contains($new, 'major');
-    $version = (string) str($new)->afterLast(': ');
+    $version = (string)str($new)->afterLast(': ');
     $tag = "v{$version}";
 
     // Check the tag
@@ -349,10 +372,10 @@ try {
     // Bump PHP packages
     $console->task(
         label: 'Bumping PHP packages',
-        handler: fn () => [
-            bumpKernelVersion($version),
-            bumpPhpPackages($version, $isMajor),
-        ],
+        handler: function () use ($version, $isMajor) {
+            bumpKernelVersion($version);
+            bumpPhpPackages($version, $isMajor);
+        },
     );
 
     // Bump JavaScript packages
@@ -373,27 +396,27 @@ try {
     // Push tags
     $console->task(
         label: 'Releasing',
-        handler: fn () => [
-            commit("chore: release {$tag}"),
+        handler: function () use ($tag) {
+            commit("chore: release {$tag}");
             executeCommands([
                 "git tag {$tag}",
                 "git push origin tag {$tag}",
-            ]),
-        ],
+            ]);
+        },
     );
 
     // Clean up
     $console->task(
         label: 'Cleaning up',
-        handler: fn () => [
-            cleanUpAfterRelease(),
-            commit('chore: post-release clean up'),
-            executeCommands('git push'),
-        ],
+        handler: function () {
+            cleanUpAfterRelease();
+            commit('chore: post-release clean up');
+            executeCommands('git push');
+        },
     );
 
-    // Re-enable protection
     updateBranchProtection(enabled: true);
+    triggerSubsplit();
 
     $console->success(sprintf(
         'Released <em>%1$s</em>. The <href="https://github.com/tempestphp/tempest-framework/releases/tag/%1$s">GitHub release</href> will be created automatically in a few seconds.',

bin/validate-packages

@@ -33,7 +33,7 @@ function checkPackageLicense(array $package): void
 
     if (! file_exists($licenseFile)) {
         throw new UnexpectedValueException(
-            sprintf('Package [tempest/%s] is missing it\'s license.', $package['name'])
+            sprintf('Package [tempest/%s] is missing it\'s license (%s).', $package['name'], $licenseFile)
         );
     }
 

composer.json

@@ -31,6 +31,7 @@
         "psr/http-message": "^1.0|^2.0",
         "psr/log": "^3.0.0",
         "symfony/cache": "^7.2",
+        "symfony/mailer": "^7.2.6",
         "symfony/process": "^7.1",
         "symfony/uid": "^7.1",
         "symfony/var-dumper": "^7.1",
@@ -62,9 +63,12 @@
         "phpbench/phpbench": "84.x-dev",
         "phpstan/phpstan": "^2.0",
         "phpunit/phpunit": "^12.2.3",
+        "predis/predis": "^3.0.0",
         "rector/rector": "^2.0-rc2",
         "spatie/phpunit-snapshot-assertions": "^5.1.8",
         "spaze/phpstan-disallowed-calls": "^4.0",
+        "symfony/amazon-mailer": "^7.2.0",
+        "symfony/postmark-mailer": "^7.2.6",
         "symplify/monorepo-builder": "^11.2",
         "tempest/blade": "^0.1.0",
         "twig/twig": "^3.16"
@@ -87,7 +91,9 @@
         "tempest/http-client": "self.version",
         "tempest/icon": "self.version",
         "tempest/intl": "self.version",
+        "tempest/kv-store": "self.version",
         "tempest/log": "self.version",
+        "tempest/mail": "self.version",
         "tempest/mapper": "self.version",
         "tempest/reflection": "self.version",
         "tempest/router": "self.version",
@@ -123,7 +129,9 @@
             "Tempest\\Http\\": "packages/http/src",
             "Tempest\\Icon\\": "packages/icon/src",
             "Tempest\\Intl\\": "packages/intl/src",
+            "Tempest\\KeyValue\\": "packages/kv-store/src",
             "Tempest\\Log\\": "packages/log/src",
+            "Tempest\\Mail\\": "packages/mail/src",
             "Tempest\\Mapper\\": "packages/mapper/src",
             "Tempest\\Reflection\\": "packages/reflection/src",
             "Tempest\\Router\\": "packages/router/src",
@@ -143,6 +151,7 @@
             "packages/datetime/src/functions.php",
             "packages/debug/src/functions.php",
             "packages/event-bus/src/functions.php",
+            "packages/http/src/functions.php",
             "packages/icon/src/functions.php",
             "packages/intl/src/Number/functions.php",
             "packages/intl/src/functions.php",
@@ -183,7 +192,9 @@
             "Tempest\\Http\\Tests\\": "packages/http/tests",
             "Tempest\\Icon\\Tests\\": "packages/icon/tests",
             "Tempest\\Intl\\Tests\\": "packages/intl/tests",
+            "Tempest\\KeyValue\\Tests\\": "packages/kv-store/tests",
             "Tempest\\Log\\Tests\\": "packages/log/tests",
+            "Tempest\\Mail\\Tests\\": "packages/mail/tests",
             "Tempest\\Mapper\\Tests\\": "packages/mapper/tests",
             "Tempest\\Reflection\\Tests\\": "packages/reflection/tests",
             "Tempest\\Router\\Tests\\": "packages/router/tests",

packages/auth/src/Allow.php

@@ -7,7 +7,7 @@
 use Attribute;
 use UnitEnum;
 
-#[Attribute(Attribute::TARGET_METHOD)]
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
 final readonly class Allow
 {
     public function __construct(

packages/auth/src/AuthorizerMiddleware.php

@@ -24,10 +24,11 @@ public function __construct(
 
     public function __invoke(Request $request, HttpMiddlewareCallable $next): Response
     {
-        $attribute = $this->matchedRoute
+        $handler = $this->matchedRoute
             ->route
-            ->handler
-            ->getAttribute(Allow::class);
+            ->handler;
+
+        $attribute = $handler->getAttribute(Allow::class) ?? $handler->getDeclaringClass()->getAttribute(Allow::class);
 
         if ($attribute === null) {
             return $next($request);

packages/cache/composer.json

@@ -7,6 +7,7 @@
         "symfony/cache": "^7.2",
         "tempest/core": "dev-main",
         "tempest/clock": "dev-main",
+        "tempest/kv-store": "dev-main",
         "tempest/container": "dev-main"
     },
     "require-dev": {

packages/cache/src/CacheInitializer.php

@@ -25,10 +25,13 @@ public function canInitialize(ClassReflector $class, null|string|UnitEnum $tag):
     #[Singleton]
     public function initialize(ClassReflector $class, null|string|UnitEnum $tag, Container $container): Cache
     {
+        $config = $container->get(CacheConfig::class, $tag);
+
         return new GenericCache(
-            cacheConfig: $container->get(CacheConfig::class, $tag),
-            deferredTasks: $container->get(DeferredTasks::class),
+            adapter: $config->createAdapter($container),
             enabled: $this->shouldCacheBeEnabled($tag),
+            deferredTasks: $container->get(DeferredTasks::class),
+            tag: $tag,
         );
     }
 

packages/cache/src/Commands/CacheStatusCommand.php

@@ -99,12 +99,10 @@ private function getCacheName(Cache $cache): string
             return $cache::class;
         }
 
-        $tag = $cache->cacheConfig->tag;
-
-        if ($tag instanceof UnitEnum) {
-            return $tag->name;
+        if ($cache->tag instanceof UnitEnum) {
+            return $cache->tag->name;
         }
 
-        return $tag ?? 'default';
+        return $cache->tag ?? 'default';
     }
 }