@makefully/adaptfully 3.0.1 → 3.0.3

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project are documented in this file.
 
+## 3.0.3 — 2026-06-18
+
+### Added
+
+- `platform.autoLogin()` and `platform.supportsAutoLogin()` for session restore without UI.
+- Google auth reads `config.autoLoginStorageKey` (default: `lastLoggedIn`) when deciding whether to attempt silent OAuth.
+
+### Changed
+
+- Auth plugins expose `autoLogin()` only (removed `silentLogin()`).
+
+### Fixed
+
+- Google auth reads OAuth config and stored tokens lazily so bridge-registered `config`/`storage` are applied before auto-login runs.
+- Prebuild injects deploy bridge scripts after `core.js` and before auth plugin runtime scripts.
+- Auth storage helper falls back to `localStorage` when `storage` is not registered via Adaptfully.
+
+## 3.0.2 — 2026-06-18
+
+### Fixed
+
+- Deploy script paths without a leading `/` are emitted as page-relative `script src` values (for subdirectory hosting).
+
 ## 3.0.1 — 2026-06-17
 
 ### Added

package/README.md

@@ -68,7 +68,7 @@ Use plugin keys in `config.platforms.<platform>.registrations`. Custom deploy sc
       "web": {
         "registrations": {
           "auth": "google-auth",
-          "storage": "/javascript/adaptfully-bridge.js"
+          "storage": "javascript/adaptfully-bridge.js"
         }
       },
       "dev": {
@@ -81,7 +81,7 @@ Use plugin keys in `config.platforms.<platform>.registrations`. Custom deploy sc
 }
 ```
 
-Standard plugin keys load bundled Adaptfully runtime scripts and emit an inline `adaptfully.register()` call. Path values add a `<script src="...">` tag — the script is expected to call `adaptfully.register()` itself (for example a bridge that wires `storage` and `config`).
+Standard plugin keys load bundled Adaptfully runtime scripts and emit an inline `adaptfully.register()` call. Path values add a `<script src="...">` tag — the script is expected to call `adaptfully.register()` itself (for example a bridge that wires `storage` and `config`). Use a leading `/` for site-root URLs; omit it for paths relative to each HTML page (required when the game is hosted in a subdirectory).
 
 Wrapfully builders (`steam`, `win`, `mac`, `android`, etc.) map to platform keys via defaults (`win` → `steam`) or an explicit `builders` array on the platform config.
 
@@ -107,6 +107,8 @@ import {
 - **`prebuildPlatform(deployFolder, platformKey, pkg)`** — copy `deploy/` to `output/<platform>-prebuild/` and inject registrations into `config.htmlInjections` (default: `index.html`).
 - **`resolveRegistrationAssets(registrations)`** — resolve runtime script paths, inline registration JS, and external script tags for a registration map (useful for Vite dev servers).
 - **`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.
 
 ---
 
@@ -284,13 +286,13 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
       "web": {
         "registrations": {
           "auth": "google-auth",
-          "storage": "/javascript/adaptfully-bridge.js"
+          "storage": "javascript/adaptfully-bridge.js"
         }
       },
       "steam": {
         "registrations": {
           "auth": "steam-auth",
-          "storage": "/javascript/adaptfully-bridge.js"
+          "storage": "javascript/adaptfully-bridge.js"
         }
       }
     },

package/lib/node/registrations.js

@@ -83,7 +83,7 @@ export function collectRegistrationParts(registrations) {
         }
 
         if (isDeployPath(value)) {
-            const src = value.startsWith('/') ? value : `/${value.replace(/^\.\//, '')}`;
+            const src = normalizeDeployScriptSrc(value);
             deployScripts.push({ key: registerKey, src });
             continue;
         }
@@ -130,6 +130,17 @@ function isDeployPath(value) {
     return value.startsWith('/') || value.startsWith('./') || value.includes('/');
 }
 
