feat(cache): canonical row cache keys + alias entries + table generation tokens

.github/workflows/phpstan.yml

@@ -14,4 +14,4 @@ jobs:
         with:
           path: lib/ tests/
           level: 9
-          php_version: 8.1
+          php_version: "8.2"

.github/workflows/phpunit.yml

@@ -14,4 +14,9 @@ jobs:
       - name: PHPUnit Tests
         uses: php-actions/phpunit@v3
         with:
-          configuration: phpunit.xml
+          configuration: phpunit.xml
+          # Pin to the PHPUnit major the package targets (composer dev deps
+          # resolve 9.6): the action's default phar is PHPUnit 11+, which
+          # ignores @dataProvider annotations and silently skips those tests.
+          version: "9.6"
+          php_version: "8.2"

.wordlist.txt

@@ -23,4 +23,20 @@ Traceback
 nodejs
 npm
 fediverse
-readme
+readme
+getUnprefixedName
+lookups
+phpnomad
+PrimaryKeyFactory
+schemas
+txt
+WithDatastoreHandlerMethods
+datastore
+PHPNomad
+PostDatabaseDatastoreHandler
+TableSchemaService
+DateModifiedFactory
+IdentifiableDatabaseDatastoreHandler
+PostsTable
+DatabaseServiceProvider
+DateCreatedFactory

README.md

@@ -125,7 +125,8 @@ The `QueryBuilder` turns that array into parameterized SQL and runs it through w
 - Extend `IdentifiableDatabaseDatastoreHandler` as the base for any handler keyed by a single `id` column
 - Use the `WithDatastoreHandlerMethods` trait for CRUD, cache reads, cache invalidation, and event dispatch
 - Build reads and writes through `QueryBuilder` and `ClauseBuilder` with condition arrays instead of raw SQL
-- Inject `DatabaseServiceProvider` into every handler to access `QueryBuilder`, `QueryStrategy`, `ClauseBuilder`, `CacheableService`, `EventStrategy`, and `LoggerStrategy`
+- Inject `DatabaseServiceProvider` into every handler to access `QueryBuilder`, `QueryStrategy`, `ClauseBuilder`, `CacheableService`, `EventStrategy`, and `LoggerStrategy`; each handler derives its own `RowCacheContextAdapter` for cache-key vocabulary
+- Rows are cached under canonical table-identity keys with per-table generation tokens; override `shouldUseTableGenerations()` on a handler to trade the generation token's race protection for a higher hit rate on write-hot tables
 - Use column factories like `PrimaryKeyFactory`, `DateCreatedFactory`, `DateModifiedFactory`, and `ForeignKeyFactory` for common column patterns
 - Model many-to-many relationships with `JunctionTable`, which handles compound primary keys and foreign key constraints
 

composer.json

@@ -25,19 +25,24 @@
         }
     ],
     "require": {
+        "php": ">=8.2",
         "phpnomad/utils": "^1.0",
         "phpnomad/cache": "^1.0",
         "phpnomad/chrono": "^1.0",
         "phpnomad/datastore": "^2.0",
         "phpnomad/singleton": "^1.0",
-        "phpnomad/logger": "^1.0"
+        "phpnomad/logger": "^1.0",
+        "phpnomad/event": "^1.0"
     },
     "require-dev": {
         "phpnomad/tests": "^0.1.0 || ^0.3.0"
     },
     "config": {
         "allow-plugins": {
             "phpstan/extension-installer": true
+        },
+        "platform": {
+            "php": "8.2.0"
         }
     }
 }