fix: lower php version (#25)

shavonn · web-flow · commit 8451a493c0f7 · 2026-01-10T01:20:01.000-05:00
* refactor: lower php version to 8.2

* refactor: remove const types

* docs: update php 8.4 to 8.2
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -17,7 +17,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        php: [ 8.4 ]
+        php: [ 8.2, 8.3, 8.4 ]
         laravel: [ 11.*, 12.* ]
         stability: [ prefer-lowest, prefer-stable ]
 
diff --git a/README.md b/README.md
@@ -980,17 +980,17 @@ class ArticlePermissions
 {
     #[Label('View Articles')]
     #[Description('Allows viewing articles')]
-    public const string VIEW = 'article:view';
+    public const VIEW = 'article:view';
 
     #[Label('Create Articles')]
     #[Description('Allows creating new articles')]
-    public const string CREATE = 'article:create';
+    public const CREATE = 'article:create';
 
     #[Label('Edit Articles')]
-    public const string EDIT = 'article:edit';
+    public const EDIT = 'article:edit';
 
     #[Label('Delete Articles')]
-    public const string DELETE = 'article:delete';
+    public const DELETE = 'article:delete';
 }
 ```
 
@@ -1010,14 +1010,14 @@ class SystemRoles
 {
     #[Label('Administrator')]
     #[Description('Has all permissions')]
-    public const string ADMIN = 'admin';
+    public const ADMIN = 'admin';
 
     #[Label('Editor')]
     #[Description('Can edit content')]
-    public const string EDITOR = 'editor';
+    public const EDITOR = 'editor';
 
     #[Label('Viewer')]
-    public const string VIEWER = 'viewer';
+    public const VIEWER = 'viewer';
 }
 ```
 
@@ -1097,7 +1097,8 @@ php artisan vendor:publish --tag=mandate-migrations-meta
 php artisan migrate
 ```
 
-This adds `label` and `description` columns to the permissions, roles, and capabilities tables. These columns are useful for displaying human-readable names in admin UIs, regardless of whether you use code-first definitions.
+This adds `label` and `description` columns to the permissions, roles, and capabilities tables. These columns are useful
+for displaying human-readable names in admin UIs, regardless of whether you use code-first definitions.
 
 ### Generator Commands
 
@@ -1128,7 +1129,8 @@ Generate TypeScript types for frontend type safety. The command automatically me
 - **Code-first definitions** — PHP classes with attributes (if enabled)
 - **Database records** — Permissions, roles, and capabilities from the database
 
-This allows you to define permissions in code (tied to features) while managing roles in the database (business-defined).
+This allows you to define permissions in code (tied to features) while managing roles in the database (
+business-defined).
 
 ```bash
 # Generate to configured location (default: resources/js/types/mandate.ts)
@@ -1199,7 +1201,7 @@ $user->assignRole('editor');
 On the frontend, use the generated TypeScript types:
 
 ```typescript
-import { ArticlePermissions, Roles, type Permission, type Role } from '@/types/mandate';
+import {ArticlePermissions, Roles, type Permission, type Role} from '@/types/mandate';
 
 // Type-safe permission checks
 function canEdit(userPermissions: Permission[]): boolean {
@@ -1235,15 +1237,15 @@ Event::listen(MandateSynced::class, function ($event) {
 
 ### Code-First Configuration Options
 
-| Option                          | Default                              | Description                              |
-|---------------------------------|--------------------------------------|------------------------------------------|
-| `code_first.enabled`            | `false`                              | Enable code-first mode                   |
-| `code_first.paths.permissions`  | `app_path('Permissions')`            | Directory to scan for permission classes |
-| `code_first.paths.roles`        | `app_path('Roles')`                  | Directory to scan for role classes       |
-| `code_first.paths.capabilities` | `app_path('Capabilities')`           | Directory to scan for capability classes |
-| `code_first.assignments`        | `[]`                                 | Role-permission/capability assignments   |
+| Option                          | Default                                | Description                              |
+|---------------------------------|----------------------------------------|------------------------------------------|
+| `code_first.enabled`            | `false`                                | Enable code-first mode                   |
+| `code_first.paths.permissions`  | `app_path('Permissions')`              | Directory to scan for permission classes |
+| `code_first.paths.roles`        | `app_path('Roles')`                    | Directory to scan for role classes       |
+| `code_first.paths.capabilities` | `app_path('Capabilities')`             | Directory to scan for capability classes |
+| `code_first.assignments`        | `[]`                                   | Role-permission/capability assignments   |
 | `code_first.typescript_path`    | `resource_path('js/types/mandate.ts')` | Default output path for TypeScript types |
-| `feature_generator`             | `null`                               | Custom feature generator class           |
+| `feature_generator`             | `null`                                 | Custom feature generator class           |
 
 ---
 
@@ -1455,7 +1457,7 @@ See [UPGRADE.md](UPGRADE.md) for detailed migration instructions.
 
 ## Requirements
 
-- PHP 8.4+
+- PHP 8.2+
 - Laravel 11.x or 12.x
 
 ## License
diff --git a/UPGRADE.md b/UPGRADE.md
@@ -118,14 +118,14 @@ class UserPermissions
 {
     #[Label('View Users')]
     #[Description('Can view user list')]
-    public const string VIEW = 'user:view';
+    public const VIEW = 'user:view';
 }
 
 #[RoleSet('system')]
 #[Inherits(EditorRole::class)]
 class AdminRole
 {
-    public const string ADMIN = 'admin';
+    public const ADMIN = 'admin';
 }
 ```
 
@@ -142,14 +142,14 @@ class UserPermissions
 {
     #[Label('View Users')]
     #[Description('Can view user list')]
-    public const string VIEW = 'user:view';
+    public const VIEW = 'user:view';
 }
 
 #[Guard('web')]
 class SystemRoles
 {
     #[Label('Administrator')]
-    public const string ADMIN = 'admin';
+    public const ADMIN = 'admin';
 }
 ```
 
@@ -291,10 +291,10 @@ serve this purpose but with more power — they can be assigned to roles and opt
 #[PermissionsSet('users', label: 'User Management', description: 'Manage users')]
 class UserPermissions
 {
-    public const string VIEW = 'user:view';
-    public const string CREATE = 'user:create';
-    public const string EDIT = 'user:edit';
-    public const string DELETE = 'user:delete';
+    public const VIEW = 'user:view';
+    public const CREATE = 'user:create';
+    public const EDIT = 'user:edit';
+    public const DELETE = 'user:delete';
 }
 ```
 
@@ -306,16 +306,16 @@ class UserPermissions
 class UserPermissions
 {
     #[Label('View Users')]
-    public const string VIEW = 'user:view';
+    public const VIEW = 'user:view';
 
     #[Label('Create Users')]
-    public const string CREATE = 'user:create';
+    public const CREATE = 'user:create';
 
     #[Label('Edit Users')]
-    public const string EDIT = 'user:edit';
+    public const EDIT = 'user:edit';
 
     #[Label('Delete Users')]
-    public const string DELETE = 'user:delete';
+    public const DELETE = 'user:delete';
 }
 
 // 2. Create a capability to group them
@@ -438,8 +438,8 @@ If you used the code-first approach in 1.x with `#[PermissionsSet]` attributes,
 #[PermissionsSet('users', label: 'User Management', description: 'Manage users')]
 class UserPermissions
 {
-    public const string VIEW = 'user:view';
-    public const string CREATE = 'user:create';
+    public const VIEW = 'user:view';
+    public const CREATE = 'user:create';
 }
 
 // After: Creates a "users-management" capability with those permissions
diff --git a/composer.json b/composer.json
@@ -18,7 +18,7 @@
     }
   ],
   "require": {
-    "php": "^8.4",
+    "php": "^8.2",
     "illuminate/contracts": "^11.0|^12.0",
     "illuminate/console": "^11.0|^12.0",
     "illuminate/support": "^11.0|^12.0"
diff --git a/src/Attributes/Capability.php b/src/Attributes/Capability.php
@@ -13,11 +13,11 @@
  *
  * @example
  * #[Capability('user-management')]
- * public const string VIEW = 'user:view';
+ * public const VIEW = 'user:view';
  *
  * #[Capability('user-management')]
  * #[Capability('reporting')]
- * public const string EXPORT = 'user:export';
+ * public const EXPORT = 'user:export';
  */
 #[Attribute(Attribute::TARGET_CLASS_CONSTANT | Attribute::IS_REPEATABLE)]
 final readonly class Capability
diff --git a/src/Attributes/Context.php b/src/Attributes/Context.php
@@ -13,7 +13,7 @@
  *
  * @example
  * #[Context(ExportFeature::class)]
- * public const string EXPORT = 'user:export';
+ * public const EXPORT = 'user:export';
  */
 #[Attribute(Attribute::TARGET_CLASS_CONSTANT)]
 final readonly class Context
diff --git a/src/Attributes/Description.php b/src/Attributes/Description.php
@@ -13,7 +13,7 @@
  *
  * @example
  * #[Description('Allows viewing user profiles and account details')]
- * public const string VIEW = 'user:view';
+ * public const VIEW = 'user:view';
  */
 #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_CLASS_CONSTANT)]
 final readonly class Description
diff --git a/src/Attributes/Guard.php b/src/Attributes/Guard.php
@@ -15,7 +15,7 @@
  * #[Guard('api')]
  * final class ApiPermissions
  * {
- *     public const string VIEW = 'api.view';
+ *     public const VIEW = 'api.view';
  * }
  */
 #[Attribute(Attribute::TARGET_CLASS)]
diff --git a/src/Attributes/Label.php b/src/Attributes/Label.php
@@ -13,7 +13,7 @@
  *
  * @example
  * #[Label('View Users')]
- * public const string VIEW = 'user:view';
+ * public const VIEW = 'user:view';
  */
 #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_CLASS_CONSTANT)]
 final readonly class Label
diff --git a/src/CodeFirst/DefinitionCache.php b/src/CodeFirst/DefinitionCache.php
@@ -13,7 +13,7 @@
  */
 final class DefinitionCache
 {
-    private const string CACHE_KEY_PREFIX = 'mandate.code_first';
+    private const CACHE_KEY_PREFIX = 'mandate.code_first';
 
     private CacheRepository $cache;
 
diff --git a/src/Exceptions/UnauthorizedException.php b/src/Exceptions/UnauthorizedException.php
@@ -23,12 +23,12 @@ final class UnauthorizedException extends HttpException
     /**
      * @var array<string>
      */
-    public private(set) array $requiredRoles = [];
+    public array $requiredRoles = [];
 
     /**
      * @var array<string>
      */
-    public private(set) array $requiredPermissions = [];
+    public array $requiredPermissions = [];
 
     public function __construct(
         string $message = 'Subject does not have the required authorization.',
diff --git a/stubs/capability.stub b/stubs/capability.stub
@@ -13,5 +13,5 @@ final class {{ class }}
 {
     #[Label('{{ capability }} Management')]
     #[Description('Manage {{ capability }} resources')]
-    public const string MANAGE = '{{ capability }}-management';
+    public const MANAGE = '{{ capability }}-management';
 }
diff --git a/stubs/permission.stub b/stubs/permission.stub
@@ -13,17 +13,17 @@ final class {{ class }}
 {
     #[Label('View {{ resource }}')]
     #[Description('View {{ resource }} records')]
-    public const string VIEW = '{{ resource }}.view';
+    public const VIEW = '{{ resource }}.view';
 
     #[Label('Create {{ resource }}')]
     #[Description('Create new {{ resource }} records')]
-    public const string CREATE = '{{ resource }}.create';
+    public const CREATE = '{{ resource }}.create';
 
     #[Label('Update {{ resource }}')]
     #[Description('Update existing {{ resource }} records')]
-    public const string UPDATE = '{{ resource }}.update';
+    public const UPDATE = '{{ resource }}.update';
 
     #[Label('Delete {{ resource }}')]
     #[Description('Delete {{ resource }} records')]
-    public const string DELETE = '{{ resource }}.delete';
+    public const DELETE = '{{ resource }}.delete';
 }
diff --git a/stubs/role.stub b/stubs/role.stub
@@ -13,13 +13,13 @@ final class {{ class }}
 {
     #[Label('Administrator')]
     #[Description('Full system access')]
-    public const string ADMIN = 'admin';
+    public const ADMIN = 'admin';
 
     #[Label('User')]
     #[Description('Standard user access')]
-    public const string USER = 'user';
+    public const USER = 'user';
 
     #[Label('Guest')]
     #[Description('Limited read-only access')]
-    public const string GUEST = 'guest';
+    public const GUEST = 'guest';
 }
diff --git a/tests/Feature/Commands/MakePermissionCommandTest.php b/tests/Feature/Commands/MakePermissionCommandTest.php
@@ -49,9 +49,9 @@
             ->assertSuccessful();
 
         $content = File::get(app_path('Permissions/TestPermissions.php'));
-        expect($content)->toContain('const string VIEW');
-        expect($content)->toContain('const string CREATE');
-        expect($content)->toContain('const string UPDATE');
-        expect($content)->toContain('const string DELETE');
+        expect($content)->toContain('const VIEW');
+        expect($content)->toContain('const CREATE');
+        expect($content)->toContain('const UPDATE');
+        expect($content)->toContain('const DELETE');
     });
 })->skip(fn () => ! class_exists(Illuminate\Console\GeneratorCommand::class), 'GeneratorCommand not available');