+/**
+ * @param {string} value Deploy-relative script path from config
+ * @returns {string} Value for HTML script src (leading `/` = site root; otherwise page-relative)
+ */
+function normalizeDeployScriptSrc(value) {
+    if (value.startsWith('/')) {
+        return value;
+    }
+    return value.replace(/^\.\//, '');
+}
+
 /**
  * @param {string} builder
  * @param {Record<string, { builders?: string[], registrations?: RegistrationMap }>} [platforms]
@@ -178,8 +189,7 @@ export function buildAdaptfullyInjection(registrations, options = {}) {
 
     for (const [registerKey, value] of Object.entries(registrations)) {
         if (isDeployPath(value)) {
-            const src = value.startsWith('/') ? value : `/${value.replace(/^\.\//, '')}`;
-            log(`adaptfully: registering ${registerKey} ← ${src}`);
+            log(`adaptfully: registering ${registerKey} ← ${normalizeDeployScriptSrc(value)}`);
         } else {
             log(`adaptfully: registering ${registerKey} ← ${value}`);
         }
@@ -191,7 +201,11 @@ export function buildAdaptfullyInjection(registrations, options = {}) {
         block += `${extScript}\n`;
     }
 
-    for (const script of parts.runtimeScripts) {
+    const coreScript = 'core.js';
+    const bootstrapScripts = parts.runtimeScripts.filter((script) => script === coreScript);
+    const pluginScripts = parts.runtimeScripts.filter((script) => script !== coreScript);
+
+    for (const script of bootstrapScripts) {
         block += `<script>\n${readRuntimeScript(script)}\n</script>\n`;
     }
 
@@ -199,6 +213,10 @@ export function buildAdaptfullyInjection(registrations, options = {}) {
         block += `<script src="${src}"></script>\n`;
     }
 
+    for (const script of pluginScripts) {
+        block += `<script>\n${readRuntimeScript(script)}\n</script>\n`;
+    }
+
     if (parts.inlineRegistrations.length > 0) {
         block += `<script>\n${parts.inlineRegistrations.join('\n')}\n</script>\n`;
     }

package/lib/runtime/auth/_helpers.js

@@ -1,4 +1,4 @@
-/* global window */
+/* global localStorage, window */
 
 /**
  * @typedef {{ id: string, email: string }} AuthUser
@@ -9,13 +9,35 @@
  * @property {string} name
  * @property {(done: ReadyCallback) => void} whenReady
  * @property {(callback: AuthCallback) => void} login
- * @property {(callback: AuthCallback) => void} silentLogin
+ * @property {(callback: AuthCallback) => void} autoLogin
+ * @property {() => boolean} [supportsAutoLogin]
  * @property {(callback: () => void) => void} logout
  * @property {() => AuthUser | null} getUser
  * @property {() => boolean} isAuthenticated
  */
 
 (function registerAuthHelpers(ns) {
+    /** @type {ReturnType<typeof createDefaultStorage> | undefined} */
+    let defaultStorage;
+
+    function createDefaultStorage() {
+        if (typeof localStorage !== 'undefined') {
+            return {
+                get(key) {
+                    const value = localStorage.getItem(key);
+                    return value === null ? undefined : value;
+                },
+                set(key, value) {
+                    localStorage.setItem(key, value == null ? '' : String(value));
+                },
+                remove(key) {
+                    localStorage.removeItem(key);
+                },
+            };
+        }
+        return null;
+    }
+
     const helpers = {
         configValue(key, fallback) {
             if (!ns.has('config')) {
@@ -29,7 +51,13 @@
         },
 
         getStorage() {
-            return ns.has('storage') ? ns.get('storage') : null;
+            if (ns.has('storage')) {
+                return ns.get('storage');
+            }
+            if (defaultStorage === undefined) {
+                defaultStorage = createDefaultStorage();
+            }
+            return defaultStorage;
         },
     };
 

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

@@ -50,10 +50,14 @@
                 });
         }
 
-        silentLogin(callback) {
+        autoLogin(callback) {
             callback({ authenticated: this.authenticated, user: this.getUser() });
         }
 
+        supportsAutoLogin() {
+            return true;
+        }
+
         logout(callback) {
             const storage = getStorage();
             this.authenticated = false;

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

@@ -6,24 +6,42 @@
     const DEFAULT_CLIENT_ID = '225754014403.apps.googleusercontent.com';
     const DEFAULT_SCOPES = 'openid email profile';
     const DEFAULT_TOKEN_KEY = 'adaptfully_google_token';
+    const DEFAULT_AUTO_LOGIN_KEY = 'lastLoggedIn';
 
     class GoogleAuthPlugin {
         constructor() {
             this.name = 'google';
             this.tokenClient = null;
-            this.tokenKey = configValue('googleTokenKey', DEFAULT_TOKEN_KEY);
-            this.clientId = configValue('googleClientId', DEFAULT_CLIENT_ID);
-            this.scopes = configValue('googleScopes', DEFAULT_SCOPES);
-            this.accessToken = sessionStorage.getItem(this.tokenKey) || '';
+            this.accessToken = '';
             this.user = null;
             this.authenticated = false;
         }
 
+        supportsAutoLogin() {
+            return true;
+        }
+
+        #tokenKey() {
+            return configValue('googleTokenKey', DEFAULT_TOKEN_KEY);
+        }
+
+        #clientId() {
+            return configValue('googleClientId', DEFAULT_CLIENT_ID);
+        }
+
+        #scopes() {
+            return configValue('googleScopes', DEFAULT_SCOPES);
+        }
+
+        #autoLoginStorageKey() {
+            return configValue('autoLoginStorageKey', DEFAULT_AUTO_LOGIN_KEY);
+        }
+
         whenReady(done) {
             const setup = () => {
                 this.tokenClient = google.accounts.oauth2.initTokenClient({
-                    client_id: this.clientId,
-                    scope: this.scopes,
+                    client_id: this.#clientId(),
+                    scope: this.#scopes(),
                     callback: () => {},
                 });
                 done();
@@ -60,12 +78,19 @@
             this.accessToken = '';
             this.user = null;
             this.authenticated = false;
-            sessionStorage.removeItem(this.tokenKey);
+            sessionStorage.removeItem(this.#tokenKey());
+        }
+
+        #loadStoredToken() {
+            if (!this.accessToken) {
+                this.accessToken = sessionStorage.getItem(this.#tokenKey()) || '';
+            }
         }
 
         #hasPersistedLogin() {
             const storage = getStorage();
-            return !!(storage?.get('lastLoggedIn'));
+            const key = this.#autoLoginStorageKey();
+            return !!(storage?.get(key));
         }
 
         #fetchUserInfo(token, callback) {
@@ -80,7 +105,7 @@
                 })
                 .then((data) => {
                     this.accessToken = token;
-                    sessionStorage.setItem(this.tokenKey, token);
+                    sessionStorage.setItem(this.#tokenKey(), token);
                     this.#applyUserInfo(data);
                     callback();
                 })
@@ -103,6 +128,8 @@
         }
 
         #restoreSession(callback) {
