@makefully/adaptfully 3.12.1 → 3.13.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project are documented in this file.
 
+## 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

@@ -437,13 +437,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 +454,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/package.json

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