diff --git a/tests/Fixtures/CodeFirst/ArticlePermissions.php b/tests/Fixtures/CodeFirst/ArticlePermissions.php
@@ -13,14 +13,14 @@ class ArticlePermissions
 {
     #[Label('View Articles')]
     #[Description('Allows viewing articles')]
-    public const string VIEW = 'article:view';
+    public const VIEW = 'article:view';
 
     #[Label('Create Articles')]
     #[Description('Allows creating new articles')]
-    public const string CREATE = 'article:create';
+    public const CREATE = 'article:create';
 
     #[Label('Edit Articles')]
-    public const string EDIT = 'article:edit';
+    public const EDIT = 'article:edit';
 
-    public const string DELETE = 'article:delete';
+    public const DELETE = 'article:delete';
 }
diff --git a/tests/Fixtures/CodeFirst/ContentCapabilities.php b/tests/Fixtures/CodeFirst/ContentCapabilities.php
@@ -13,8 +13,8 @@ class ContentCapabilities
 {
     #[Label('Content Management')]
     #[Description('Manage all content')]
-    public const string MANAGE_CONTENT = 'content-management';
+    public const MANAGE_CONTENT = 'content-management';
 
     #[Label('User Management')]
-    public const string MANAGE_USERS = 'user-management';
+    public const MANAGE_USERS = 'user-management';
 }