+            this.#loadStoredToken();
+
             const trySilentGoogleLogin = () => {
                 if (this.#hasPersistedLogin()) {
                     this.#requestAccessToken('none', callback);
@@ -135,7 +162,7 @@
             });
         }
 
-        silentLogin(callback) {
+        autoLogin(callback) {
             if (this.authenticated && this.user?.id) {
                 callback({ authenticated: true, user: this.getUser() });
                 return;
@@ -149,7 +176,7 @@
             const storage = getStorage();
             const finish = () => {
                 this.#clearSession();
-                storage?.remove('lastLoggedIn');
+                storage?.remove(this.#autoLoginStorageKey());
                 callback();
             };
 

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

@@ -22,10 +22,14 @@
             callback({ authenticated: this.authenticated, user: this.getUser() });
         }
 
-        silentLogin(callback) {
+        autoLogin(callback) {
             callback({ authenticated: this.authenticated, user: this.getUser() });
         }
 
+        supportsAutoLogin() {
+            return false;
+        }
+
         logout(callback) {
             const storage = getStorage();
             this.user = null;

package/lib/runtime/platform.js

@@ -53,13 +53,17 @@
             });
         }
 
-        silentLogin(callback) {
+        autoLogin(callback) {
             this.whenReady(() => {
                 if (!this.online) {
                     callback({ authenticated: false });
                     return;
                 }
-                this.auth.silentLogin((result) => {
+                if (typeof this.auth.autoLogin !== 'function') {
+                    callback({ authenticated: false });
+                    return;
+                }
+                this.auth.autoLogin((result) => {
                     callback(result || {
                         authenticated: this.auth.isAuthenticated(),
                         user: this.auth.getUser(),
@@ -68,6 +72,12 @@
             });
         }
 
+        supportsAutoLogin() {
+            return typeof this.auth.supportsAutoLogin === 'function'
+                ? this.auth.supportsAutoLogin()
+                : typeof this.auth.autoLogin === 'function';
+        }
+
         logout(callback) {
             this.whenReady(() => {
                 this.auth.logout(() => {

package/package.json

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