@makefully/adaptfully 3.12.1 → 3.14.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 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
+
+- **Per-platform `config.*` overrides** — `config.platforms.<key>.packageName` (and other identity/branding fields) override top-level `config.*` defaults for that platform. Control fields (`packager`, `registrations`, `builder`, `deployments`, `steamId`, `socialLogin`, `steamworks`) are unchanged. Helpers: `resolvePlatformConfig`, `getConfigValue`, `resolveConfigForBuild`.
+
 ## 3.12.1 — 2026-07-23
 
 ### Fixed

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.
 
 ---
 
@@ -437,13 +440,13 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
 | Field | Used by | Description |
 |-------|---------|-------------|
 | `title` | All | Display name shown in stores and app shells |
-| `packageName` | Cordova, Electron, UWP | Reverse-DNS identifier (`com.company.game`) |
+| `packageName` | Cordova, Capacitor, Electron, UWP, Play upload | Reverse-DNS identifier (`com.company.game`) |
 | `publisherDisplayName` | Cordova, Electron, web | Short publisher name |
 | `publisherFullName` | Electron | Legal entity name for copyright |
 | `publisherWebsite` | Cordova, web | Company URL |
 | `publisherEmailAddress` | Cordova | Contact email |
 | `scope` | Web/PWA | Base URL scope for the web app |
-| `themeColor` | Cordova, Electron, UWP, web | Loading screen / theme color |
+| `themeColor` | Cordova, Capacitor, Electron, UWP, web | Loading screen / theme color |
 | `twitterId` | Web | Twitter handle for meta tags |
 | `deployFolder` | Client | Neutral deploy directory staged before prebuild (default: `deploy`) |
 | `htmlInjections` | Prebuild | Deploy-relative HTML paths to inject (default: `["index.html"]`) |
@@ -454,8 +457,29 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
 | `platforms.<name>.packager` | Prebuild | `web` (default), `electron`, `cordova`, or `capacitor` — selects the packager class that adds platform-specific files during prebuild |
 | `platforms.<name>.steamId` | Electron + steam-auth | Steamworks app ID baked into `preload.js` (client). Upload app IDs belong in the Steam deployment `manifest.json` |
 | `platforms.<name>.socialLogin` | Capacitor + social-auth | Capgo provider config (`providers`, `google.webClientId`, `apple.clientId`, optional `defaultProvider`) |
+| `platforms.<name>.<configField>` | Build/deploy | Overrides the matching top-level `config.*` default for that platform only (e.g. `platforms.android.packageName`, `platforms.ios.title`). Does not apply to control fields: `packager`, `registrations`, `builder`, `builders`, `deployments`, `steamId`, `socialLogin`, `steamworks` |
 | `properties` | Cordova | Cordova config.xml entries (plugins, allow-navigation, etc.) |
 
+Top-level `config.*` values are **defaults**. Any non-control field on `config.platforms.<name>` overrides the default when that platform is built or deployed. Example:
+
+```json
+"config": {
+  "packageName": "com.example.game",
+  "title": "My Game",
+  "platforms": {
+    "android": {
+      "packager": "capacitor",
+      "packageName": "com.example.game.android"
+    },
+    "android-dev": {
+      "packager": "capacitor",
+      "packageName": "com.example.game.dev"
+    }
+  }
+}
+```
+
+
 ### `wrapfully.json`
 
 Optional. Fields are shallow-merged into `package.json`'s `config`:

package/lib/node/index.js

@@ -1,6 +1,12 @@
 export { buildOutputDir, clearStaleBuildExtract, resolveBuildArtifactDir } from './artifacts.js';
 export { createArchive, createDeployArchive, createReleaseArchive, createSourceArchive } from './archive.js';
 export { loadProjectConfig, resolveServerUrl } from './config.js';