diff --git a/tests/Fixtures/CodeFirst/SystemRoles.php b/tests/Fixtures/CodeFirst/SystemRoles.php
@@ -15,10 +15,10 @@ class SystemRoles
 {
     #[Label('Administrator')]
     #[Description('Has all permissions')]
-    public const string ADMIN = 'admin';
+    public const ADMIN = 'admin';
 
     #[Label('Editor')]
-    public const string EDITOR = 'editor';
+    public const EDITOR = 'editor';
 
-    public const string VIEWER = 'viewer';
+    public const VIEWER = 'viewer';
 }

Original file line number	Diff line number	Diff line change
`@@ -118,14 +118,14 @@ class UserPermissions`
`118`	`118`	`{`
`119`	`119`	`#[Label('View Users')]`
`120`	`120`	`#[Description('Can view user list')]`
`121`		`- public const string VIEW = 'user:view';`
	`121`	`+ public const VIEW = 'user:view';`
`122`	`122`	`}`
`123`	`123`
`124`	`124`	`#[RoleSet('system')]`
`125`	`125`	`#[Inherits(EditorRole::class)]`
`126`	`126`	`class AdminRole`
`127`	`127`	`{`
`128`		`- public const string ADMIN = 'admin';`
	`128`	`+ public const ADMIN = 'admin';`
