Store auth references as RecordIds

Author: JustKira

README.md

@@ -98,7 +98,9 @@ surreal import --conn http://localhost:8000 \
     schema.surql
 ```
 
-The generated schema uses `SCHEMAFULL` tables by default. Each field is typed from the BetterAuth schema: required fields take a concrete type (`string`, `datetime`, `bool`, and so on), optional fields use `option<T | null>` so they accept a typed value, a stored `NULL`, or a missing value, and object fields are marked `FLEXIBLE` so they hold arbitrary keys. `DEFINE INDEX` statements are emitted for unique fields and for fields BetterAuth marks as indexed. Every statement uses `IF NOT EXISTS`, so the file is safe to reapply.
+The generated schema uses `SCHEMAFULL` tables by default. Each field is typed from the BetterAuth schema: required fields take a concrete type (`string`, `datetime`, `bool`, and so on), optional fields use `option<T | null>` so they accept a typed value, a stored `NULL`, or a missing value, and object fields are marked `FLEXIBLE` so they hold arbitrary keys. Fields declared by Better Auth with `references: { field: "id" }` are emitted as SurrealDB `record<table>` fields, for example `session.userId` becomes `record<user>`. `DEFINE INDEX` statements are emitted for unique fields and for fields BetterAuth marks as indexed. Every statement uses `IF NOT EXISTS`, so the file is safe to reapply.
+
+At runtime, the adapter converts referenced string IDs into SurrealDB `RecordId` values for create, update, and where clauses, then deserializes returned records back to plain string IDs for Better Auth. Existing string reference rows are not migrated automatically.
 
 If your app adds many dynamic plugin fields and you do not want to regenerate the schema each time, set `schemaMode: 'schemaless'`. Known fields stay typed and indexed, and writes to undeclared fields are accepted.