+export {
+    getConfigValue,
+    PLATFORM_CONTROL_KEYS,
+    resolveConfigForBuild,
+    resolvePlatformConfig,
+} from './platform-config.js';
 export { send } from './deploy.js';
 export {
     appendMetaIcons,

package/lib/node/packagers/base.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { STANDARD_PLUGINS } from '../registrations.js';
+import { resolvePlatformConfig } from '../platform-config.js';
 
 /** @typedef {import('../registrations.js').RegistrationMap} RegistrationMap */
 /** @typedef {'web' | 'electron' | 'cordova' | 'capacitor'} PackagerName */
@@ -38,15 +39,17 @@ function gameConfigPlatform(platformKey) {
 /**
  * @param {string} dest
  * @param {string} platformKey
- * @param {{ name: string, version: string, config?: { title?: string } }} pkg
+ * @param {{ name: string, version: string, config?: object }} pkg
  * @param {(message: string) => void} log
  */
 function writeGameConfig(dest, platformKey, pkg, log) {
+    const config = resolvePlatformConfig(pkg, platformKey);
     const content = `window.gameConfig = ${JSON.stringify({
-        title: pkg.config?.title,
+        title: config.title,
         version: pkg.version,
         id: pkg.name,
         platform: gameConfigPlatform(platformKey),
+        packageName: config.packageName,
     }, null, 4)};`;
 
     fs.writeFileSync(path.join(dest, 'game-config.js'), content);

package/lib/node/packagers/electron.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { Packager } from './base.js';
+import { resolvePlatformConfig } from '../platform-config.js';
 
 const STEAM_INIT = `const path = require('path');
 
@@ -221,8 +222,10 @@ export class ElectronPackager extends Packager {
 
     /** @param {string} dest */
     writeElectronMain(dest) {
-        const withSteam = this.usesPlugin('steam-auth');
-        const mainContent = buildElectronMain(withSteam, this.pkg.config?.themeColor);
+        const
+            withSteam = this.usesPlugin('steam-auth'),
+            config = resolvePlatformConfig(this.pkg, this.platformKey),
+            mainContent = buildElectronMain(withSteam, config.themeColor);
 
         if (withSteam) {
             const steamId = resolvePlatformSteamId(this.platformKey, this.pkg);

package/lib/node/platform-config.js

@@ -0,0 +1,81 @@
+/**
+ * Keys that configure platform behavior (not inherited identity/defaults).
+ * These stay on `platforms.<key>` and are not treated as config.* overrides.
+ */
+export const PLATFORM_CONTROL_KEYS = new Set([
+    'registrations',
+    'builder',
+    'builders',
+    'packager',
+    'deployments',
+    'steamId',
+    'socialLogin',
+    'steamworks',
+]);
+
+/**
+ * Resolve effective `config` for a platform: top-level `config.*` are defaults;
+ * any non-control field on `config.platforms.<platformKey>` overrides them.
+ *
+ * @param {{ config?: Record<string, unknown> }} pkg
+ * @param {string | null | undefined} platformKey
+ * @returns {Record<string, unknown>}
+ */
+export function resolvePlatformConfig(pkg, platformKey) {
+    const root = pkg?.config && typeof pkg.config === 'object' ? pkg.config : {};
+    /** @type {Record<string, unknown>} */
+    const resolved = { ...root };
+    delete resolved.platforms;
+
+    if (!platformKey || typeof platformKey !== 'string') {
+        return resolved;
+    }
+
+    const platform = root.platforms?.[platformKey];
+    if (!platform || typeof platform !== 'object' || Array.isArray(platform)) {
+        return resolved;
+    }
+
+    for (const [key, value] of Object.entries(platform)) {
+        if (PLATFORM_CONTROL_KEYS.has(key) || value === undefined) {
+            continue;
+        }
+        resolved[key] = value;
+    }
+
+    return resolved;
+}
+
+/**
+ * @param {{ config?: Record<string, unknown> }} pkg
+ * @param {string | null | undefined} platformKey
+ * @param {string} key
+ * @param {unknown} [fallback]
+ */
+export function getConfigValue(pkg, platformKey, key, fallback) {
+    const resolved = resolvePlatformConfig(pkg, platformKey);
+    return resolved[key] !== undefined ? resolved[key] : fallback;
+}
+
+/**
+ * Prefer a platform whose key matches the deployment key (e.g. deploy "android"
+ * → platforms.android), else the build's platformKey.
+ *
+ * @param {{ config?: Record<string, unknown> }} pkg
+ * @param {{ platformKey?: string | null, deploymentKey?: string | null }} [context]
+ */
+export function resolveConfigForBuild(pkg, context = {}) {
+    const { platformKey = null, deploymentKey = null } = context;
+    const platforms = pkg?.config?.platforms;
+
+    if (
+        deploymentKey
+        && platforms
+        && typeof platforms === 'object'
+        && platforms[deploymentKey]
+    ) {
+        return resolvePlatformConfig(pkg, deploymentKey);
+    }
+
+    return resolvePlatformConfig(pkg, platformKey);
+}

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.12.1",
+    "version": "3.14.0",
     "description": "Platform abstraction and Wrapfully deploy client for Makefully games",
     "type": "module",
     "main": "./lib/node/index.js",