`129`	`129`	`}`
`130`	`130`	```
`131`	`131`
`@@ -142,14 +142,14 @@ class UserPermissions`
`142`	`142`	`{`
`143`	`143`	`#[Label('View Users')]`
`144`	`144`	`#[Description('Can view user list')]`
`145`		`- public const string VIEW = 'user:view';`
	`145`	`+ public const VIEW = 'user:view';`
`146`	`146`	`}`
`147`	`147`
`148`	`148`	`#[Guard('web')]`
`149`	`149`	`class SystemRoles`
`150`	`150`	`{`
`151`	`151`	`#[Label('Administrator')]`
`152`		`- public const string ADMIN = 'admin';`
	`152`	`+ public const ADMIN = 'admin';`
`153`	`153`	`}`
`154`	`154`	```
`155`	`155`
`@@ -291,10 +291,10 @@ serve this purpose but with more power — they can be assigned to roles and opt`
`291`	`291`	`#[PermissionsSet('users', label: 'User Management', description: 'Manage users')]`
`292`	`292`	`class UserPermissions`
`293`	`293`	`{`
`294`		`- public const string VIEW = 'user:view';`
`295`		`- public const string CREATE = 'user:create';`
`296`		`- public const string EDIT = 'user:edit';`
`297`		`- public const string DELETE = 'user:delete';`
	`294`	`+ public const VIEW = 'user:view';`
	`295`	`+ public const CREATE = 'user:create';`
	`296`	`+ public const EDIT = 'user:edit';`
	`297`	`+ public const DELETE = 'user:delete';`
`298`	`298`	`}`
`299`	`299`	```
`300`	`300`
`@@ -306,16 +306,16 @@ class UserPermissions`
`306`	`306`	`class UserPermissions`
`307`	`307`	`{`
`308`	`308`	`#[Label('View Users')]`
`309`		`- public const string VIEW = 'user:view';`
	`309`	`+ public const VIEW = 'user:view';`
`310`	`310`
`311`	`311`	`#[Label('Create Users')]`
`312`		`- public const string CREATE = 'user:create';`
	`312`	`+ public const CREATE = 'user:create';`
`313`	`313`
`314`	`314`	`#[Label('Edit Users')]`
`315`		`- public const string EDIT = 'user:edit';`
	`315`	`+ public const EDIT = 'user:edit';`
`316`	`316`
`317`	`317`	`#[Label('Delete Users')]`
`318`		`- public const string DELETE = 'user:delete';`
	`318`	`+ public const DELETE = 'user:delete';`
`319`	`319`	`}`
`320`	`320`
`321`	`321`	`// 2. Create a capability to group them`
@@ -438,8 +438,8 @@ If you used the code-first approach in 1.x with `#[PermissionsSet]` attributes,
`438`	`438`	`#[PermissionsSet('users', label: 'User Management', description: 'Manage users')]`
`439`	`439`	`class UserPermissions`
`440`	`440`	`{`
`441`		`- public const string VIEW = 'user:view';`
`442`		`- public const string CREATE = 'user:create';`
	`441`	`+ public const VIEW = 'user:view';`
	`442`	`+ public const CREATE = 'user:create';`
`443`	`443`	`}`
`444`	`444`
`445`	`445`	`// After: Creates a "users-management" capability with those permissions`
Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,7 @@`
`18`	`18`	`}`
`19`	`19`	`],`
`20`	`20`	`"require": {`
`21`		`- "php": "^8.4",`
	`21`	`+ "php": "^8.2",`
`22`	`22`	`"illuminate/contracts": "^11.0\|^12.0",`
`23`	`23`	`"illuminate/console": "^11.0\|^12.0",`
`24`	`24`	`"illuminate/support": "^11.0\|^12.0"`
Original file line number	Diff line number	Diff line change
`@@ -13,11 +13,11 @@`
`13`	`13`	`*`
`14`	`14`	`* @example`
`15`	`15`	`* #[Capability('user-management')]`
`16`		`- * public const string VIEW = 'user:view';`
	`16`	`+ * public const VIEW = 'user:view';`
`17`	`17`	`*`
`18`	`18`	`* #[Capability('user-management')]`
`19`	`19`	`* #[Capability('reporting')]`
`20`		`- * public const string EXPORT = 'user:export';`
	`20`	`+ * public const EXPORT = 'user:export';`
`21`	`21`	`*/`
`22`	`22`	`#[Attribute(Attribute::TARGET_CLASS_CONSTANT \| Attribute::IS_REPEATABLE)]`
`23`	`23`	`final readonly class Capability`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@`
`13`	`13`	`*`
`14`	`14`	`* @example`
`15`	`15`	`* #[Context(ExportFeature::class)]`
`16`		`- * public const string EXPORT = 'user:export';`
	`16`	`+ * public const EXPORT = 'user:export';`
`17`	`17`	`*/`
`18`	`18`	`#[Attribute(Attribute::TARGET_CLASS_CONSTANT)]`
`19`	`19`	`final readonly class Context`