feat: add a surreal session driver

[ibourgeois]

Summary

• register a first-class session driver backed by Laravel's database session handler
• document how to enable Surreal-backed sessions and migrate the sessions table on the Surreal connection
• cover session read, write, update, expiry, and cleanup behavior against a real local Surreal runtime

Closes #27

Testing

• vendor/bin/pint --dirty --format agent
• php artisan test --compact tests/Feature/SurrealSessionDriverTest.php

[Copilot]

Pull request overview

Adds a SurrealDB-backed Laravel session driver by reusing Laravel’s built-in database session handler on the surreal connection, plus documentation and an end-to-end lifecycle test against a real local Surreal runtime.

Changes:

• Register a surreal session driver via DatabaseSessionHandler in the application service provider.
• Document how to enable Surreal-backed sessions and migrate the table on the Surreal connection.
• Add a feature test that exercises session read/write/update/expiry/GC against a local SurrealDB process.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
app/Providers/AppServiceProvider.php	Registers the surreal session driver using Laravel’s database session handler on the Surreal connection.
config/session.php	Updates the documented list of supported session drivers to include surreal.
README.md	Documents enabling Surreal-backed sessions and running the migration on the surreal connection.
tests/Feature/SurrealSessionDriverTest.php	Adds an integration test covering the full session lifecycle on SurrealDB.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.