@clivly/auth-better-auth 0.7.1 → 0.7.2

package/README.md

@@ -1,19 +1,35 @@
 # @clivly/auth-better-auth
 
-[better-auth](https://better-auth.com) implementation of Clivly's `ClivlyAuthAdapter`. Resolves a CRM end-user's identity from the host app's better-auth session via `auth.api.getSession`.
+better-auth implementation of Clivly's `ClivlyAuthAdapter`. It resolves the
+current end-user through `auth.api.getSession({ headers })` on each request.
 
-Zero runtime dependencies — you pass your own `betterAuth({...})` instance, so there's no `better-auth` version to keep in lockstep.
+## Install
+
+```bash
+npm install @clivly/auth-better-auth better-auth
+```
+
+This adapter is a Tier 2 surface in
+[STABILITY.md](https://github.com/amani-joseph/clivly.com/blob/master/STABILITY.md).
+
+## Usage
 
 ```ts
 import { createBetterAuthAdapter } from "@clivly/auth-better-auth";
-import { auth } from "./auth"; // your betterAuth({ ... }) instance
+import { auth } from "./auth";
 
 const authAdapter = createBetterAuthAdapter({ auth });
 
-const user = await authAdapter.getUser(request); // { id, email, name } | null
+const user = await authAdapter.getUser(request);
+// { id, email, name } | null
 ```
 
-Returns `null` when there's no session or the session user has no email (Clivly requires one). The adapter answers "who is this person?" only — CRM authorization lives in Clivly's separate `crm_members` layer.
+The package does not bundle its own better-auth runtime. You pass your existing
+`betterAuth({...})` instance in.
+
+Returns `null` when there is no session, or when the session user cannot be
+mapped to a Clivly user. The adapter only answers identity; CRM authorization
+still lives in Clivly's separate `crm_members` layer.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clivly/auth-better-auth",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "private": false,
   "type": "module",
   "description": "better-auth implementation of Clivly's ClivlyAuthAdapter.",
@@ -25,7 +25,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@clivly/core": "0.7.1"
+    "@clivly/core": "0.7.2"
   },
   "devDependencies": {
     "tsdown": "^0.22.14",