@makefully/adaptfully 3.13.0 → 3.14.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented in this file.
 
+## 3.14.0 — 2026-08-21
+
+### Added
+
+- **`platform.supportsLogout()`** — whether `logout()` yields a durable signed-out state. Google, social, and dev return `true`; Steam returns `false` (Steamworks identity returns on `autoLogin`). Defaults to `false` when the auth plugin omits the method. Games should hide Sign out UI when this is false.
+- **`platform.requiresEmail()`** — whether a complete identity needs email in addition to id. Google, social, and dev return `true`; Steam returns `false`. Defaults to `true` when unimplemented. Use instead of branching on `auth.name === 'steam'` for session completeness and account-sync routing.
+
 ## 3.13.0 — 2026-07-24
 
 ### Added

package/README.md

@@ -185,7 +185,7 @@ When `steam-auth` is registered on an **`electron`** platform, Adaptfully prebui
 - **`main.js`** — Electron shell with Steam overlay enabled and a preload script wired in
 - **`preload.js`** — initializes [steamworks.js](https://github.com/ceifa/steamworks.js) with `platforms.<name>.steamId` and exposes `window.__ADAPTFULLY_STEAMWORKS__`
 
-The renderer `steam-auth` plugin reads the Steam ID from that bridge. When Steam is available, `autoLogin()` succeeds immediately with `{ id: steamId64, email: '' }`. Optional config keys:
+The renderer `steam-auth` plugin reads the Steam ID from that bridge. When Steam is available, `autoLogin()` succeeds immediately with `{ id: steamId64, email: '' }`. `supportsLogout()` is `false` and `requiresEmail()` is `false` — games should not offer Sign out, and should treat id-only identity as complete. Optional config keys:
 
 | Key | Default | Purpose |
 |-----|---------|---------|
@@ -229,6 +229,9 @@ import {
 - **`runAdaptfullyStage('prebuild' | 'build' | 'deploy', platformKey, options)`** — run a pipeline stage programmatically.
 - **`platform.autoLogin(callback)`** — restore a prior session without UI when the auth plugin supports it (Google uses `lastLoggedIn` in storage and a cached OAuth token).
 - **`platform.supportsAutoLogin()`** — whether the active auth plugin can attempt automatic sign-in.
+- **`platform.logout(callback)`** — clear / revoke the platform session when supported.
+- **`platform.supportsLogout()`** — whether logout is a durable user-facing action. Steam returns `false` (identity is bound to the Steam client); Google, social, and dev return `true`. Prefer this over checking `auth.name` when showing Sign out UI.
+- **`platform.requiresEmail()`** — whether `getUser()` must include email for a complete session. Steam returns `false` (SteamID64 alone); Google, social, and dev return `true`. Prefer this over checking `auth.name` for session sync and account-link routing.
 
 ---
 

package/lib/runtime/auth/_helpers.js

@@ -11,6 +11,8 @@
  * @property {(callback: AuthCallback) => void} login
  * @property {(callback: AuthCallback) => void} autoLogin
  * @property {() => boolean} [supportsAutoLogin]
+ * @property {() => boolean} [supportsLogout] — durable signed-out state (false for Steamworks-bound identity)
+ * @property {() => boolean} [requiresEmail] — whether getUser() must include email for a complete session
  * @property {(callback: () => void) => void} logout
  * @property {() => AuthUser | null} getUser
  * @property {() => boolean} isAuthenticated

package/lib/runtime/auth/dev-auth.js

@@ -58,6 +58,14 @@
             return true;
         }
 
+        supportsLogout() {
+            return true;
+        }
+
+        requiresEmail() {
+            return true;
+        }
+
         logout(callback) {
             const storage = getStorage();
             this.authenticated = false;

package/lib/runtime/auth/google-auth.js

@@ -21,6 +21,14 @@
             return true;
         }
 
+        supportsLogout() {
+            return true;
+        }
+
+        requiresEmail() {
+            return true;
+        }
+
         #tokenKey() {
             return configValue('googleTokenKey', DEFAULT_TOKEN_KEY);
         }

package/lib/runtime/auth/social-auth.js

@@ -74,6 +74,14 @@
             return true;
         }
 
+        supportsLogout() {
+            return true;
+        }
+
+        requiresEmail() {
+            return true;
+        }
+
         #autoLoginStorageKey() {
             return configValue('autoLoginStorageKey', DEFAULT_AUTO_LOGIN_KEY);
         }

package/lib/runtime/auth/steam-auth.js

@@ -118,6 +118,14 @@
             return true;
         }
 
+        supportsLogout() {
+            return false;
+        }
+
+        requiresEmail() {
+            return false;
+        }
+
         #autoLoginStorageKey() {
             return configValue('autoLoginStorageKey', DEFAULT_AUTO_LOGIN_KEY);
         }

package/lib/runtime/platform.js

@@ -78,6 +78,27 @@
                 : typeof this.auth.autoLogin === 'function';
         }
 
+        /**
+         * Whether logout() yields a durable signed-out state for this auth backend.
+         * Games should hide Sign out UI when this is false (e.g. Steam).
+         * Defaults to false when the plugin does not implement the method.
+         */
+        supportsLogout() {
+            return typeof this.auth.supportsLogout === 'function'
+                ? this.auth.supportsLogout()
+                : false;
+        }
+
+        /**
+         * Whether a complete identity requires email in addition to id.
+         * Id-only backends (Steam) return false. Defaults to true when unimplemented.
+         */
+        requiresEmail() {
+            return typeof this.auth.requiresEmail === 'function'
+                ? this.auth.requiresEmail()
+                : true;
+        }
+
         logout(callback) {
             this.whenReady(() => {
                 this.auth.logout(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@makefully/adaptfully",
-    "version": "3.13.0",
+    "version": "3.14.0",
     "description": "Platform abstraction and Wrapfully deploy client for Makefully games",
     "type": "module",
     "main": "./lib/node/index.js",